/decision

What it does

Captures decisions the way software teams capture ADRs (Architecture Decision Records) — one numbered file per decision in decisions/ at the project root, with context, the options that were on the table, the call, and its consequences.

The rules that make the trail trustworthy:

• One decision per record. “Scheme B and the 2022 code edition” is two records.
• Never renumbered, never deleted. Wrong decisions get marked superseded, with a pointer to their replacement — the reasoning trail is the point.
• Options captured honestly. A record with one option is an announcement, not a decision.

Every record is indexed in PROJECT.md. Analysis skills propose a record whenever they surface a real choice — an as-of-right envelope versus a bonus path, a code edition, a GWP threshold.

Install

Claude Desktop:

1. Open Customize → Browse plugins
2. Click + → Add marketplace from GitHub
3. Enter AlpacaLabsLLC/skills-for-architects
4. Install the Project Dossier plugin

Claude Code (terminal):

claude plugin marketplace add AlpacaLabsLLC/skills-for-architects
claude plugin install 09-project-dossier@skills-for-architects

Usage

/decision we're going with the UAP bonus scheme
/decision                          ← interview for a decision in the air
/decision supersede 0003           ← replace an earlier decision, keep the trail
/decision list                     ← index with statuses

Records are plain files — share them the way the project is already shared (git, Drive, Dropbox). Review happens in version control or in conversation.