@estebanforge/pi-go-review
v1.0.2
Published
Go code-review tool for Pi. Grades your git diffs against the 100 Go Mistakes rubric (https://100go.co/) and returns categorized findings (Bug / Suggestion / Nit / Good pattern) with an Approve or Request-Changes verdict. Not a linter; pairs with go vet a
Downloads
371
Maintainers
Readme
@estebanforge/pi-go-review
Go code review against the 100 Go Mistakes checklist (100go.co). Registers a go_review tool that reads git diffs, filters to .go files, and attaches the full rubric (100 numbered mistakes + 1 community entry) for the LLM to review against.
Install
pi install npm:@estebanforge/pi-go-reviewUsage
Ask Pi: "review my Go changes."
The tool runs git in one of five modes:
| Mode | Description | Needs ref |
| --- | --- | --- |
| working | Unstaged changes | No |
| staged | Staged (cached) changes | No |
| all | All changes vs HEAD | No |
| commit | A specific commit | Yes (SHA) |
| range | A commit range | Yes (e.g. main..HEAD) |
Narrow scope with path (a file or directory).
What it does
- Reads the git diff filtered to
*.go. - Attaches the full 100 Go Mistakes checklist (100 numbered mistakes + 1 community entry, 11 categories).
- The LLM reviews the diff and returns categorized findings:
| Severity | Meaning | | --- | --- | | Bug / Critical | Must fix | | Suggestion | Should consider | | Nit | Minor improvement | | Good pattern | Well done |
Each finding cites the mistake number (e.g. #39) and the file + code fragment. Ends with a Verdict: Approve / Request Changes / Needs Discussion.
Categories covered
| Section | Mistakes | | --- | --- | | Code & Project Organization | #1–#16 | | Data Types | #17–#29 | | Control Structures | #30–#35 | | Strings | #36–#41 | | Functions & Methods | #42–#47 | | Error Management | #48–#54 | | Concurrency: Foundations | #55–#60 | | Concurrency: Practice | #61–#74 | | Standard Library | #75–#81 | | Testing | #82–#90 | | Optimizations | #91–#100 |
TUI rendering
Custom rendering for both the tool call and its result: mode, file count, insertions/deletions, and truncation status at a glance.
Credits
Based on 100 Go Mistakes and How to Avoid Them by Teivah.
License
MIT
