Comet X Ultimate v4

🚀 Bootstrap repo for AI agents & automation
Azure DevOps (primary) | GitHub (secondary)

🎯 Overview

Multi-agent automation platform combining:

• AI Agents (AG1 → AG2 → AG3) for intelligent task processing
• Power Automate Desktop for browser automation
• Azure Services for cloud infrastructure
• GitHub Actions for CI/CD

📐 Architecture

flowchart TB
    subgraph UI["🖥️ UI/Channels"]
        EXE[EXE App]
        CLI[CLI]
        Teams[Teams Bot]
        Web[Web Portal]
    end

    subgraph Agents["🤖 Agent Pipeline"]
        AG1[AG1: Understanding]
        AG2[AG2: Orchestration]
        AG3[AG3: Reporting]
        AG1 -->|artifacts/ag1-*.json| AG2
        AG2 -->|artifacts/ag2-*.json| AG3
    end

    subgraph PAD["🌐 Browser Automation"]
        PADFlows[Power Automate Desktop]
        Edge[Edge WebDriver]
        PADFlows --> Edge
    end

    subgraph Azure["☁️ Azure Services"]
        EntraID[Entra ID]
        KV[Key Vault]
        Storage[Blob Storage]
    end

    UI --> Agents
    Agents --> PAD
    Agents --> Azure
    AG3 --> GHA[GitHub Actions]

Loading

🚀 Quickstart

Prerequisites

• Windows 11 with PowerShell 7+
• Power Automate Desktop
• Azure CLI (az) + GitHub CLI (gh)
• Python 3.11+

Setup

# Clone the repo
git clone https://github.com/Grar00t/cometx.git
cd cometx

# Add Azure DevOps remote (primary)
git remote add origin https://dev.azure.com/cometxsa/cometx/_git/cometx

# Initialize first agent
.\scripts\init-agent.ps1 -AgentName "AG1" -Template "understanding"

# Run PAD flow (example)
.\scripts\run-pad.ps1 -Flow "flow-report-export" -Headless

Create All Agents

.\scripts\init-agent.ps1 -AgentName "AG1" -Template "understanding"
.\scripts\init-agent.ps1 -AgentName "AG2" -Template "orchestration"
.\scripts\init-agent.ps1 -AgentName "AG3" -Template "reporting"

📁 Project Structure

cometx/
├── .github/
│   ├── workflows/
│   │   ├── security-ci.yml      # CodeQL + Trivy scans
│   │   └── azure-deploy.yml     # OIDC deployment
│   └── copilot-instructions.md  # AI agent guidelines
├── agents/
│   ├── AG1/                     # Understanding agent
│   ├── AG2/                     # Orchestration agent
│   └── AG3/                     # Reporting agent
├── artifacts/
│   └── examples/                # Sample JSON outputs
├── flows/                       # PAD flow definitions
├── scripts/
│   ├── init-agent.ps1          # Agent scaffolding
│   └── run-pad.ps1             # PAD flow runner
├── src/                         # Core application code
├── tests/                       # Test suites
├── README.md
└── SECURITY.md

🔐 Security

Policy	Implementation
Authentication	OIDC with Azure (no long-lived secrets)
Secrets	Azure Key Vault only
Scans	CodeQL + Trivy (fail on CRITICAL)
Permissions	Least-privilege (contents: read)

See SECURITY.md for full policy.

🤖 Agent Communication

Agents communicate via JSON artifacts (not HTTP/Queue):

artifacts/
├── ag1-2025-12-21T14-30-00Z-context.json
├── ag2-2025-12-21T14-30-05Z-tasks.json
└── ag3-2025-12-21T14-30-10Z-report.json

Pattern: ag<N>-<ISO-timestamp>-<type>.json

☁️ Azure Resources

Naming convention: cometx-<service>-<env>

Resource	Dev	Prod
Key Vault	cometx-kv-dev	cometx-kv-prod
Storage	cometxstgdev	cometxstgprod
VM	cometx-vm-dev	cometx-vm-prod

📄 License

MIT © 2025 Comet X Team