Use this skill when documenting significant architectural decisions. Provides ADR templates following the Nygard format with sections for context, decision, consequences, and alternatives. Use when writing ADRs, recording decisions, or evaluating options.
Creates structured architecture decision records following the Nygard template to document context, choices, and consequences.
/plugin marketplace add yonatangross/orchestkit/plugin install orkl@orchestkitThis skill inherits all available tools. When active, it can use any tool Claude has access to.
assets/adr-template.mdchecklists/adr-review-checklist.mdexamples/adr-0001-adopt-microservices.mdexamples/adr-0002-choose-postgresql.mdexamples/adr-0003-api-versioning-strategy.mdreferences/adr-best-practices.mdrules/_sections.mdrules/_template.mdrules/interrogation-reliability.mdrules/interrogation-scalability.mdrules/interrogation-security.mdscripts/adr-frontmatter.yamlscripts/adr-manager.pyscripts/create-adr.mdscripts/list-adrs.pyArchitecture Decision Records (ADRs) are lightweight documents that capture important architectural decisions along with their context and consequences. This skill provides templates, examples, and best practices for creating and maintaining ADRs in your projects.
ADRs serve as architectural memory for your team:
Each ADR should follow this structure:
Format: ADR-####: [Decision Title]
Example: ADR-0001: Adopt Microservices Architecture
Current state of the decision:
What to include:
What to include:
Be specific and actionable:
What to include:
Document at least 2 alternatives:
For each alternative, explain:
Links to relevant resources:
Proposed → Accepted → [Implemented] → (Eventually) Superseded/Deprecated
↓
Rejected
Once accepted, don't edit ADRs. Create new ADRs that supersede old ones.
ADRs are historical records written as if the decision is being made now.
ADRs capture decisions, not implementation details.
Get input from relevant stakeholders before accepting.
Use 4-digit zero-padded numbers: ADR-0001, ADR-0002, etc. Maintain a single sequence even with multiple projects.
Keep ADRs in version control alongside code:
/docs/adr/ or /architecture/decisions//create-adr [number] [title] to generate ADR with auto-filled contextassets/adr-template.mdscripts/create-adr.md - Dynamic ADR generator with auto-filled context
/create-adr [number] [title]$ARGUMENTS and !command for dynamic contextassets/adr-template.md - Static template for manual use
| Rule | Impact | What It Covers |
|---|---|---|
| interrogation-scalability | HIGH | Scale questions, data volume, growth projections |
| interrogation-reliability | HIGH | Data patterns, UX impact, coherence validation |
| interrogation-security | HIGH | Access control, tenant isolation, attack surface |
❌ Too Technical: "We'll use Kubernetes with these 50 YAML configs..." ✅ Right Level: "We'll use Kubernetes for container orchestration because..."
❌ Too Vague: "We'll use a better database" ✅ Specific: "We'll use PostgreSQL 15+ for transactional data because..."
❌ No Alternatives: Only documenting the chosen solution ✅ Comparative: Document why alternatives weren't chosen
❌ Missing Consequences: Only listing benefits ✅ Balanced: Honest about costs and trade-offs
❌ No Context: "We decided to use Redis" ✅ Contextual: "Given our 1M+ concurrent users and sub-50ms latency requirement..."
ork:api-design: Use when designing APIs referenced in ADRsork:database-patterns: Use when ADR involves database choicesSkill Version: 2.0.0 Last Updated: 2026-01-08 Maintained by: AI Agent Hub Team
Keywords: adr, architecture decision, decision record, document decision Solves:
Keywords: when to write adr, adr lifecycle, adr workflow, adr process, adr review, quantify impact Solves:
Keywords: tradeoff, pros cons, alternatives, comparison, evaluate options Solves:
Keywords: consequence, impact, risk, benefit, outcome Solves:
Search, retrieve, and install Agent Skills from the prompts.chat registry using MCP tools. Use when the user asks to find skills, browse skill catalogs, install a skill for Claude, or extend Claude's capabilities with reusable AI agent components.
Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use for discovering, retrieving, and improving prompts.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.