🛡️ Skill: Commit Sentinel (v2.1.0)

Executive Summary

The commit-sentinel is the guardian of repository health and historical clarity. In 2026, where AI agents generate thousands of lines of code daily, the role of the sentinel is critical to prevent "History Pollution" and "Type Decay." This skill enforces a rigorous 4-step validation protocol, promotes surgical history sculpting via rebasing, and leverages automated hooks to ensure that only elite-level code reaches the main branch.

📋 Table of Contents

1. The 4-Step Validation Protocol
2. The "Do Not" List (Anti-Patterns)
3. Conventional Commits 2026
4. History Sculpting (Interactive Rebase)
5. Forensic Validation (Git Bisect)
6. Git 3.0 Readiness (SHA-256)
7. Automated Hook Orchestration
8. Reference Library

🛡️ The 4-Step Validation Protocol

Before every commit, the Sentinel MUST execute:

1. Surgical Diff Review: git diff --cached to verify every line.
   • Filter: Remove all console.log, TODO (unless planned), and debug artifacts.
2. Strict Type Audit: bun x tsc --noEmit (Mandatory).
   • Standard: ZERO type errors allowed in the entire workspace.
3. Linter Enforcement: bun run lint.
   • Standard: Adherence to the project's formatting and security rules.
4. Logical Atomicity: Ensure the commit does exactly ONE thing.
   • Check: If the diff covers multiple features/fixes, use git add -p to split.

🚫 The "Do Not" List (Anti-Patterns)

📝 Conventional Commits 2026

We follow the strictly typed commit standard:

• feat(scope): A new feature.
• fix(scope): A bug fix.
• refactor(scope): No feature or bug change.
• perf(scope): Performance improvements.
• chore(scope): Internal tools/config.
• docs(scope): Documentation only.

Structure:

type(scope)!: short description (max 50 chars)

Detailed body explaining WHY this change was made.
Wrapped at 72 chars.

BREAKING CHANGE: [details]
Resolves #123

🔨 History Sculpting (Interactive Rebase)

The Sentinel never pushes messy local history.

# Clean up the last 3 local commits before pushing
git rebase -i HEAD~3

Use squash to combine small "fix" commits into a single "feat" or "fix".

🔍 Forensic Validation (Git Bisect)

When a bug appears, find the source with binary search.

git bisect start
git bisect bad HEAD
git bisect good [last_known_good_tag]
# Automate with:
git bisect run bun test

🚀 Git 3.0 Readiness

• SHA-256: Transitioning away from SHA-1 for collision resistance.
• Rust Core: Native speed for monorepo operations.
• Push Protection: Automated secret detection in the commit loop.

📖 Reference Library

Detailed deep-dives into Git excellence:

• Git Forensics: Regressions and bisecting.
• Advanced Rebasing: interactive mode and autosquash.
• Git 3.0 Guide: SHA-256 and Rust integration.
• Hook Automation: Husky, Lefthook, and Pre-commit.

Updated: January 22, 2026 - 17:50