Plannotator: 에이전트의 계획에 줄 쳐서 돌려보내는 리뷰 화면
SSW는 개발 규칙에 AI가 세운 계획은 Plannotator로 리뷰하라고 권장으로 적어 뒀어요
- 누가
- 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도 줄마다 코멘트하며 리뷰해요.




이걸로 만든 사람들
안에서는 이렇게 돌아가요
- 1
Claude Code → plannotator (훅 명령)
ExitPlanMode → PermissionRequest 훅플러그인의 hooks.json이 ExitPlanMode의 권한 요청에 plannotator 명령을 걸어 둬요.apps/hook/hooks/hooks.json - 2
plannotator (훅 명령) → 로컬 서버와 리뷰 화면
stdin의 훅 이벤트에서 계획을 읽어 서버 시작인자 없이 불리면 계획 리뷰 모드예요. 훅이 준 입력에서 계획 글을 꺼내 로컬 서버에 넘겨요.apps/hook/server/index.ts - 3
- 4
나 → 로컬 서버와 리뷰 화면
주석, 삭제선, 메모 그리고 승인 또는 거절계획의 줄에 직접 표시하고 Approve나 Send Feedback 가운데 하나를 눌러요.packages/server/index.ts - 5
plannotator (훅 명령) → Claude Code
승인이면 진행, 거절이면 주석을 피드백으로결정을 stdout으로 돌려줘서 에이전트가 그대로 진행하거나 주석을 받아 계획을 고쳐요.apps/hook/server/index.ts - 6
Claude Code → 고친 계획과 Plan Diff
고친 계획을 다시 제출다시 올라온 계획에는 지난 버전에서 무엇이 바뀌었는지 Plan Diff가 보여요.
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- 플랜 모드를 자주 쓰는데 계획을 대충 읽고 승인하게 될 때
- 에이전트가 만든 변경을 커밋 전에 PR 보듯 줄마다 보고 싶을 때
- 에이전트 여럿이 던지는 질문과 결과물을 한 창에서 받고 싶을 때
- 에이전트가 만든 HTML 시안이나 문서의 특정 부분을 짚어 고치게 할 때
이건 안 돼요
- 리뷰 화면이 열릴 때마다 GitHub에서 최신 릴리스를 확인해요. 계획 내용은 보내지 않지만, 끄는 설정은 아직 없다고 README가 밝혀요.
- 작은 마크다운 공유 링크는 암호화되지 않아요. 링크 전체를 가진 사람은 내용을 읽을 수 있고, 링크 공유는 지원 종료 쪽으로 가고 있어요.
- Claude Code 2.1.287 이상에서는 리뷰 중에도 Claude가 멈추지 않아요. 승인 전에 플랜 모드를 직접 나가면 편집을 시작할 수 있어요.
- Droid는 명령만 되고 계획 가로채기는 아직 없어요. 네이티브 Windows의 Codex는 훅을 손으로 설정해야 해요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요
