Spec Coding

8 Claude Code skills for infrastructure and platform engineering. Guide teams from "what's broken" to "what to build" through structured documentation.

The Pipeline

/spec-gap → /spec-require → /spec-architect → /spec-tasklist
  GAP         REQ              FIP                Task List
  差距分析     需求规格          架构设计            任务拆分

4 supporting skills for cross-cutting concerns: /spec-naming, /spec-failure, /spec-autoconf, /spec-infra.

Install

claude plugins install github.com/lew/spec-coding

Quick Start

Type /spec-gap in Claude Code. The skill will:

1. Ask your project name, issue number, and branch
2. Guide you section by section through the GAP template
3. Each section: summarize → ask → fill → confirm
4. Output to specs/<project>/GAP_<project>.md

Then continue through the pipeline: /spec-require → /spec-architect → /spec-tasklist.

Output Structure

specs/
├── _shared/                    ← Platform-level, shared across projects
│   ├── NAMING_<platform>.md
│   ├── FAILURE_<platform>.md
│   └── DEPS_<platform>.md
│
└── <project>/                  ← Per-project, 4 pipeline documents
    ├── GAP_<project>.md
    ├── REQ_<project>.md
    ├── FIP_<project>.md
    ├── TASK_<project>.md
    └── AUTO_TASK_CONFIG.yaml

What Makes This Different

• TDD for documentation — spec-gap has a verified baseline test proving it catches invention of unconfirmed details
• HARD-GATE enforcement — non-negotiable rules (never invent business decisions, never skip status updates)
• Self-review with verification commands — every skill runs copy-pasteable checks before handoff
• Traceability chain — GAP ID → FR-X.Y.Z → T-ID → commit SHA

Skills Detail

Skill	Template	When
/spec-gap	GAP Analysis	Starting a project, need baseline vs target comparison
/spec-require	Requirements	Have gaps, need measurable FR- IDs
/spec-architect	FIP	Have requirements, need architecture design with diagrams
/spec-tasklist	Task List	Have architecture, need granular work items
/spec-naming	Naming Rules	Need consistent resource naming across AWS/Terraform
/spec-failure	Failure Patterns	Documenting deployment failures, building checklists
/spec-autoconf	Auto Task Config	Automating task execution via Sub-Agent architecture
/spec-infra	Infra Dep Rules	Multi-environment deployment ordering and blockers

License

MIT