review-board

name	review-board
description	This skill should be used when the user asks to "review the board", "show the case status", "what's on the board", "show investigation progress", "display the case", or wants to see the current state of their investigation CaseBoard.

Review Board — Display Investigation State

Present the current CaseBoard state in a human-readable format, showing all fragments, threads, hypotheses, and the investigation's overall progress.

Process

1. Load Board State

python $PLUGIN_ROOT/scripts/board.py status .detective/cases/<case-id>.json
python $PLUGIN_ROOT/scripts/scoring.py suggest-phase .detective/cases/<case-id>.json
python $PLUGIN_ROOT/scripts/convergence.py .detective/cases/<case-id>.json

Also read the full case file to access fragment details:

cat .detective/cases/<case-id>.json

2. Present the Board

Display in this structured format:

## Case: <title>
**Phase**: <current phase> | **Actions**: <taken>/<budget> | **Converged**: <yes/no>

### Active Hypotheses (<count>)
| ID | Description | Confidence | Supporting | Contradicting |
|----|-------------|------------|------------|---------------|
| <id> | <content> | <conf>    | <count>    | <count>       |

### Eliminated Hypotheses (<count>)
| ID | Description | Reason |
|----|-------------|--------|
| <id> | <content> | <elimination_reason> |

### Evidence Chain (<count> pieces)
- [Anchor] <content> (source: <source>)
- [Evidence] <content> (source: <source>)
- [Clue] <content> (needs verification)

### Constraints (<count> active)
- <constraint content> → eliminates: <hypothesis ids>

### Key Connections
- <from> --<type>--> <to> (most important threads)

### Investigation Log (last 5 actions)
- Round N: <action description> → <outcome>

3. Provide Assessment

After the board display, add a brief analytical summary:

• What's going well (strong evidence chains)
• What's concerning (unsupported hypotheses, isolated fragments)
• Suggested next step
• Whether a case discussion might be helpful

Graph Export (Optional)

If the user asks for a visual/graph representation:

python $PLUGIN_ROOT/scripts/board.py export-graph .detective/cases/<case-id>.json

This outputs DOT format which can be rendered with Graphviz.

Multiple Cases

If multiple case files exist in .detective/cases/, list them and ask which to review:

ls .detective/cases/*.json

Additional Resources

Scripts

• scripts/board.py — Board status and DOT graph export
• scripts/scoring.py — Phase suggestion
• scripts/convergence.py — Convergence status check