← ClaudeAtlas

thread-speclisted

Turn a thread's stub into a spec: read the stub, research the code and the knowledge base, decide what can be decided, ask only what cannot, and file the spec document. Use for spec this, define this thread, brainstorm, think this through, what should this be, flesh out the stub, requirements, design this.
nathanaday/claude-atlas · ★ 0 · Testing & QA · score 72
Install: claude install-skill nathanaday/claude-atlas
# Write a thread's spec Read [threads.md](../wiki/references/threads.md). Tools: `threads`, `thread`, `status`. The spec says what will be true when the thread is done, and why. It is the agreement between the user and whoever does the work. It is quick to write: most of the work is reading, and the user answers only what reading cannot. ## Understand before you ask 1. Call `threads` with the `id`. Read the stub. 2. Find the answers yourself: the code the thread touches, its tests, the CLAUDE.md of the work, recent commits, and the knowledge base (the project's page, `wiki/hot.md`, a Grep for the subject). A question the code answers is not a question for the user. 3. Decide what you can decide. Where one option is right, take it and give the reason in the spec. The user reads the spec and can disagree there. ## Ask only what changes the spec A question goes to the user when the answer is theirs alone (a preference, a priority, a constraint outside the code) and a wrong guess would change what is built. There is no right number of questions: none is common, and ten are fine for a thread that needs them. Ask them together in one message, each with the answer you recommend, so the user can reply in a line. Do not ask for approval section by section. When the stub holds several independent pieces of work, say so first and offer a thread for each (`thread-stub`). Spec the one the user picks. ## What the spec holds Write for someone who has not seen this conve