Adr Drafter

Draft a new ExStruct ADR or propose an update to an existing ADR from an issue, PR, diff, tests, and specs. Use when an ADR is required or recommended and you need a structured draft with context, decision, consequences, and evidence.

harumiWeb cbc7b29 2 files · 1.5 KB Updated

File contents

ADR Drafter

Draft a policy record, not an implementation memo.

Read

  1. dev-docs/agents/adr-governance.md
  2. dev-docs/agents/adr-criteria.md
  3. dev-docs/agents/adr-workflow.md
  4. dev-docs/adr/template.md
  5. Related ADRs under dev-docs/adr/

Workflow

  1. Confirm whether the target is a new ADR or an update to an existing ADR.
  2. Read the issue, diff, relevant specs, tests, and implementation files.
  3. Extract:
    • policy-level context
    • chosen decision
    • positive and negative consequences
    • concrete evidence from tests, code, and related specs
  4. Produce one of these outputs:
    • a new ADR draft
    • an update proposal for an existing ADR
    • ADR not needed with rationale

Draft Rules

  • Keep why in the ADR and leave detailed how in code or specs.
  • Fill Tests, Code, and Related specs whenever possible.
  • If the policy replaces an old one, state the supersede relation explicitly.
  • If evidence is missing, say so instead of inventing support.

harumiWeb/exstruct/tree/main/.agents/skills/adr-drafter commit cbc7b298c7

Frequently asked questions

npx skillmds@latest add harumiweb/adr-drafter