Claude Code Skills·Claude Skills·The open SKILL.md registry for Claude
ClaudSkills / Engineering / architecture

open-knowledge-pack-software-lifecycle-record-a-decision

Category: Engineering  ·  Sub-category: architecture  ·  Last updated:
Records an architecture decision as a Nygard/MADR-shaped ADR under decisions/ — capturing the context that forced the choice, the options weighed, the decision itself, and its consequences in both directions, plus the supersedes chain that keeps a decision log honest. Read when asked to record an architecture decision, write an ADR, log the decision we made, document why we chose X over Y, capture this decision for the record, or supersede an old decision with a new one. Do NOT read to frame a proposal or explore an idea not yet decided (frame-a-proposal), to write a spec or implementation plan (write-a-spec), to write an incident postmortem (write-a-postmortem), or to judge whether a design is sound (review-a-design). This skill records a decision already made; it does not make one.
Security AStatic scan found no risk patternsHow grading works ›

From the source SKILL.md

The platform open-knowledge skill still governs every markdown operation here (grounding, linking, the rule that OK's MCP tools own in-scope markdown); this skill layers ADR craft on top.

What this skill does

open-knowledge-pack-software-lifecycle-record-a-decision is a community-contributed Claude Code skill in the architecture sub-category. It ships as a SKILL.md file that Claude Code auto-discovers under ~/.claude/skills/record-a-decision/ and loads when your prompt matches the skill's trigger.

Who uses this skill

The open-knowledge-pack-software-lifecycle-record-a-decision Claude Code skill is built for software engineers, backend developers, full-stack teams, and technical leads building and maintaining production systems. It's part of ClaudSkills (also referred to as Claude Skills or Claude Code Skills) — the open community-curated registry of 169,000+ SKILL.md files for Anthropic's Claude Code agent and the wider Claude ecosystem (Claude API, Claude Agent SDK).

How to install

Free

Manual install (2 steps)

mkdir -p ~/.claude/skills/record-a-decision
curl -L https://claudskills.com/skills/record-a-decision/SKILL.md \
  -o ~/.claude/skills/record-a-decision/SKILL.md

Or just download SKILL.md directly and drop it into ~/.claude/skills/record-a-decision/. Claude Code auto-discovers it on next session.

Skills live at ~/.claude/skills/record-a-decision/SKILL.md on macOS/Linux, or %USERPROFILE%\.claude\skills\record-a-decision\SKILL.md on Windows. See the full install guide for step-by-step instructions.

Telegram

📱 Install from your phone or desktop Telegram

Open @claudskills_bot on Telegram, tap Open Desktop App, and the desktop app installs this skill for you. Or share the bot link with a colleague — they get the same one-tap install. Learn more →

Pro

One-click install via the desktop app

The ClaudSkills desktop app installs any skill directly into ~/.claude/skills/ with one click — no terminal required. Pro starts at $9/mo or $149 lifetime.

Pro

For the full experience including quality scoring and one-click install features for each skill — upgrade to Pro.

Frequently asked questions

How do I install the open-knowledge-pack-software-lifecycle-record-a-decision Claude Code skill?
Install via the ClaudSkills desktop app (one click) or copy SKILL.md from the source repository to ~/.claude/skills/record-a-decision/SKILL.md and restart Claude Code. Both flows are detailed at claudskills.com/install/.
What does the open-knowledge-pack-software-lifecycle-record-a-decision skill do?
Records an architecture decision as a Nygard/MADR-shaped ADR under decisions/ — capturing the context that forced the choice, the options weighed, the decision itself, and its consequences in both directions, plus the supersedes chain that keeps a decision log honest. Read when asked to record an architecture decision, write an ADR, log the decision we made, document why we chose X over Y, capture this decision for the record, or supersede an old decision with a new one. Do NOT read to frame a proposal or explore an idea not yet decided (frame-a-proposal), to write a spec or implementation plan (write-a-spec), to write an incident postmortem (write-a-postmortem), or to judge whether a design is sound (review-a-design). This skill records a decision already made; it does not make one.
Is this skill free to install?
Yes. ClaudSkills is an open registry — every skill keeps its source repository's license, and manual install via copy is free. ClaudSkills Pro ($9/mo, $79/yr, or $149 one-time) adds one-click install via the desktop app and a multi-signal Quality Score.
When should I use the open-knowledge-pack-software-lifecycle-record-a-decision skill?
Use open-knowledge-pack-software-lifecycle-record-a-decision when your Claude Code task falls under the Engineering category — specifically in the architecture area. Claude Code auto-discovers installed skills and invokes the right one based on the task description, so you can also ask Claude directly (e.g. "use open-knowledge-pack-software-lifecycle-record-a-decision" or describe the task and let Claude pick). Browse related skills at /category/engineering/.
What is a Claude Code skill and how does the open-knowledge-pack-software-lifecycle-record-a-decision skill fit in?
A Claude Code skill is a SKILL.md file that lives under ~/.claude/skills/<name>/ and tells the Claude Code CLI agent how to perform a specific task (instructions, prompts, allowed tools). Skills are auto-discovered at session start. open-knowledge-pack-software-lifecycle-record-a-decision is one of 67,000+ skills indexed in the open ClaudSkills catalog, classified under the Engineering category. Learn more at /learn/what-is-a-claude-skill/.

Attribution & license

Cite this skill

If you reference this skill in a blog post, paper, or documentation, you can cite it as:

APA
inkeep. (2026). open-knowledge-pack-software-lifecycle-record-a-decision [Claude Code skill]. ClaudSkills. https://claudskills.com/skills/record-a-decision/
BibTeX
@misc{record-a-decision-2026,
  author    = {inkeep},
  title     = {open-knowledge-pack-software-lifecycle-record-a-decision [Claude Code skill]},
  year      = {2026},
  publisher = {ClaudSkills},
  url       = {https://claudskills.com/skills/record-a-decision/}
}

Embed this skill

Promote, attribute, or link this skill from your own README, blog post, or documentation. All three snippets are free to use — no sign-up, no API key. More distribution surfaces →

Badge
[![ClaudSkills](https://claudskills.com/badge/record-a-decision.svg)](https://claudskills.com/skills/record-a-decision/?utm_source=badge&utm_medium=readme&utm_campaign=skill_badge)
<script>
<script src="https://claudskills.com/embed/record-a-decision.js" async></script>
<iframe>
<iframe src="https://claudskills.com/embed/record-a-decision.html" width="100%" height="160" frameborder="0" loading="lazy" title="ClaudSkills: open-knowledge-pack-software-lifecycle-record-a-decision"></iframe>

Security scan

Grade A · scanned 2026-08-01 — free static scan against the OWASP Agentic Skills Top 10.

The scan flagged 1 of 10 categories (execution), including lower-severity patterns. Patterns shown inside code fences are weighted as examples rather than instructions — read the grading methodology for what this does and does not guarantee.

Show this grade on your repo (click to copy):

[![Security: A](https://img.shields.io/badge/Security-A-2e7d32)](https://claudskills.com/skills/record-a-decision/#security)

Free. No spam. Unsubscribe in one click.

More Engineering skills

Browse all Engineering skills in the ClaudSkills registry, or explore these other picks from the same category:

Browse all Engineering skills → Top 100 skills
Part of ClaudSkills — the open registry for Claude Skills & Claude Code Skills.  ·  What's New  ·  Install guide  ·  About  ·  llms.txt

Part of Acreator Store — Adam Lankamer's AI tools: PerfectStudio · Ucaption · UTagger · AutoXPoster · TestYourSkills · AutomationFlows · Au Naturel · Telegram @acreatorstore