Plannotator

Plannotator는 AI 에이전트가 계획은 썼지만 아직 아무것도 만들지 않은 그 순간을 위한 시각적 계층이다. 터미널에서 긴 텍스트 덩어리를 스크롤하는 대신, 같은 문서를 웹페이지로 렌더링한 상태로 본다. 문장을 골라 코멘트를 붙이고 전송을 누른다. 에이전트는 그 피드백을 받아 작업을 고친다. 프로젝트 스스로를 검토 표면이라고 설명하는데, 정확하다. 에이전트와 작업의 다음 단계 사이에 자리한다.

매력은 타이밍에 있다. 계획 속 잘못된 가정은 찾는 데 몇 분이면 된다. 같은 실수를 코드를 다 쓴 뒤에 찾으면 훨씬 비싸다. Plannotator는 그 간격에 기댄다. 하나의 잘못된 설계 결정이 수십 개 파일로 번질 수 있는 큰 기능에 에이전트를 쓰는 사람에게 특히 그렇다.

무엇이 아닌지도 알아 둘 만하다. Plannotator는 코드를 쓰지 않고, 무언가를 대신 호스팅해 주지도 않는다. 모든 게 로컬에서 돌아간다. 계획과 diff, 코멘트는 내 컴퓨터에 남는다. 워크플로가 공유 클라우드 작업 공간에 의존한다면, Plannotator를 그 주변에 끼워 맞춰야 한다. 반대가 아니다. 또 다른 한계는 코딩 에이전트 옆에서 사는 도구라는 점이다. 이 컴퓨터에서 Claude Code나 Codex 같은 에이전트 도구를 이미 돌리고 있지 않다면 단독으로는 쓸모가 없다.

시작하기

1. 내 플랫폼용 설치 프로그램을 실행한다. macOS, Linux, WSL이라면 curl -fsSL https://plannotator.ai/install.sh | bash다. Windows라면 PowerShell이나 명령 프롬프트에서 대응하는 명령을 실행한다.
2. 설치 프로그램이 내 에이전트에 스스로 연결되게 둔다. 어떤 코딩 에이전트가 있는지 감지해 맞는 훅과 슬래시 명령, 스킬을 추가한다.
3. 새 터미널을 열고 plannotator --version을 실행해 명령이 동작하는지 확인한다.
4. 코딩 에이전트에서 검토를 실행한다. 명령에는 /plannotator-annotate <file|dir|url>, /plannotator-review [PR_URL], 에이전트의 가장 최근 메시지를 위한 /plannotator-last가 있다.
5. 브라우저가 문서를 열고, 표시를 달면 코멘트가 곧바로 에이전트에게 돌아간다.