MyConvergio - Claude Code Plugin

v5.1.1 | 65 Specialized Agents | Copilot CLI Support | Sync Agent | CLI Dashboard

"Intent is human, momentum is agent" — The Agentic Manifesto

What's New in v5.0.0

Copilot CLI support, ecosystem sync agent, public repo cleanup.

GitHub Copilot CLI Support

• 9 Copilot agents shipped in copilot-agents/ — same quality, Copilot format
• Workflow agents: @prompt, @planner, @execute, @validate, @tdd-executor
• Utility agents: @code-reviewer, @compliance-checker, @strategic-planner, @ecosystem-sync
• Works with any project — universal, not project-specific

Ecosystem Sync Agent

• ecosystem-sync agent (dual format: Claude Code + Copilot CLI)
• On-demand sync from upstream config → MyConvergio with sanitization
• Blocklist enforcement, personal path detection, dry-run mode
• Script: sync-to-myconvergio.sh --dry-run | --category agents|scripts|copilot|all

Public Repo Cleanup

• Removed 7 internal development docs from root
• Removed 6 internal/duplicate docs from docs/
• Sanitized personal path references
• Consolidated documentation for public consumption

Previous Highlights (v4.8.0)

• 5 new agents (60 → 65): sentinel, research-report-generator, task-executor-tdd, thor-validation-gates, app-release-manager-execution
• SQL injection fix + script hardening (89 scripts)
• 11 agents updated, 7 reference docs, 10 commands, 7 skills
• Agent Teams support, Tasks API, memory/maxTurns (v4.7.0)
• Strategic planner modules, worktree scripts, dashboard (v4.5.0)
• Multi-terminal support (Kitty, tmux, Zed, Warp, iTerm2)

Quick Start

Installation

Option A: Clone & Use (Recommended)

git clone https://github.com/roberdan/MyConvergio.git
cd MyConvergio
claude --plugin-dir .

Option B: Global npm Install

# Full install (all 65 agents)
npm install -g myconvergio

# Or choose a profile for lower context usage:
MYCONVERGIO_PROFILE=minimal npm install -g myconvergio  # 9 agents, ~50KB
MYCONVERGIO_PROFILE=lean npm install -g myconvergio     # 65 agents, ~600KB

Copies agents to ~/.claude/agents/. See Context Optimization Guide for details.

Option C: Claude Marketplace (Coming Soon)

claude plugins install myconvergio

Pending Anthropic approval

Option D: GitHub Copilot CLI

MyConvergio ships Copilot CLI agents in copilot-agents/. To use them:

