AI Dev Kit

Architecture-first development workflow plugin for Claude Code.

ai-dev-kit is a Claude Code plugin that provides a complete development workflow: architecture exploration, phased planning, swim-lane execution, and documentation management. It supports multi-agent orchestration across Claude, Cursor, Gemini, OpenAI, and more.

Features

• Planning System: /ai-dev-kit:plan, /ai-dev-kit:plan-phase, /ai-dev-kit:plan-roadmap, /ai-dev-kit:explore-architecture
• Execution System: /ai-dev-kit:execute-lane, /ai-dev-kit:execute-phase with worktree isolation
• Documentation System: TOON format, hierarchical indexes, /ai-dev-kit:docs-find, /ai-dev-kit:docs-update
• Multi-Agent Orchestration: /ai-dev-kit:delegate, /ai-dev-kit:route across 6 providers
• Specialized Agents: 15+ agents for planning, execution, and documentation
• Skills Library: C4 modeling, codebase analysis, library detection, standards extraction

Prerequisites

• Claude Code v1.0.0 or later
• Python 3.10+ (for scripts)
• UV (Python package manager) - curl -LsSf https://astral.sh/uv/install.sh | sh
• Node.js 18+ (for CLI tools and npm packages)
• jq (required for orchestration scripts) - apt install jq or brew install jq
• Chrome (optional, for browser automation)

Installation

From Marketplace (Recommended)

# Add the marketplace (one-time)
claude plugin marketplace add ViperJuice/ai-dev-kit

# Install the plugin
claude plugin install ai-dev-kit@ai-dev-kit

# Or install with project scope
claude plugin install ai-dev-kit@ai-dev-kit --scope project

# OPTIONAL: Install helper CLI for asset sync
# Note: The PyPI package name is 'viper-dev-kit' but the command is 'ai-dev-kit'
# This CLI is optional and only needed for syncing plugin assets locally
uv tool install viper-dev-kit

# Sync plugin assets locally (optional; /ai-dev-kit:setup also does this)
ai-dev-kit sync --target .claude/ai-dev-kit

From Source (Development)

# Clone the repository
git clone https://github.com/ViperJuice/ai-dev-kit
cd ai-dev-kit

# Install globally
./dev-tools/scripts/install-plugin.sh

# Or for development (symlink mode)
./dev-tools/scripts/install-plugin.sh --dev

# Install the helper CLI from this repo (optional)
uv tool install --editable .

Restart Claude Code after installing (plugins do not auto-reload).

Quick Start

Brownfield (Existing Project)

# 1. Assess the current project
/ai-dev-kit:assess

# 2. Configure the project
/ai-dev-kit:setup

# 3. Validate the setup
/ai-dev-kit:validate

Greenfield (New Project)

# 1. Initialize a new project
/ai-dev-kit:init

# 2. Explore and plan
/ai-dev-kit:explore-architecture
/ai-dev-kit:plan-roadmap

Commands

Planning

Execution

Documentation

Research

Orchestration

Kit Management

Onboarding

Utility

Documentation

After installation, documentation is available at ai-docs/:

• ai-docs/libraries/ - Library documentation (20+ sources)
• ai-docs/libraries/_index.toon - Master index
• ai-docs/libraries/_registry.json - Source configuration

Use /ai-dev-kit:docs-find [query] to search, or navigate indexes directly.

Multi-Agent Environment

The plugin supports delegating tasks to the most appropriate AI provider:

Project Structure After Setup

my-project/
├── .claude/
│   ├── settings.json         # Claude Code settings
│   └── run-logs/             # Execution logs
├── ai-docs/                  # AI-consumable documentation
│   └── libraries/            # Library docs
├── specs/                    # Project specifications
├── architecture/             # C4 diagrams
├── AGENTS.md                 # Universal agent instructions
├── CLAUDE.md -> AGENTS.md    # Claude Code symlink
└── GEMINI.md -> AGENTS.md    # Gemini CLI symlink

Contributing

See docs/MAINTAINER.md for development guidelines.

This repository uses its own ai-dev-kit plugin for development. The plugin is at plugins/ai-dev-kit/ and commands are available via the /ai-dev-kit:* namespace.

License

MIT License - see LICENSE file for details.