Menu
Use when making or recording significant architectural decisions - capture context, alternatives, and rationale as structured ADRs
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
Debug frontend vanilla JS issues - console errors, rendering bugs, SPA navigation, WebSocket
Automates the process of setting up the first admin user or adding new admins via the bootstrap endpoint. Includes a Python script for easy execution.
Push to remote and wait for CI to pass. If CI fails, read logs, fix bugs, and re-push. Repeat until green.
Use when building or debugging LangGraph multi-agent systems - eval-first execution, task decomposition, model routing by complexity, and cost discipline
Use when AI agent modifies API routes or backend logic - catch systematic blind spots where the same model writes and reviews code
Use when you have a written implementation plan to execute with review checkpoints between tasks
| name | architecture-decision-records |
| description | Use when making or recording significant architectural decisions - capture context, alternatives, and rationale as structured ADRs |
# ADR-NNNN: [Decision Title]
**Date**: YYYY-MM-DD
**Status**: proposed | accepted | deprecated | superseded by ADR-NNNN
## Context
[2-5 sentences: the problem motivating this decision]
## Decision
[1-3 sentences: the choice made]
## Alternatives Considered
### Alternative 1: [Name]
- **Pros**: ...
- **Cons**: ...
- **Why not**: ...
## Consequences
### Positive
- ...
### Negative
- ...
docs/adr/ doesn't exist, ask user before creatingdocs/adr/README.md index| Category | Examples |
|---|---|
| Technology choices | Framework, database, cloud provider |
| Architecture patterns | Monolith vs microservices, event-driven |
| API design | REST vs GraphQL, auth mechanism |
| Data modeling | Schema design, caching strategy |
| Infrastructure | Deployment model, CI/CD pipeline |
| Security | Auth strategy, encryption approach |
| Testing | Test framework, coverage targets |
| Process | Branching strategy, review process |
proposed → accepted → [deprecated | superseded by ADR-NNNN]