13K 스타를 받은 GitHub 저장소가 단 하나의 매우 명확한 아이디어를 중심으로 구축되었습니다.
코딩 에이전트의 계획은 코드가 되기 전에 Pull Request(PR) 스타일의 검토를 거쳐야 합니다.
이것을 Plannotator라고 부르며, 에이전트가 생성한 계획을 개발자가 구현을 시작하기 전에 결정을 검사하고, 주석을 달고, 수정할 수 있는 인터랙티브 리뷰 작업 공간으로 변환합니다.
일반적인 Claude Code 워크플로우를 생각해 보세요.
에이전트가 길고 긴 Markdown 플랜을 제안합니다. 사용자는 터미널에서 이를 훑어보고 승인한 다음, 에이전트에게 코딩을 시작하도록 합니다. 20분이 지난 후, 요구사항을 오해했거나, 불필요한 복잡성을 도입했거나, 원하지 않았던 아키텍처를 선택했다는 것을 깨닫습니다.
이제 당신은 막을 수 있었던 작업을 되돌리도록 요청해야 합니다.
Plannotator가 이 워크플로우를 바꿉니다.
이전 방식:
→ 터미널에서 마크다운 벽면(wall of Markdown) 읽기
→ 단 하나의 결정으로 전체 계획 승인하기
→ 구현 과정 중 잘못된 가정 발견하기
→ 동일한 요구사항을 다시 설명해야 함
→ 불필요한 코드를 수정하는 데 또 다른 반복 작업 시간 소비하기
이제 당신은 다음을 할 수 있습니다:
→ 동의하지 않는 정확한 섹션을 강조 표시하기
→ 삭제할 불필요한 구현 단계를 표시하기
→ 인라인 주석을 추가하고 대체 방안 제안하기
→ 구조화된 피드백을 코딩 에이전트에게 직접 전송하기
→ 수정된 계획과 이전 버전을 비교하기
→ 디자인이 합리적일 때만 승인하기
통합 기능은 특히 흥미롭습니다.
Claude Code의 경우, Plannotator는 플랜 승인 워크플로우에 연결됩니다. 에이전트가 계획을 제출하면, 리뷰 인터페이스가 브라우저에서 열립니다.
사용자의 주석은 구조화된 피드백으로 변환되어 에이전트에게 반환됩니다. 에이전트는 계획을 수정할 수 있으며, Plannotator는 반복(iteration) 간에 무엇이 변경되었는지 보여줍니다.
동일한 접근 방식은 구현 후에도 작동합니다.
/plannotator-review를 실행하여 적절한 코드 리뷰 인터페이스에서 커밋되지 않은 변경 사항을 검사할 수 있습니다.
파일 탐색, 나란히 비교되는 diff(side-by-side diffs) 검토, 특정 라인에 주석 달기, 코드 변경 제안하기, 그리고 전체 리뷰를 에이전트에게 다시 전송할 수 있습니다.
HTML 아티팩트(artifacts), 문서, 그리고 풀 리퀘스트(pull requests) 검토도 지원됩니다.
하지만 가장 유용한 추가 기능 중 하나는 Plannotator Inbox입니다.
여러 코딩 에이전트(coding agents)를 실행하는 경우, 이들이 질문, 제안된 계획(proposed plans), 코드 리뷰 등을 하나의 로컬 작업 공간에 남길 수 있습니다. 터미널 간을 끊임없이 전환할 필요 없이 실제 아티팩트를 검사하고, 결정을 내리며, 적절한 에이전트 세션에 피드백을 보낼 수 있습니다.
Plannotator는 지원되는 플러그인(plugins), 훅(hooks), 명령어(commands), 그리고 MCP를 통해 Claude Code, Codex, OpenCode, Pi, Gemini CLI 및 기타 에이전트 환경과 통합됩니다.
이는 로컬에서 실행되며, 기본적으로 검토 데이터를 사용자의 장치에 보관하고, MIT/Apache-2.0 라이선스 하의 오픈 소스입니다.
코딩 에이전트들은 계획을 구현하는 데 놀라울 정도로 능숙해지고 있습니다.
Plannotator는 개발자들이 그 계획들이 실제로 구현할 가치가 있는지 확인할 수 있는 더 나은 방법을 제공합니다.
잘못된 구현을 포착하기 가장 좋은 시점은 그것이 아직 계획서 속의 단지 한 문단일 때입니다.
GitHub 저장소는 다음과 같습니다: https://t.co/sIgsqNjbA2