IDD - Intent Driven Development

Complete toolkit for Intent-driven development

中文文档

Philosophy

Traditional:  Code → Test → Documentation
SDD:          Spec → Code → Test              (Spec as reference)
TDD:          Test → Code → Documentation     (Test as contract)
IDD:          Intent → Test → Code → Sync     (Intent as source of truth)

Intent is the new source code. Code review is done by AI, Intent review is done by Humans.

Why not SDD?

See docs/methodology.md for detailed comparison.

Toolkit Overview

┌─────────────────────────────────────────────────────────────┐
│                      IDD Lifecycle                           │
│                                                              │
│  Setup                                                       │
│  ┌───────────────────┐  ┌───────────────────┐               │
│  │ /intent-assess    │  │ /intent-init      │               │
│  │   Evaluate fit    │  │   Initialize IDD  │               │
│  └───────────────────┘  └───────────────────┘               │
│                                                              │
│  Creation                                                    │
│  ┌───────────────────┐  ┌───────────────────┐               │
│  │ /intent-interview │  │ /intent-critique  │               │
│  │   Create Intent   │  │   Review quality  │               │
│  └───────────────────┘  └───────────────────┘               │
│                                                              │
│  Review                                                      │
│  ┌───────────────────┐  ┌───────────────────┐               │
│  │ /intent-review    │  │ /intent-changes   │               │
│  │   Approve sections│  │   Propose changes │               │
│  └───────────────────┘  └───────────────────┘               │
│                                                              │
│  Execution                                                   │
│  ┌───────────────────┐  ┌───────────────────┐               │
│  │ /intent-build-now │  │ /intent-plan      │               │
│  │   Validate & build│  │   TDD plan        │               │
│  └───────────────────┘  └───────────────────┘               │
│           │                                                  │
│           ▼                                                  │
│  ┌─────────────────────────────────────────────────────┐    │
│  │  TDD Agent Team (Autonomous Execution)              │    │
│  │                                                     │    │
│  │  idd-task-execution-master ──→ Phase planning       │    │
│  │           │                                         │    │
│  │           ▼                                         │    │
│  │  idd-test-master ──→ Test-first design              │    │
│  │           │                                         │    │
│  │           ▼                                         │    │
│  │  idd-code-guru ──→ Elegant implementation           │    │
│  │           │                                         │    │
│  │           ▼                                         │    │
│  │  idd-e2e-test-queen ──→ E2E verification            │    │
│  └─────────────────────────────────────────────────────┘    │
│                                                              │
│  Sync & Validate                                             │
│  ┌───────────────────┐  ┌───────────────────┐               │
│  │ /intent-sync      │  │ /intent-check     │               │
│  │   Sync back       │  │   Run checks      │               │
│  └───────────────────┘  └───────────────────┘               │
│                                                              │
│  Report & Share                                              │
│  ┌───────────────────┐  ┌───────────────────┐               │
│  │ /intent-report    │  │ /intent-story     │               │
│  │   Generate docs   │  │   Share experience│               │
│  └───────────────────┘  └───────────────────┘               │
└─────────────────────────────────────────────────────────────┘

Installation

# Quick install
npx add-skill arcblock/idd

# Or manual install
git clone https://github.com/ArcBlock/idd ~/path/to/idd
claude mcp add-plugin ~/path/to/idd

Commands

Skills (Interactive)

...