AI 칼럼

코딩@donghyeok99운영진

Plannotator: 에이전트의 계획에 줄 쳐서 돌려보내는 리뷰 화면

SSW는 개발 규칙에 AI가 세운 계획은 Plannotator로 리뷰하라고 권장으로 적어 뒀어요

브라우저에 열린 계획에 형광펜을 긋고, 메모를 달고, 한 줄을 지워 Send Feedback으로 보내면 그 줄이 고쳐져 돌아오고, Approve를 눌러요.
브라우저에 열린 계획에 형광펜을 긋고, 메모를 달고, 한 줄을 지워 Send Feedback으로 보내면 그 줄이 고쳐져 돌아오고, Approve를 눌러요.
누가
backnotprop이 Apache-2.0과 MIT 이중 라이선스로 공개했어요. 코딩 에이전트의 계획과 코드를 실행 전에 직접 훑어보려는 사람을 위한 거예요.
언제
2025년 12월 28일에 공개됐고, 최근 릴리스는 2026년 11월 15일 v0.28.65예요.
어디서
Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, Pi에 붙어요. macOS, Linux, WSL, Windows에서 내 브라우저로 열려요.

이게 불편했어요

에이전트가 계획을 내놓으면 터미널에 긴 글이 주르륵 흘러가요. 셋째 단계만 마음에 안 드는데, 그걸 말하려면 「3번에서 그 부분 말고요」 하고 다시 길게 써야 해요. 귀찮아서 그냥 승인하고 나면, 고칠 수 있었던 걸 코드가 다 나온 뒤에야 발견해요.

그래서 이렇게 풀어요

Plannotator는 계획이 나오는 순간 그걸 브라우저의 문서로 열어요. 문제 있는 줄에 형광펜을 긋고, 메모를 달고, 필요 없는 줄은 지우면 그 표시들이 구조화된 피드백이 돼서 에이전트에게 돌아가요. 에이전트가 계획을 고쳐 다시 내면 무엇이 바뀌었는지 diff로 보여요. 같은 화면으로 커밋 전 변경이나 GitHub, GitLab의 PR도 줄마다 코멘트하며 리뷰해요.

계획 문서에 줄 단위로 주석을 다는 화면
계획 문서에 줄 단위로 주석을 다는 화면
파일 트리와 나란히 보는 diff로 하는 코드 리뷰
파일 트리와 나란히 보는 diff로 하는 코드 리뷰
여러 에이전트의 질문과 파일이 모이는 Plannotator Inbox
여러 에이전트의 질문과 파일이 모이는 Plannotator Inbox
렌더링된 HTML 결과물 위에 바로 주석 달기
렌더링된 HTML 결과물 위에 바로 주석 달기

이걸로 만든 사람들

ssw.com.auSSW Rules2026-11-16

SSW가 사내 개발 규칙으로 정리한 글이에요. AI가 PLAN.md를 만들면 Plannotator가 열리고, 줄에 코멘트를 달아 Send Feedback으로 보내고, 고친 계획을 다시 본 뒤 승인하는 순서를 권장해요.

Plannotator opens the plan in a browser-based, pull-request-style review UI.

안에서는 이렇게 돌아가요

  1. 1

    Claude Code → plannotator (훅 명령)

    ExitPlanMode → PermissionRequest 훅플러그인의 hooks.json이 ExitPlanMode의 권한 요청에 plannotator 명령을 걸어 둬요.apps/hook/hooks/hooks.json
  2. 2

    plannotator (훅 명령) → 로컬 서버와 리뷰 화면

    stdin의 훅 이벤트에서 계획을 읽어 서버 시작인자 없이 불리면 계획 리뷰 모드예요. 훅이 준 입력에서 계획 글을 꺼내 로컬 서버에 넘겨요.apps/hook/server/index.ts
  3. 3

    로컬 서버와 리뷰 화면 → 나

    브라우저에 리뷰 화면 열기로컬에서는 임의 포트, SSH에서는 고정 포트 19432로 열어요.packages/server/browser.ts
  4. 4

    나 → 로컬 서버와 리뷰 화면

    주석, 삭제선, 메모 그리고 승인 또는 거절계획의 줄에 직접 표시하고 Approve나 Send Feedback 가운데 하나를 눌러요.packages/server/index.ts
  5. 5

    plannotator (훅 명령) → Claude Code

    승인이면 진행, 거절이면 주석을 피드백으로결정을 stdout으로 돌려줘서 에이전트가 그대로 진행하거나 주석을 받아 계획을 고쳐요.apps/hook/server/index.ts
  6. 6

    Claude Code → 고친 계획과 Plan Diff

    고친 계획을 다시 제출다시 올라온 계획에는 지난 버전에서 무엇이 바뀌었는지 Plan Diff가 보여요.

넣으면 이렇게 나와요

에이전트가 계획을 내놓음 (명령 없음)브라우저에 리뷰 화면이 저절로 열려요
/plannotator-review <github-pr-url>GitHub PR을 파일 트리와 diff 뷰어로 리뷰
/plannotator-last에이전트의 마지막 답에 주석을 달아 돌려보내요
/plannotator-annotate report.html --render-htmlHTML을 변환하지 않고 그린 그대로 띄워 주석

나한테 맞을까요

이럴 때 좋아요

  • 플랜 모드를 자주 쓰는데 계획을 대충 읽고 승인하게 될 때
  • 에이전트가 만든 변경을 커밋 전에 PR 보듯 줄마다 보고 싶을 때
  • 에이전트 여럿이 던지는 질문과 결과물을 한 창에서 받고 싶을 때
  • 에이전트가 만든 HTML 시안이나 문서의 특정 부분을 짚어 고치게 할 때

이건 안 돼요

  • 리뷰 화면이 열릴 때마다 GitHub에서 최신 릴리스를 확인해요. 계획 내용은 보내지 않지만, 끄는 설정은 아직 없다고 README가 밝혀요.
  • 작은 마크다운 공유 링크는 암호화되지 않아요. 링크 전체를 가진 사람은 내용을 읽을 수 있고, 링크 공유는 지원 종료 쪽으로 가고 있어요.
  • Claude Code 2.1.287 이상에서는 리뷰 중에도 Claude가 멈추지 않아요. 승인 전에 플랜 모드를 직접 나가면 편집을 시작할 수 있어요.
  • Droid는 명령만 되고 계획 가로채기는 아직 없어요. 네이티브 Windows의 Codex는 훅을 손으로 설정해야 해요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기