# Copy agents to your Copilot config
cp copilot-agents/*.agent.md ~/.copilot/agents/

# Or symlink for auto-updates
ln -sf "$(pwd)/copilot-agents"/*.agent.md ~/.copilot/agents/

Available Copilot agents: @code-reviewer, @compliance-checker, @execute, @planner, @prompt, @strategic-planner, @tdd-executor, @validate, @ecosystem-sync

Usage

Claude Code — invoke any agent:

@ali-chief-of-staff Help me design our global expansion strategy
@baccio-tech-architect Design microservices architecture for healthcare platform
@rex-code-reviewer Review this pull request for security issues

Copilot CLI — invoke workflow agents:

@prompt Extract requirements for user authentication feature
@planner Create execution plan from requirements
@execute Run task-001 with TDD workflow
@validate Verify completed wave meets quality gates

Use slash commands (Claude Code):

/myconvergio:status    # Show ecosystem status
/myconvergio:team      # List all 65 agents by category
/myconvergio:plan      # Create a strategic execution plan

How It Works

graph TB
    subgraph USER["👤 You"]
        REQ[Requirements]
    end

    subgraph PLATFORMS["Dual Platform Support"]
        CC["☁️ Claude Code<br/><i>Full orchestration, parallel workers</i>"]
        COP["🤖 Copilot CLI<br/><i>Sequential TDD, same quality</i>"]
    end

    subgraph WORKFLOW["Structured Delivery Pipeline"]
        direction LR
        P["📋 Prompt<br/>Extract F-xx"]
        PL["📐 Plan<br/>Waves & Tasks"]
        EX["⚡ Execute<br/>TDD Cycle"]
        TH["🛡️ Thor<br/>Quality Gate"]
    end

    subgraph AGENTS["65 Specialized Agents"]
        direction TB
        L["7 Leadership<br/><i>ali, satya, dan...</i>"]
        T["9 Technical<br/><i>baccio, rex, dario...</i>"]
        C["11 Core<br/><i>thor, planner, marcus...</i>"]
        B["11 Business<br/><i>amy, davide, oliver...</i>"]
        O["27 More<br/><i>compliance, design,<br/>research, release...</i>"]
    end

    subgraph INFRA["89 Scripts + Hooks + CLI Dashboard"]
        S["Digest Scripts<br/><i>Compact JSON, cached</i>"]
        H["Hook System<br/><i>Pre/Post tool guards</i>"]
        D["SQLite + CLI Dashboard<br/><i>Plans, tokens, waves</i>"]
    end

    REQ --> CC & COP
    CC & COP --> P --> PL --> EX --> TH
    TH -->|PASS| D
    TH -->|FAIL max 3x| EX
    WORKFLOW --> AGENTS
    AGENTS --> INFRA

Workflow (Prompt → Plan → Execute → Verify)

MyConvergio follows a structured delivery flow that mirrors Claude Code best practices. See docs/workflow.md for the full reference.

1) Prompt

Use /prompt to extract requirements (F-xx) and confirm scope before planning.

Docs: .claude/commands/prompt.md

2) Planner

Use /planner to generate a multi-wave plan with tasks tied to F-xx criteria.

Docs: .claude/commands/planner.md

3) Execution (Executor Tracking)

Use the executor tracking helpers to log execution state and generate task markdown.

Docs: EXECUTOR_TRACKING.md
Scripts: .claude/scripts/executor-tracking.sh, .claude/scripts/generate-task-md.sh

4) Thor QA Guardian

Use the Thor agent to validate completion, evidence, and quality gates.

Agent: .claude/agents/core_utility/thor-quality-assurance-guardian.md

5) Dashboard

Monitor plans, waves, tasks, and token usage via the CLI mini-dashboard:

dashboard-mini.sh              # Full project overview
dashboard-mini.sh --overview   # Cross-project summary
dashboard-mini.sh --help       # All options

Requirements: bash + sqlite3 (preinstalled on macOS/Linux). On Windows, use WSL2.

CLI Dashboard

Terminal-native project dashboard — no browser, no server, no dependencies.

Features

• Project Overview: Plans, waves, tasks with progress bars and status
• Token Tracking: API token consumption and cost monitoring
• Wave/Task Drilldown: Detailed per-wave and per-task status
• Human Tasks: Highlights tasks requiring manual intervention
• Git Integration: Branch status, PR data (via gh CLI, optional)
• Cross-Platform: macOS, Linux, WSL2 (bash + sqlite3)
• Multi-Machine Sync: Optional remote sync via sync-dashboard-db.sh

Quick Start

# Make sure dashboard-mini.sh is in your PATH
export PATH="$HOME/.claude/scripts:$PATH"

# Run the dashboard
dashboard-mini.sh

# Overview of all active projects
dashboard-mini.sh --overview

Database

Reads the same SQLite database as Claude Code (~/.claude/data/dashboard.db). No additional configuration required.

Note: The web dashboard (Node.js, port 31415) was removed in v5.0.0 in favor of this CLI dashboard. The web version is available in the git history (v4.8.0 and earlier) for reference.

Agent Portfolio (65 Specialists)

Leadership & Strategy (7)

| Agent | Description | | ----------------------------------------- | ------------------------------------------------------- | | ali-chief-of-staff | Master orchestrator for complex multi-domain challenges | | satya-board-of-directors | Board-level strategic advisor | | domik-mckinsey-strategic-decision-maker | McKinsey Partner-level strategic decisions | | antonio-strategy-expert | Strategy frameworks (OKR, Lean, Agile) | | amy-cfo | Chief Financial Officer for financial strategy | | dan-engineering-gm | Engineering General Manager | | matteo-strategic-business-architect | Business strategy architect |

Technical Development (9)

| Agent | Description | | ------------------------------- | -------------------------------------------- | | baccio-tech-architect | Elite Technology Architect for system design | | marco-devops-engineer | DevOps for CI/CD and infrastructure | | dario-debugger | Systematic debugging expert | | rex-code-reviewer | Code review specialist | | otto-performance-optimizer | Performance optimization | | paolo-best-practices-enforcer | Coding standards enforcer | | omri-data-scientist | Data Scientist for ML and AI | | adversarial-debugger | 3-hypothesis parallel bug diagnosis | | task-executor-tdd | TDD workflow module (RED→GREEN→REFACTOR) |

Business Operations (11)

| Agent | Description | | ------------------------------------------ | ----------------------------------------- | | davide-project-manager | Project Manager (Agile, Scrum, Waterfall) | | marcello-pm | Product Manager for strategy and roadmaps | | oliver-pm | Senior Product Manager | | luke-program-manager | Program Manager for portfolios | | anna-executive-assistant | Executive Assistant with task management | | andrea-customer-success-manager | Customer Success Manager | | fabio-sales-business-development | Sales & Business Development | | sofia-marketing-strategist | Marketing Strategist | | steve-executive-communication-strategist | Executive Communication | | enrico-business-process-engineer | Business Process Engineer | | dave-change-management-specialist | Change Management specialist |

Design & UX (3)

| Agent | Description | | ------------------------------------- | -------------------------------------- | | jony-creative-director | Creative Director for brand innovation | | sara-ux-ui-designer | UX/UI Designer | | stefano-design-thinking-facilitator | Design Thinking facilitator |

Compliance & Legal (5)

| Agent | Description | | --------------------------------------- | ---------------------------------- | | elena-legal-compliance-expert | Legal & Compliance expert | | luca-security-expert | Cybersecurity expert | | dr-enzo-healthcare-compliance-manager | Healthcare Compliance (HIPAA, FDA) | | sophia-govaffairs | Government Affairs specialist | | guardian-ai-security-validator | AI Security validator |

Specialized Experts (14)

| Agent | Description | | ---------------------------------------- | ------------------------------------- | | behice-cultural-coach | Cultural intelligence expert | | fiona-market-analyst | Market Analyst for financial research | | michael-vc | Venture Capital analyst | | angela-da | Senior Decision Architect | | ethan-da | Data Analytics specialist | | evan-ic6da | Principal Decision Architect (IC6) | | ava-analytics-insights-virtuoso | Analytics virtuoso | | riccardo-storyteller | Narrative designer | | jenny-inclusive-accessibility-champion | Accessibility champion | | giulia-hr-talent-acquisition | HR & Talent Acquisition | | sam-startupper | Silicon Valley startup expert | | wiz-investor-venture-capital | Venture Capital investor | | coach-team-coach | Team Coach | | research-report-generator | Morgan Stanley-style research reports |

Core Utility (11)

| Agent | Description | | ------------------------------------------------ | --------------------------------- | | marcus-context-memory-keeper | Institutional memory guardian | | thor-quality-assurance-guardian | Quality watchdog | | thor-validation-gates | Validation gates module for Thor | | diana-performance-dashboard | Performance dashboard specialist | | socrates-first-principles-reasoning | First principles reasoning master | | strategic-planner | Wave-based execution plan creator | | taskmaster-strategic-task-decomposition-master | Task decomposition expert | | po-prompt-optimizer | Prompt engineering expert | | wanda-workflow-orchestrator | Workflow orchestrator | | xavier-coordination-patterns | Coordination patterns architect | | sentinel-ecosystem-guardian | Ecosystem config auditor |

Release Management (3)

| Agent | Description | | ------------------------------- | -------------------------------------- | | app-release-manager | Release engineering with quality gates | | app-release-manager-execution | Execution phases (3-5) module | | feature-release-manager | Feature completion and issue closure |

Plugin Structure

MyConvergio/
├── .claude-plugin/
│   └── plugin.json           # Plugin manifest
├── .claude/
│   ├── CLAUDE.md             # Main config
│   ├── agents/               # 65 agents (8 categories)
│   ├── rules/                # Execution rules
│   ├── scripts/              # 89 digest + utility scripts
│   ├── reference/            # 11 on-demand operational docs
│   ├── skills/               # 10 reusable workflows
│   └── templates/            # State tracking templates
├── copilot-agents/           # 9 Copilot CLI agents
├── hooks/                    # 12 enforcement hooks + lib/
│   ├── prefer-ci-summary.sh
│   ├── enforce-line-limit.sh
│   ├── worktree-guard.sh
│   └── lib/common.sh
├── commands/                 # 3 slash commands
├── scripts/                  # Install/backup/test scripts
└── bin/myconvergio.js        # CLI entry point

Architecture

Agent Ecosystem

graph TB
    subgraph "Platforms"
        CC[Claude Code<br/>65 agents, parallel workers]
        COP[Copilot CLI<br/>9 agents, sequential TDD]
    end

    subgraph "Leadership & Strategy (7)"
        ALI[ali-chief-of-staff<br/>Orchestrator]
        SATYA[satya-board-of-directors]
        DOMIK[domik-mckinsey]
        ANTONIO[antonio-strategy]
        DAN[dan-engineering-gm]
        AMY[amy-cfo]
        MATTEO[matteo-business-architect]
    end

    subgraph "Core Utility (11)"
        SP[strategic-planner<br/>Wave Planner]
        THOR[thor-qa-guardian<br/>Quality Gate]
        TVG[thor-validation-gates]
        TE[task-executor]
        TETDD[task-executor-tdd]
        MARCUS[marcus-memory-keeper]
        SOCRATES[socrates-reasoning]
        WANDA[wanda-workflow]
        XAVIER[xavier-coordination]
        DIANA[diana-dashboard]
        PO[po-prompt-optimizer]
        SENTINEL[sentinel-guardian]
    end

    subgraph "Technical Development (9)"
        BACCIO[baccio-architect]
        REX[rex-reviewer]
        DARIO[dario-debugger]
        ADVDBG[adversarial-debugger]
        OTTO[otto-performance]
        MARCO[marco-devops]
        PAOLO[paolo-enforcer]
        OMRI[omri-data-scientist]
    end

    subgraph "Release Management (4)"
        ARM[app-release-manager]
        ARE[app-release-manager-execution]
        FRM[feature-release-manager]
        ESYNC[ecosystem-sync<br/>Dual Platform]
    end

    CC -->|full suite| ALI
    COP -->|workflow agents| SP
    COP -->|@code-reviewer| REX
    COP -->|@validate| THOR

    ALI -->|orchestrates| SP
    SP -->|creates waves| TE
    TE -->|follows| TETDD
    TE -->|validated by| THOR
    THOR -->|uses| TVG
    THOR -->|delegates| BACCIO
    THOR -->|delegates| REX
    THOR -->|delegates| OTTO
    ARM -->|uses| ARE
    ESYNC -->|syncs| ARM

Execution Flow (Prompt → Plan → Execute → Verify)

sequenceDiagram
    participant U as User
    participant P as /prompt
    participant PL as /planner
    participant SP as strategic-planner
    participant TE as task-executor
    participant TH as thor-qa-guardian
    participant DB as plan-db.sh

    U->>P: Define requirements (F-xx)
    P->>U: Confirm scope
    U->>PL: Create plan
    PL->>SP: Generate waves & tasks
    SP->>DB: Store plan in SQLite

    loop Per Wave
        DB->>TE: Start task (plan-db.sh start)
        TE->>TE: TDD: RED → GREEN → REFACTOR
        TE->>TH: Submit for validation
        TH->>TH: 7 quality gates
        alt PASS
            TH->>DB: plan-db.sh validate ✓
            TH->>TE: APPROVED
        else FAIL
            TH->>TE: REJECTED (max 3 rounds)
            TE->>TE: Fix issues
        end
    end

    DB->>U: All waves complete

Hook System & Token Optimization

flowchart LR
    subgraph "PreToolUse Hooks"
        H1[prefer-ci-summary.sh<br/>Block verbose CLI]
        H2[worktree-guard.sh<br/>Protect main branch]
        H3[warn-bash-antipatterns.sh<br/>Prefer Read/Grep/Glob]
    end

    subgraph "PostToolUse Hooks"
        H4[enforce-line-limit.sh<br/>Max 250 lines/file]
        H5[auto-format.sh<br/>Prettier/ESLint]
        H6[track-tokens.sh<br/>Token usage tracking]
    end

    subgraph "Lifecycle Hooks"
        H7[inject-agent-context.sh<br/>SubagentStart]
        H8[preserve-context.sh<br/>PreCompact]
        H9[session-end-tokens.sh<br/>Stop]
    end

    subgraph "Security"
        SEC[sql_escape<br/>SQL injection protection]
    end

    H1 & H2 & H3 --> |PreToolUse| CLAUDE[Claude Code]
    CLAUDE --> |PostToolUse| H4 & H5 & H6
    CLAUDE --> |Lifecycle| H7 & H8 & H9
    H6 & H8 & H9 --> SEC
    SEC --> DB[(SQLite<br/>dashboard.db)]

Script Categories

mindmap
  root((89 Scripts))
    Digest Scripts
      git-digest.sh
      build-digest.sh
      test-digest.sh
      ci-digest.sh
      npm-digest.sh
      error-digest.sh
      diff-digest.sh
      +7 more
    Plan DB
      plan-db.sh (core)
      lib/plan-db-core.sh
      lib/plan-db-crud.sh
      lib/plan-db-display.sh
      lib/plan-db-validate.sh
      lib/plan-db-cluster.sh
      lib/plan-db-conflicts.sh
      lib/plan-db-drift.sh
      lib/plan-db-import.sh
      lib/plan-db-remote.sh
    Orchestration
      orchestrate.sh
      claude-parallel.sh
      claude-monitor.sh
      tmux-parallel.sh
      tmux-monitor.sh
    Worktree
      worktree-create.sh
      worktree-check.sh
      worktree-guard.sh
      worktree-cleanup.sh
      worktree-merge-check.sh
    Utilities
      context-audit.sh
      cleanup-cache.sh
      memory-save.sh
      file-lock.sh
      stale-check.sh

Model Tiering

pie title Agent Distribution by Model Tier
    "Haiku (37)" : 37
    "Sonnet (24)" : 24
    "Opus (2)" : 2

Skills

Reusable workflows you can reference in your projects:

| Skill | Use Case | | --------------------- | -------------------------------------------------------------- | | structured-research | NEW Hypothesis-driven research with confidence calibration | | code-review | Systematic code review process | | debugging | Root cause analysis methodology | | architecture | System design patterns | | security-audit | Security assessment framework | | performance | Performance optimization | | strategic-analysis | McKinsey-style analysis | | release-management | Release engineering | | project-management | Agile/Scrum workflows | | orchestration | Multi-agent coordination |

Structured Research (NEW)

Based on Anthropic best practices:

• Generate 2-4 competing hypotheses
• Track confidence levels (0-100%) with evidence
• Verify across multiple independent sources
• Iterative self-critique: "What am I missing?"
• Maintain research state (hypothesis-tree.json, research-notes.md)

Example:

Research the best approach for implementing authentication in our app.
Use structured-research skill to evaluate OAuth2 vs JWT vs session cookies.

Rules

MyConvergio includes two rule systems:

Primary Rules (Active)

Located in .claude/rules/ - Use these for new work:

| Rule | Purpose | | -------------------------- | ------------------------------------------------------------------------------------------------------------ | | execution.md | UPDATED How work gets done (context awareness, parallel calls, anti-overengineering, Definition of Done) | | guardian.md | NEW Thor enforcement, PR comment resolution, completion verification | | agent-discovery.md | UPDATED Agent routing, subagent orchestration patterns | | engineering-standards.md | UPDATED Code quality, security (OWASP), testing, API design | | file-size-limits.md | NEW Max 250 lines per file with split strategies | | README.md | Rules hierarchy and usage guide |

Domain-Specific Rules

Copy to your project's .claude/rules/ for consistent standards:

• code-style.md - ESLint, Prettier, PEP8
• security-requirements.md - OWASP Top 10
• testing-standards.md - Unit, integration, coverage
• documentation-standards.md - JSDoc, README, ADRs
• api-development.md - REST, versioning
• ethical-guidelines.md - Privacy, accessibility

State Tracking Templates (NEW)

Located in .claude/templates/ for multi-session work:

• tests.json - Structured test status tracking
• progress.txt - Unstructured progress notes
• README.md - Usage guidelines for context refresh scenarios

Execution Framework

This repository is fully self-contained with two rule systems:

Primary Rules (Active)

| Document | Purpose | Priority | | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -------- | | CONSTITUTION.md | Security, Ethics, Identity | SUPREME | | execution.md | NEW How Work Gets Done (context awareness, parallel calls, anti-overengineering) | 2nd | | guardian.md | NEW Thor enforcement, PR comment resolution, completion verification | 3rd | | engineering-standards.md | Code quality, security, testing, API design | 4th |

Legacy System (Backward Compatibility)

| Document | Purpose | Priority | | -------------------------------------------------------------------------------- | -------------------------------------------------------------- | -------- | | EXECUTION_DISCIPLINE.md | Legacy execution rules (maintained for backward compatibility) | - | | CommonValuesAndPrinciples.md | Organizational Values | - |

Recommendation: New work should reference .claude/rules/execution.md instead of EXECUTION_DISCIPLINE.md. See .claude/rules/README.md for hierarchy details.

No external configuration files are required.

Security Framework

All agents implement the MyConvergio Constitution:

| Article | Protection | | ------- | ----------------------------------------------------------- | | I | Identity Lock - Immutable agent identity | | II | Ethical Principles - Fairness, transparency, accountability | | III | Security Directives - Anti-hijacking, input validation | | IV | Operational Boundaries - Role adherence | | V | Failure Modes - Graceful degradation | | VI | Collaboration - Safe inter-agent communication | | VII | Accessibility & Inclusion (NON-NEGOTIABLE) | | VIII | Accountability - Logging and audit trails |

The Agentic Manifesto

Human purpose. AI momentum.

What we believe

1. Intent is human, momentum is agent.
2. Impact must reach every mind and body.
3. Trust grows from transparent provenance.
4. Progress is judged by outcomes, not output.

How we act

1. Humans stay accountable for decisions and effects.
2. Agents amplify capability, never identity.
3. We design from the edge first: disability, language, connectivity.
4. Safety rails precede scale.
5. Learn in small loops, ship value early.

Read the full Agentic Manifesto

Migration from npm Package

If upgrading from v2.x (npm package):

# Uninstall npm version
npm uninstall -g myconvergio

# Install plugin version
claude plugins install myconvergio

License & Legal

Copyright 2025 Convergio.io

Licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International

Disclaimers

• Experimental Software: Provided "AS IS" without warranties
• Non-Commercial Use Only: See LICENSE file for details
• No Corporate Affiliation: Not affiliated with Anthropic, OpenAI, or Microsoft
• Personal Project: Author is a Microsoft employee; this is a personal initiative

Author Note: Roberto D'Angelo is a Microsoft employee. This project is a personal initiative created independently during personal time. This project is NOT affiliated with, endorsed by, or representing Microsoft Corporation.

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

For questions about commercial licensing: [email protected]

Built with AI assistance in Milano, following the Agentic Manifesto principles

v5.0.0 | February 2026 | Claude Code Plugin + Copilot CLI