# Adr > | - **Type:** Skill - **Install:** `agentstack add skill-crewforth-crewforth-adr` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [crewforth](https://agentstack.voostack.com/s/crewforth) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [crewforth](https://github.com/crewforth) - **Source:** https://github.com/crewforth/crewforth/tree/main/kit/skills/adr - **Website:** https://crewforth.com/ ## Install ```sh agentstack add skill-crewforth-crewforth-adr ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Architecture Decision Record (ADR) Trigger phrases: "adr", "architecture decision", "decision record", "why this approach", "why we chose", "why we went with", "nobody remembers why", "why we picked" ## When On an architecture/technology choice that is expensive to reverse, long-lived, or contested (database selection, auth strategy, critical pattern). Small/reversible decisions do not require an ADR. **Most of these are never announced as decisions, and that is how they get missed.** The examples above all sound like a question someone asked — "Redis or Postgres?" — so they are easy to recognise. The ones that actually escape arrive inside ordinary build work: you are asked to add a feature, and along the way you settle what an entity owns, what a session is bound to, what makes a row unique, which layer holds a rule. Nobody said "decide"; you decided anyway, and the next person inherits it with no idea it was a choice. Measured in the field: one infrastructure task settled four such questions and produced no record of any of them, in a session where this skill was installed and its trigger read every turn. So the test is not "was I asked to choose". It is: **would a maintainer six months from now, wanting to do this differently, need to know why it is this way?** If yes, it is an ADR, however undramatic it felt while writing it. Cheap tell: you rejected an alternative in your head and moved on without writing it down. ## On a team, the record ALSO goes on the board `docs/` is gitignored in an install, so an ADR written there reaches the machine that wrote it and nobody else — which is the opposite of what a decision record is for. When a `teamboard` exists, record it with `board.sh decide "" ""` as well: the board is shared, so it arrives at every teammate's next session opening, and it travels even when the board lives in its own repository. The local file stays the long form; the board entry is the part that has to reach people, so it must be readable on its own — a title nobody can act on ("auth decided") is not a record. ## Format (docs/adr/NNNN-short-title.md, ~1 page) ``` # NNNN. Status: proposed | accepted | rejected | superseded (by NNNN) ## Context Which problem/constraint requires this decision? ## Decision What was decided (clear, one sentence + rationale)? ## Consequences Pros / cons / accepted trade-offs. ## Alternatives considered Why were they not chosen? ``` ## Principles - **Invariant:** a new decision marks the old ADR as `superseded`; an ADR is **never deleted** (decision history is preserved). - Numbered and dated; keep it short. ## Deliberately bypassing a rule is a decision too A gate the user knowingly overrode — a deferred DoD item, an accepted known gap, a trimmed scope — belongs here whenever its effect outlives the task. It is not a lesser kind of decision: choosing *not* to apply a rule shapes the codebase exactly as choosing a database does, and it is the one class of decision that leaves no trace in the code at all. Six months on, a rule that was weighed and overridden is indistinguishable from one that was never noticed, and the second is the one you would want to fix. Record it in the same file as any other decision, with the fields that make it reversible: ``` ## Bypassed - — why: — asked by: — revisit: ``` `revisit` is the load-bearing field. A bypass with no condition attached is permanent by default, and nobody chose permanence. See [[confidence-check]], which is where most bypasses surface. ## DoD - Decision + rationale + rejected alternatives recorded; status current. - Any deliberately bypassed rule is recorded with its reason, who asked, and what would reverse it. ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [crewforth](https://github.com/crewforth) - **Source:** [crewforth/crewforth](https://github.com/crewforth/crewforth) - **License:** MIT - **Homepage:** https://crewforth.com/ Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-crewforth-crewforth-adr - Seller: https://agentstack.voostack.com/s/crewforth - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.