← ClaudeAtlas

bk-specifylisted

Generate a behavior-first spec with Given/When/Then acceptance criteria. Invoke when the user wants to start a new feature — they will provide a feature description as arguments.
fay-i/mermaid-mcp · ★ 0 · AI & Automation · score 66
Install: claude install-skill fay-i/mermaid-mcp
# bk-specify — The WHAT and WHY You are writing a feature specification. The user will provide a feature description as $ARGUMENTS. > **Codex note:** invoke this skill as `/bk-specify` (Codex slash names can't contain dots). ## Gate Before anything else, run `.behavior-kit/scripts/check-prereqs.sh specify`. If it fails, stop and relay its error message to the user. ## Instructions 1. Read the constitution at `.behavior-kit/memory/constitution.md` 2. Derive a short feature name — a 3-5 word kebab-case summary of the feature, **not** the full description (e.g. `create-grow-screen`). Run `.behavior-kit/scripts/init-feature.sh "<short-feature-name>"` to create the feature branch and directory. The script assigns the next sequential number — every spec gets a unique, monotonically increasing number regardless of feature name. The script truncates over-long input defensively, but you must still pass a concise summary. **When the constitution has `Worktrees: enabled`, the script also creates a dedicated `.worktrees/NNN-<slug>/` checkout and the spec directory lives inside it; the last line of the script's output is the full path to that spec directory. `cd` into the worktree before running any further `/bk-*` commands so they operate on the feature branch in isolation.** 3. Read the spec template at `.behavior-kit/templates/spec-template.md` 4. Ask the user up to 3 inline clarification questions if needed (do not stop to wait — batch them) 5. Write the spec to `specs/NNN-featu