Architecture Decision Records
This gives Claude templates and patterns for writing Architecture Decision Records, those critical documents that explain why you chose PostgreSQL over MongoDB or decided to adopt TypeScript. You get four template styles ranging from comprehensive MADR format (with sections for context, options, consequences) to lightweight Y-statements, plus specific guidance on when decisions warrant an ADR versus when they don't. The templates are thorough, maybe even verbose, but that's the point. ADRs live forever in your codebase and save future developers from archaeological guesswork. Good for teams that want to stop having the same architectural debates every six months because nobody remembers why things are the way they are.
- skills.sh installs
- 749
- GitHub stars
- 43.1K
- last updated
- Jul 14, 2026
Install
$ npx -y skills add sickn33/antigravity-awesome-skills --skill architecture-decision-records --agent claude-codeInstalls into .claude/skills of the current project.
Files
Architecture Decision Records
Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.
Use this skill when
- Making significant architectural decisions
- Documenting technology choices
- Recording design trade-offs
- Onboarding new team members
- Reviewing historical decisions
- Establishing decision-making processes
Do not use this skill when
- You only need to document small implementation details
- The change is a minor patch or routine maintenance
- There is no architectural decision to capture
Instructions
- Capture the decision context, constraints, and drivers.
- Document considered options with tradeoffs.
- Record the decision, rationale, and consequences.
- Link related ADRs and update status over time.
Core Concepts
1. What is an ADR?
An Architecture Decision Record captures:
- Context: Why we needed to make a decision
- Decision: What we decided
- Consequences: What happens as a result
2. When to Write an ADR
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/sickn33/antigravity-awesome-skills
- Categories
- Code Review & Quality, Productivity & Planning
- First seen
- May 16, 2026
More from sickn33/antigravity-awesome-skills
All 708- Deployment Procedures749
- Notion Template Business749
- Antigravity Workflows748
- Nanobanana Ppt Skills748
- Python Pro747
- Wordpress Penetration Testing744
- Performance Engineer743
- File Uploads740
- Rag Implementation739
- Content Marketer737
- Marketing Psychology737
- Stitch Ui Design737
- Ab Test Setup736
- Frontend Security Coder735
- Writing Plans735
- Reverse Engineer732
- Canvas Design730
- Kaizen728
- Prompt Library727
- Parallel Agents726
- Zapier Make Patterns713
- Web Security Testing709
- Algorithmic Art707
- Address Github Comments705
Recommended
More Code Review & Quality
adr-reviewruvnet/rufloReview code changes against accepted ADRs for compliance violations745skills.sh installs
gcp-cloud-architectalirezarezvani/claude-skillsDesign GCP architectures for startups and enterprises. Use when asked to design Google Cloud infrastructure, deploy to GKE or Cloud Run, configure BigQuery pipe732skills.sh installs
frontend-architecturemanutej/luxor-claude-marketplaceComponent architecture, design patterns, state management strategies, module systems, build tools, and scalable application structure728skills.sh installs
medical-imaging-reviewluwill/research-skillsUse when the user asks to plan, conduct, document, synthesize, or draft a medical imaging AI narrative review or method survey, scoping review, or systematic re695skills.sh installs
react-component-architectureaj-geddes/useful-ai-promptsDesign scalable React components using functional components, hooks, composition patterns, and TypeScript. Use when building reusable component libraries and ma683skills.sh installs
build-review-interfacehamelsmu/evals-skillsBuild a custom browser-based annotation interface tailored to your data for reviewing LLM traces and collecting structured feedback. Use when you need to build 647skills.sh installs