Task Type	Apply Workflow
Complex new features	✅ Full SDD+TDD
Simple new features	⚠️ TDD only (skip RFC)
Technical decisions	✅ ADR + TDD
Bug fixes	⚠️ TDD only
Large-scale refactoring	✅ RFC + TDD
Small-scale refactoring	⚠️ TDD only

Use this skill when:

User explicitly requests SDD/TDD workflow
Implementing features that affect multiple components
Making architectural or technology stack decisions
Refactoring requires specification documentation
Working on ai-cli-syncer project or similar spec-driven projects

Core Workflow: 6 Phases

Spec → Design Review → Test → Code → Verify → Iterate

Phase 1: Specification (Spec)

Goal: Define what to build and why.

Choose document type:

RFC (Request for Comments): New features, user-facing changes, complex refactoring
ADR (Architecture Decision Record): Technology choices, architectural patterns, data formats

Key sections to complete:

RFC: Summary, Motivation, Technical Design, Test Strategy
ADR: Context, Considered Options, Decision Outcome, Consequences

Location: docs/specs/rfcs/ or docs/specs/adrs/

Phase 2: Design Review & Breakdown

Goal: Analyze spec and create implementation plan.

Key Activities:

Requirements Breakdown: Decompose spec into implementable units
Technical Feasibility: Evaluate technical viability
Implementation Planning: Define order, priorities, resources
Risk Identification: Identify potential issues and mitigation

Outputs:

Decomposed requirements list
Technical feasibility assessment
Implementation plan (order, timeline, resources)
Risk matrix with mitigation strategies

Phase 3: Test Definition

Goal: Derive test cases from specifications to define success criteria.

Steps:

Extract Acceptance Criteria from spec's Test Strategy section
Write test case descriptions (unit + integration)
Document test scenarios (happy path, error handling, edge cases)

Format: Given-When-Then structure

Phase 4: TDD Implementation

Goal: Implement using Red-Green-Refactor cycle.

TDD Cycle:

Red: Write failing test
Green: Write minimal code to pass
Refactor: Improve code while keeping tests passing

Repeat for each function/feature.

Phase 5: Verification

Goal: Ensure implementation meets spec and quality standards.

Checklist:

Phase 6: Iteration

Goal: Incorporate feedback and update specs as needed.

Steps:

Collect feedback (reviews, tests, users)
Update spec if implementation discoveries warrant it
Update tests to match spec changes
Re-verify (return to Phase 5)

Working with AI Agents

Requesting SDD+TDD Workflow

Example prompts:

"Implement the sync command using SDD+TDD workflow from RFC-0001"

"Create an ADR for choosing the configuration format, then implement with TDD"

"Follow SDD+TDD workflow to add user authentication feature"

What the AI Agent Will Do

Read and understand the RFC/ADR specification
Analyze and break down requirements
Create implementation plan and identify risks
Derive test cases from Test Strategy section
Write tests first (Red)
Implement minimal code (Green)
Refactor for quality
Verify against spec requirements
Update spec if needed

Collaboration Tips

Be explicit: Reference specific RFC/ADR numbers
Provide context: Share relevant spec sections
Review checkpoints: Ask agent to verify spec compliance
Iterate openly: Discuss spec updates during implementation

Resources

references/

full_workflow.md - Comprehensive workflow documentation including:

Detailed phase-by-phase instructions
Workflow diagrams
Practical implementation examples
Checklists for each phase
AI agent collaboration patterns

When to load: When detailed guidance is needed for a specific phase, when implementing a complex feature for the first time, or when teaching the workflow to new team members.

Quick Reference:

Need	Action
Start new feature	RFC → Design Review → Tests → TDD implement
Make tech decision	ADR → Design Review → Tests → TDD implement
Understand phases	Read `references/full_workflow.md`
Get examples	See "실전 예제" section in full_workflow.md
Use checklist	Find phase checklists in full_workflow.md

sdd-tdd-workflow

SDD + TDD Integrated Workflow

Overview

When to Use This Skill