저는 여러 고객을 위한 에이전트 시스템 (agent systems)을 구축하고 있습니다. 코드 외에도 통합 사양서 (integration specs), 프로젝트 계획서, 보고서와 같은 문서들을 제공해야 합니다. 고객은 프로젝트 전이나 진행 중에 이 문서들을 읽고 승인해야 합니다. 저는 한동안 Google Docs에 이 문서들을 쓰는 것을 중단했는데, 제 에이전트가 제가 하는 것보다 훨씬 빠르게 작성하기 때문입니다 (게다가 더 보기에도 좋습니다). 하지만 첫 번째 초안은 항상 부분적으로 틀립니다. 너무 길거나, 잘못된 권장 사항을 제시하거나, 이상한 제안을 하기도 합니다. 그래서 제 업무는 문서를 작성하는 것에서 검토하는 것으로 바뀌었습니다. 또한 저는 마크다운 (Markdown)을 사용하지 않습니다. 마크다운은 에이전트에게는 괜찮지만, 전체 사양서를 마크다운으로 읽는 것은 저에게 고통스럽고, 고객도 어차피 문서를 받아야 하기 때문입니다. 그래서 에이전트는 HTML을 생성합니다. 읽기 쉽고, 타이포그래피가 훌륭하며, 다이어그램과 코드 블록 (code blocks)이 포함됩니다. 이것이 새로운 문제를 만들었습니다. 에이전트에게 무엇이 틀렸는지 어떻게 알려줄 것인가 하는 점입니다. 저는 "3절, 인보이스 매핑 아래 두 번째 문단에서 당신이 틀렸습니다"라고 타이핑하고 싶지 않습니다. 그래서 저는 이를 위해 웹 앱을 직접 만들었습니다 (공지: 이것은 저의 개인적인 도구이며, 이 게시물은 워크플로우에 관한 것이지 링크 공유를 위한 것이 아닙니다). 루프는 다음과 같습니다: 저의 개인적인 단계: 에이전트가 초안을 완성하고 제 웹 앱의 개인 프로젝트에 HTML을 푸시(push)하면, 저는 브라우저에서 이를 열고 앵커 댓글 (anchored comments)을 남깁니다. 에이전트가 생성한 문장, 다이어그램, 또는 이미지를 클릭하고 무엇이 틀렸는지 또는 무엇이 누락되었는지 입력합니다. 다시 터미널 (terminal)로 돌아가서 "내 댓글을 가져와서 작업해줘"라고 말합니다. 에이전트는 각 댓글이 연결된 정확한 인용구나 요소를 함께 가져옵니다. 댓글의 내용에 따라 에이전트는 수정안을 제안하고 저와 하나씩 검토하거나, 제가 이해하지 못한 부분을 설명해 줍니다. 에이전트는 변경 사항을 적용하고, 새 버전을 업로드하며, 처리한 댓글에 표시를 합니다. 저는 브라우저에서 다시 읽습니다. 문서가 괜찮아질 때까지 반복합니다. 고객 단계: 제가 만족하면, 에이전트는 깨끗한 사본을 제 앱 내의 고객 프로젝트(별도)에 새로운 v1으로 게시합니다. 버전 기록이나 저의 내부적인 "이건 틀렸어, 어떻게 이렇게 바보 같을 수 있지!" 같은 댓글은 전혀 남지 않습니다. 고객은 저의 지저분한 전체 과정을 결코 보지 못합니다.

고객은 브라우저에서 URL을 열고 제가 했던 것과 동일한 방식으로, 정확한 문장이나 다이어그램에 댓글을 답니다. 또한 고객은 MCP를 통해 자신만의 에이전트 (Agent)를 연결하여 문서에 대해 질문할 수도 있습니다. 저는 제 에이전트를 사용하여 고객의 댓글을 가져옵니다. 그중 일부는 에이전트가 프로젝트 컨텍스트 (Project Context)를 바탕으로 스스로 답변할 수 있으며, 나머지는 우리가 함께 검토합니다. 저는 댓글창에 직접 답변을 타이핑하는 일이 전혀 없습니다. 새로운 버전이 업로드되면, 고객은 자신의 댓글 중 어떤 것이 해결되었는지(어떤 노트와 함께), 그리고 어떤 것이 여전히 열려 있는지 확인할 수 있습니다. 이는 저에게 두 가지 문제를 해결해 주었습니다. 첫째, 양방향 모두에서 피드백을 다시 타이핑할 필요가 없다는 점입니다 (제 댓글은 에이전트의 작업 항목이 되고, 고객의 댓글은 동일한 방식으로 돌아옵니다). 둘째, 고객은 제가 이미 검토한 문서만을 보게 된다는 점입니다. 물론 Claude Code/Cowork에서 결과물 (Artifacts)을 직접 게시하는 방법도 있지만, 저는 Claude, Codex, Cursor를 동시에 사용하고 있습니다. 그리고 각각의 도구는 동일한 MCP를 통해 제 웹 앱에 연결되어 동일한 문서에서 작업합니다. 설정에 대해 궁금한 점이 있다면 기꺼이 답변해 드리겠습니다. /u/Competitive_Rip8635 제출 [link] [comments]