yamatatsu-aidlc

AI-DLC Plugin for Claude Code

日本語

An implementation of AI-DLC (AI-Driven Development Life Cycle) as a Claude Code plugin. Packages an adaptive software development workflow as skills, agents, and hooks.

Installation

From marketplace (recommended)

Inside Claude Code REPL:

# 1. Register the marketplace
/plugin marketplace add yamatatsu/claude-aidlc

# 2. Install the plugin
/plugin install aidlc@yamatatsu-aidlc

Local development

git clone https://github.com/yamatatsu/claude-aidlc.git
claude --plugin-dir ./claude-aidlc

Usage

Starting a workflow

After enabling the plugin, run in chat:

/aidlc:start

AI-DLC analyzes the workspace, initializes state files, and guides you to the next step.

Basic flow

1. /aidlc:start to begin a project
2. At each stage, AI generates question files (.md) -- you fill in the answers
3. AI generates artifacts -- you review and approve
4. After approval, proceed to the next stage

Use /aidlc:resume to continue after a session break, and /aidlc:status to check progress at any time.

Skills

Entry points

Command	Description
/aidlc:start	Start a new workflow (workspace detection + state initialization)
/aidlc:resume	Resume from a previous session
/aidlc:status	Display current progress (read-only)

Inception phase (planning & design)

Command	Condition	Description
/aidlc:inception-reverse-engineering	Brownfield only	Analyze existing codebase
/aidlc:inception-requirements	Always	Requirements analysis and question generation
/aidlc:inception-user-stories	Conditional	User story creation
/aidlc:inception-workflow-planning	Always	Create execution plan (EXECUTE/SKIP per stage)
/aidlc:inception-application-design	Conditional	Application design
/aidlc:inception-units-generation	Conditional	Decompose into units of work

Construction phase (implementation)

Command	Argument	Description
/aidlc:construction-functional-design [unit]	Unit name	Business logic design
/aidlc:construction-nfr-requirements [unit]	Unit name	NFR assessment + tech stack selection
/aidlc:construction-nfr-design [unit]	Unit name	NFR pattern design
/aidlc:construction-infrastructure-design [unit]	Unit name	Infrastructure design
/aidlc:construction-code-generation [unit]	Unit name	Code generation (2-part: planning then generation)
/aidlc:construction-build-and-test	None	Build & test across all units

Command details

/aidlc:start — Start new workflow

Analyzes the workspace, auto-detects the project type (greenfield / brownfield), and initializes AI-DLC state management.

• Workspace detection: Determines project type from existing code and build files
• Initialization: Creates aidlc-docs/ directory, aidlc-state.md (state tracking), and audit.md (audit log)
• Next step guidance: Routes to reverse-engineering for brownfield, requirements for greenfield

If aidlc-state.md already exists, suggests /aidlc:resume instead.

/aidlc:resume — Resume from previous session

Resumes a paused workflow from the last completed stage.

• Smart context loading: Loads only artifacts relevant to the current stage to minimize token usage
• Status summary: Shows project type, current phase/stage, and last completed milestone
• Next action options: Offers to continue or review previous artifacts

/aidlc:status — Display progress

Read-only view of current project progress. No files are modified.

• Fast execution (Haiku model, isolated Explore agent)
• Displays progress as checklists for Inception and Construction phases
• Lists all generated artifacts

---

/aidlc:inception-reverse-engineering — Analyze existing codebase

Comprehensively analyzes a brownfield codebase and generates technical documentation.