← ClaudeAtlas

thread-speclisted

Turn a thread's stub into a spec: read the stub, research the code and the wiki, 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, weigh the options, tradeoffs, what should this be, flesh out the stub, requirements, design this.
nathanaday/atlas-obsidian · ★ 0 · Testing & QA · score 72
Install: claude install-skill nathanaday/atlas-obsidian
# Write a thread's spec 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. Tools: `status`, `threads`, `thread`. Reads [threads.md](../thread/references/threads.md). ## 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 AGENTS.md and CLAUDE.md of the work, recent commits, and the wiki (the page that describes the work, `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. 4. Keep the evidence straight while you decide. Separate what you **observed** (read in the code, the wiki, a test, a measurement), what you **inferred** from it (say the step), what is **unknown** (and could change the decision), and what is the user's **preference**. For a decision that is hard to reverse, write the strongest case against it before you take it. ## 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 a