Skip to main content

bm-decide

Capture a durable engineering decision in Basic Memory with rationale, alternatives, consequences, and affected work.

Source facts

Repository
basicmachines-co/basic-memory
Last source activity
July 24, 2026 at 05:02
Detected SKILL.md language
English
Stars
4,391
Forks
343

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
3 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
bm-decide
description
Capture a durable engineering decision in Basic Memory with rationale, alternatives, consequences, and affected work.
# Capture A Decision Use this when the user makes or asks to record a durable choice. A decision is a choice with rationale and consequences, not a casual preference. ## Steps 1. Resolve `~/.codex/basic-memory.json`, then the nearest project `.codex/basic-memory.json`; project keys override user keys: - write to `primaryProject` when set - follow `placementConventions` for the directory when they are specific - otherwise use `codex/decisions` Apply the `bm-writing` skill before drafting the note. 2. Clarify only if the choice itself is ambiguous. Do not ask for every field if the conversation already contains the rationale. 3. Write a `type: decision` note: - `status: open` unless the user says it is accepted, superseded, or rejected - `decided: <ISO timestamp when known>` - `project: <primaryProject if known>` 4. Include: - the decision - context - rationale - alternatives considered - consequences - affected files, specs, issues, PRs, or notes 5. Confirm with the permalink. If this supersedes an older decision, update the old note or link it as `supersedes`.
View on GitHub