decision-map

Converts loose ideas into git-tracked decision maps of typed investigation tickets resolved one per session.

916|82|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/SethGammon/Citadel --skill decision-map
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: decision-map
Source: https://github.com/SethGammon/Citadel/tree/main/skills/decision-map
Command: npx skills add https://github.com/SethGammon/Citadel --skill decision-map

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fuzzy, half-formed ideas often stall because open questions get lost between sessions or get tackled in the wrong order. This Skill turns a vague idea into a persistent, git-tracked decision map of typed investigation tickets with explicit blocking edges, so planning survives across sessions and each ticket is resolved in a valid order.

Core Features & Use Cases

  • Session-Resumable Planning Maps: Stores the entire planning effort in one Markdown file at .planning/decision-maps/<slug>.md, reloaded whole at the start of every session.
  • Typed Investigation Tickets: Supports Research, Prototype, and Grilling ticket types, each with declared blockers, a question, and an inline resolution recording the decision and its reasoning.
  • Graduation to Buildable Work: Resolved tickets that produce buildable outcomes are graduated into .planning/intake/ items for downstream autopilot or campaign execution.
  • Use Case: You have an idea for a new feature but several unknowns about APIs, UX, and architecture. Bootstrap a decision map, then resolve one ticket per session until every question is answered and the resulting intake items are ready to build.

Quick Start

Ask the agent to create a decision map for your idea, for example: "Plan this out — create a decision map for adding real-time collaboration to the editor."

Frequently Asked Questions about decision-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a vague software idea before building it?▼

Create a decision map: bootstrap a Markdown file listing typed investigation tickets (Research, Prototype, Grilling) with blocking edges, then resolve one ticket per session. Resolved buildable outcomes graduate into intake items for execution.

How do I keep planning context across multiple AI sessions?▼

Store the plan in a single git-tracked Markdown decision map that is reloaded whole at the start of every session. Each ticket records its resolution and reasoning inline, so no context needs to be re-derived.

When should I use a decision map instead of a campaign or TODO list?▼

Use a decision map when work is still being figured out — too fuzzy for a scoped campaign and too big for a single intake item. Once tickets resolve into buildable work, hand them off to intake, autopilot, or a campaign.

What happens if a ticket's blockers are still open?▼

A ticket with open blockers is never resolved. If no frontier ticket is resolvable, the deadlock is reported and a blocking ticket is resolved first, preserving valid dependency ordering.

Can I resolve multiple tickets in one session?▼

No. The protocol enforces exactly one ticket resolved per session, or one map bootstrapped per session. This keeps each decision deliberate and the map's frontier advancing in controlled steps.