← ClaudeAtlas

speclisted

Write a minimal spec — goal, non-goals, acceptance criteria, open questions — before implementing a feature or change. Use when the user asks to "spec this", "напиши спеку", "what does done mean here", "acceptance criteria for X", or before starting a non-trivial implementation without a clear definition of done. Different from /rfc (explores architecture options, 10 sections) and /adr (records a decision already made) — /spec pins down what "done" means for one concrete change, in five to twenty lines. Its acceptance criteria become the input for /verify.
yuri-semenenko/ai-engineering-workspace · ★ 1 · AI & Automation · score 75
Install: claude install-skill yuri-semenenko/ai-engineering-workspace
# Spec Pin down what "done" means before writing code. Even a five-line spec beats none: it forces the boundary question (what are we *not* doing?) and gives `/verify` something concrete to check against. This is the lightweight entry to the Define phase — reach for `/rfc` only when there are genuinely competing architectural options to weigh. ## Rationalizations | Rationalization | Rebuttal | |---|---| | "Task too simple for a spec." | Acceptance criteria apply at any scale. A simple task gets a five-line spec, not zero. | | "The requirements are obvious from the ask." | Then writing them down costs a minute and catches the one place they weren't. | | "We'll figure out the edge cases while coding." | Edge cases decided mid-implementation default to whatever is easiest to code, not what's right. | | "A spec will slow us down." | Rework from a misunderstood requirement is slower than twenty lines of markdown. | ## Format ```markdown ## Goal <1-2 sentences: the user-visible outcome, not the implementation.> ## Non-goals <What this change deliberately does NOT do. The scope fence — anything here appearing in the diff is scope creep.> ## Acceptance criteria <Testable statements. Each one either passes or fails — no "works well". - [ ] <observable behavior, ideally with concrete input → output> - [ ] <error/edge case behavior>> ## Open questions <Anything blocking or ambiguous. If a question changes the approach, resolve it before coding; otherwise note the assumption and