Human Review
AI 에이전트가 만든 HTML과 Markdown을 위한 로컬 시각 편집기 — 그 자리에서 고치고, 문서처럼 코멘트하고, 한 번에 통째로 돌려보내기
Human Review는 AI가 생성한 HTML 또는 Markdown 파일 — 혹은 localhost에서 돌고 있는 페이지 — 을 편집 가능한 문서로 브라우저에 열어 주는 MIT 라이선스 명령줄 도구입니다. 문구를 직접 고치고, 블록을 재배치하고, 특정 문구나 요소에 고정된 코멘트를 남긴 다음, 변경 사항과 코멘트를 한 묶음으로 에이전트에게 되돌립니다. 채팅으로 변경을 설명할 필요가 없습니다. 모든 것이 내 컴퓨터에서 돌아가며, README는 계정도 클라우드 서비스도 데이터베이스도 API 키도 필요 없다고 밝힙니다.
Human Review란
Human Review(github.com/petergyang/human-review)는 MIT 라이선스의 작은 JavaScript CLI로, 2026년 7월 말에 처음 공개됐습니다. 에이전트가 호출할 수 있는 스킬로 설치하거나 npx로 직접 실행한 뒤 파일을 지정하면 — `/human-review (대상 파일)` — 그 파일이 편집 가능한 페이지로 브라우저에 열립니다. 이 도구가 지목하는 문제는 익숙합니다. 채팅으로 에이전트에게 피드백을 준다는 것은 "세 번째 섹션의 X를 Y로 바꾸고, 첫 번째와 겹치는 카드를 빼고, 행동 유도 문구를 다시 써 줘" 같은 문단을 쓴 다음, 모델이 무엇을 어떻게 이해했는지 확인하려고 파일 전체를 다시 읽는 일입니다.
- 출력물을 직접 편집한다. 텍스트를 제자리에서 기본 서식과 함께 바꾸고, 글머리 기호와 번호 목록을 만들고, 키보드 단축키로 링크를 추가하거나 수정하고, 모서리를 끌어 이미지 크기를 바꾸고, 이미지를 옮기고, 블록 전체를 끌어 페이지를 재배치할 수 있습니다.
- 문서처럼 코멘트한다. 문구를 선택해 그 정확한 위치에 코멘트를 고정하거나, 이미지·차트·섹션을 클릭해 해당 요소에 코멘트를 답니다. 무언가를 지울 때 채팅으로 설명할 필요는 없습니다. 그냥 없애면 됩니다.
- 한 번에 모두 보낸다. Send 한 번이면 모든 편집과 코멘트가 함께 에이전트에게 전달되고, 에이전트가 원본에 반영한 뒤 다음 검토를 위해 페이지를 새로 고칩니다. 링크를 커맨드 클릭하면 도중에 피드백을 잃지 않고 한 세션에서 여러 페이지를 검토할 수 있습니다.
- 파일뿐 아니라 돌고 있는 앱도 검토한다. localhost URL을 지정하면 실제 페이지를 검토합니다. README는 차이를 정확히 짚습니다. HTML 파일에서는 직접 편집과 크기 변경이 자동 저장되고, Markdown과 localhost 검토는 에이전트가 원본에 반영할 수 있도록 Send가 필요합니다.
창업자의 스택에서 어디에 놓이나
이것은 그로스 도구가 아니며, 그 점은 분명히 해 두는 편이 좋습니다. 한 겹 앞쪽, 모든 AI 작업 흐름이 만들어 내지만 거의 아무도 풀지 않는 왕복 구간에 놓입니다. 에이전트가 무언가를 내놓았다와 이게 맞다 사이의 틈입니다. 편집을 산문으로 설명하는 방식은 양쪽으로 정보를 흘립니다. 변경을 서술하는 데 변경을 직접 하는 것보다 오래 걸리고, 그러고도 제대로 반영됐는지 감사해야 합니다. 산출물을 직접 편집하면 서술 단계가 통째로 사라집니다.
궁합이 가장 또렷한 곳은 마케팅 페이지입니다. 에이전트의 출력이 완성돼 보이면서 틀렸을 가능성이 가장 높은 자리이기 때문입니다. 모델에게 랜딩 페이지를 만들게 하고 있다면, 검토 한 바퀴가 초안과 사이트를 가르는 전부입니다. 사냥할 만한 구체적 결함은 웹사이트를 만들 때 AI를 써야 할까에 정리해 두었습니다. 저장소 자체는 어리고, 정착했다기보다 활발히 개발 중입니다. 2026년 7월에 만들어졌고 8월 초에 v0.5.0과 v0.6.0이 하루 간격으로, v0.6.1이 2026-08-15에 나왔습니다. 인터페이스는 계속 움직인다고 보는 편이 좋습니다.
검토 단계가 새로 만드는 실패 방식
사람을 회로 안에 넣는 것은 옳은 직관이고, 공짜가 아닙니다. 작업을 잃는 새로운 경로, 즉 결코 일어나지 않는 검토를 들여옵니다. 우리는 자체 플랫폼에서 이를 배웠습니다. 에이전트가 제안하는 모든 대외 행동은 사람의 승인을 기다리고, 그 관문은 프롬프트로 요청되는 대신 코드로 강제됩니다. 프롬프트 수준의 규칙은 부탁이고 코드 수준의 규칙은 그렇지 않기 때문입니다. 우리 시스템이 만들어 낸 처음 스물네 건의 승인 요청 가운데 정확히 절반은 완료된 행동이 되지 못했습니다. 다섯 건은 상대편에서 실패했고, 일곱 건은 아예 클릭되지 않았습니다.
흥미로운 숫자는 그 일곱입니다. 아무도 거절하지 않았습니다. 그저 누군가 신경 쓰던 순간보다 대기열이 더 오래 살아남았을 뿐입니다. 그것이 검토 단계가 물리는 세금이고, 그래서 원칙보다 설계의 세부가 더 중요합니다. 대기열은 보여야 하고, 한 묶음은 한 번에 비울 수 있을 만큼 작아야 하며, 도구는 실제로 무슨 일이 있었는지 되돌려 보고해야 합니다. 마지막 항목은 우리도 나중에 덧붙였습니다. 자기 승인의 결말을 볼 수 없는 에이전트는 게시되지 않은 것을 게시했다고 고객에게 태연히 말하기 때문입니다.
그 경계가 곧 AgentCeres — AI 그로스 오피서, agentceres.com — 의 설계 전부입니다. 전문가 팀이 SEO 페이지와 소셜 게시물, 광고, 아웃리치를 초안으로 쓰고, 세상으로 나가는 것은 무엇이든 사람이 승인 버튼을 누를 때까지 기다립니다. Human Review 같은 로컬 편집기는 그 클릭을 더 잘 아는 클릭으로 만들어 줍니다. 산출물을 검토하는 편이 그 설명을 검토하는 것보다 낫기 때문입니다. 어느 쪽이든 초안은 싼 절반입니다. AI 마케팅 팀이 실제로 할 수 있는 일도 함께 보세요.
FAQ
- Human Review는 무료인가요?
- 네. 저장소는 MIT 라이선스이고 전부 로컬에서 돌아갑니다. README는 계정도 클라우드 서비스도 데이터베이스도 API 키도 필요 없다고 밝힙니다. 드는 비용은 이미 쓰고 있는 에이전트 값뿐입니다. Human Review는 검토 단계만 맡고, 편집 내용은 반영을 위해 에이전트에게 넘깁니다.
- Human Review는 어떤 AI 도구와 함께 쓰나요?
- README는 Claude Code와 Codex를 포함한 코딩 에이전트용 스킬로 설치하는 방법을 설명합니다. 저장소에서 설치해 달라고 에이전트에게 요청하거나 `npx -y human-review setup --global` 을 실행하면 됩니다. 저장소에는 에이전트에게 사용법을 가르치는 SKILL.md가 들어 있어, 스킬 파일을 읽는 환경이면 모두 대상입니다.
- AI 출력이 괜찮아 보여도 검토가 필요한가요?
- 특히 그럴 때 필요합니다. 생성된 페이지에서는 완벽하게 보이는 부분이 망가져 있을 확률이 가장 높습니다. 목적지가 없는 문의 폼, 내 컴퓨터에서만 열리는 이미지 같은 것들이요. 페이지를 바라보는 것과 확인하는 것은 다릅니다. 그래서 쓸모 있는 검토는 읽는 검토가 아니라 산출물을 직접 만져 보는 검토입니다.
You built it. Now grow it.
AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.