Skip to content

LuciferDono/sentinel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sentinel

A Claude Code plugin that enforces code quality, sole authorship, and review discipline across your contributions.

Features

  • Code Review (/review) -- Best-practice code review using parallel subagent chunks. Audits your diff against a full ruleset and reports violations with file, line, severity, and draft comments.
  • Pull Request (/pr) -- Create or update pull requests with built-in preflight checks and style-matched descriptions.
  • CI Fix (/ci) -- Diagnose and fix failing CI checks on your current branch.
  • Preflight (/preflight) -- Run lint, test, and build checks locally before opening a PR.
  • Implementation Review (/impl-review) -- Review an implementation plan or design doc against project conventions.
  • Sole Authorship Hook -- Automatically blocks any git commit containing AI attribution markers (Co-Authored-By, Generated with).

Installation

claude plugin add LuciferDono/sentinel

Usage

Review the current diff

/review

Review only a specific file or path:

/review src/parser.ts

Create a pull request

/pr

Target a specific base branch:

/pr --base develop

Fix failing CI

/ci

Run preflight checks

/preflight

Review an implementation plan

/impl-review docs/design.md

Architecture

Subagent Review Pattern

The /review command splits the full best-practice ruleset into chunks and launches a code-reviewer subagent for each chunk in parallel. Each subagent:

  1. Receives its chunk of rules and the unified diff.
  2. Checks every rule heading against added lines in the diff.
  3. Verifies potential violations by reading source files before reporting.
  4. Returns an AUDIT trail (PASS / N/A / FAIL per rule) and a VIOLATIONS list.

The parent skill collects all subagent results, deduplicates findings, and produces a single consolidated report. This approach scales linearly with ruleset size without hitting context limits.

Sole Authorship Policy

The PreToolUse hook in hooks/hooks.json intercepts every Bash tool call. If the command contains Co-Authored-By or Generated with, the hook exits with code 1 and the commit is blocked. This enforces sole authorship on all commits made through Claude Code.

License

MIT

About

Production-grade Claude Code plugin for code review, CI management, and branch workflows with subagent-driven architecture

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages