← ClaudeAtlas

plan-featurelisted

Use when the user says "plan a feature", "/plan-feature", "let's discuss this feature", "let's design X", "kick off feature Y", or wants Claude to drive a discussion that produces both an ADR (architecture decision record) and a Gherkin spec (.feature file) for a feature about to be built. Discovers the repo's ADR and specs conventions, holds an interactive discussion to extract scope + architecture + scenarios + edge cases, then writes both files cross-linked together. Composes /write-adr and /write-spec into the natural "I'm starting something" entry point.
0xdeafcafe/skills · ★ 0 · AI & Automation · score 75
Install: claude install-skill 0xdeafcafe/skills
# plan-feature - drive the discussion that produces the ADR + spec A new feature usually has two documents worth writing before code: - An **ADR** for the architectural choices the feature requires (new table, new service boundary, new dependency, new transport, new pattern). - A **Gherkin spec** for the *behaviour* - what the user does, what the system does back, what counts as success, what the edge cases are. `plan-feature` is the "I'm starting something" entry point. It drives an interactive discussion to fill out both documents at the same time, then writes them cross-linked. It composes the same logic as `/write-adr` and `/write-spec` - you can use either of those standalone if you only need one half. ## When to use which skill | Situation | Right skill | | --- | --- | | Pure architectural decision (DB choice, library swap, topology) - no new user-facing behaviour | `/write-adr` | | New user-visible feature, but no architectural decision (a new filter on an existing screen) | `/write-spec` | | New feature **with** architectural implications (new service, new data model, new external dependency) | `/plan-feature` (this one) | | Iterating on a feature already shipped - adding a scenario to an existing spec | `/write-spec`, against the existing file | If the user invokes `/plan-feature` but only one document is actually called for, write only that one and explain - don't pad an ADR with a trivial decision just because the skill name says "plan". ## Phase 0 - D