Agent skill · Security

ln-74-architecture-decision-recorder

Records one architecture decision with context, alternatives, tradeoffs, and consequences. Use for a significant choice; not for broad design, audit, or implementation.

levnikolaevichgithub.com/levnikolaevichGitHub ↗
claude-codecodexMIT
Install
npx skills add levnikolaevich/claude-code-skills --skill ln-74-architecture-decision-recorder --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 6 KB
Bundled scripts: none
Path: plugins/architecture-suite/skills/ln-74-architecture-decision-recorder/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 528
Language: HTML

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Architecture Decision Recorder **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:** Treat the ordered checkbox workflow below as this skill's Definition of Done. Work through every item in order, and mark it complete only when its action and required evidence are complete. `N/A`, skipped, unavailable, or delegated items remain incomplete. Before returning, apply this skill's verdict and approval rules to every incomplete item and prepend **Checklist: X/Y complete**<br>**Incomplete: None | section/item — reason; outcome impact; exact next action**; list every incomplete item. ## Tool Routing | 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 `U

What's inside
Steps it walks through
  1. Tool Routing
  2. Artifact Rules
  3. Checklist
  4. 1. Establish the Decision Contract
  5. 2. Gather Context and Forces
  6. 3. Evaluate Alternatives
  7. 4. Record the Decision
  8. 5. Validate and Report
  9. Output Contract
More from claude-code-skills
All skills →
About this skill
What does the ln-74-architecture-decision-recorder skill do?

Records one architecture decision with context, alternatives, tradeoffs, and consequences. Use for a significant choice; not for broad design, audit, or implementation.

How do I install it?

Run `npx skills add levnikolaevich/claude-code-skills --skill ln-74-architecture-decision-recorder --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From levnikolaevich/claude-code-skills, a repository with 528 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going