diagram-to-iac 1.0.4__tar.gz → 1.0.5__tar.gz

{diagram_to_iac-1.0.4 → diagram_to_iac-1.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: diagram-to-iac
-Version: 1.0.4
+Version: 1.0.5
 Summary: Convert architecture diagrams into IaC modules
 Author-email: vindpro <admin@vindpro.com>
 Description-Content-Type: text/markdown
@@ -29,27 +29,39 @@ An automated DevOps-in-a-Box system that intelligently handles complete Repo-to-
 
 The **R2D (Repo-to-Deployment) Action** is a self-healing, Terraform-first DevOps automation solution that lives inside a single GitHub Action. When you supply any repository URL, our SupervisorAgent marshals specialized agents to handle the complete deployment workflow.
 
-### Quick Start with GitHub Actions
+### 🎯 2-Minute Quick Start
+
+**Step 1:** Add the unified workflow to your repository:
 
 ```yaml
-name: Deploy Infrastructure
+# .github/workflows/r2d-unified.yml
+name: R2D - DevOps in a Box
 on:
-  push:
-    branches: [main]
+  issues:
+    types: [opened, edited]
+  pull_request:
+    types: [closed]
+  workflow_dispatch:
+    inputs:
+      repo_url:
+        description: 'Repository URL to deploy'
+        required: false
+        type: string
 
 jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Deploy with R2D
-        uses: amartyamandal/diagram-to-iac/.github/actions/r2d@v1
-        with:
-          repo: ${{ github.server_url }}/${{ github.repository }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          TF_CLOUD_TOKEN: ${{ secrets.TF_CLOUD_TOKEN }}
+  r2d-deploy:
+    uses: amartyamandal/diagram-to-iac/.github/workflows/r2d-unified.yml@main
+    secrets: inherit
+    with:
+      repo_url: ${{ inputs.repo_url || github.server_url }}/${{ github.repository }}
 ```
 
+**Step 2:** Configure your secrets (see [complete guide](docs/R2D_USER_GUIDE.md))
+
+**Step 3:** Trigger deployment via issue, PR merge, or manual run
+
+> 📚 **[Complete Setup Guide](docs/R2D_USER_GUIDE.md)** - Everything you need in one place!
+
 ### Key Features
 
 - **🤖 Self-Healing**: Automatically creates GitHub Issues for errors and suggests fixes
@@ -168,89 +180,93 @@ In GitHub Actions, the following artifacts are automatically collected:
 
 ## 🔧 GitHub Actions Usage
 
-Add the R2D action to your workflow for automated infrastructure deployment:
+The R2D system now uses a **unified workflow** that handles all deployment scenarios automatically. This replaces the previous multiple workflow files with a single, intelligent solution.
+
+### ⚡ Simple Setup (Recommended)
 
-### Basic Setup
+Add this single workflow file to get all R2D capabilities:
 
 ```yaml
-name: Deploy Infrastructure
+# .github/workflows/r2d-unified.yml
+name: R2D - DevOps in a Box
 on:
-  push:
-    branches: [main]
+  issues:
+    types: [opened, edited]
+  pull_request:
+    types: [closed]
+  workflow_dispatch:
+    inputs:
+      repo_url:
+        description: 'Repository URL to deploy'
+        required: false
+        type: string
 
 jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Deploy with R2D
-        uses: amartyamandal/diagram-to-iac/.github/actions/r2d@v1
-        with:
-          repo: ${{ github.server_url }}/${{ github.repository }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          TF_CLOUD_TOKEN: ${{ secrets.TF_CLOUD_TOKEN }}
+  r2d-deploy:
+    uses: amartyamandal/diagram-to-iac/.github/workflows/r2d-unified.yml@main
+    secrets: inherit
+    with:
+      repo_url: ${{ inputs.repo_url || github.server_url }}/${{ github.repository }}
 ```
 
-### Advanced Configuration
+### 🎮 Multiple Ways to Deploy
 
-```yaml
-- name: Deploy with Custom Settings
-  uses: amartyamandal/diagram-to-iac/.github/actions/r2d@v1
-  with:
-    repo: 'https://github.com/my-org/infrastructure'
-    package_version: 'v2.1.0'
-    dry_run: 'false'
-    branch_name: 'deploy-prod'
-    thread_id: 'prod-deployment-001'
-  env:
-    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-    TF_CLOUD_TOKEN: ${{ secrets.TF_CLOUD_TOKEN }}
-    OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-```
+- **📝 Issue-based**: Create an issue with "deploy" in title/body
+- **🔀 PR merge**: Automatic deployment when PRs are merged
+- **🎯 Manual**: Use workflow_dispatch with optional custom repo URL
+- **🔒 External repos**: Deploy any accessible repository
 
-### Required Secrets
+### 📋 Required Secrets
 
-Configure these in your repository settings:
+Configure these in your repository settings → Secrets and variables → Actions:
 
 | Secret | Description | Required |
 |--------|-------------|----------|
 | `GITHUB_TOKEN` | GitHub API access (auto-provided) | ✅ Yes |
-| `TF_CLOUD_TOKEN` | Terraform Cloud API token | ✅ Yes |
-| `OPENAI_API_KEY` | OpenAI API key | ❌ Optional |
-| `ANTHROPIC_API_KEY` | Claude API key | ❌ Optional |
-| `GOOGLE_API_KEY` | Gemini API key | ❌ Optional |
+| `TF_CLOUD_TOKEN` | Terraform Cloud workspace token | ✅ Yes |
+| `OPENAI_API_KEY` | OpenAI API key for AI features | ❌ Optional |
+| `ANTHROPIC_API_KEY` | Claude API key for AI features | ❌ Optional |
 
-### Example Workflows
+> 📚 **[Complete Setup Guide](docs/R2D_USER_GUIDE.md)** includes examples, troubleshooting, and advanced configurations.
 
-See [`.github/actions/r2d/examples/`](.github/actions/r2d/examples/) for complete workflow examples:
+## 📈 Observability & Monitoring
 
-- **Basic Deployment**: Simple push-to-deploy workflow
-- **Multi-Environment**: Deploy to dev/staging/prod with approvals
-- **PR Validation**: Validate infrastructure changes in pull requests
-- **Drift Detection**: Scheduled infrastructure drift monitoring
-- **External Repository**: Deploy from external repositories
+After each workflow run, comprehensive artifacts are generated:
 
+- **📊 Step Summary Dashboard**: `step-summary.md` with Terraform changes, security findings, and metrics
+- **📋 Structured Logs**: JSONL format in `logs/` directory for analysis  
+- **🔍 GitHub Integration**: Automatic issue creation and PR suggestions
+- **📦 Artifacts**: Plans, reports, and logs uploaded as GitHub Actions artifacts
 
-After each workflow run, a Markdown dashboard is generated at `step-summary.md`
-showing a high level overview of Terraform modules, resource changes and tfsec
-findings. The dashboard is derived from the JSONL logs and can be viewed
-directly in the repository or uploaded as a build artifact.
+## 🧪 Development & Testing
 
+For local development and testing:
 
+```bash
+# Install development dependencies
+pip install -e .[dev]
 
-This repository provides a container action that runs the `SupervisorAgent` on the current repository. Add the action to a workflow as shown below:
+# Run the CLI locally
+diagram-to-iac https://github.com/user/repo --dry-run
 
-```yaml
-jobs:
-  supervisor:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Run Supervisor Agent
-        uses: ./.github/actions/supervisor
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+# Run tests
+pytest
 ```
 
-The action reads `GITHUB_REPOSITORY` and `GITHUB_TOKEN` automatically to clone the repository and execute the agent.
+## 📚 Documentation
+
+## 📚 Documentation
+
+- **[R2D User Guide](docs/R2D_USER_GUIDE.md)** - Complete setup and usage guide
+- **[Migration Guide](docs/MIGRATION_GUIDE.md)** - Migrate from old workflows to unified approach
+- **[Container Action](.github/actions/r2d/)** - Technical details of the container action
+- **[Agent Architecture](src/diagram_to_iac/agents/)** - How the AI agents work together
+- **[Simplification Summary](docs/SIMPLIFICATION_COMPLETION_SUMMARY.md)** - What changed in the unified approach
+
+## 🤝 Contributing
+
+This project follows strict coding standards and security practices. See the development guidelines in the repository for contribution instructions.
+
+---
+
+> **"One container, many minds—zero manual toil."** 🤖

{diagram_to_iac-1.0.4 → diagram_to_iac-1.0.5}/README.md

@@ -8,27 +8,39 @@ An automated DevOps-in-a-Box system that intelligently handles complete Repo-to-
 
 The **R2D (Repo-to-Deployment) Action** is a self-healing, Terraform-first DevOps automation solution that lives inside a single GitHub Action. When you supply any repository URL, our SupervisorAgent marshals specialized agents to handle the complete deployment workflow.
 
-### Quick Start with GitHub Actions
+### 🎯 2-Minute Quick Start
+
+**Step 1:** Add the unified workflow to your repository:
 
 ```yaml
-name: Deploy Infrastructure
+# .github/workflows/r2d-unified.yml
+name: R2D - DevOps in a Box
 on:
-  push:
-    branches: [main]
+  issues:
+    types: [opened, edited]
+  pull_request:
+    types: [closed]
+  workflow_dispatch:
+    inputs:
+      repo_url:
+        description: 'Repository URL to deploy'
+        required: false
+        type: string
 
 jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Deploy with R2D
-        uses: amartyamandal/diagram-to-iac/.github/actions/r2d@v1
-        with:
-          repo: ${{ github.server_url }}/${{ github.repository }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          TF_CLOUD_TOKEN: ${{ secrets.TF_CLOUD_TOKEN }}
+  r2d-deploy:
+    uses: amartyamandal/diagram-to-iac/.github/workflows/r2d-unified.yml@main
+    secrets: inherit
+    with:
+      repo_url: ${{ inputs.repo_url || github.server_url }}/${{ github.repository }}
 ```
 
+**Step 2:** Configure your secrets (see [complete guide](docs/R2D_USER_GUIDE.md))
+
+**Step 3:** Trigger deployment via issue, PR merge, or manual run
+
+> 📚 **[Complete Setup Guide](docs/R2D_USER_GUIDE.md)** - Everything you need in one place!
+
 ### Key Features
 
 - **🤖 Self-Healing**: Automatically creates GitHub Issues for errors and suggests fixes
@@ -147,89 +159,93 @@ In GitHub Actions, the following artifacts are automatically collected:
 
 ## 🔧 GitHub Actions Usage
 
-Add the R2D action to your workflow for automated infrastructure deployment:
+The R2D system now uses a **unified workflow** that handles all deployment scenarios automatically. This replaces the previous multiple workflow files with a single, intelligent solution.
+
+### ⚡ Simple Setup (Recommended)
 
-### Basic Setup
+Add this single workflow file to get all R2D capabilities:
 
 ```yaml
-name: Deploy Infrastructure
+# .github/workflows/r2d-unified.yml
+name: R2D - DevOps in a Box
 on:
-  push:
-    branches: [main]
+  issues:
+    types: [opened, edited]
+  pull_request:
+    types: [closed]
+  workflow_dispatch:
+    inputs:
+      repo_url:
+        description: 'Repository URL to deploy'
+        required: false
+        type: string
 
 jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Deploy with R2D
-        uses: amartyamandal/diagram-to-iac/.github/actions/r2d@v1
-        with:
-          repo: ${{ github.server_url }}/${{ github.repository }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          TF_CLOUD_TOKEN: ${{ secrets.TF_CLOUD_TOKEN }}
+  r2d-deploy:
+    uses: amartyamandal/diagram-to-iac/.github/workflows/r2d-unified.yml@main
+    secrets: inherit
+    with:
+      repo_url: ${{ inputs.repo_url || github.server_url }}/${{ github.repository }}
 ```
 
-### Advanced Configuration
+### 🎮 Multiple Ways to Deploy
 
-```yaml
-- name: Deploy with Custom Settings
-  uses: amartyamandal/diagram-to-iac/.github/actions/r2d@v1
-  with:
-    repo: 'https://github.com/my-org/infrastructure'
-    package_version: 'v2.1.0'
-    dry_run: 'false'
-    branch_name: 'deploy-prod'
-    thread_id: 'prod-deployment-001'
-  env:
-    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-    TF_CLOUD_TOKEN: ${{ secrets.TF_CLOUD_TOKEN }}
-    OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-```
+- **📝 Issue-based**: Create an issue with "deploy" in title/body
+- **🔀 PR merge**: Automatic deployment when PRs are merged
+- **🎯 Manual**: Use workflow_dispatch with optional custom repo URL
+- **🔒 External repos**: Deploy any accessible repository
 
-### Required Secrets
+### 📋 Required Secrets
 
-Configure these in your repository settings:
+Configure these in your repository settings → Secrets and variables → Actions:
 
 | Secret | Description | Required |
 |--------|-------------|----------|
 | `GITHUB_TOKEN` | GitHub API access (auto-provided) | ✅ Yes |
-| `TF_CLOUD_TOKEN` | Terraform Cloud API token | ✅ Yes |
-| `OPENAI_API_KEY` | OpenAI API key | ❌ Optional |
-| `ANTHROPIC_API_KEY` | Claude API key | ❌ Optional |
-| `GOOGLE_API_KEY` | Gemini API key | ❌ Optional |
+| `TF_CLOUD_TOKEN` | Terraform Cloud workspace token | ✅ Yes |
+| `OPENAI_API_KEY` | OpenAI API key for AI features | ❌ Optional |
+| `ANTHROPIC_API_KEY` | Claude API key for AI features | ❌ Optional |
 
-### Example Workflows
+> 📚 **[Complete Setup Guide](docs/R2D_USER_GUIDE.md)** includes examples, troubleshooting, and advanced configurations.
 
-See [`.github/actions/r2d/examples/`](.github/actions/r2d/examples/) for complete workflow examples:
+## 📈 Observability & Monitoring
 
-- **Basic Deployment**: Simple push-to-deploy workflow
-- **Multi-Environment**: Deploy to dev/staging/prod with approvals
-- **PR Validation**: Validate infrastructure changes in pull requests
-- **Drift Detection**: Scheduled infrastructure drift monitoring
-- **External Repository**: Deploy from external repositories
+After each workflow run, comprehensive artifacts are generated:
 
+- **📊 Step Summary Dashboard**: `step-summary.md` with Terraform changes, security findings, and metrics
+- **📋 Structured Logs**: JSONL format in `logs/` directory for analysis  
+- **🔍 GitHub Integration**: Automatic issue creation and PR suggestions
+- **📦 Artifacts**: Plans, reports, and logs uploaded as GitHub Actions artifacts
 
-After each workflow run, a Markdown dashboard is generated at `step-summary.md`
-showing a high level overview of Terraform modules, resource changes and tfsec
-findings. The dashboard is derived from the JSONL logs and can be viewed
-directly in the repository or uploaded as a build artifact.
+## 🧪 Development & Testing
 
+For local development and testing:
 
+```bash
+# Install development dependencies
+pip install -e .[dev]
 
-This repository provides a container action that runs the `SupervisorAgent` on the current repository. Add the action to a workflow as shown below:
+# Run the CLI locally
+diagram-to-iac https://github.com/user/repo --dry-run
 
-```yaml
-jobs:
-  supervisor:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Run Supervisor Agent
-        uses: ./.github/actions/supervisor
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+# Run tests
+pytest
 ```
 
-The action reads `GITHUB_REPOSITORY` and `GITHUB_TOKEN` automatically to clone the repository and execute the agent.
+## 📚 Documentation
+
+## 📚 Documentation
+
+- **[R2D User Guide](docs/R2D_USER_GUIDE.md)** - Complete setup and usage guide
+- **[Migration Guide](docs/MIGRATION_GUIDE.md)** - Migrate from old workflows to unified approach
+- **[Container Action](.github/actions/r2d/)** - Technical details of the container action
+- **[Agent Architecture](src/diagram_to_iac/agents/)** - How the AI agents work together
+- **[Simplification Summary](docs/SIMPLIFICATION_COMPLETION_SUMMARY.md)** - What changed in the unified approach
+
+## 🤝 Contributing
+
+This project follows strict coding standards and security practices. See the development guidelines in the repository for contribution instructions.
+
+---
+
+> **"One container, many minds—zero manual toil."** 🤖

{diagram_to_iac-1.0.4 → diagram_to_iac-1.0.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name        = "diagram-to-iac"
-version     = "1.0.4"
+version     = "1.0.5"
 description = "Convert architecture diagrams into IaC modules"
 readme      = "README.md"
 authors     = [{ name="vindpro", email="admin@vindpro.com" }]

{diagram_to_iac-1.0.4 → diagram_to_iac-1.0.5}/src/diagram_to_iac.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: diagram-to-iac
-Version: 1.0.4
+Version: 1.0.5
 Summary: Convert architecture diagrams into IaC modules
 Author-email: vindpro <admin@vindpro.com>
 Description-Content-Type: text/markdown
@@ -29,27 +29,39 @@ An automated DevOps-in-a-Box system that intelligently handles complete Repo-to-
 
 The **R2D (Repo-to-Deployment) Action** is a self-healing, Terraform-first DevOps automation solution that lives inside a single GitHub Action. When you supply any repository URL, our SupervisorAgent marshals specialized agents to handle the complete deployment workflow.
 
-### Quick Start with GitHub Actions
+### 🎯 2-Minute Quick Start
+
+**Step 1:** Add the unified workflow to your repository:
 
 ```yaml
-name: Deploy Infrastructure
+# .github/workflows/r2d-unified.yml
+name: R2D - DevOps in a Box
 on:
-  push:
-    branches: [main]
+  issues:
+    types: [opened, edited]
+  pull_request:
+    types: [closed]
+  workflow_dispatch:
+    inputs:
+      repo_url:
+        description: 'Repository URL to deploy'
+        required: false
+        type: string
 
 jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Deploy with R2D
-        uses: amartyamandal/diagram-to-iac/.github/actions/r2d@v1
-        with:
-          repo: ${{ github.server_url }}/${{ github.repository }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          TF_CLOUD_TOKEN: ${{ secrets.TF_CLOUD_TOKEN }}
+  r2d-deploy:
+    uses: amartyamandal/diagram-to-iac/.github/workflows/r2d-unified.yml@main
+    secrets: inherit
+    with:
+      repo_url: ${{ inputs.repo_url || github.server_url }}/${{ github.repository }}
 ```
 
+**Step 2:** Configure your secrets (see [complete guide](docs/R2D_USER_GUIDE.md))
+
+**Step 3:** Trigger deployment via issue, PR merge, or manual run
+
+> 📚 **[Complete Setup Guide](docs/R2D_USER_GUIDE.md)** - Everything you need in one place!
+
 ### Key Features
 
 - **🤖 Self-Healing**: Automatically creates GitHub Issues for errors and suggests fixes
@@ -168,89 +180,93 @@ In GitHub Actions, the following artifacts are automatically collected:
 
 ## 🔧 GitHub Actions Usage
 
-Add the R2D action to your workflow for automated infrastructure deployment:
+The R2D system now uses a **unified workflow** that handles all deployment scenarios automatically. This replaces the previous multiple workflow files with a single, intelligent solution.
+
+### ⚡ Simple Setup (Recommended)
 
-### Basic Setup
+Add this single workflow file to get all R2D capabilities:
 
 ```yaml
-name: Deploy Infrastructure
+# .github/workflows/r2d-unified.yml
+name: R2D - DevOps in a Box
 on:
-  push:
-    branches: [main]
+  issues:
+    types: [opened, edited]
+  pull_request:
+    types: [closed]
+  workflow_dispatch:
+    inputs:
+      repo_url:
+        description: 'Repository URL to deploy'
+        required: false
+        type: string
 
 jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Deploy with R2D
-        uses: amartyamandal/diagram-to-iac/.github/actions/r2d@v1
-        with:
-          repo: ${{ github.server_url }}/${{ github.repository }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          TF_CLOUD_TOKEN: ${{ secrets.TF_CLOUD_TOKEN }}
+  r2d-deploy:
+    uses: amartyamandal/diagram-to-iac/.github/workflows/r2d-unified.yml@main
+    secrets: inherit
+    with:
+      repo_url: ${{ inputs.repo_url || github.server_url }}/${{ github.repository }}
 ```
 
-### Advanced Configuration
+### 🎮 Multiple Ways to Deploy
 
-```yaml
-- name: Deploy with Custom Settings
-  uses: amartyamandal/diagram-to-iac/.github/actions/r2d@v1
-  with:
-    repo: 'https://github.com/my-org/infrastructure'
-    package_version: 'v2.1.0'
-    dry_run: 'false'
-    branch_name: 'deploy-prod'
-    thread_id: 'prod-deployment-001'
-  env:
-    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-    TF_CLOUD_TOKEN: ${{ secrets.TF_CLOUD_TOKEN }}
-    OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-```
+- **📝 Issue-based**: Create an issue with "deploy" in title/body
+- **🔀 PR merge**: Automatic deployment when PRs are merged
+- **🎯 Manual**: Use workflow_dispatch with optional custom repo URL
+- **🔒 External repos**: Deploy any accessible repository
 
-### Required Secrets
+### 📋 Required Secrets
 
-Configure these in your repository settings:
+Configure these in your repository settings → Secrets and variables → Actions:
 
 | Secret | Description | Required |
 |--------|-------------|----------|
 | `GITHUB_TOKEN` | GitHub API access (auto-provided) | ✅ Yes |
-| `TF_CLOUD_TOKEN` | Terraform Cloud API token | ✅ Yes |
-| `OPENAI_API_KEY` | OpenAI API key | ❌ Optional |
-| `ANTHROPIC_API_KEY` | Claude API key | ❌ Optional |
-| `GOOGLE_API_KEY` | Gemini API key | ❌ Optional |
+| `TF_CLOUD_TOKEN` | Terraform Cloud workspace token | ✅ Yes |
+| `OPENAI_API_KEY` | OpenAI API key for AI features | ❌ Optional |
+| `ANTHROPIC_API_KEY` | Claude API key for AI features | ❌ Optional |
 
-### Example Workflows
+> 📚 **[Complete Setup Guide](docs/R2D_USER_GUIDE.md)** includes examples, troubleshooting, and advanced configurations.
 
-See [`.github/actions/r2d/examples/`](.github/actions/r2d/examples/) for complete workflow examples:
+## 📈 Observability & Monitoring
 
-- **Basic Deployment**: Simple push-to-deploy workflow
-- **Multi-Environment**: Deploy to dev/staging/prod with approvals
-- **PR Validation**: Validate infrastructure changes in pull requests
-- **Drift Detection**: Scheduled infrastructure drift monitoring
-- **External Repository**: Deploy from external repositories
+After each workflow run, comprehensive artifacts are generated:
 
+- **📊 Step Summary Dashboard**: `step-summary.md` with Terraform changes, security findings, and metrics
+- **📋 Structured Logs**: JSONL format in `logs/` directory for analysis  
+- **🔍 GitHub Integration**: Automatic issue creation and PR suggestions
+- **📦 Artifacts**: Plans, reports, and logs uploaded as GitHub Actions artifacts
 
-After each workflow run, a Markdown dashboard is generated at `step-summary.md`
-showing a high level overview of Terraform modules, resource changes and tfsec
-findings. The dashboard is derived from the JSONL logs and can be viewed
-directly in the repository or uploaded as a build artifact.
+## 🧪 Development & Testing
 
+For local development and testing:
 
+```bash
+# Install development dependencies
+pip install -e .[dev]
 
-This repository provides a container action that runs the `SupervisorAgent` on the current repository. Add the action to a workflow as shown below:
+# Run the CLI locally
+diagram-to-iac https://github.com/user/repo --dry-run
 
-```yaml
-jobs:
-  supervisor:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Run Supervisor Agent
-        uses: ./.github/actions/supervisor
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+# Run tests
+pytest
 ```
 
-The action reads `GITHUB_REPOSITORY` and `GITHUB_TOKEN` automatically to clone the repository and execute the agent.
+## 📚 Documentation
+
+## 📚 Documentation
+
+- **[R2D User Guide](docs/R2D_USER_GUIDE.md)** - Complete setup and usage guide
+- **[Migration Guide](docs/MIGRATION_GUIDE.md)** - Migrate from old workflows to unified approach
+- **[Container Action](.github/actions/r2d/)** - Technical details of the container action
+- **[Agent Architecture](src/diagram_to_iac/agents/)** - How the AI agents work together
+- **[Simplification Summary](docs/SIMPLIFICATION_COMPLETION_SUMMARY.md)** - What changed in the unified approach
+
+## 🤝 Contributing
+
+This project follows strict coding standards and security practices. See the development guidelines in the repository for contribution instructions.
+
+---
+
+> **"One container, many minds—zero manual toil."** 🤖