brightraven-dev
A personal development workflow plugin for Claude Code, built for the Bright Raven ecosystem. Provides session-aware quality gates, documentation hygiene tools, multi-agent version tracking, and automated pitfall detection.
Version: 1.1.1
Author: devBrightRaven / Bright Raven
Repository: https://github.com/devBrightRaven/brightraven-dev
Overview
brightraven-dev is a Claude Code plugin that embeds development best practices directly into the AI-assisted coding workflow. Rather than relying on memory or discipline, it automates pre-commit checks, tracks skill file modifications, and learns from session pitfalls -- turning the coding agent into a workflow-aware assistant.
The plugin is organized into two layers:
- Commands -- slash commands invoked on demand for specific tasks (quality checks, documentation audits, vault syncing, security analysis).
- Hooks -- background scripts that run automatically on tool use and session events (pre-commit gating, skill change tracking, pitfall detection).
Features
- Auto-detect project language and run tests, lint, and typecheck before commits
- Track coding agent versions across Claude Code, Copilot CLI, Gemini CLI, Codex CLI, and Kiro
- Audit documentation for stale paths, wrong versions, and broken references
- One-way sync project docs to an Obsidian vault with frontmatter injection
- Generate a GitHub repo index as an Obsidian-compatible markdown file
- Validate deny-list coverage by simulating dangerous commands against
settings.json patterns
- Detect session pitfalls (retries, user corrections, back-and-forth edits) and log them for review
- Monitor skill/command file changes and remind when a stocktake is due
Commands
All commands are invoked as /brightraven-dev:<command> within a Claude Code session.
/brightraven-dev:pre-commit-check
Pre-commit quality gate. Auto-detects the project's language and toolchain, runs all checks, and outputs a go/no-go verdict.
- Supported languages: JS/TS (vitest/jest/mocha, eslint, tsc), Python (pytest, ruff/flake8, pyright/mypy), Go (go test, golangci-lint, go vet), Rust (cargo test, cargo clippy), C# (dotnet test, dotnet format)
- Verdict: PASS / WARN (coverage < 80% or lint warnings) / FAIL (test failure or typecheck error)
- Flags:
--staged to check only staged files where possible
- Read-only -- reports the verdict but does not commit or fix issues automatically.
/brightraven-dev:agents-check
Scans all installed coding agents and reports their version status.
- Agents checked: Claude Code, GitHub Copilot CLI, Gemini CLI, Codex CLI, Kiro
- Compares installed version against latest from npm registry or GitHub releases.
- Flags:
--update shows update commands and asks for confirmation before running them.
- Read-only by default -- does not update or install agents automatically.
/brightraven-dev:docs-audit
Audits project documentation for references that do not match the actual codebase.
- Scans
README.md, CLAUDE.md, DEVELOPMENT.md, CONTRIBUTING.md, CHANGELOG.md, and docs/**/*.md.
- Checks file paths, version numbers, command examples, and internal URL references.
- Flags:
--fix suggests corrections but waits for confirmation before editing.
- Read-only by default.
/brightraven-dev:project-sync
One-way sync of project documentation to an Obsidian vault.
- Direction: project to vault only. Never writes back to the project.
- Scans
docs/, openspec/, CLAUDE.md, README.md, DEVELOPMENT.md, CONTRIBUTING.md, CHANGELOG.md, AGENTS.md.
- Adds YAML frontmatter (tags, status, source, synced_from, synced_at) to files that lack it.
- Maps code repo paths to vault target directories based on configurable path patterns.
- Usage:
/brightraven-dev:project-sync {project-path}
/brightraven-dev:repo-index
Generates a GitHub repository index as an Obsidian-compatible markdown file.
- Uses
gh repo list to fetch all repos for a given GitHub account.
- Groups repos by visibility (private/public), sorted by last push date.
- Outputs with wiki-link formatting for Obsidian cross-referencing.
- Includes stats: total repos, most active, language distribution.
- Usage:
/brightraven-dev:repo-index [github-username] (defaults to devBrightRaven)
/brightraven-dev:security-check
Validates deny-list coverage in ~/.claude/settings.json by simulating dangerous commands.
- Tests predefined dangerous commands (destructive file ops, git force-push, remote code execution, privilege escalation, etc.) against configured deny patterns.
- Uses the same glob-to-regex logic as
deny-check.mjs.
- Reports gaps and suggests new deny patterns to add.
- Flags: Pass a specific command string as an argument to test it in addition to the predefined list.
- Read-only -- does not modify
settings.json without confirmation.
