open-index/open-npm huggingface dataset:
npm package: @hdh/pi-contributions-bot
Description: Pi extension that gates git commit on CONTRIBUTING_BOT.md compliance
Author: Harry Hudson
Latest version: 0.1.1

# pi-contributions-bot

A [pi](https://github.com/badlogic/pi-mono) 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

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

Or try without installing:

```bash
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