ADR-0105 — Stretch and collapse: the artifact set is a dial, not a set of stations
- Sections
- 4
- Format
- Markdown
- Order
- 141 / 156
Context
The artifact set risks two failure modes: too many stations (ceremony for a trivial change) or too
lean (can't unfold for an 8-PR migration). ADR-0103
started the fix (spec is the unit, task on-demand) but it was never stated as a principle, and the kit
still ships /examples + /advanced as if every adopter needs every extended-type blank. Ratified
from RFC-stretch-collapse (suspec-works#72 ceremony).
Decision
-
The artifact set is a dial. Default is spec-only; stretch on demand —
+taskwhen a spec splits into parallel slices,+change-planfor multi-wave migrations,+inventoryfor brownfield,+research/audit/bug-report/PRD/RFC/ADRwhen that stance is needed. Nothing is a mandatory station — the complexity of the work summons the artifact; the ephemeral stretch artifacts collapse away after (ADR-0104). Level: convention. -
Drop
/examplesand/advancedfrom the kit. The extended-type shape belongs in the authoring skills (ADR-0042 one skill per authored artifact; ADR-0016 self-contained bodies), not in loose template files; the deep reference lives indocs/. This refines ADR-0064 (drops the advanced tier + the example). Level: convention.
Consequences
- The kit slims to the core loop + the skills; offline self-containment yields to single-sourcing
(the shape ships in the skills; the reference is one fetch to
docs/).docs/examples/keeps the walkthroughs. - Implementation deferred (later plan): each extended-type authoring skill inlines its shape
first, then
/advanced+/examplesare deleted (nothing loses the shape). No change ships with this ADR.
Affected obligations / constraints
Starter kit: Set up a workspace