implannotator

Approval-gated frontend implementation for Pi, combining Implannotator design guidance with Plannotator reviews.

Packages

Package details

extensionskill

Install implannotator from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:implannotator
Package
implannotator
Version
0.2.0
Published
Jul 15, 2026
Downloads
143/mo · 143/wk
Author
yoseph_23
License
MIT
Types
extension, skill
Size
2.1 MB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "extensions/index.ts"
  ],
  "skills": [
    "skills/implannotator"
  ]
}

Security note

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

README

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

  1. Inspect the project without mutation.
  2. Draft a complete plan.
  3. Approve it in Plannotator or through the text fallback.
  4. Implement as the sole writer.
  5. Run adaptive Quick, Standard, or Full QA.
  6. Open the initial code review.
  7. Repair up to three times without reopening intermediate browser tabs.
  8. Open one final review.
  9. 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:

  1. Built-in defaults
  2. ~/.pi/agent/implannotator.json
  3. <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.