Document-before-shipping (standards & frameworks)

Document-before-shipping (standards & frameworks)

For standards, conventions, and framework deliverables: write the spec, acceptance criteria, and definition of done first; implement second. Product delivery to clients still ships fast — this rule is specific to factory infrastructure work.

Concrete applications

  • MET-0008 (Macroscope rendering templates) — spec written before code; skill /toolkit:framework-publish is extracted from the pattern only after gabarits are validated. Anti-drift mechanism. TFD-0022 Rationale
  • Toolkit-catalog bundle (RD-0031) — spike-first gate; one low-stakes talent before broad retrofit. Measure install friction before committing. TFD-0021 Actions §2
  • EA catalog lifecycle — CSV stays the editable surface through the validation gate; D1 upload happens only after validation. TFD-0019 Lifecycle

Why

Drives clarity before commitment, prevents premature skill extraction (simplicity first, agent execution rule #2), and lets the factory measure something before scaling it.

Linked