Decision Roadmap Generator

Reads accumulated raw entries from the knowledge vault and synthesizes them into a narrative decision roadmap — a document organized by decision threads rather than time periods. Each thread tells the story of a key decision: what triggered it, what was explored, what was chosen, what was abandoned, whether those abandonments still make sense, and which decisions were revised or superseded.

Unlike weekly/monthly reports (organized by calendar period) or git history (organized by code changes), the decision roadmap is organized by decision threads — chains of related entries that reveal how a project's thinking evolved.

Workflow

Step 0: Resolve Config and Scope

Resolve the vault path using the standard Lode config resolution. The bundled decision graph helper performs that resolution while building the derived index:

python <this-skill>/scripts/decision_graph.py build --cwd "$PWD"