Spec Coding Skill
A spec-driven methodology for LLM agents to define, plan, and implement large-scale coding work with quality and consistency.
When Activated
- Read 00-agent-execution.md first — these are global rules that apply to every phase and take precedence over all other instructions
- Start Phase 01 — follow 01-initialization.md to create the requirement definition document
- Work through phases in order — consult the reference file for each phase as you enter it
All generated documents go under .dev/[NNN]-[req-name]/ in the project root.
Phase Overview
Phase 01 — Initialization (required)
↓
Phase 02 — Prerequisite Tasks (optional, LLM judges)
Phase 03 — Algorithm Design (optional, LLM judges)
↓
Phase 04 — Implementation Plan (required)
↓
Phase 05 — Task Planning (required)
↓
Phase 06 — Create start-and-resume.md (required)
↓
Phase 07 — Execution (required)Phases 02 and 03 are independent — both, one, or neither may be needed.
Phase Reference
| Phase | Output | Reference |
|---|---|---|
| 01 Initialization | init.md | 01-initialization.md |
| 02 Prerequisite Tasks | inspect.md / research.md / profiling.md / diagnosis.md | 02-prerequisite-tasks.md |
| 03 Algorithm Design | algorithm-design.md | 03-algorithm-design.md |
| 04 Implementation Plan | plan.md | 04-implementation-plan.md |
| 05 Task Planning | tasks.md | 05-task-planning.md |
| 06 Create start-and-resume.md | start-and-resume.md | 06-start-and-resume.md § Step 0 |
| 07 Execution | code | 06-start-and-resume.md |
Coding Reference
| Topic | Reference |
|---|---|
| OOP & SOLID Principles | 07-oop-principles.md |
| Coding Standards (all languages) | 08-coding-standards.md |
Core Rules
- Never skip a required phase
- Read existing code before modifying anything
- Write and pass unit tests before moving to the next task
- Minimize changes when the project is
live; breaking changes are allowed forpre-launch+ new modules - Never hardcode secrets; use environment variables
- All identifiers, comments, and docs must be in English