القائمة
Record durable architectural decisions in docs/adr with compact context and consequences.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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.