Menü
Record durable architectural decisions in docs/adr with compact context and consequences.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| 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.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.