Plannotator:user Code Review

Request a code review from the user via plannotator. Use at the end of an implementation task, or when the user asks for a review cycle. Collects structured annotations, then addresses each item.

jamiebrynes7 36a843b 1.4 KB Updated

File contents

Plannotator provides a structured review UI where the user can leave inline annotations on specific files and lines. Use it to get precise, actionable feedback.

Run the following command to start a review session. Set the Bash tool timeout to 1800000ms (30 minutes) so the user has enough time to review and annotate.

plannotator review

Plannotator starts a local HTTP server. If the execution environment sandboxes localhost socket creation, run the command using its narrowest available permission-escalation mechanism. Otherwise, run it normally.

If Plannotator reports that its entire port range is exhausted in a sandboxed environment, treat that as a possible socket-permission failure rather than immediately changing ports; retry once with permission to bind a localhost socket.

Reviewing Feedback

For each annotation from the user:

  1. Summarize the feedback in one line
  2. Evaluate whether the suggestion is valid — push back if it would introduce a bug, conflict with project conventions, or reduce code quality
  3. Act — apply the fix or explain why you disagree

If no changes were requested, acknowledge this and move on.

jamiebrynes7/dotfiles/tree/main/home/programs/plannotator/skills/plannotator-user-code-review commit 36a843bf64

Frequently asked questions

npx skillmds@latest add jamiebrynes7/plannotator-user-code-review