# Decision

> Record a durable decision with context, options, rationale, consequences, and a future review trigger. Use when the user asks to document a choice that has actually been made; do not trigger for an unresolved question.

- Skill: `aylee/decision` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add aylee/decision`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aylee/decision/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aylee (https://skillmd.com/u/aylee)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aylee/decision

---


# Decision

1. Read the owner binder, active workstream, related artifacts, and `library/templates/decision.md`.
2. Distinguish a real decision from an unresolved question. If the decision has not been made, capture it in the workstream instead of fabricating an outcome.
3. Record context, decision, considered alternatives, rationale, consequences, reversibility, owner, and revisit trigger.
4. Store project-specific decisions in the binder. Store truly cross-project, durable decisions in `memory/decisions/`. Link rather than duplicate.
5. Link the decision from the workstream artifact index when it affects active work. Do not create a receipt for the decision document.

If linking the artifact changes the workstream, follow the state protocol and
create a receipt only for that workstream revision transition.

Use the date of the actual decision. Separate evidence from inference and do not retrofit certainty.

