vvkmnn Claude Augur
Surface plan reasoning as scannable inline abstracts. Decisions, risks, discoveries, recommendations — visible at a glance.
When to Use
- After writing or editing a plan file
- When the user asks to explain or summarize a plan
- When the user asks "why did you choose this approach?"
- After plan mode exits with a new or updated plan
Quick Reference
| Tool | Purpose |
|---|---|
augur_explain |
Extract plan structure and return a template for inline rendering |
Workflow
- Write or edit a plan file
augur_explain(plan_path: "/path/to/plan.md")- MCP returns a one-line summary + template with
[FILL]markers - Render the filled template inline in your response (not in a code block)
- Discuss your recommendations and questions with the user
Template Format
MCP pre-renders the header band (title + progress bar) and purpose. You fill 6 sections:
- Decisions —
✓ chose X → reason/~ uncertain/? risky guess - Risks —
⚠ If X → Yplain English sentences - Discoveries —
★ things found during exploration not in the plan - Questions —
◆ questions the user needs to answer - Trade-offs — 3-column:
+ gain │ − lose │ · skip - Recommendations —
→ investigate, weak spots, quick wins, plan gaps
Rules
- 80 chars wide, ~25 lines total
- Minimal words — plain English a child could read
- Be ADVERSARIAL — surface doubts, not confidence
- After rendering: discuss recommendations and questions as a conversation
- Render inline, never in a code block
Common Mistakes
| Mistake | Fix |
|---|---|
| Rendering in a code block | Include the template directly in your response text |
| Restating the plan | Surface what ISN'T in the plan |
| Silent rendering | Discuss recommendations and questions with the user after |
| Verbose text | One short line per item, minimal words |