manual page/ ADRs
ADR-0157 - Ruthless skills and closed artifact authorship
sourceSource: suspec/docs/adrs/0157-ruthless-skills-and-closed-artifact-authorship.mdModified: 2026-07-13
Context
Universal methods inherited artifact machinery, ambiguity boilerplate, and defensive instructions
whose absence produced identical behavior. Triple-check recorded findings instead of destroying
them. The inspection type persisted after its writers stopped needing documents.
Decision
- Every skill is ruthless and economical. Keep only instructions that change execution. Use hard imperatives. Delete filler, soft framing, default behavior, announcement labels, inert negatives, and duplicated mechanics.
- Fork every ambiguity.
fork-meactivates whenever ambiguity survives factual investigation. It stops dependent work and presents at least three genuine options through the native picker, recommendation first, with each reason and cost stated plainly. Other skills expose ambiguity; they do not copy picker mechanics or name a sibling dependency. - Artifact authorship is closed. Only
sus-spec,sus-task,sus-review,sus-inventory,sus-change-plan,sus-audit, andsus-researchcreate Suspec artifacts. Evidence receipts and run notes remain untyped sidecars owned by those workflows. Theinspectionartifact type retires. - Inspection methods resolve work in place. Bulletproof and Demolition return compact chat. Revolver runs at least six sequential stances. Triple-check runs exactly three fresh top-tier passes. For both loops, supported findings are fixed and verified, refuted findings carry decisive evidence, genuine human decisions stop for selection, and unresolved defects block the next reviewer.
- The deterministic contract rejects the retired type. Checks contract
0.19.0recognizesinventory,audit, andresearchas unchecked.inspectionbecomes an unknown type. No check ID changes. - Lifecycle close stays with artifact workflows. After an artifact is fully actioned and no downstream step needs it, its workflow requires one human disposition for the artifact and its sidecars: Delete, Leave, or Promote.
Narrowed decisions
- ADR-0145: economy now governs skill source as well as generated Markdown; one ambiguity method owns picker mechanics.
- ADR-0146: inspection methods no longer produce inspection artifacts; Triple-check resolves sequentially instead of splitting inspect and refine modes.
- ADR-0149: self-containment requires local method contracts, not duplicated cross-cutting mechanics.
- ADR-0150: lifecycle disposition remains on artifact workflows.
- ADR-0151: the catalog adds
fork-me; the owned artifact set dropsinspection. - ADR-0152: the recognized type set narrows and the
checks contract advances to
0.19.0. - ADR-0155: Revolver's sequential resolution stands.
- ADR-0156: fixed procedures carry no generic picker boilerplate; genuine ambiguity still activates the dedicated selection method.
Consequences
- Universal methods leave no transient documents behind.
- Every ambiguity reaches a human as an actionable fork, not a guess or essay question.
- Revolver and Triple-check improve the target instead of compiling defect reports.
- Installed skill payloads spend tokens only on behavior-changing instructions.
Status
Accepted (2026-07-13). Narrows ADR-0145, ADR-0146, ADR-0149 through ADR-0152, ADR-0155, and ADR-0156.
Need a starting point? Install the skills