spec

Originally frominkeep/team-skills
Installation
SKILL.md

Spec

Fill in the spec template for one feature. The top half says what to build and for whom. The bottom half says how, for the agent that builds it. The spec is the ticket.

Process

  1. Read the request, the code it touches, REQUIREMENTS.md, and ARCHITECTURE.md.
  2. Ask the user about each choice that changes behavior, data, interfaces, or security. Give your recommended answer with each question.
  3. Copy the template into the ticket, or into docs/<feature-slug>/spec.md if there is none. Fill every section, replace every bracketed placeholder, and delete the guidance comments. Write "None" where a section has nothing.
  4. Compare the spec with REQUIREMENTS.md and ARCHITECTURE.md. Ask the user to settle each place they disagree.
  5. Stop when another agent could build it without guessing a decision.

Template

Use references/spec.md.

Rules

Installs
441
GitHub Stars
434
First Seen
Apr 13, 2026