Skills
.Work. You
Rest

spec-first

Community

Spec-first: spec → plan → execute → verify.

Software Engineering#planning#documentation#verification#execution#spec#tests
Authorrohunvora
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Spec-first development enforces a deliberate spec/planning loop for non-trivial tasks. By creating spec.md, todo.md, and decisions.md before coding, teams reduce "looks right" failures and ship with robust tests.

Core Features & Use Cases

  • Stage A: Frame the Problem
  • Stage B: Write spec.md (freeze decisions)
  • Stage C: Generate todo.md (planning)
  • Stage D: Execute Changes (small diffs, frequent verification)
  • Stage E: Verify and Review (adversarial mode)
  • Stage F: Decide What Lasts (policy vs mechanism)

Quick Start

  • Frame the problem and surface tradeoffs; surface constraints; frame minimal version; generate spec.md; create a stepwise plan in todo.md; implement changes in small, testable steps; verify with adversarial review and tests.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: spec-first
Download link: https://github.com/rohunvora/my-claude-skills/archive/main.zip#spec-first

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository