decision-mapping

This skill is invoked when a loose idea requires more than one agent session to turn into a plan. It creates a stateful decision map in a markdown file, and drives the user through a sequence of tickets to resolve the open questions - which may require either prototyping, research or discussion.

Location

Decision maps live at .agent/context/decision-maps/<slug>.md — git-tracked agent config, not repo root. Create .agent/context/decision-maps/ if missing (see /setup-knowledge-vault or /setup-optimal-brain context setup).

The Decision Map

The decision map is a single compact Markdown file, one per planning effort. It is the canonical artifact — the whole map is loaded as context into every session, so it must stay compact.

Assets created during tickets should be linked to from the map, not duplicated within it.

Structure

Numbered entries ("tickets"), each its own section keyed by its number:

## #1: Relational Or Non-Relational Database?