@hdh/pi-contributions-bot

Pi extension that gates git commit on CONTRIBUTING_BOT.md compliance

Package details

← Back
extension

Install @hdh/pi-contributions-bot from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@hdh/pi-contributions-bot
Package
@hdh/pi-contributions-bot
Version
0.1.1
Published
Mar 16, 2026
Downloads
26/mo · 3/wk
Author
hdh
License
MIT
Types
extension
Size
11 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-contributions-bot

A pi extension that gates git commit on compliance with project-specific engineering standards defined in a CONTRIBUTING_BOT.md file.

How it works

  1. Place a CONTRIBUTING_BOT.md file at the root of any project (falls back to CONTRIBUTING.md or CONTRIBUTING)
  2. The extension intercepts every git commit attempt (by the agent or via ! shell)
  3. A reviewer subagent audits the staged diff against your standards
  4. If violations are found, the commit is blocked and the agent receives the violation report
  5. The agent fixes the issues and retries the commit
  6. Use /review for manual reviews at any time

Install

pi install npm:@hdh/pi-contributions-bot

Or try without installing:

pi -e npm:@hdh/pi-contributions-bot

Usage

The extension activates automatically when a CONTRIBUTING_BOT.md (or CONTRIBUTING.md / CONTRIBUTING) file exists in the project root.

Automatic (commit gate)

Every git commit by the agent is intercepted and reviewed before it can proceed. If violations are found, the commit is blocked and the agent receives the violation report so it can self-correct.

Manual

/review              # interactive — asks for scope
/review staged       # review staged changes
/review all          # review entire codebase
/review src/lib.rs   # review specific file

CONTRIBUTING_BOT.md

The standards file is freeform Markdown containing any engineering standards relevant to your project — coding style, error handling, naming conventions, linting rules, etc. The reviewer checks code against exactly what's documented, nothing more.

License

MIT