القائمة
Generate Architecture Decision Records (ADRs) to document significant architectural decisions. Use when making important technical decisions that need documentation.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Run section orchestrators to coordinate multi-component workflows. Use when starting work on a section.
Validate agent YAML frontmatter and configuration. Use before committing agent changes or in CI.
Reply to PR review comments using the correct GitHub API endpoint. Use when responding to inline code review feedback (not gh pr comment).
Run Mojo tests using mojo test command. Use when executing tests or verifying test coverage.
Track implementation progress against plan. Use to monitor component delivery and identify blockers.
Check agent configuration coverage across hierarchy levels and phases. Use to ensure complete agent system coverage.
| name | doc-generate-adr |
| description | Generate Architecture Decision Records (ADRs) to document significant architectural decisions. Use when making important technical decisions that need documentation. |
| mcp_fallback | none |
| category | doc |
Create Architecture Decision Records for technical decisions.
./scripts/create_adr.sh "Decision Title"
# Creates: docs/adr/ADR-XXX-decision-title.md
All ADRs follow this structure:
# ADR-XXX: Title
**Status**: Proposed | Accepted | Deprecated | Superseded
**Date**: YYYY-MM-DD
**Deciders**: Names/roles
## Context
What is the issue we're facing?
## Decision
What decision are we making?
## Rationale
Why this decision? Key reasons.
## Consequences
### Positive
- Benefit 1
### Negative
- Drawback 1
### Neutral
- Other impact 1
## Alternatives Considered
### Alternative 1
Why not chosen.
docs/adr/
├── ADR-001-language-selection.md
├── ADR-002-testing-strategy.md
└── README.md
| Issue | Fix |
|---|---|
| Missing context | Add background and constraints |
| Unclear decision | Make decision more specific |
| Missing alternatives | Document at least 2 alternatives |
| No consequences | Think through positive and negative impacts |
/docs/adr/ for examplesphase-plan-generate for planning