Menú
Record durable architectural decisions in docs/adr with compact context and consequences.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
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.