aida-local

AIDA Plugin for Claude Code

AIDA (Agent Integration & Development Architecture) - Multi-agent orchestration framework for Claude Code.

English | 日本語 | 简体中文 | 繁體中文 | Русский | فارسی | العربية

Table of Contents

• Overview
• Requirements
• Installation
• Update
• Uninstall
• Usage Guide
• Command Reference
• Quality Gates
• Configuration
• Troubleshooting
• Contributing
• License

---

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