architecture-decision-records
Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architect...
75
Quality
65%
Does it follow best practices?
Impact
91%
1.15xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/antigravity-architecture-decision-records/SKILL.mdEvaluation results
100%
13%Establishing ADR Documentation for a New Fintech API Project
ADR directory structure and naming
ADR directory location
100%
100%
File naming convention
100%
100%
README index with table
50%
100%
Template file present
100%
100%
Valid ADR status value
100%
100%
Decision Drivers section
20%
100%
Considered Options with pros and cons
100%
100%
Consequences split into subsections
100%
100%
Context section explains the problem
100%
100%
Related Decisions section
100%
100%
Without context: $0.3034 · 1m 30s · 15 turns · 63 in / 4,597 out tokens
With context: $0.4161 · 1m 46s · 17 turns · 267 in / 5,522 out tokens
100%
14%API Gateway Selection for a Growing Microservices Platform
Comprehensive MADR section coverage
Valid status value
100%
100%
Decision Drivers section
80%
100%
All three options documented
100%
100%
Pros AND cons for Kong
100%
100%
Pros AND cons for rejected options
100%
100%
Rationale section
100%
100%
Consequences: Positive subsection
100%
100%
Consequences: Negative subsection
62%
100%
Consequences: Risks subsection
80%
100%
Implementation Notes section
100%
100%
Related Decisions section
0%
100%
References section
100%
100%
Without context: $0.2229 · 1m 15s · 9 turns · 10 in / 3,684 out tokens
With context: $0.3416 · 1m 40s · 12 turns · 264 in / 4,545 out tokens
75%
10%Updating Authentication Architecture Documentation
ADR lifecycle and supersession
Original ADR not modified
66%
33%
New ADR file created
100%
100%
Supersedes reference in status
0%
100%
Old ADR marked superseded
100%
100%
Lessons Learned section
0%
0%
README index updated
100%
100%
New ADR links to ADR-0008
100%
100%
Valid status value in new ADR
100%
100%
New ADR Context section
100%
100%
New ADR Consequences section
100%
100%
Without context: $0.2739 · 1m 26s · 11 turns · 60 in / 4,387 out tokens
With context: $0.6219 · 2m 12s · 27 turns · 205 in / 6,198 out tokens
- Repository
- boisenoise/skills-collections
- Commit
5c5ae21
- Evaluated
- Agent
- Claude Code
- Model
- Claude Sonnet 4.6
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.