Read-set manifest: devrites-engine context --skills-root .devin/skills <slug> --phase clarify bundles every file named below into one deduplicated read. Trigger names map to the conditional rules in the sections that follow.
/rite-clarify: resolve product decisions
Run this required pass between spec and strategy. If the spec covers every material
decision, ask no questions. Otherwise stay until each material decision has an
owner. This phase settles behavior and constraints; /rite-define settles
implementation.
Reuse devrites-interview in /clarify mode. Write
decision-coverage.md as scan evidence, not an interview transcript.
Rules consulted
Read core.md, its afk-hitl.md, and
reference/decision-coverage.md. Fresh evidence
dispatch uses
agents.md.
Rules
- Search code/docs/contracts first. Facts and reversible implementation/test choices
are agent-owned; ask only about product, scope, policy, irreversible risk, or human-only access.
- Enumerate the full topology before details so no sibling surface is omitted.
- Ask one coherent human-owned decision packet at a time. One packet may close several rows
only when owner and trade-off match; never ask permission for routine repair/retry.
- One scan may cap at five packets for cognitive load, but readiness has no question cap:
re-scan until clear.
- Material assumptions carry evidence, confidence, owner, validation, and consequence.
- Refuse the rationalizations in
anti-patterns.
Workflow
- Orient. Resolve source per phase target binding, then read its
state.md and spec.md. Require
state.md spec_gate: passed (legacy Spec gate: passed line accepted); otherwise stop at /rite-spec. Apply the native cursor
protocol below before changing workspace artifacts.
- Enumerate the topology. From the spec, live code, contracts, references,
and recorded decisions, list every material stakeholder/priority, invariant, actor,
journey/component, state, data lifecycle, integration, failure/recovery path,
operation, proof surface, applicability row, and must-NOT boundary.
- Scan coverage. Apply
devrites-interview in clarify mode and mark each
material surface closed, agent-owned, not-applicable,
deferred-nonblocking, or open with evidence and an owner. Use native repository search
first. Ask the host to run devrites-evidence-scout only for a bounded missing
fact, then reconcile its cited result.
- Close decisions. Record facts and reversible technical choices directly.
Ask one coherent option packet only for product, scope, policy, irreversible
risk, or human-only access. Persist answers in the owning artifacts and repeat
the scan until no blocking
open row or unowned material assumption
remains.
- Write the verdict. Write
Decision coverage: CLEAR only after re-reading all inputs and confirming
every material row has current evidence and an owner. Normal flow sets phase=clarify and
next_action=/rite-temper, or /rite-define for low-stakes specs temper skips.
Later-phase entries follow the ownership protocol below. Return inline verdicts
to the controlling caller; otherwise stop before starting the next phase.
Native clarify cursor protocol
Edit only cursor rows; preserve unrelated Markdown and table/bullet presentation.
- Validate before writes: require no return fields or a complete pair:
recognized later
return_phase, non-empty return_next_action. Invalid/half
pairs fail closed. Later phases: temper, define, plan, vet, build,
converge, prove, polish, review, seal, ship.
- Spec entry: set
phase=clarify, status=running,
next_action=/rite-clarify <slug>; omit return fields.
- Caller-owned pair: pair with
phase!=clarify requires a native
controlling caller; otherwise stop for ownership recovery. Run bounded Clarify
inline, preserve all cursor rows, and return its verdict to caller.
Contract changes require Plan repair and Vet before outer resume.
- Clarify-owned pair: standalone later-phase entry without a pair saves current
phase/non-empty next action as the pair, then sets
phase=clarify,
status=running, next_action=/rite-clarify <slug>. Missing/unknown values
fail closed. phase=clarify resumes without writes; its pair belongs to
standalone Clarify, not a nested caller.
- Restore: after fresh
CLEAR, only the owner restores its pair.
Contract-neutral standalone Clarify restores phase/next action, sets
status=running, atomically unsets both return fields, and re-reads to verify.
Contract changes retain the pair through Plan repair and Vet; only its owner
consumes it after readiness. Preserve caller pairs.
Output
Done: decision coverage closed for <slug>; <n> topology surfaces scanned.
Changed: decision-coverage.md, spec.md, decisions.md, assumptions.md, questions.md
Evidence: Decision coverage: CLEAR; human packets <n>; agent-owned facts <n>
Open: none blocking; deferred-nonblocking <n>
Next: /rite-temper (or /rite-define for a low-stakes spec temper skips)
Record: .devrites/work/<slug>/decision-coverage.md
↻ Hygiene: /clear — decision coverage is persisted in decision-coverage.md
If not clear, name the exact rows and next genuine decision packet. An objective spec defect
or factual search task never routes through /rite-resolve.
1---2name: rite-clarify-73description: Audit a completed spec for missing decisions before strategy or architecture. Use after /rite-spec when coverage is incomplete or stale; not for spec writing.4argument-hint: "[feature-slug]"5metadata:6 source: https://skillmd.com/skills/viktorsbaikers/rite-clarify-77---89<!-- loads: {"always":["devrites-lib/reference/parallel-workspaces.md","devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/code-navigation.md","devrites-lib/reference/standards/code-index.md","devrites-lib/reference/standards/afk-hitl.md","rite-clarify/reference/decision-coverage.md","rite-clarify/reference/anti-patterns.md"],"triggers":{"agents":["devrites-lib/reference/standards/agents.md"]},"workspace":["brief.md","spec.md","state.md","decisions.md","assumptions.md","questions.md","decision-coverage.md"],"workspaceByRole":{"evidence-scout":["brief.md","spec.md","state.md","questions.md"]},"rootOnly":["devrites-lib/reference/parallel-workspaces.md","devrites-lib/reference/standards/code-index.md","devrites-lib/reference/standards/afk-hitl.md"]} -->10> Read-set manifest: `devrites-engine context --skills-root .devin/skills <slug> --phase clarify` bundles every file named below into one deduplicated read. Trigger names map to the conditional rules in the sections that follow.111213# /rite-clarify: resolve product decisions1415Run this required pass between spec and strategy. If the spec covers every material16decision, ask no questions. Otherwise stay until each material decision has an17owner. This phase settles behavior and constraints; `/rite-define` settles18implementation.1920Reuse [`devrites-interview`](../devrites-interview/SKILL.md) in `/clarify mode`. Write21`decision-coverage.md` as scan evidence, not an interview transcript.2223## Rules consulted2425Read [`core.md`](../devrites-lib/reference/standards/core.md), its [`afk-hitl.md`](../devrites-lib/reference/standards/afk-hitl.md), and26[`reference/decision-coverage.md`](reference/decision-coverage.md). Fresh evidence27dispatch uses28[`agents.md`](../devrites-lib/reference/standards/agents.md).2930## Rules3132- Search code/docs/contracts first. Facts and reversible implementation/test choices33 are agent-owned; ask only about product, scope, policy, irreversible risk, or human-only access.34- Enumerate the full topology before details so no sibling surface is omitted.35- Ask one coherent human-owned decision packet at a time. One packet may close several rows36 only when owner and trade-off match; never ask permission for routine repair/retry.37- One scan may cap at five packets for cognitive load, but readiness has no question cap:38 re-scan until clear.39- Material assumptions carry evidence, confidence, owner, validation, and consequence.40- Refuse the rationalizations in [`anti-patterns`](reference/anti-patterns.md).4142## Workflow43441. **Orient.** Resolve source per [phase target binding](../devrites-lib/reference/parallel-workspaces.md#phase-target-binding), then read its `state.md` and `spec.md`. Require45 `state.md` `spec_gate: passed` (legacy `Spec gate: passed` line accepted); otherwise stop at `/rite-spec`. Apply the native cursor46 protocol below before changing workspace artifacts.472. **Enumerate the topology.** From the spec, live code, contracts, references,48 and recorded decisions, list every material stakeholder/priority, invariant, actor,49 journey/component, state, data lifecycle, integration, failure/recovery path,50 operation, proof surface, applicability row, and must-NOT boundary.513. **Scan coverage.** Apply `devrites-interview` in clarify mode and mark each52 material surface `closed`, `agent-owned`, `not-applicable`,53 `deferred-nonblocking`, or `open` with evidence and an owner. Use native repository search54 first. Ask the host to run `devrites-evidence-scout` only for a bounded missing55 fact, then reconcile its cited result.564. **Close decisions.** Record facts and reversible technical choices directly.57 Ask one coherent option packet only for product, scope, policy, irreversible58 risk, or human-only access. Persist answers in the owning artifacts and repeat59 the scan until no blocking `open` row or unowned material assumption60 remains.615. **Write the verdict.** Write `Decision coverage: CLEAR` only after re-reading all inputs and confirming62 every material row has current evidence and an owner. Normal flow sets `phase=clarify` and63 `next_action=/rite-temper`, or `/rite-define` for low-stakes specs temper skips.64 Later-phase entries follow the ownership protocol below. Return inline verdicts65 to the controlling caller; otherwise stop before starting the next phase.6667## Native clarify cursor protocol6869Edit only cursor rows; preserve unrelated Markdown and table/bullet presentation.7071- **Validate before writes:** require no return fields or a complete pair:72 recognized later `return_phase`, non-empty `return_next_action`. Invalid/half73 pairs fail closed. Later phases: `temper`, `define`, `plan`, `vet`, `build`,74 `converge`, `prove`, `polish`, `review`, `seal`, `ship`.75- **Spec entry:** set `phase=clarify`, `status=running`,76 `next_action=/rite-clarify <slug>`; omit return fields.77- **Caller-owned pair:** pair with `phase!=clarify` requires a native78 controlling caller; otherwise stop for ownership recovery. Run bounded Clarify79 inline, preserve all cursor rows, and return its verdict to caller.80 Contract changes require Plan repair and Vet before outer resume.81- **Clarify-owned pair:** standalone later-phase entry without a pair saves current82 phase/non-empty next action as the pair, then sets `phase=clarify`,83 `status=running`, `next_action=/rite-clarify <slug>`. Missing/unknown values84 fail closed. `phase=clarify` resumes without writes; its pair belongs to85 standalone Clarify, not a nested caller.86- **Restore:** after fresh `CLEAR`, only the owner restores its pair.87 Contract-neutral standalone Clarify restores phase/next action, sets88 `status=running`, atomically unsets both return fields, and re-reads to verify.89 Contract changes retain the pair through Plan repair and Vet; only its owner90 consumes it after readiness. Preserve caller pairs.9192## Output9394```text95Done: decision coverage closed for <slug>; <n> topology surfaces scanned.96Changed: decision-coverage.md, spec.md, decisions.md, assumptions.md, questions.md97Evidence: Decision coverage: CLEAR; human packets <n>; agent-owned facts <n>98Open: none blocking; deferred-nonblocking <n>99Next: /rite-temper (or /rite-define for a low-stakes spec temper skips)100Record: .devrites/work/<slug>/decision-coverage.md101↻ Hygiene: /clear — decision coverage is persisted in decision-coverage.md102```103104If not clear, name the exact rows and next genuine decision packet. An objective spec defect105or factual search task never routes through `/rite-resolve`.