Capture a decision with context, options, and rationale for future reference
This skill helps you document decisions while context is fresh. Decisions are hard to reconstruct later — this captures the reasoning so future-you (and your team) can understand why.
Read the config file to find the vault location:
~/.config/engineering-os/config — parse VAULT_PATH=... and
ENGINEERING_OS_MODE=...%APPDATA%\engineering-os\config.ps1 — parse $env:VAULT_PATH and
$env:ENGINEERING_OS_MODEAll file references in this skill use $VAULT_PATH as the base directory.
If the config file does not exist, tell the user: "Engineering OS is not set up.
Run setup.sh (or setup.ps1 on Windows) from the plugin directory first."
Read the following files for context:
$VAULT_PATH/decisions/decision_log.md (if it exists) to see format and recent decisions$VAULT_PATH/goals/90_day.md for current priorities$VAULT_PATH/memory.md for decision patterns and anti-patternsAsk me the following questions one at a time, wait for my response, then move to the next:
After I answer, do two things:
If $VAULT_PATH/decisions/decision_log.md doesn't exist, create it with a header. Then
append the new entry:
### [Decision Title]
**Date:** YYYY-MM-DD
**Type:** [One-way door / Two-way door]
**Status:** [Decided / Pending input]
**Context:** [Brief situation description]
**Options considered:**
1. [Option A] — [pros/cons in one line]
2. [Option B] — [pros/cons in one line]
3. [Option C] — [if applicable]
**Decision:** [What was chosen]
**Rationale:** [Why — the deciding factor]
**Trade-offs accepted:** [What you're giving up or risking]
**Review by:** [Date to revisit, if applicable]
---
If the decision is architectural, org-structural, or will be hard to reverse, ask:
This seems significant enough for a standalone ADR. Want me to create one at
$VAULT_PATH/decisions/YYYY-MM-DD-[slug].md?
If yes, create it using this format:
# ADR: [Decision Title]
**Date:** YYYY-MM-DD
**Status:** Accepted
**Deciders:** [Who was involved]
## Context
[What prompted this decision — the problem or opportunity]
## Decision
[What we decided to do]
## Options Considered
### Option 1: [Name]
- **Pros:** [...]
- **Cons:** [...]
### Option 2: [Name]
- **Pros:** [...]
- **Cons:** [...]
## Consequences
[What follows from this decision — both positive and negative]
## Review Date
[When to revisit this decision, if applicable]
After logging: