ONEDEV

plannotator

AI Coding ToolsskillTypeScript

★ 8,709주당 +170조회 4

무엇인가

Plannotator는 AI 코딩 에이전트가 산출한 계획·명세·마크다운·HTML·코드 diff를 사람이 검토하고 주석을 달아, 그 주석 묶음을 에이전트가 실행할 피드백으로 되돌리는 검토 루프를 규율한다. 구현 착수 전 문서 검토와 구현 후 diff 검토를 같은 표면에서 처리하도록 절차를 고정하는 것이 규율 대상이다.

어떻게 동작하나

동작은 에이전트의 훅과 슬래시 명령에 직접 연결되는 방식이다. 계획 모드는 별도 명령 없이 각 하네스의 훅으로 배선되어, 에이전트가 계획을 만들면 마크다운 검토 화면이 브라우저에 열린다. `/plannotator-annotate`는 로컬 파일·폴더·URL을 받고 `--render-html`로 HTML을 변환 없이 렌더링하며, `/plannotator-last`는 에이전트의 마지막 메시지를, `/plannotator-review`는 미커밋 변경·GitHub PR·GitLab MR을 대상으로 삼는다. CLI는 `plannotator sessions`와 `plannotator archive`로 세션 재개와 저장된 계획 결정 열람을 담당한다. Codex에서는 슬래시 명령 대신 `!plannotator …` 또는 `$plannotator-*` 스킬을 쓴다. 주석은 Plannotator 데이터 디렉터리에 저장되어 터미널 리뷰와 앱 리뷰가 누적된다.

무엇과 다른가

CLAUDE.md·SKILL.md 같은 규칙 파일이 에이전트의 행동을 문장으로 제약하는 것과 달리, 이 스킬 팩은 검토 행위 자체를 브라우저 표면으로 분리한다. 프롬프트에 리뷰를 요청하는 방식은 대화 로그 안에서 끝나지만, 여기서는 문서와 diff에 위치 기반 주석이 붙고 그 주석이 에이전트에 전달된다. 검토 중인 대상에 대해 AI에 질의하거나, AI 리뷰가 diff에 코멘트를 게시하는 기능도 같은 표면에 내장되어 있다. Git·GitButler·Jujutsu(`jj`)·Perforce(`p4`) 작업 트리와 GitHub·GitLab 원격 PR을 같은 절차로 다룬다.

어떻게 쓰나

설치는 에이전트의 훅·명령에 연결한 뒤 브라우저 검토 화면을 띄우는 흐름이다. 터미널 리뷰는 `herdr plugin install plannotator/herdr-annotate`로 붙이고, Herdr 없이 문서 검토만 하려면 `brew install plannotator/tap/plannotator-tui`로 TUI를 단독 실행한다. 첫 사용은 `/plannotator-annotate README.md`로 로컬 마크다운을 열거나 `/plannotator-review`로 미커밋 변경을 여는 것이며, 계획 검토는 명령 없이 계획 생성 시 자동으로 열린다.

전제와 한계

전제는 Claude Code를 비롯해 Codex·Copilot CLI·Gemini CLI·OpenCode·Kiro·Droid·Amp·Pi에서 도는 환경이다. 사용 텔레메트리와 분석은 수집하지 않고 계획·diff·주석·초안·이력·설정은 기본적으로 로컬에 남지만, 각 검토 표면이 로드될 때 GitHub에서 최신 릴리스 존재를 확인하며 이에 대한 옵트아웃 설정은 없다. URL 주석은 기본적으로 Jina Reader를 경유해 대상을 가져오고, GitHub·GitLab 리뷰는 인증된 CLI와 Git remote로 PR·MR 데이터를 읽는다. Ask AI와 리뷰 에이전트는 선택한 질문과 관련 컨텍스트를 설정한 제공자로 전송한다. 링크 공유는 호환용으로 남아 있으나 deprecated 방향이며 팀 공유의 주된 방향은 별도 호스팅 제품인 Workspaces다. 작은 마크다운 공유는 URL 프래그먼트에 압축되어 저장되며 암호화되지 않는다.

유사 도구