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.