architecture-decision-records
Document significant technical decisions with structured context, rationale, and consequences.
What it does
- Making significant architectural decisions
- Documenting technology choices
- Recording design trade-offs
- Onboarding new team members
- Reviewing historical decisions
- Establishing decision-making processes
- Context: Why we needed to make a decision
Requirements & configuration
- We need to select a primary database for our new e-commerce platform. The system
- The team has experience with MySQL, PostgreSQL, and MongoDB. We need ACID
- Cons: Weaker JSON support, no built-in full-text search (need
- team has limited experience, requires schema design discipline
- Need to learn PostgreSQL-specific features (JSONB, full-text search syntax)
Configuration: NNNN
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
Document significant technical decisions with structured context, rationale, and consequences.
Source
Repository: https://github.com/wshobson/agents
architecture-decision-records FAQ
What does the architecture-decision-records skill do?
Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes. Making significant architectural decisions Documenting technology choices
What does architecture-decision-records require?
We need to select a primary database for our new e-commerce platform. The system The team has experience with MySQL, PostgreSQL, and MongoDB. We need ACID Cons: Weaker JSON support, no built-in full-text search (need team has limited experience, requires schema design discipline Need to learn PostgreSQL-specific features (JSONB, full-text search syntax) Configuration keys: NNNN.
How do I install architecture-decision-records?
Run: npx -y skills add https://github.com/wshobson/agents --skill architecture-decision-records --agent claude-code — the source lives at github.com/wshobson/agents.
Maintain architecture-decision-records?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[](https://getagentictools.com/skills/wshobson-agents-architecture-decision-records?ref=badge) npx agentictools info skills/wshobson-agents-architecture-decision-records The second line is the CLI lookup for this page — handy in READMEs and docs.
Related skills
seedance2-api End-to-end AI video generation from storyboard concept to final output.
python-project-structure python project structure
plugin structure plugin structure
plugin settings plugin settings
search Web search with LLM-optimized results, relevance scoring, and flexible filtering.
gdpr-data-handling GDPR-compliant data handling with consent management, data subject rights, and privacy controls.