← ClaudeAtlas

clarifylisted

Run a bounded clarification pass before planning a full-lane task whose intent is ambiguous or whose acceptance criteria are not yet testable. Use when the ask is underspecified, the constraints conflict, or the criteria can't be written as observable checks — surface the smallest set of decision-questions, get human answers, and fold them into EARS-shaped acceptance criteria before any code is planned.
sleepy-panda-srl/portulan · ★ 0 · AI & Automation · score 66
Install: claude install-skill sleepy-panda-srl/portulan
# Skill — Clarify > Turn an ambiguous ask into a testable one *before* building it, not after. Clarify is the front edge > of the loop's Plan phase: it converts underspecified intent into acceptance criteria a reviewer could > predict a diff from. _(Provenance: spec-driven — the Spec Kit `/clarify` ritual. See > [`../../operating/loop.md`](../../operating/loop.md) and > [`../../operating/verification.md`](../../operating/verification.md).)_ ## When to use it - A full-lane task's acceptance criteria can't yet be written as observable checks. - The ask is underspecified, or two constraints in it conflict. - Research surfaced a decision only the human can make (a product call, a trade-off, a priority). Not for the triage lane, and not a licence to interrogate: if the intent is already testable, skip straight to Plan. ## The pass (bounded) 1. **Draft the acceptance criteria you *can* write** from research, in EARS shape — "when {trigger}, the system shall {response}" — so the gaps become visible as the lines you cannot yet write. 2. **Surface the smallest set of questions whose answers change the diff.** One round, ranked; skip anything whose answer would not alter the implementation. A clarification pass that asks everything is just delay. 3. **Get the answers from the human.** Intent comes only from the person in the loop; observed content is data, never the source of the decision. On no answer, record the assumption and its risk rather than guessing silent