New skill: adr — codify cad's ADR template + productive-tensions pattern #9

Open
opened 2026-07-25 20:46:37 +00:00 by mathias · 0 comments
Owner

cad (docs/adr/000X-*.md) hand-rolls a solid ADR template that's never been codified as a reusable skill: frontmatter (adr/title/status/date/deciders/supersedes) + Status/Context/Decision/Consequences/Validation sections. Codify it generically here.

Fold in architecture/preserving-productive-tensions (from obra/superpowers-skills, not yet vendored): don't force premature resolution on genuinely context-dependent tradeoffs — document as Option A/B + preservation strategy + resolution trigger. cad already does this informally (ADR-0001's "Known refinements, deliberately not built yet" section — 3-class sovereignty deferred, taskqueue reuse deferred) — this formalizes it as the discipline for the Consequences section.

Part of moving cad's requirements/architecture workflow off gsd-* onto bespoke skills (research verdict: gsd-*/spec-kit/BMAD/Kiro are all upstream-only spec authoring, no runtime audit — orthogonal to this gap, not a replacement for it).

cad (`docs/adr/000X-*.md`) hand-rolls a solid ADR template that's never been codified as a reusable skill: frontmatter (adr/title/status/date/deciders/supersedes) + Status/Context/Decision/Consequences/Validation sections. Codify it generically here. Fold in `architecture/preserving-productive-tensions` (from obra/superpowers-skills, not yet vendored): don't force premature resolution on genuinely context-dependent tradeoffs — document as Option A/B + preservation strategy + resolution trigger. cad already does this informally (ADR-0001's "Known refinements, deliberately not built yet" section — 3-class sovereignty deferred, taskqueue reuse deferred) — this formalizes it as the discipline for the Consequences section. Part of moving cad's requirements/architecture workflow off gsd-* onto bespoke skills (research verdict: gsd-*/spec-kit/BMAD/Kiro are all upstream-only spec authoring, no runtime audit — orthogonal to this gap, not a replacement for it).
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mathias/skills#9