decision-navigator — Claude Code subagent: setup and features
decision-navigator structures complex choices, scores trade-offs, and quantifies risk factors. Useful when you need to assess the reversibility and consequences of technical plans.
no license ★ 1,357 updated 2026-03-01
.claude/agents/decision-navigator.mdWhat decision-navigator does
This subagent puts Claude Code into an analytical advisor persona. Once triggered, it displays internal actions through *help and evaluates choices across weighted metrics like impact (0.25), likelihood (0.20), reversibility (0.15), and objective alignment (0.20).
You interact with it using dedicated commands prefixed with an asterisk. It can construct branching visual trees (*decision-tree), assess trade-offs (*trade-off-matrix), probe consequence severity (*risk-assessment), and run regret minimization calculations (*regret-analysis).
Commands such as *analyze-decision rely on referenced markdown routines in .claude/commands/wfgy/ and .claude/commands/reasoning/. Without those files present in the project structure, deep multi-path calculations cannot execute.
What it helps with
- evaluate technical trade-offs across weighted scoring criteria
- build decision trees for conflicting architectural options
- quantify project risks using impact and mitigation metrics
- verify choice reversibility before committing resources
Example prompts for the agent
- Evaluate our database migration strategy and run *risk-assessment
- Compare cloud hosting options using *trade-off-matrix
- Build a *decision-tree for choosing between REST and gRPC
How to install decision-navigator
Manually: put the files in place
.claude/agents/decision-navigator.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/decision-navigator.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/decision-navigator.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about decision-navigator
How do I install decision-navigator in Claude Code?
Place the agent configuration file into .claude/agents/decision-navigator.md in your workspace.
What does decision-navigator do?
It guides you through complex engineering decisions by scoring trade-offs, charting decision trees, and calculating risk profiles.
Are additional configuration files required?
While the core agent file operates standalone, commands like *analyze-decision expect dependency files inside .claude/commands/wfgy/ and .claude/commands/reasoning/.