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.61x

Quality

66%

Does it follow best practices?

Impact

100%

1.61x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./tests/ext_conformance/artifacts/agents-wshobson/documentation-generation/skills/architecture-decision-records/SKILL.md

Evaluation results

100%

35%

Message Broker Selection for Real-Time Payment Events

Full MADR format ADR

Criteria

Without context

With context

Valid status value

100%

Decision Drivers section

100%

Multiple options with pros/cons

100%

Rationale section

25%

100%

Positive consequences

100%

Negative consequences

100%

Risks with mitigations

100%

Implementation Notes section

62%

100%

Related Decisions section

100%

References section

100%

docs/adr/ placement

100%

NNNN-title-with-dashes.md naming

100%

22%

Documenting the Move Away from Stateful Sessions

ADR supersession workflow

Criteria

Without context

With context

New file, not edit

100%

Supersedes reference in status

100%

Old ADR status updated

100%

Sequential file naming

100%

Migration plan with phases

46%

100%

Considered alternatives

100%

Positive and negative consequences

100%

Context references old approach limitations

100%

Bootstrapping the ADR Process for a New Platform Team

ADR directory structure and index

Criteria

Without context

With context

docs/adr/ directory

100%

README index table columns

100%

template.md present

100%

NNNN-title-with-dashes.md naming

100%

Index links to ADR files

37%

100%

adr-tools commands in setup script

100%

Valid status values in ADRs

100%

New ADR creation instructions

50%

100%

Both decisions documented with trade-offs

100%

README index updated

85%

100%

Repository: Dicklesworthstone/pi_agent_rust
Commit: 47823e3

Evaluated: about 1 month ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Message Broker Selection for Real-Time Payment Events Documenting the Move Away from Stateful Sessions Bootstrapping the ADR Process for a New Platform Team

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.