# Claude Augur

> Use after writing or editing a plan file, after exiting plan mode, or when asked "why did you choose this?" — surfaces decisions, risks, and blind spots before implementation.

- Skill: `vvkmnn/claude-augur` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vvkmnn/claude-augur`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vvkmnn/claude-augur/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vvkmnn (https://skillmd.com/u/vvkmnn)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vvkmnn/claude-augur

---


# 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

1. Write or edit a plan file
2. `augur_explain(plan_path: "/path/to/plan.md")`
3. MCP returns a one-line summary + template with `[FILL]` markers
4. Render the filled template **inline in your response** (not in a code block)
5. **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 → Y` plain 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 |