← ClaudeAtlas

briefs-healthlisted

Audit the briefs for a project when it feels muddled, stalled, or you've lost the thread. Reports what's out of shape and asks one question to drive reprioritization.
naxoc/claude-briefs · ★ 2 · Data & Documents · score 63
Install: claude install-skill naxoc/claude-briefs
# Briefs: Health Check Run this when a project feels muddled, stalled, or you've lost the thread. It reads the briefs and gives you an honest picture of the state — then helps you reorder, not just report. ## Step 1: Find the briefs folder Check these in order: - Read `.claude/briefs-path` for a saved path - Check if `.briefs/` exists in the project root - If neither works, ask the user for the path ## Step 2: Read all four files in parallel CURRENT.md, BACKLOG.md, PROGRESS.md, NOTES.md — plus any staged plans in `queue/`. If the folder has a PLAN.md but no BACKLOG.md, it predates the rename — treat PLAN.md as BACKLOG.md and offer to `mv` it. ## Step 3: Audit each file ### CURRENT.md - Is there an active task? If empty or vague, flag it. - Does it look stale? Signs: no concrete next move, multiple tasks crammed in, "TODO" or "TBD" with no follow-up, `# Log` silent while the task claims to be in flight. - **All task-list boxes ticked but the task still active?** It's awaiting review — suggest the user review, commit, and run `/briefs-done` so it gets archived instead of rotting here. - **Non-trivial task with an empty `# Approach`?** Flag it — suggest `/briefs-plan` before more work happens ad hoc. - Is the active task actually reflected in BACKLOG.md's `## Up next` or `## Blocked`? ### BACKLOG.md - **`## Up next`**: More than 3 items? Flag it — needs pruning. Items that are actually blocked but not labeled as such? - **`## Blocked`**: Any items missing a reason or da