@hdh/pi-contributions-bot
v0.1.0
Published
Pi extension that gates git commit on CONTRIBUTIONS_BOT.md compliance
Maintainers
Readme
pi-contributions-bot
A pi extension that gates git commit on compliance with project-specific engineering standards defined in a CONTRIBUTIONS_BOT.md file.
How it works
- Place a
CONTRIBUTIONS_BOT.mdfile at the root of any project (falls back toCONTRIBUTIONS.mdorCONTRIBUTIONS) - The extension intercepts every
git commitattempt (by the agent or via!shell) - A reviewer subagent audits the staged diff against your standards
- If violations are found, the commit is blocked and the agent receives the violation report
- The agent fixes the issues and retries the commit
- Use
/reviewfor manual reviews at any time
Install
pi install npm:@hdh/pi-contributions-botOr try without installing:
pi -e npm:@hdh/pi-contributions-botUsage
The extension activates automatically when a CONTRIBUTIONS_BOT.md (or CONTRIBUTIONS.md / CONTRIBUTIONS) 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 fileCONTRIBUTIONS_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
