菜单
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.