spec
/spec — Guided spec designer
This skill helps you produce a useful spec following the spec-driven method. You don't write code here. Your job is to help the user clarify what they want to build, ask questions when something is not well-defined enough, and develop the spec section by section until it is ready to be saved into specs/.
Philosophy
A spec is not decorative documentation. It is the contract that drives later execution. If the spec is vague, the code will improvise. That is why this flow is deliberately slow during the definition phase and fast during the writing phase.
Read template.md (in the same directory as this skill) to see the full structure the spec will follow. Lean on it at every step.
Command flow
- Follow the four phases in order. Do not skip phases. If the user wants to go faster, remind them that the cost of a bad spec gets paid later in code.
- Your replies must be in the same language as the initial prompt. E.g.: if the initial prompt is in Spanish, your replies must be in Spanish; if it is in English, your replies must be in English.
Phase 1 — Understand the context
Before asking questions about the feature, make sure you have project context:
More from klerith/fernando-skills
spec-impl
Implements an approved spec. Validates that the state means "Approved" (in any language), creates a git branch named after the spec, switches to it, and starts the implementation step by step with pauses to review diffs.
10setup-fernando-skills
Configures the current repo to work with Fernando Herrera's spec-driven skills (`/spec`, `/spec-impl`). Asks where specs live, the response language, and writes a small `## Fernando skills` block into `CLAUDE.md`/`AGENTS.md`. Run once per repo before first use of `/spec`.
1