Agent skill

bruhook

Context tracking and plan enforcement system. Use when working on long coding sessions with plans.

View SKILL.md on GitHub Repository
Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/geakstr/bruhook/tree/main/skills/bruhook

SKILL.md

bruhook - Context Tracking System

bruhook is a buddy system that runs in the background during your coding sessions. It helps maintain context, track progress, and prevent incomplete work.

What bruhook does

When BRUHOOK_ENABLED=true:

  1. Code review - Every file change is reviewed against the plan by a background Claude session. Drift (justified or not) gets logged.

  2. Plan tracking - Session-to-plan mappings are stored in .bruhook/session-plans.json in the project directory.

  3. Context restoration - On session resume or compaction, the plan and review log are automatically injected back into context.

  4. Completion checking - When you try to stop, bruhook verifies the plan is actually complete. If steps are missing, it blocks the stop and tells you what's left.

Where to find things

  • Plan file: Usually in ~/.claude/plans/*.md - the current session's plan
  • Review log: .bruhook/reviews/{plan-name}.log in the project directory
  • Session mapping: .bruhook/session-plans.json in the project directory

How to check status

Use /bruhook:status to see:

  • Current plan file for this session
  • Whether bruhook is enabled
  • Path to the review log

Use /bruhook:log to read the review log for the current session.

Important behaviors

  • The plan tracker ALWAYS runs (even without BRUHOOK_ENABLED) to maintain session-plan mappings
  • Review logs use numbered entries [N] that build incrementally
  • The completion checker examines git diff to verify actual implementation matches claims
  • Any drift from the plan is logged, whether justified or not

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

mattpocock/skills

git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

111,310 9,758
Explore
mattpocock/skills

scaffold-exercises

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

111,310 9,758
Explore
mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore
mattpocock/skills

migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

111,310 9,758
Explore
mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore
mattpocock/skills

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results