Agent Alchemy¶

A plugin suite and developer toolkit that extends Claude Code into a structured development platform — from specs to tasks to autonomous execution.

What is Agent Alchemy?¶

Agent Alchemy is an open-source toolkit for AI and software engineers who use Claude Code. It adds structured development workflows through markdown-as-code plugins, a real-time task dashboard, and a VS Code extension — all designed to work together as an integrated pipeline.

graph LR
    Spec["/create-spec"] --> Analyze["/analyze-spec"]
    Analyze --> Tasks["/create-tasks"]
    Tasks --> Execute["/execute-tasks"]
    Execute --> Dashboard["Task Manager"]

    style Spec fill:#7c4dff,color:#fff
    style Analyze fill:#7c4dff,color:#fff
    style Tasks fill:#7c4dff,color:#fff
    style Execute fill:#7c4dff,color:#fff
    style Dashboard fill:#00bcd4,color:#fff

Key Features¶

Spec-Driven Development — Transform ideas into structured specifications through adaptive interviews, then decompose specs into dependency-ordered tasks that execute autonomously (SDD Tools)
Test-Driven Development — RED-GREEN-REFACTOR workflows with framework auto-detection for pytest, Jest, and Vitest (TDD Tools)
Deep Codebase Analysis — Multi-agent hub-and-spoke exploration with intelligent caching (Core Tools)
Feature Development — Structured implementation with architect and reviewer agent teams (Dev Tools)
Hypothesis-Driven Debugging — Systematic bug investigation with triage-based routing, parallel agent exploration, and automatic learning capture (Dev Tools)
Real-Time Task Dashboard — Kanban board that visualizes task execution as it happens (Task Manager)
Plugin Authoring — Schema validation and autocomplete for building your own plugins (VS Code Extension)

Quick Start¶

# Install Claude Code plugins
claude plugins install agent-alchemy/agent-alchemy-sdd-tools
claude plugins install agent-alchemy/agent-alchemy-core-tools
claude plugins install agent-alchemy/agent-alchemy-dev-tools
claude plugins install agent-alchemy/agent-alchemy-tdd-tools
claude plugins install agent-alchemy/agent-alchemy-git-tools

Then try:

/create-spec           # Start a spec interview
/deep-analysis         # Explore a codebase
/feature-dev           # Implement a feature
/bug-killer            # Debug with hypothesis-driven investigation
/generate-tests        # Generate tests from code

For a full walkthrough, see the Getting Started guide.

Documentation¶

Section	Description
Getting Started	Installation, prerequisites, and first steps
Architecture	System design, plugin composition, and data flow
Plugins	All 6 plugin groups with skills, agents, and usage guides
Task Manager	Real-time Kanban dashboard setup and API reference
VS Code Extension	Schema validation and autocomplete for plugin authoring
Configuration	Settings reference for all plugin behaviors
Contributing	Development setup, conventions, and how to help

Project Status¶

Agent Alchemy is in active development. Current plugin versions:

Plugin	Version	Status
Core Tools	0.2.0	Stable
Dev Tools	0.3.0	Stable
SDD Tools	0.2.0	Stable
TDD Tools	0.2.0	Stable
Git Tools	0.1.0	Stable
Plugin Tools	0.1.1	Stable

License¶

MIT — see LICENSE for details.