[보관] 30. 리포트 샘플 분할 — easy(비개발자용) / detailed(상세) 두 버전

시각: 2026-04-28 ~12:35 KST 컨텍스트: 03-sample-report.md를 강의·기업 제공 자료로 활용 결정 후, 청중 분리 필요성 발견

무엇이 있었나

사용자가 본 프로젝트의 외부 활용처를 명시: AI 에이전트 셋업 강의 + 기업 도입 자문 자료. 단일 리포트로는 비개발자 의사결정자와 방법론자 양쪽을 모두 만족시킬 수 없음 → 청중별 분리 결정.

새 구조:

reports/
├── README.md      # 버전 카탈로그 + 청중별 권장
├── easy.md        # 8~12쪽, 비개발자 의사결정자·강의 수강생용
└── detailed.md    # 40~60쪽, 방법론자·R&D·구매 심사용 (구 03-sample-report.md)

기존 03-sample-report.md는 얇은 포인터(3행) 로 축소 — reports/로 이전됐음을 안내. 본문 전체는 reports/detailed.md로 이전.

reports/easy.md는 새 작성. 차이점:

통계 용어(ICC·κ·표준편차·반증 조건·메타평가·프레이밍) 모두 회피
시각적 막대 그래프(ASCII), 4 시나리오 분기, 5문항 체크리스트, 결정 트리 부록
“솔직한 한계” 표 — 답하지 않는 것 명시
“자주 받는 질문” Q&A 4건
detailed로 더 깊이 가는 다음 단계 표

왜 그렇게 갔나

활용 맥락이 결정: 본 산출물은 강의 부교재 + 기업 도입 자료로 쓰일 예정. 청중이:

수강생/CXO = 결정에 필요한 만큼만, 통계 없이, 시나리오 중심
CTO/평가 엔지니어 = 재현·반박 가능성 우선, 통계·절차 전부

같은 데이터·같은 결론, 청중별 다른 작성:

easy는 detailed의 요약본이 아님 — 별도 작성
두 파일 갱신은 동시에, detailed가 진실 원본
easy에서 새 결론 추가 금지

확장성 고려: 향후 onepager(임원), course-handout(강의 워크북), slide-deck, replication-kit 등 더 많은 청중 대응 버전이 들어갈 수 있는 구조. reports/에 누적, README 카탈로그에 한 줄 추가하는 방식.

기존 03 처리: 3가지 안 검토했음:

03 삭제 + 모든 참조 갱신 (가장 깔끔)
03 그대로 유지 + reports/ 별도 생성 (중복 발생)
03을 얇은 포인터로 축소 + 본문은 reports/로 이전 (선택)

3안 채택 — history/28·29에 03 참조가 박혀있어 유지하면서, 03 자체는 카탈로그성 1쪽으로 축소.

무엇이 남았나

이번 턴 cascade:

reports/README.md 신규 (버전 카탈로그 + 청중별 권장 + 작성 규칙)
reports/detailed.md 신규 (구 03 본문 + L3 §6.5 가설 검증 표·§6.7 v2 GO/NO-GO 판정·§6.8 변경 이력 추가, 부록 ICC 격상)
reports/easy.md 신규 (8 본문 + 결정 트리·FAQ 부록 2개)
03-sample-report.md 본문 → 얇은 포인터로 교체 (3쪽 → 1쪽)
README.md 문서 표 + 산출물 표 갱신
07-indicator-spec.md I5 W2 루브릭 참조를 reports/detailed.md로

운영상 후속:

easy/detailed 두 파일에 같은 데이터를 일관되게 채워 넣는 작성 절차 명시 — reports/README.md “작성 규칙”에 박음
향후 추가 버전(onepager·course-handout·slide-deck·replication-kit)은 reports/ 누적, 같은 청중 분리 원칙 유지
강의·기업 자료로 변환 시 브랜딩(로고·연락처) 추가 필요 — 본 샘플에선 미포함, v1 채움 시점에 결정

알려진 위험

easy/detailed 결론 어긋남 위험: 두 파일을 동시에 갱신하지 않으면 의사결정자(easy)가 본 결론이 방법론자(detailed) 결론과 달라질 수 있음. 작성 룰에 “두 파일 동시 갱신, detailed가 진실 원본” 박았으나 운영 규율 필요.
easy의 시각적 막대 그래프: 현재 ASCII 블록 문자 사용 — Slack·이메일·PDF 변환 시 폰트 의존. 실데이터 채울 때 SVG/PNG로 교체 검토.
easy 부록 A의 결정 트리: 현재 상상으로 가정 — D3 종료 후 데이터로 확정해야 신뢰성 확보. 가정을 결과로 말하지 않도록 주의.
strict한 청중 분리: 일부 독자는 “easy를 봤는데 detailed로 가야 하나?”를 모를 수 있음. easy 끝에 “다음 단계” 표를 박았으나 onepager(1쪽)가 추가되면 그 분기도 명시 필요.