Tailr — 리뷰 루프
Tailr를 사용하면 함께 작업하는 사람이 브라우저에서 실행 중인 개발 서버를 마크업할 수 있습니다. 요소를 클릭하고, 무엇이 잘못되었는지 말하면, 모든 마크를 한 번에 배치로 전달합니다. 에이전트는 배치를 적용하고 각 마크가 적용될 때마다 보고합니다.
아래 규칙은 전체 프로토콜입니다. 이는 tailr init이 프로젝트의 AGENTS.md / CLAUDE.md에 작성하는 것과 동일한 규칙입니다. 이 플러그인이 대신 규칙을 제공하므로, 사용자 저장소의 어떤 파일도 수정할 필요가 없습니다.
Tailr — 검토자의 시각적 마크업
검토자는 브라우저에서 실행 중인 앱을 마크업하고 변경 사항을 하나의 배치로 전달합니다. .tailr/session.json 파일이 존재하면 세션이 활성화된 것입니다. 그렇지 않다면, 장기 실행 백그라운드 프로세스로 세션을 시작하세요. 프로세스는 계속 실행되어야 하므로, 에이전트가 대기하는 동안 턴을 차단하지 마세요:
npx tailr --target http://localhost:<dev server port>
이 명령은 리뷰 URL(보통 http://localhost:4100)을 출력합니다. 검토자에게 원래 포트 대신 이 URL을 사용하라고 알리세요. Tailr는 앱을 프록시하고 오버레이를 주입합니다. 소스는 수정되지 않습니다.
루프는 wait → pull → 각 마크에 대해 progress → done 또는 fail 순서입니다.
| 명령어 | MCP 도구 | |
|---|---|---|
npx tailr status | tailr_status | 배치가 대기 중인가요? 종료 코드 0: 예 · 3: 세션 활성, 대기 중인 배치 없음 · 2: 세션 없음 |
npx tailr wait | tailr_wait | 보내기 버튼을 누를 때까지 차단; 종료 코드 0: 배치가 대기 중 · 3: 시간 초과, 다시 시작 · 2: 세션 종료 |
npx tailr pull | tailr_pull | 배치를 임대(lease)하여 JSON으로 출력 |
npx tailr progress <ref> | tailr_progress | 하나의 마크가 적용되었음을 보고 |
npx tailr done | tailr_done | 실행이 완료됨 |
npx tailr fail "reason" | tailr_fail | 불완전하게 반환됨 |
각 마크는 ref("01"), type, 마크가 만들어진 route, 최선의 노력으로 제공되는 소스 address, CSS selector, 요소의 텍스트, 검토자의 comment를 포함합니다.
comment— 설명된 대로 해당 요소를 변경remove— 해당 요소를 삭제text—before/after를 포함; 텍스트를after로 변경point— 요소 대신 페이지x/y좌표를 포함. 검토자가 장소를 표시한 것으로, 특정 요소가 아닙니다. 그들이 그 자리에 새로운 것이 필요하거나, 단순히 위치를 표시한 것일 수 있습니다. 그들의 댓글이 이를 설명합니다.
중요한 규칙
wait는 장기 실행 백그라운드 프로세스로 실행하고, 그 종료를 알림으로 처리하세요. 검토자에게 배치가 도착했다고 알리도록 요청하거나, 폴링하지 마세요. 각 실행을 종료한 후 다시 시작하세요.- 각 마크를 적용할 때마다
progress로 보고하세요. 한 번에 모두 보고하지 마세요. 검토자는 화면에서 마크가 사라지는 것을 봅니다. 한꺼번에 보고하면 아무 일도 일어나지 않는 것처럼 보입니다. - 항상
done또는fail로 실행을 종료하세요. 그렇게 하기 전까지 검토자는 다른 배치를 보낼 수 없습니다. 수행할 수 없는 작업이 발생하면, 실제로 무엇이 잘못되었는지fail로 알리세요. Tailr는 설명을 임의로 만들지 않으며, 검토자를 당신에게 다시 안내합니다. - 소스 주소와 선택자가 일치하지 않으면, 소스 주소를 신뢰하세요.
"orphaned": true가 있는 마크는 보내기 전에 요소가 사라진 것입니다. 의도된 바를 추측하지 말고 검토자에게 문의하세요.- 마크가 모호하면, 해석을 선택하지 말고 질문하세요.
- 프로젝트 디렉토리에서 명령어를 실행하세요. 그래야 Tailr가 세션을 찾을 수 있습니다.
이 플러그인에서 명령어 실행하기
이 플러그인은 Tailr의 MCP 서버를 등록하므로, tailr_status, tailr_wait, tailr_pull, tailr_progress, tailr_done, tailr_fail을 직접 사용할 수 있습니다. CLI보다 이 도구들을 선호하세요. MCP 도구는 항상 제공되지만, npx tailr 단축어는 Tailr가 설치된 프로젝트에서만 작동합니다.
CLI를 사용해야 할 경우, 전체 패키지 이름을 사용하여 Tailr가 설치되지 않은 프로젝트에서도 작동하도록 하세요:
npx -y @gcrft123/tailr <command>
세션을 시작하는 단계에는 MCP 도구가 없습니다. 세션은 해당 도구들이 통신하는 서버이기 때문입니다. 장기 실행 백그라운드 프로세스로 시작하세요. 프로세스는 계속 실행되어야 하므로, 에이전트가 대기하는 동안 턴을 차단하지 마세요:
npx -y @gcrft123/tailr --target http://localhost:<dev server port>
프로젝트에 Tailr가 의존성으로 설치되어 있다면, 일반 npx tailr도 동일하며 더 짧습니다.