What's New
🔧 Short-Form Slash Commands Now Work
Previously, brooks-lint skills were only accessible via the namespaced format /brooks-lint:brooks-review. This is a Claude Code plugin system limitation — all plugin skills carry a pluginname: namespace prefix.
v0.8.1 fixes this. The session-start hook now auto-installs thin wrapper files to ~/.claude/commands/ on first session start, enabling:
| Short Form | Full Form | Action |
|---|---|---|
/brooks-review
| /brooks-lint:brooks-review
| PR code review |
/brooks-audit
| /brooks-lint:brooks-audit
| Architecture audit |
/brooks-debt
| /brooks-lint:brooks-debt
| Tech debt assessment |
/brooks-test
| /brooks-lint:brooks-test
| Test quality review |
Both forms work — short-form is auto-installed, full-form always available.
🛡️ Versioned Sentinel File
A sentinel file (~/.claude/commands/.brooks-lint-v0.8.1) tracks which version installed the wrappers. On plugin upgrade, the wrappers auto-refresh — no manual cleanup needed. Old sentinel files are cleaned up automatically.
🍎 macOS Bash 3.2 Compatibility
Replaced declare -A (bash 4+ only) with a case statement in the session-start hook. macOS ships /bin/bash 3.2 by default — the hook now works regardless of which bash version env bash resolves to.
📝 Single Source of Truth
The hook now copies canonical wrapper files from the commands/ directory instead of regenerating from an inline template. This eliminates content drift between the repo files and what gets installed.
Upgrade
# Plugin marketplace users
/plugin update brooks-lint@brooks-lint-marketplace
/reload-plugins
# Manual install users
git pull
cp commands/*.md ~/.claude/commands/After updating, restart your Claude Code session. The short-form commands will be available immediately.
Note: If you already have custom
~/.claude/commands/brooks-*.mdfiles, the hook will NOT overwrite them. Delete them manually if you want the updated versions.
Changed Files
hooks/session-start— auto-install logic with versioned sentinelcommands/*.md— simplified to thin skill wrappersCHANGELOG.md— added entries for v0.7.0, v0.8.0, v0.8.1CLAUDE.md,README.md,CONTRIBUTING.md,AGENTS.md,GEMINI.md— updated command referencesskills/brooks-review/pr-review-guide.md— updated internal reference- Version bumped to 0.8.1 across all 5 manifest files
Full Changelog: v0.8.0...v0.8.1