AI Agent System

A coordinated multi-agent system for software development, available for VS Code (GitHub Copilot), GitHub Copilot CLI, and Claude Code CLI.

Features

• 17 specialized agents for different development phases
• Explicit handoff protocols between agents
• Multi-Agent Impact Analysis Framework for comprehensive planning
• Cross-session memory using cloudmcp-manager
• Self-improvement system with skill tracking and retrospectives
• Installation scripts for global or per-repository setup

Quick Start

Remote Installation (Recommended)

Install directly from GitHub without cloning the repository:

# Remote installation (interactive)
Set-ExecutionPolicy Bypass -Scope Process -Force
iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/rjmurillo/ai-agents/main/scripts/install.ps1'))

This prompts you to select the environment (Claude/Copilot/VSCode) and scope (Global/Repository).

Local Installation

If you have cloned the repository, use the unified installer:

# Claude Code
.\scripts\install.ps1 -Environment Claude -Global              # User-level
.\scripts\install.ps1 -Environment Claude -RepoPath "."        # Repository

# GitHub Copilot CLI
.\scripts\install.ps1 -Environment Copilot -Global             # User-level
.\scripts\install.ps1 -Environment Copilot -RepoPath "."       # Repository

# VS Code
.\scripts\install.ps1 -Environment VSCode -Global              # User-level
.\scripts\install.ps1 -Environment VSCode -RepoPath "."        # Repository

Add -Force to overwrite existing files without prompting.

Note: Copilot CLI global installation has a known issue - use repository installation instead.

Usage Examples

# Claude Code
Task(subagent_type="analyst", prompt="investigate issue X")

# VS Code
@orchestrator Help me implement a new feature

# Copilot CLI
copilot --agent analyst --prompt "investigate issue X"

See docs/installation.md for complete installation documentation.

Directory Structure

src/
├── vs-code-agents/      # VS Code / GitHub Copilot agents
├── copilot-cli/         # GitHub Copilot CLI agents
└── claude/              # Claude Code CLI agents
scripts/                 # Installation scripts
copilot-instructions.md  # GitHub Copilot instructions
CLAUDE.md                # Claude Code instructions
USING-AGENTS.md          # Detailed usage guide

Agents

Agent	Purpose
orchestrator	Task coordination and routing
analyst	Pre-implementation research
architect	Design governance and ADRs
planner	Milestones and work packages
implementer	Production code and tests
critic	Plan validation
qa	Test strategy and verification
retrospective	Learning extraction
memory	Cross-session context
skillbook	Skill management
+ 7 more...	See USING-AGENTS.md

Contributing

See CONTRIBUTING.md for detailed contribution guidelines.

1. Fork and clone the repository
2. Enable pre-commit hooks: git config core.hooksPath .githooks
3. Make changes following the guidelines
4. Submit a pull request

Agent Development

This project uses a template-based generation system. To modify agents:

1. Edit templates in templates/agents/*.shared.md
2. Run pwsh build/Generate-Agents.ps1 to regenerate
3. Commit both template and generated files

Do not edit files in src/vs-code-agents/ or src/copilot-cli/ directly. See CONTRIBUTING.md for details.

Documentation

• CONTRIBUTING.md - Contribution guidelines and agent development
• docs/installation.md - Complete installation guide
• USING-AGENTS.md - Comprehensive usage guide
• copilot-instructions.md - GitHub Copilot integration
• CLAUDE.md - Claude Code integration
• docs/ideation-workflow.md - Ideation workflow documentation
• docs/markdown-linting.md - Markdown standards

License

MIT