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.

Install with Tessl CLI

npx tessl i github:Dicklesworthstone/pi_agent_rust --skill architecture-decision-records

What are skills?

Review — 76%

Does it follow best practices?

If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:

npx tessl skill review --optimize ./path/to/skill

Learn more

Validation — 11 / 11 Passed

Validation for skill structure

SKILL.md

Review

Evals

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%

Without context: $0.2690 · 4m 17s · 11 turns · 81 in / 4,707 out tokens

With context: $0.6336 · 7m 40s · 28 turns · 481 in / 7,686 out tokens

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%

56%

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%

Without context: $0.4939 · 5m 49s · 18 turns · 171 in / 8,304 out tokens

With context: $0.7188 · 11m 32s · 22 turns · 194 in / 10,555 out tokens

Evaluated: about 16 hours ago
Agent: Claude Code

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.