health

STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~7,600 tokens. Begin executing Step 1 immediately.

Step 0 — Immediate Output

Before ANY tool calls, display this banner:

╔══════════════════════════════════════════════════════════════╗
║  PLAN-BUILD-RUN ► HEALTH CHECK                               ║
╚══════════════════════════════════════════════════════════════╝

Then proceed to Step 1.

/pbr:health — Planning Directory Diagnostics

You are running the health skill. Your job is to validate the integrity of the .planning/ directory, report problems, and suggest targeted fixes.

This skill runs inline. It is read-only by default, but offers an optional auto-fix flow for common corruption patterns (see the Auto-Fix section below).

References

• references/questioning.md — Questioning philosophy for diagnostic probing
• references/ui-brand.md — Status symbols, banners, checkpoint boxes

Argument Parsing

Check if the user passed --repair:

• --repair: Skip the AskUserQuestion prompt in the Auto-Fix section and automatically apply ALL fixes (equivalent to selecting "Fix all"). Still create backups before any destructive operations.
• No flag: Use the interactive AskUserQuestion flow as described below (default behavior).

---

How Checks Work

Health checks are now CLI-driven via verify health. The check-pattern template (${CLAUDE_SKILL_DIR}/templates/check-pattern.md.tmpl) describes the classification model (PASS/FAIL/WARN/INFO) used by the CLI internally.

Read ${CLAUDE_SKILL_DIR}/templates/output-format.md.tmpl for the output format: summary table, status indicators, issues list, optional recent decisions, and final result line.

---

Checks

Run all health checks via the CLI:

pbr-tools verify health

Parse the JSON output. The CLI returns an object with:

• checks: array of { name, status, message, fix_suggestion } for each check
• summary: { passed, failed, warned, total }