Menu
Record durable architectural decisions in docs/adr with compact context and consequences.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Maintain CHANGELOG.md as meaningful merges land. Use after merging a feature branch, before cutting a release, or when asked "what changed?".
Cut a GitHub release by updating changelog, validating release checks, creating a tag, and publishing with gh.
Ship current work through a GitHub pull request using git and gh.
Shared vocabulary for designing deep modules, interfaces, seams, and adapters.
Diagnose hard bugs by building a tight repro loop before changing code.
Maintain Moodle MCP domain language and update CONTEXT.md only when terminology is resolved.
| name | adr |
| description | Record durable architectural decisions in docs/adr with compact context and consequences. |
| metadata | {"author":"mattpocock","version":"1.0.2"} |
Use this when a decision should be remembered because future agents or maintainers would otherwise reopen it.
Write an ADR only when all are true:
Skip ADRs for obvious choices, temporary plans, routine library usage, or decisions already captured in code and context.
docs/adr/.0001-short-slug.md, 0002-short-slug.md.# Short Decision Title
Status: accepted
Context: one or two short paragraphs.
Decision: what we chose.
Consequences: what this makes easier and harder.
Keep it compact. Optional sections are fine only when they add signal.
git diff --check.