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 architectural choices, or establishing decision processes.

1.45x

Quality

65%

Does it follow best practices?

Impact

99%

1.45x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/documentation-generation/skills/architecture-decision-records/SKILL.md

Evaluation results

100%

28%

Set Up Architecture Decision Records for a New Platform

ADR infrastructure setup and standard ADR authoring

Criteria

Without context

With context

Correct directory location

100%

File naming convention

100%

README index present

100%

README index table

100%

README creating instructions

100%

README status definitions

100%

Template file present

100%

ADR status field

100%

Decision Drivers section

62%

100%

Multiple options with pros/cons

100%

Rationale section

100%

Honest negative consequences

100%

adr-tools usage

30%

100%

99%

33%

Propose an Event Sourcing Architecture for Order Management

RFC-style ADR for complex proposals

Criteria

Without context

With context

Summary section

100%

Motivation section

100%

Specific motivation items

100%

Detailed Design section

83%

100%

Drawbacks section

62%

87%

Substantive drawbacks

75%

100%

Alternatives section

100%

Unresolved Questions as checklist

12%

100%

Implementation Plan section

91%

100%

References section

100%

98%

30%

Supersede an Outdated Infrastructure Decision

ADR deprecation and supersession workflow

Criteria

Without context

With context

Original ADR not modified

100%

83%

New ADR created

100%

New ADR file naming

100%

Supersedes status format

33%

100%

Migration Plan present

100%

Lessons Learned section

100%

Negative consequences included

100%

Old ADR status updated

100%

README index updated

100%

Context references original ADR

100%

Repository: wshobson/agents
Commit: 91fe43e

Evaluated: 27 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Set Up Architecture Decision Records for a New Platform Propose an Event Sourcing Architecture for Order Management Supersede an Outdated Infrastructure Decision

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.