idd

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?

Aspect	SDD	IDD
Organization	By requirement type (functional, UX, technical)	By module/layer
Core artifact	Text descriptions	Structure diagrams
Granularity	Split into user stories	Keep complete patterns
Task management	Separate task files	None - AI decomposes autonomously
LLM friendliness	Needs context assembly	Understands complete pattern at once

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
# Add marketplace from GitHub
/plugin marketplace add git@github.com:ArcBlock/idd.git
# claude plugin marketplace add git@github.com:ArcBlock/idd.git

# Install the plugin
/plugin install idd
# claude plugin install idd

Commands

Skills (Interactive)