AI 에이전트를 위한 피드백

보통의 피드백은 사람이 볼 티켓을 만듭니다. 에이전트가 바로 쓰는 피드백(agent-ready feedback)은 AI가 곧장 행동으로 옮길 수 있는 컨텍스트를 만듭니다. 자유 텍스트 설명이 아니라 요소의 셀렉터, 스크린샷, 그리고 아티팩트의 목표와 제약 조건까지요.

덜렁 스크린샷 하나에 "이거 고쳐줘"만 붙이면 에이전트는 목표와 의도를 추측할 수밖에 없고, 추측 한 번마다 재생성 비용이 듭니다. 구조화된 피드백은 그 추측을 없앱니다. 에이전트는 명시된 목표에 맞게 정확한 요소를 고칩니다.

artifact-review 모드에서 Patchrooms는 코멘트마다 목표, 제약 조건, 사용 도구를 셀렉터, 스크린샷과 함께 첨부합니다. 구조화 작업은 클릭하는 그 순간 한 번만 일어납니다. 누군가 버그를 에이전트에 넘길 때마다 반복하지 않습니다.

• 클릭한 요소의 DOM 셀렉터.
• 스크린샷, URL, 뷰포트, 브라우저, 그리고 발생한 콘솔 에러.
• 텍스트 코멘트 또는 자동으로 변환된 음성 메모.
• 리포트별 상태: 신규, 분류됨, 진행 중, 마감.

사람이 아무것도 붙여넣지 않아도 돌아가는 루프를 위해, MCP 피드백 서버는 list_reports와 get_report(스크린샷 인라인 포함)를 노출해 에이전트가 큐를 직접 읽게 하고, set_status로 고친 것을 마감하게 합니다. 읽기와 마감은 지금 동작하며, Slack, Linear, Jira 네이티브 커넥터는 아직입니다.

secret key(pr_sk_...)는 에이전트를 MCP에 인증하며 프런트엔드에는 절대 노출되지 않습니다. MCP 문서는 영어로 docs.patchrooms.com에 있습니다.

컨텍스트를 직접 붙여넣고 싶으신가요? 모든 리포트는 Markdown으로 내보내져 Claude Code, Cursor, Codex, Windsurf, Cline에 읽어서 붙여넣을 수 있습니다. 에이전트가 실제로 읽는 텍스트는 영어입니다(모델이 소비하는 그대로입니다). 내보낸 결과는 이렇게 생겼습니다.

## Report: Checkout review
**Tool:** claude-code   **Goal:** reduce checkout friction
**Constraint:** keep the layout single-column

- **Element:** `input#coupon-code`
- **Comment:** Remove the coupon field; almost no one uses it.
- **Screenshot:** blob/scr_5da7.png
- **URL:** https://preview.example.com/checkout

AI 아티팩트 리뷰(AI artifact review)는 곧 이 루프입니다. 생성하고, 그 자리에서 리뷰하고, 고치는 것. 모든 코멘트는 상태와 함께 대시보드에 도착하므로, 팀은 채팅 기록을 다시 읽는 대신 무엇이 해결됐고 무엇이 열려 있는지 바로 봅니다.

코드 리뷰가 시작되기 전의 체크포인트입니다. diff가 아니라 에이전트가 실제로 렌더링한 것을 누군가 들여다보는 단계죠. agent-ready feedback과 workflows에서 더 살펴보세요.