Codex에서 AI 팀을 만들고, 보고서의 누락을 독립 검수로 찾아봤습니다
2026.10.08
소개: 내 업무에 맞는 AI 팀으로 과제를 해보기
이번 주 과제는 나만의 AI 부서를 구성하고, 실제 업무 하나를 맡겨 결과물을 만들어보는 것이었습니다. 저는 Codex에서 이 과정을 진행하고 싶었습니다.
고른 업무는 업무용 시스템의 기능 개선을 추가로 조사·기획할지 판단하기 위한 보고서 작성입니다. 기존 화면 점검 기록과 유사 서비스 참고 자료를 읽고, 어떤 기능을 검토할지와 그 전에 무엇을 확인해야 하는지를 정리하는 일입니다.
기존 보고서 작성 스킬 두 개를 출발점으로 삼았습니다. 의사결정자용 보고서의 구성과 조사·작성·검수 인계 방식을 참고해 팀 지침을 만들었습니다.
진행 방법: 먼저 역할과 문서부터 정했습니다
팀 이름은 제품 의사결정 지원팀입니다. 역할은 네 가지로 나눴습니다.
역할 | 맡긴 일 |
|---|---|
Master | 업무 범위와 결정 질문 정리, 사용할 근거 선택, 작성 기준 확정, 결과 통합 |
Researcher | 제공 자료에서 사실·제약·충돌·미확인 사항 조사 |
Writer | 선택한 근거로 HTML 보고서 초안 작성, 검수 피드백 반영 |
Reviewer | 원문과 초안을 비교해 누락·단정·범위 이탈 확인, 변경 부분 재검수 |
Master는 메인 대화가 맡고, Researcher·Writer·Reviewer는 각각 별도의 실제 서브에이전트로 실행했습니다. 앞 단계의 결과를 다음 역할에 전달하는 순서로 진행했습니다.
모델은 별도로 지정하지 않았습니다. 서브에이전트는 부모 설정을 상속했고, 정확한 모델명과 추론 수준은 실행 기록에서 확인할 수 없어 ‘미확인’으로 남겼습니다.
업무를 시작하기 전에는 작업 폴더에 다음 문서를 준비했습니다.
AGENTS.md: 공통 행동, 파일 보존, 권한과 검증 규칙TEAM.md: 역할, 실행 순서, 근거와 인계 형식, 보고서 기준TASK-TEMPLATE.md: 실제 업무 요청을 정리하는 양식RUN-TEMPLATE.md: 진행 상태와 검수·수정 내용을 남기는 양식
이 문서들이 이번 팀의 ‘문서형 하네스’입니다. 누가 무엇을 하고, 어떤 파일을 다음 역할에 넘기며, 무엇을 확인해야 완료인지 적었습니다. 실제 에이전트는 업무 실행 단계에서 따로 호출했습니다.
실제로 맡긴 업무
업무용 시스템의 상세 화면에 판단 근거를 보여주는 정보 영역을 추가할지 검토하는 보고서를 맡겼습니다. 사용자가 어떤 항목을 확인할 때, 판단에 필요한 정보와 그 근거를 함께 볼 수 있도록 하는 기능입니다.
결정 질문은 다음과 같이 좁혔습니다.
판단 근거를 보여주는 상세 정보 영역의 추가 조사·기획을 진행할지, 선행 확인까지 보류할지 판단할 수 있도록 보고서 초안을 작성한다.
자료는 기존 화면 점검 기록, 유사 서비스 기능 점검 기록, 비교 분석 기록, 외부 서비스 소개 PDF의 총 4개였습니다. 자료에서 확인한 사실과 제안, 아직 모르는 것을 구분하도록 했습니다.
이번 업무에서 만들 결과는 최소 표시 범위, 판단 근거, 제약, 선행 확인 사항이 담긴 HTML 보고서 초안이었습니다. 개발과 실제 고객 조사는 다음 판단에 필요한 사항으로 남겼습니다.
흐름은 아래와 같습니다.
업무 정리 → 자료 조사 → 작성 기준 확정 → HTML 초안
→ 독립 검수 → 수정·통합 → 변경 부분 재검수 → 결과 저장시행착오: 조사에는 있던 조건이 초안에서 빠졌습니다
독립 검수에서 발견한 문제는 판단 근거가 어느 대상에 적용되는지를 확인할 조건의 누락이었습니다.
자료에는 개별 항목, 여러 항목을 묶은 그룹, 현재 화면에서 조회한 범위가 구분돼 있었습니다. 이들은 같은 대상이나 범위라고 가정할 수 없습니다.
예를 들어 그룹 전체의 판단 근거를 선택한 항목 하나의 근거로 그대로 읽으면, 판단 대상이나 비율 계산의 기준을 혼동할 수 있습니다. 이는 누락이 중요한 이유를 설명하는 예시입니다. 실제 시스템에 그런 계산 오류가 있다고 확인한 것은 아닙니다.
파일을 비교했을 때 누락 경로는 다음과 같았습니다.
단계 | 기록에서 확인한 내용 |
|---|---|
Researcher 조사 | 개별 항목과 그룹의 구분을 먼저 확인한다는 조건이 있었음 |
Master 작성 인계 | 최소 표시 범위로 요약하면서 해당 조건이 빠짐 |
Writer 최초 초안 | 빠진 조건을 보완하지 못함 |
Reviewer 독립 검수 | 원문의 구분과 초안을 비교해 누락 발견 |
확인 가능한 최초 누락 지점은 Master의 요약·작성 인계였습니다. Writer에게 전달되기 전의 기준 문서부터 조건이 빠져 있었고, 초안에서도 복구되지 않았습니다.
수정할 때는 근거가 개별 항목·그룹·현재 조회 범위 중 어디에 적용되는지 확인하도록 했습니다. 전체 기간과 선택한 기간의 구분도 선행 확인 사항에 넣었습니다. 수치와 비율은 적용 대상·기간·분모·산식·이용권한을 확인할 수 있을 때만 후보로 남겼습니다.
최초 초안은 덮어쓰지 않았습니다. 수정본을 별도로 만들고 관련 부분을 다시 독립 검수받았습니다. 재검수에서는 이 문제의 해결을 확인했습니다.
결과: 보고서 초안과 수정 경로가 남았습니다
최종적으로 저장한 HTML은 8개 절로 구성했습니다. 결정 요청, 핵심 메시지, 제안 범위, 판단 근거, 예상 효과와 제약, 미확인 사항, 사람의 결정 사항, 근거 부록입니다. 채택·제외 및 충돌 기록을 포함한 근거 ID 18개를 연결했습니다.
보고서의 권장안은 현행 기능·데이터·실제 업무 문제부터 확인하는 제한된 조사 진행입니다. 조사 자료나 자원을 확보하기 어렵다면 선행 확인까지 보류하는 선택지도 남겼습니다.
상세 정보 영역에서 조사할 기본 표시 후보는 분류와 의미, 연결 근거, 관계와 조회 범위, 출처와 시간, 불확실성과 상태입니다. 수치·비율은 정의와 이용 조건을 확인한 경우에만 포함하도록 했습니다.
유사 서비스 화면은 표시 사례로 참고했습니다. 다른 서비스에 화면이 있다는 사실만으로 해당 시스템의 구현 가능성을 확정하지 않았습니다. 사용자의 필요, 데이터 이용권한, 비용과 효과도 미확인으로 남겼습니다.
저장한 파일은 아래와 같습니다.
파일 | 남긴 내용 |
|---|---|
| 문제가 남아 있던 최초 초안 |
| 검수 후 수정·통합한 보고서 초안 |
| 조사 결과, 최초 작성 기준, 수정된 근거 기록 |
| 최초 검수와 변경 부분 재검수 |
| 실제 역할, 단계, 발견한 문제, 검증과 남은 제한 |
| 과제 제출 항목에 맞춘 결과 정리 |
내용 검수와 화면 확인도 구분했습니다. Reviewer는 원문과 보고서를 대조했습니다. Master는 데스크톱·모바일의 대표 화면, 근거 링크와 표의 키보드 탐색을 별도로 확인했습니다.
이번 실행으로 보고서 작성·독립 검수·수정의 한 사이클을 마쳤습니다. 시간 절감이나 비용은 측정하지 않았으며, 실제 시스템 검증과 사용자 인터뷰는 수행하지 않았습니다.
이 실행에서 확인한 점과 다음 개선 후보
이번에는 별도 Reviewer가 인계 과정에서 빠진 조건 한 건을 발견했습니다. 여러 역할을 두어도 요약 단계에서 필요한 조건이 사라질 수 있고, 원문과 초안을 대조하는 검수에서 그 누락을 찾아낼 수 있다는 사례가 남았습니다.
출처 링크가 붙어 있는지와 원문의 중요한 구분이 유지됐는지는 함께 확인할 필요가 있습니다. 최초 조사·작성 기준·초안을 보존해 두었기 때문에 조건이 어느 단계에서 빠졌는지도 비교할 수 있었습니다.
다음 개선 후보는 작성 인계 전에 근거가 적용되는 대상, 조회 범위, 기간 조건이 조사 결과에서 작성 기준으로 이어졌는지 확인하는 점검입니다.
하네스는 무엇부터 바꾸면 좋을까?
현재 권장안은 문서의 인계 규칙을 먼저 보완하고, 네 역할의 분업은 유지하는 것입니다. 이번에는 자료를 읽지 못한 것이 아니라, 읽은 조건이 작성 인계에서 빠졌습니다.
선택지 | 이번 실패를 바탕으로 한 개선 후보 |
|---|---|
문서 |
|
분업 | 현재 네 역할 유지. Master·Writer·Reviewer의 인계 점검 책임을 구체화 |
MCP | 이번 누락을 해결하기 위한 추가 필요성은 확인되지 않음. 외부 자료 접근·도구 연동 문제가 생길 때 검토 |
구체적인 규칙은 이렇게 제안합니다. Master는 중요한 조건의 채택·제외·미확인과 이유를 남깁니다. Writer는 채택 조건을 본문이나 선행 확인 사항에 반영합니다. Reviewer는 조사 결과 → 작성 기준 → 초안을 비교해 빠진 조건이 있는지 확인합니다.
이 권장안은 과제와 사례글에 기록한 개선 제안입니다. 공통 팀 지침이나 MCP 설정을 실제로 수정하지는 않았습니다. 다음 실행에서 중요 조건이 유지됐거나 제외 이유가 남았는지 확인하는 것이 검증 후보입니다. 재발 방지 효과는 아직 확인하지 않았습니다.
느낀 점과 아쉬웠던 점 — 회고 제안
아래는 실행 기록을 바탕으로 추천한 회고 문안입니다. 작성자의 실제 감상으로 확정된 내용은 아닙니다.
가장 도움이 됐던 점은 별도 검수 에이전트가 원문과 초안을 비교해 빠진 조건을 찾아준 것입니다. 최초 초안과 수정 기록을 남겨 두니, 결과물을 고치는 데서 그치지 않고 어느 인계 단계에서 누락됐는지도 확인할 수 있었습니다.
아쉬웠던 점은 역할을 나눠도 조사에서 확인한 조건이 작성 기준으로 모두 이어지지는 않았다는 것입니다. 다음에는 역할별 작업뿐 아니라, 중요한 조건이 다음 단계에 제대로 전달됐는지도 확인해보고 싶습니다.
비슷한 업무에 써볼 수 있는 요청문
아래는 이번 방식에서 정리한 재사용용 요청문입니다. 실제로 입력한 원문 전체를 그대로 옮긴 것은 아닙니다. 사용하는 환경에서 별도 에이전트 실행을 지원하는지 먼저 확인하면 됩니다.
제품 의사결정 지원팀으로 이 업무를 진행해줘.
너는 Master이고, Researcher·Writer·Reviewer를 서로 다른 실제
서브에이전트로 실행해줘.
업무: [기능]의 추가 조사·기획을 진행할지 판단하기 위한
보고서 초안 작성.
자료: [제공 자료 목록]
범위: 최소 표시 항목, 근거, 제약, 선행 확인 사항.
제공 자료를 조사한 뒤 작성 기준을 정하고 초안을 작성해줘.
별도 Reviewer가 원문과 초안을 대조하도록 하고,
필수 수정 사항을 반영한 뒤 변경 부분을 재검수해줘.
최초 초안과 수정본을 따로 보존하고 실행 기록도 남겨줘.
확인된 사실·제안·미확인을 구분하고,
실제로 실행한 역할과 확인할 수 있는 모델만 기록해줘.
개발·우선순위·출시 결정은 사람에게 남겨줘.



AI가 역할을 나눠서 보고서를 만들고, 다른 AI가 빠진 내용을 다시 확인한다는 점이 신기했어요. 초안과 수정본을 따로 남겨서 어디서 빠졌는지 찾은 부분도 인상적이었습니다. 좋은 사례 감사합니다!