原始内容
Implannotator
implannotator is a cross-platform Pi package for production-grade frontend work with mandatory plan approval, adaptive browser QA, Plannotator code review, bounded repairs, and resumable audit records.
Installation
Plannotator is a companion Pi package. Install it once, then install Implannotator:
pi install npm:@plannotator/pi-extension
pi install npm:implannotator
Implannotator reuses the active companion through Plannotator's public event API; it does not bundle or register a second Plannotator extension. If the companion is unavailable, mandatory text approval remains available.
For local development:
cd <path-to-repository>/implannotator
npm install
pi install npm:@plannotator/pi-extension
pi install .
Restart Pi or run /reload, then use:
/implannotator
/implannotator craft <target>
/implannotator audit <target>
/implannotator status
/implannotator resume
/implannotator review
/implannotator verify
/implannotator config
/implannotator update-check
The skill may also be selected automatically for frontend design and implementation requests.
Workflow
- Inspect the project without mutation.
- Draft a complete plan.
- Approve it in Plannotator or through the text fallback.
- Implement as the sole writer.
- Run adaptive Quick, Standard, or Full QA.
- Open the initial code review.
- Repair up to three times without reopening intermediate browser tabs.
- Open one final review.
- Complete only after approval or an explicit warned override.
Audit records are written to .implannotator/runs/<run-id>/. The package never automatically stashes, resets, commits, or pushes.
Configuration
Configuration merges in this order:
- Built-in defaults
~/.pi/agent/implannotator.json<project>/.pi/implannotator.json
Low-risk automatic approval is disabled by default. See docs/configuration.md.
Development
npm run typecheck
npm run lint
npm test
npm run test:compat
npm run verify:snapshot
npm run pack:check
See docs/installation.md, docs/architecture.md, docs/workflow.md, docs/qa.md, and docs/security.md.