Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →levnikolaevich/ln-74-architecture-decision-recorder
Records one architecture decision with context, alternatives, tradeoffs, and consequences.
Passed 4 of 12 test cases with the skill, and 4 of 12 without it.
and 6 more in the full report
6 fixed2 passed either way9 still failing5 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 6 test cases the skill fixed. Same model, same prompt, with and without the skill.
Record an ADR choosing OpenTelemetry for tracing across Python microservices. Express the decision clearly. Structure as: 1) Result, 2) Scope, 3) Evidence, 4) Verification, 5) Completion.
| Checked | Without skill | With skill |
|---|---|---|
| Expresses the decision statement in active testable language | Passed | Passed |
| Sets record status to Proposed | Missed | Passed |
The instructions your model reads when the skill loads.
Goal: Preserve the context, forces, alternatives, decision, and consequences of one architecturally significant choice in a compact durable record. Change only approved decision documentation; do not design the whole system, approve a decision silently, delete history, audit code, or implement the choice.
Execution contract: The ordered checkboxes are the Definition of Done. Track every item internally as PENDING, PROVEN with concrete evidence, CLEARED with evidence that its condition is absent, or UNPROVEN with a gap; reading, delegation, or tool failure is not proof. Reconcile items after each section. Before returning, resolve all PENDING and count only PROVEN and CLEARED; apply the skill's verdict and approval rules to every gap.
Preserve user intent, scope, and existing authorization. Continue authorized work; ask only for consequential unresolved choices or required external approval. Scale depth to material risk without silently skipping checks. Preserve dependency and safety ordering; otherwise choose the verification method appropriate to each obligation.
| Need | Preferred capability | Fallback |
|---|---|---|
| Existing decision convention | Repository search and direct document reads | Use the default path and compact format |
| Decision drivers | Requirements, architecture artifacts, implementation evidence, and stakeholder statements | Mark unsupported drivers UNKNOWN |
| Alternatives and external claims | Repository evidence plus current official sources | Mark time-sensitive claims UNVERIFIED |
| Sequence and supersession | Existing filenames, indexes, and decision links | Return BLOCKED rather than reuse a number |
| Document mutation | Minimal patch to one approved decision record and necessary supersession links | Return BLOCKED if authority or path is unclear |
One record captures one decision. If the request contains independent decisions with different drivers or lifecycles, split them only with explicit approval.
docs/architecture/decisions/NNNN-<slug>.md with the next unused monotonic number.Proposed.Accepted only after explicit confirmation from an authorized decision-maker.Superseded and link both directions only after the replacement is explicitly accepted; preserve historical content.test cases passed, vs 4 / 12 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.