rizanw/steno-spec / packages/skills/skills/steno-spec
steno-spec
Verifiedsteno-spec — requirements phase
Goal: requirements.md a reviewer with no context can test against: WHAT must be true, never HOW.
Hard rules: never read a spec file back in full (use steno show <id>); no code in criteria.
0. Resume (the spec already exists)
Run steno status <slug> first and branch on it; never redo intake for an existing spec.
requirements.md: not startedorskeleton: requirements.md …→ go to step 2.- phase
requirements, no skeleton line, not approved →steno show requirements, then go to step 5. requirementsalready approved → stop; the next skill issteno-design.- phase
brief→ stop; finishsteno-brainstorm(steno approve brief) first.
1. Intake (new spec only; skip what the user already said)
Ask once, in one message: (a) feature or bugfix? (b) mode: requirements-first (default, gated), quick (all three artifacts, no gates, small work), or brief first (unclear idea → steno-brainstorm).
Then steno new <kebab-slug> --title "<Title>" (add --bugfix), or steno quick <slug>.
2. Explore (one bounded pass)
- If the spec has a brief:
steno show brief. It is the primary input: its Decision sets scope, its Open questions carry into step 5. - Steering: read
product.mdand the topic file for the area (steno show steering/<f>). Ifsteno statusprintedsteering: none, offersteno-steerfirst; if it printed nothing about steering the repo is greenfield, so skip steering and rely on the brief and the user. - Find what the feature touches: pages, queries, data fields, i18n, existing filters or modes. If a sub-agent is available, delegate to one capped at 15 files: paths, a ≤250-word summary of data fields, modes, conventions, small UI rules worth keeping (markers, ordering, hide/show, fallbacks), and ambiguities. Otherwise look yourself, opening only what you need. Greenfield: skip this; the brief is the code knowledge.
- That summary is all the code knowledge needed; never spawn writers that re-read code.
3. Outline
steno scaffold writes the requirements.md skeleton if it is missing. Write the outline into that file, replacing the <…> placeholders under its headings; never a separate file.
- Introduction: two short paragraphs: situation today, what changes.
- Glossary:
- **Term_Name**: definitionfor each view, control, mode and entity the criteria name (THE Wallet_Picker SHALL …, never "the dropdown"), defined by what the user sees. - One
### Requirement N: <title>per user-visible capability (3–8), each with its**User Story:**. Always consider one for data availability (what existing records must provide) and one for modes and localisation. In gated mode show titles and stories (not the file) and ask "proceed to detail these?". In quick mode or if told to run through, continue.
4. Detail each requirement (you, in this context)
Fill #### Acceptance Criteria under each requirement in requirements.md: 3–6 each (aim near 4), one EARS sentence, exactly one SHALL, at most 35 words:
WHEN <trigger>, THE <Term> SHALL … · IF <condition>, THEN THE <Term> SHALL … · WHILE <state>, … · WHERE <mode/option>, … · THE <Term> SHALL …
Cover happy path, empty/zero cases, the inverse action, mode variants, what must NOT happen. Concrete values only when given by the user or data.
Forbidden in criteria: file paths, component/prop/state names, function signatures, CSS, i18n keys. Wanting them means design; note it for steno-design.
5. Check and hand over
steno lint requirements; fix every error and warning (spec/placeholder: a<…>is still unreplaced;ears/implementation,ears/too-long: rewrite in user terms;ears/undefined-term: add the term).- Put every ambiguity the explorer flagged, every assumption and invented value under a final
## Open questionslist; never silently pick a side. - Report:
steno show requirements, the open questions, then offer resolve (when questions are open: interview the user one question at a time with a recommended answer, write each answer into the requirement, delete the question and the heading with the last one, re-lint), approve (steno approve requirements, thensteno-design; open questions carry over), review (steno-review --stage requirements) or edit (one requirement, re-lint). Neversteno approvewithout the user's yes, except in quick mode.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |