Brooks-Lint

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-*.md files, 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 sentinel
• commands/*.md — simplified to thin skill wrappers
• CHANGELOG.md — added entries for v0.7.0, v0.8.0, v0.8.1
• CLAUDE.md, README.md, CONTRIBUTING.md, AGENTS.md, GEMINI.md — updated command references
• skills/brooks-review/pr-review-guide.md — updated internal reference
• Version bumped to 0.8.1 across all 5 manifest files

Full Changelog: https://github.com/hyhmrright/brooks-lint/compare/v0.8.0...v0.8.1