AIDA Plugin for Claude Code
AIDA (Agent Integration & Development Architecture) - Multi-agent orchestration framework for Claude Code.
English | 日本語 | 简体中文 | 繁體中文 | Русский | فارسی | العربية
Table of Contents
Overview
AIDA enables multi-agent orchestration for software development projects using Claude Code's Task tool to spawn subagents. It automates the entire development lifecycle from requirements to implementation with TDD (Test-Driven Development) enforcement.
Key Features
- Multi-Agent Orchestration: Automatically spawns and coordinates multiple Claude agents
- 5-Phase Workflow: Structured development from requirements to implementation
- 19 Quality Gates: Automated validation of code quality, tests, and coverage
- TDD Enforcement: Red-Green-Refactor cycle with evidence tracking
- Stack Support: Go + React + Docker (default), with extensibility for other stacks
Requirements
Required
| Tool | Version | Purpose |
|---|
| Claude Code | Latest | Core CLI |
| bash | 4.0+ | Script execution |
| git | 2.0+ | Version control |
| jq | 1.6+ | JSON processing |
Recommended
| Tool | Version | Purpose |
|---|
| grepai | Latest | Semantic search (80% token reduction) |
| fzf | Latest | Interactive file selection |
| jj (Jujutsu) | Latest | Environment isolation |
| go | 1.21+ | Backend development |
| node | 18+ | Frontend development |
| docker | 24+ | Container builds |
Install Dependencies
# Ubuntu/Debian
sudo apt install jq fzf git
# macOS
brew install jq fzf git
# Install grepai (recommended for semantic search)
go install github.com/yoanbernabeu/grepai@latest
# Install jj (optional - for environment isolation)
cargo install jj-cli
Installation
Method 1: One-Line Install (Recommended)
curl -sSL https://raw.githubusercontent.com/clearclown/claude-code-aida/main/scripts/install.sh | bash
Method 2: Manual Clone
# Clone repository
git clone https://github.com/clearclown/claude-code-aida.git ~/.claude-code-aida
# Run install script
cd ~/.claude-code-aida
./scripts/install.sh
Method 3: Install to Custom Location
# Clone to custom location
git clone https://github.com/clearclown/claude-code-aida.git /path/to/aida
# Install from that location
cd /path/to/aida
./scripts/install.sh
Verify Installation
# Check installation
./scripts/verify-installation.sh
# Restart Claude Code
claude
# Test command availability
/aida:status
If /aida shows "Unknown skill", restart Claude Code and try again.
What Gets Installed
~/.claude-code-aida/ # AIDA source files
~/.claude/commands/
aida.md # Main /aida command
aida/
init.md # /aida:init
start.md # /aida:start
status.md # /aida:status
work.md # /aida:work
pipeline.md # /aida:pipeline
enhance.md # /aida:enhance
analyze.md # /aida:analyze
maintain.md # /aida:maintain
import.md # /aida:import
resume.md # /aida:resume
fix.md # /aida:fix
Update
Automatic Update
# Navigate to AIDA directory
cd ~/.claude-code-aida
# Pull latest changes and reinstall
git pull origin main
./scripts/install.sh
Update Script
# One-line update
cd ~/.claude-code-aida && git pull origin main && ./scripts/install.sh
Update to Specific Version
cd ~/.claude-code-aida
git fetch --tags
git checkout v1.2.0 # Replace with desired version
./scripts/install.sh
Update from Specific Branch
cd ~/.claude-code-aida
git fetch origin
git checkout develop # or feature/new-feature
git pull
./scripts/install.sh
Verify Update
# Check version/status
./scripts/verify-installation.sh
# Restart Claude Code after update
# Then test:
/aida:status
Uninstall
Complete Uninstall
# Remove command files
rm -f ~/.claude/commands/aida.md
rm -rf ~/.claude/commands/aida/
# Remove AIDA source directory
rm -rf ~/.claude-code-aida
clearclown