← ClaudeAtlas

spec-clarifylisted

Use right after a spec is drafted, or whenever one still has open questions in it - "let's clarify this spec", "answer the open questions before we plan it". Asks one question at a time, each leading with a recommended answer you can accept by saying yes, and writes every answer into the spec - including a deliberate "decide that later", which is an answer and gets recorded as one. Planning and building refuse to start until this reaches zero open questions.
repository-standards/core · ★ 3 · Testing & QA · score 76
Install: claude install-skill repository-standards/core
<!-- Vendored from github/spec-kit v0.13.2 (MIT - scripts/spec/LICENSE). PATCHED(repository-standards) hunks are marked inline; CHERRY-PICKED hunks name the upstream commit they came from. --> <!-- PATCHED(repository-standards): em and en dashes normalised to ASCII hyphens throughout. standard/docs/conventions.md forbids them, and this file ships into every adopting repo, so the vendored punctuation would have carried a rule break into each one. Prose only - no instruction, path or example changed. Enforced by tools/prose-check.mjs. --> <!-- PATCHED(repository-standards): ADR-033 - records outrank the dossier and the user; the dossier was documented as the sole pre-user answer source, so a question a decision had already settled was asked anyway, and whatever the user said that day won --> **Records first, then discovery, then the user.** Before the dossier and before any question, read `docs/decision-records/`'s index and open in full only the records whose subject overlaps this spec - and where `decision-records-check` is not running to prove the index lists everything on disk, list the directory too. An **Accepted** record in scope has already answered: write its answer into the spec citing it (`per ADR-0NN`), and do not ask. `Proposed` / `Rejected` / `Superseded` bind nothing - follow the supersession link to the record that is current. <!-- PATCHED(repository-standards): ADR-024 - the dossier answers before the user does --> **Discovery second.*