Menu
Create Architecture Decision Records. Activated when the user mentions ADR, architectural decision, or technical trade-off.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Legacy code archaeology — multi-phase discovery that reads the codebase, git history, and optionally Jira to reconstruct WHY code exists. Produces discovery notes, ADR candidates, and PRD candidates for human review. Activated when user says 'descobrir módulo', 'arqueologia de código', 'entender legado', 'contexto do módulo', 'por que esse código', 'legacy context', '/discover', or when starting work on an unfamiliar legacy module.
Legacy code archaeology and context bootstrap. Activated when the user mentions "legacy code", "código legado", "sistema antigo", "código sem documentação", "discover module", "entender módulo", "arqueologia de código", "código que ninguém entende", or runs /discover. Populates the empty upper layers of tiered lookup (memory and docs) before context-engineering techniques can be effective. Read-only for source code: outputs discovery notes, ADR candidates, and suggested intent markers. Remote discovery supports GitHub (via gh CLI) and Azure DevOps (via az CLI plus REST).
Context engineering — proactive context window management. Activated when working on large tasks, long sessions, multi-file changes, or when context is getting bloated. Keywords: "context", "too much code", "split this task", "focus", "scope down", "token budget", "keep it small". Complements the reactive context-guard hook with proactive techniques.
Reconcile a Claude Design handoff bundle (PROMPT.md) with the project's PRD and conventions. Activated when the PRD references a Claude Design handoff, when a PROMPT.md exists in docs/design/, or when the user mentions "Claude Design", "design handoff", or "PROMPT.md".
Pattern learner. Activated when the user says "learn from this", "what patterns", "improve skills", "retrospective", "session review", or wants to extract reusable patterns from recent work to improve the project's skills and conventions.
Long-term memory via vector DB. Activated when the user asks about past decisions, previous solutions, project history, "how did we do X", "last time", "we already solved", or when the agent needs historical context before planning an implementation.
| name | adr |
| description | Create Architecture Decision Records. Activated when the user mentions ADR, architectural decision, or technical trade-off. |
| allowed tools | Read, Write, Glob |
Create in docs/architecture/adr-NNN-title.md:
# ADR-NNN: Decision Title
## Status
Proposed | Accepted | Deprecated | Superseded by ADR-XXX
## Context
What motivated this decision? What problem are we solving?
## Decision
What we decided to do and why.
## Alternatives considered
1. **Alternative A** — pros and cons
2. **Alternative B** — pros and cons
## Consequences
- Positive: ...
- Negative: ...
- Risks: ...
## Impact on specs
[SPEC] List affected specs:
- Compliance: [impact]
- Security: [impact]
- Scalability: [impact]
- [others]
## References
- PRD: `docs/product/xxx.md`
- Design: [link]
ls docs/architecture/)