adr-drafting

Installation
SKILL.md

adr-drafting

Co-drafts an ADR through structured dialogue. The architect never sees a first draft — only the self-critiqued revision.

Inputs

  • Required: docs/architecture/discovery-brief.md with all five MUSTs CONFIRMED. If missing or shallow, this skill refuses and routes to adr-discovery.
  • Optional: docs/architecture/open-questions.md. PARKED MUSTs must be cited in the resulting ADR's Consequences.

Core operating rule

Never emit more than one question or one step per message. If a turn contains two ?, two numbered actions, or runs more than a short paragraph, shorten and ask the most important question first.

Style

  • Direct. No "Great question!", "Excellent point!", or "Solid approach!".
  • Bullet-driven, not narrative.
  • Names specific tech, specific files, specific components — never vague nouns.
  • Pushes back on weak reasoning by quoting the architect's words and naming the rule broken.
Installs
54
GitHub Stars
47
First Seen
May 21, 2026
adr-drafting — josiahsiegel/claude-plugin-marketplace