skill

record-a-decision

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.

Description as published by the maintainer. Source

• active

active — Most recent push to the repository was 2026-08-06.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Will this work with your setup?

No harness stated by the author and no install path convention detected. Compatibility is untested.

We have not run this skill against a task with and without it enabled, so we cannot tell you whether it improves anything, what it costs in tokens, or whether it duplicates behaviour your harness already has. When we have run that test, the result will appear on this page with the task, the versions and the budget it used.

The skill definition lives at packages/server/assets/skills/packs/software-lifecycle/record-a-decision/SKILL.md in https://github.com/inkeep/open-knowledge.

Where to get it

• Repository — https://github.com/inkeep/open-knowledge

Related, by what their authors tagged them

• inkeep-open-knowledge-codebase-wiki — last commit 2026-08-06, shares 2nd-brain, company-brain, docs
  How to work in a Codebase Wiki project (the `codebase-wiki` starter pack): an agent-authored, source-grounded wiki of t…
• inkeep-open-knowledge-consolidate-notes — last commit 2026-08-06, shares 2nd-brain, company-brain, docs
  Promote existing research into a canonical article under `articles/` in a Knowledge Base project (the `knowledge-base`…
• inkeep-open-knowledge-frame-a-proposal — last commit 2026-08-06, shares 2nd-brain, company-brain, docs
  Frame a new design proposal (RFC-shape) under proposals/ — problem before solution, named beneficiary and observable ch…
• inkeep-open-knowledge-knowledge-base — last commit 2026-08-06, shares 2nd-brain, company-brain, docs
  How to work in a Knowledge Base project (the `knowledge-base` starter pack). Read when the project has the three-layer…
• inkeep-open-knowledge-note-taking — last commit 2026-08-06, shares 2nd-brain, company-brain, docs
  How to work in a Plain Notes project (the `plain-notes` starter pack): a flat notes/ folder plus a daily/ journal. The…
• inkeep-open-knowledge-okf-knowledge-base — last commit 2026-08-06, shares 2nd-brain, company-brain, docs
  How to work in an OKF starter project (the `okf` starter pack): a knowledge base that is conformant with Google's Open…
• inkeep-open-knowledge-open-knowledge — last commit 2026-08-06, shares 2nd-brain, company-brain, docs
  Authoritative agent-runtime contract for working inside an OpenKnowledge project — a markdown-CRDT knowledge base expos…
• inkeep-open-knowledge-open-knowledge-discovery — last commit 2026-08-06, shares 2nd-brain, company-brain, docs
  Read when the user asks what OpenKnowledge is, wants to install it on a repository, wants to open or preview a single m…
• inkeep-open-knowledge-open-knowledge-write-skill — last commit 2026-08-06, shares 2nd-brain, company-brain, docs
  Use when the user wants to create, author, write, or design a new Agent Skill (a SKILL.md) — for OpenKnowledge or for t…
• inkeep-open-knowledge-personal-crm — last commit 2026-08-06, shares 2nd-brain, company-brain, docs
  How to work in a Personal CRM project (the `entity-vault` starter pack, GBrain-compatible): a typed-entity vault of peo…

These share tags the maintainers applied themselves, such as 2nd-brain, company-brain, docs, knowledge-. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

Also from inkeep

• inkeep-open-knowledge-research-with-sources — last commit 2026-08-06
  Investigate a topic against preserved sources and write a provisional research article under `research/` in a Knowledge…
• inkeep-open-knowledge-review-a-design — last commit 2026-08-06
  Reviews whether a design is SOUND — solving the right problem, derived from its stated goals and constraints — and emit…
• inkeep-open-knowledge-software-lifecycle — last commit 2026-08-06
  How to work in a Software Lifecycle project (the `software-lifecycle` starter pack): proposals → decisions → specs → po…
• inkeep-open-knowledge-worldbuilding — last commit 2026-08-06
  How to work in a Worldbuilding project (the `worldbuilding` starter pack): a fiction encyclopedia of characters, settin…
• inkeep-open-knowledge-write-a-postmortem — last commit 2026-08-06
  Write a blameless incident postmortem under postmortems/ following the Google SRE shape — evidence-based timeline, trig…
• inkeep-open-knowledge-write-a-spec — last commit 2026-08-06
  Scope a feature end to end and write an implementation spec under specs/ from an accepted proposal — current-system map…
• inkeep-open-knowledge-writing-workflow — last commit 2026-08-06
  How to work in a Writing Pipeline project (the `writing-pipeline` starter pack): a three-stage drafting flow, ideas → d…

How the author describes it

Topics the maintainer set on GitHub: 2nd-brain, agent-skills, claude, codex, company-brain, docs, knowledge-, knowledge-base, knowledge-management, llm, llm-wiki, llm-wiki-karpathy, markdown, markdown-editor, md, mdx, notes, pkm, second-brain, skills.