CE ADR Author
Use this skill for any architectural record work in
docs/improvement/adrs/.
Core assets
assets/adr_template.md- canonical ADR template (copy this first).docs/improvement/adrs/- authoritative ADR directory.docs/improvement/RELEASE_PLAN_v1.md- roadmap entry that must stay aligned.
Workflow
- Determine whether this is a new ADR or an update to an existing ADR.
- For new ADRs, calculate the next ADR number:
Get-ChildItem docs/improvement/adrs/ADR-*.md |
ForEach-Object { [int]($_.Name -replace 'ADR-(\d+).*','$1') } |
Measure-Object -Maximum | Select-Object -ExpandProperty Maximum
- Copy the template asset to the target file:
Copy-Item .claude/skills/ce-adr-author/assets/adr_template.md `
docs/improvement/adrs/ADR-<NNN>-<kebab-slug>.md
- Fill every required field and section in the template. Keep language
normative when needed (
MUST,MUST NOT,SHOULD). - Add/validate
Related:ADR links and update references to superseded ADRs. - If the decision changes implementation sequencing, add a one-line summary in
docs/improvement/RELEASE_PLAN_v1.mdunder ADR roadmap summary. - If status changes to
Superseded, rename the replaced ADR withsupersededprefix and setSuperseded-by.
Status lifecycle
| Status | Meaning |
|---|---|
Draft |
Under review; not yet binding |
Accepted |
Binding and enforceable |
Accepted (scoped) |
Binding only for explicit scope |
Deprecated |
Visible but replaced guidance exists |
Superseded |
Replaced by newer ADR |
Required quality checks
- Filename uses
ADR-<NNN>-<kebab-slug>.md. - Template sections are complete (Context, Decision, Alternatives, Consequences, Adoption, Open Questions).
- At least two alternatives are documented with rejection rationale.
- Decision text states enforceable constraints clearly.
Related:entries point to real ADR files.- Release-plan linkage is updated when applicable.
Output contract
Return:
- ADR file path and status.
- Summary of decision and alternatives.
- Any companion updates made to
RELEASE_PLAN_v1.md.