Prevention

AI development agent that embeds XP/CD best practices to achieve Elite DORA metrics.

Build the product right. Ship value fast. Learn continuously.

What is Prevention?

Prevention turns Claude Code into a disciplined engineering partner. Instead of just generating code, it enforces TDD, Clean Architecture, ATDD, and Continuous Delivery — the practices that separate elite teams from the rest.

One command to set up. Slash commands to drive the workflow. Gates to keep you honest.

Quick Start

cd your-project
npx @avesta-hq/prevention init

Then start Claude Code and run /avesta-help to see your status and available commands.

Workflow

Prevention guides you through a proven delivery workflow:

vision → plan → acceptance tests → TDD → driver → review → ship

Each phase has gates that ensure prerequisites are met before you move forward. You can't skip writing tests before shipping, or ship without a review.

Agents

27 specialized agents organized by workflow phase:

| Phase | Command | Purpose | | -------------------- | --------------------------------- | ---------------------------------------------------- | | Setup | /avesta-init [type] | Initialize workflow tracking | | | /avesta-scaffold | Scaffold project structure (greenfield) | | | /avesta-help | Show status, gates, and next steps | | Vision | /avesta-vision | Define product vision, success metrics, scope | | Planning | /avesta-plan <feature> | Break feature into TDD-ready tasks (Example Mapping) | | | /avesta-spike <question> | Technical exploration (disposable code) | | Acceptance Tests | /avesta-acceptance-test | Write Executable Specification | | | /avesta-dsl | Implement Domain Specific Language layer | | | /avesta-driver | Implement Protocol Drivers (UI/API) | | TDD | /avesta-red <behavior> | Write ONE failing test | | | /avesta-green | Minimal code to make it pass | | | /avesta-refactor | Improve structure (tests must stay green) | | | /avesta-cycle <behavior> | Full red-green-refactor cycle | | | /avesta-layer | All tests first, then all production code | | Change Types | /avesta-bug-fix <description> | Bug fix workflow | | | /avesta-enhance <description> | Enhancement workflow | | | /avesta-tech-debt <description> | Tech debt workflow (approval tests) | | Review & Ship | /avesta-code-review | Domain-specific code review | | | /avesta-commit | Conventional commit | | | /avesta-ship | Merge to main | | CI/CD | /avesta-commit-stage | Set up commit stage pipeline | | | /avesta-release-stage | Set up release stage pipeline | | | /avesta-acceptance-stage | Set up acceptance stage pipeline | | Metrics | /avesta-dora-init | Initialize DORA metrics tracking | | | /avesta-dora-report | Generate DORA metrics report | | Maintenance | /avesta-dependency-review | Review deps and generate update plan | | | /avesta-mutation-testing | Analyze test effectiveness |

License Tiers

| Feature | Free | Pro | | -------------------- | -------------------------------------------------- | -------------------- | | Core TDD | /avesta-red, /avesta-green, /avesta-refactor | All 27 agents | | Setup | /avesta-init, /avesta-scaffold, /avesta-help | All 27 agents | | Skills | - | 27 contextual skills | | Gate enforcement | - | Automated gates | | Projects | 1 | Unlimited |

Free tier gives you the core TDD loop. Pro unlocks the full workflow with all agents, skills, and gate enforcement.

Manual MCP Setup

If you prefer to configure the MCP server manually, create .mcp.json at your project root:

{
  "mcpServers": {
    "prevention": {
      "command": "npx",
      "args": ["@avesta-hq/prevention", "serve"]
    }
  }
}

Then restart Claude Code.

Requirements

• Node.js >= 18
• Claude Code CLI