| name | brain-status |
| description | Display a quick overview of the Brain Spec workspace with steering doc status, specs, tasks, and progress. |
| context | fork |
| allowed-tools | Glob, Read, Grep, Bash |
Brain Status — Workspace Dashboard
Display a quick overview of the Brain Spec workspace: steering doc status, all specs with progress, archived specs, and overall statistics.
Usage
/brain-status
No arguments. Reads workspace state and displays a summary.
Instructions
Step 1: Read Version
Read the VERSION file at ${CLAUDE_SKILL_DIR}/VERSION (the directory of the currently running skill, exported by Claude Code). If ${CLAUDE_SKILL_DIR} is unset (older runtimes), fall back to checking .claude/skills/brain-status/VERSION then .claude/skills/brain-init/VERSION via Glob. If no VERSION file is found in any location, use "dev" for the dashboard header.
Step 2: Verify Workspace
Check if .brain-spec/config.json exists using Glob.
- If not found, display: "No Brain Spec workspace found. Run
/brain-init to set up."
- If found, proceed.
Step 3: Check Steering Documents
Check for the existence of each steering document:
.brain-spec/steering/product.md.brain-spec/steering/tech.md.brain-spec/steering/structure.md
Step 4: List Active Specs
Use Glob to find all .brain-spec/specs/*.meta.json files. Read each one.
For each spec, also read .brain-spec/tasks/{slug}/tasks.json if it exists to get task counts.
Step 5: List Archived Specs
Use Glob to find all .brain-spec/archive/*/archive-metadata.json files. Read each one.
Step 6: Display Dashboard
Format the output as follows:
╔══════════════════════════════════════╗
║ Brain Spec Dashboard v{version} ║
╚══════════════════════════════════════╝
Steering Documents
product.md ✓ exists / ✗ missing
tech.md ✓ exists / ✗ missing
structure.md ✓ exists / ✗ missing
Active Specs
Slug Status Progress
───────────────── ────────── ──────────────────
user-auth-flow active ━━━━━━━━━━━━──── 60% (3/5)
api-redesign draft ────────────────── 0% (0/0)
Archived Specs
Slug Reason Archived
───────────────── ─────────── ──────────
old-feature completed 2025-01-10
Overall Statistics
Active specs: 2
Archived specs: 1
Total tasks: 5
Completed tasks: 3
Completion: 60%
If there are no specs, show: "No specs yet. Create one with /brain-spec create <name>"
If there are no archived specs, show: "No archived specs."
Progress bar: 18 characters wide. Use ━ for filled and ─ for empty. Calculate fill: round(progress / 100 * 18).
Notes on Fork Context
This skill uses context: fork so that the JSON parsing and file reads stay isolated from the main conversation context. The output is the formatted dashboard text shown to the user.
