# task-1872 완료 보고서

**작업**: 3문서 2유형 체계 — Agent 미팅 진행 (코딩 금지)
**팀**: dev6-team (페룬)
**일시**: 2026-04-16
**작업 유형**: 설계 미팅 (코딩 없음)

---

## SCQA

**S**: 현재 3문서(plan.md, context-notes.md, checklist.md)는 `memory/plans/<프로젝트명>/` 단일 경로에 저장되며, 시스템 인프라 프로젝트(anu-guide-system 등)와 일반 작업 태스크가 같은 구조로 혼재되어 있다.

**C**: 제이회장님이 3문서를 "시스템 3문서"와 "작업 3문서" 2유형으로 구분하기로 결정했다. 현행 단일 경로/단일 스키마로는 유형 구분, 라이프사이클 관리(아카이브), QC 검증 기준 분리가 불가능하다.

**Q**: 시스템/작업 3문서를 어떤 경로 구조, 스키마, 코드 변경으로 구분하며, dispatch→team_prompts→workflow→QC→nuclear-approval까지 E2E로 어떻게 연동할 것인가?

**A**: Agent 미팅(7명 참석, 사이클 2)에서 전원동의 합의안을 도출했다. 경로 분리(`memory/plans/tasks/{task_id}/`), YAML `scope: system|task` 필드 추가, dispatch.py 자동 생성(Lv.3+), DIRECT-WORKFLOW Step 2.3 삽입, three_docs_check verifier 신규 추가 등 12개 파일 ~327 라인 변경 규모의 구현 설계서를 확정했다. 코드 수정은 별도 태스크로 진행.

---

## 산출물

- `/home/jay/workspace/memory/meetings/2026-04-16-3docs-two-types.md` — 미팅 기록 (합의안 + 구현 설계서 포함)

## 합의안 핵심 요약

### A. 문서 체계

1. **경로**: 시스템 3문서는 기존 `memory/plans/<프로젝트>/` 유지, 작업 3문서는 `memory/plans/tasks/{task_id}/` 신규
2. **YAML**: `scope: system | task` 필드 신규 추가 (필수)
3. **아카이브**: 완료 후 `memory/plans/tasks/archived/{task_id}/`로 이동, `archived_at` 자동 추가
4. **3docs-schema.md**: scope 필드, 경로 규약, 아카이브 규약 추가

### B. 코드 실행단

1. **dispatch.py**: `_create_task_docs()` 함수 추가, Lv.3+ 시 자동 생성 (+45 라인)
2. **team_prompts.py**: Lv.3+ 프롬프트에 작업 3문서 경로 섹션 자동 삽입 (+20 라인)
3. **DIRECT-WORKFLOW.md**: Step 2.3 "작업 3문서 초기화" 삽입 (+12 라인)
4. **qc_verify.py**: three_docs_check verifier 신규 (FAIL 5조건, WARN 3조건) (~80 라인)
5. **verification-before-completion**: 3문서 완성 검증 추가 (+25 라인)
6. **nuclear-approval**: 작업 3문서 검증 추가 (+10 라인)
7. **템플릿**: `prompts/templates/task-docs/` 3개 파일 신규

### 구현 순서
Phase 1(스키마) → Phase 2(템플릿+dispatch) → Phase 3(prompts+workflow) → Phase 4(QC verifier) → Phase 5(검증 연동) → Phase 6(테스트)

---

## 발견 이슈 및 해결

1. **경로 분리 방식 불일치**: 로키(최상위 분리)와 라다(하위 분기) 간 의견 차이 → 기존 경로 하위호환 유지를 위해 하위 분기 방식으로 합의 해결
2. **YAML 필드명 충돌**: `doc_class` vs `scope` → 기존 네이밍 컨벤션(단일 영단어)과의 일관성으로 `scope` 채택
3. **워크플로우 삽입 시점 불일치**: Step 2.3(설계 시) vs Step 3.5(완료 시) → 2단계 접근(초기화+완성 검증)으로 양쪽 의견 수렴

---

## 셀프 QC

- [x] 1. 영향 파일 목록 명시 — 12개 파일 변경 범위 명시 완료
- [x] 2. 엣지 케이스 — 벨레스 테스트 매트릭스에 깨진 YAML, 빈 파일, 심볼릭 링크 등 5건 포함
- [x] 3. 작업 지시와 정확히 일치 — "미팅만 진행, 코딩 금지" 준수, 코드 수정 0건
- [x] 4. 보안 — 로키가 path traversal 방어, 권한 제한 설계 반영
- [x] 5. 테스트 커버리지 — 벨레스 테스트 계획 20케이스 합의
- [x] 6. 이슈 직접 해결 — 3건 쟁점 모두 미팅 내 합의로 해결
- [x] 7. 아키텍처 원칙 — 기존 경로 하위호환, 단일 책임(verifier 분리) 준수
- [x] 8. 인터페이스 변경 — 스키마 변경 사항을 3docs-schema.md 업데이트 범위에 명시
- [x] 9. 이미지/배너 — 해당 없음 (코딩/디자인 작업 아님)
- [x] 10. CLAUDE.md — 변경 없음

## 모델 사용 기록

| 팀원 | 모델 | 작업 내용 |
|------|------|----------|
| 스바로그 (백엔드) | sonnet | 코드 실행단 설계 의견 |
| 라다+모코시 (프론트/UX) | sonnet | 프론트엔드/UX 관점 의견 |
| 벨레스 (테스터) | sonnet | 테스트 계획 의견 |
| 로키 (DA/보안) | sonnet | 보안/데이터 관점 의견 |
| 마아트 (QC) | sonnet | QC 검증 체계 의견 |

## 횡단조직 소환 기록

| 에이전트 | 소환 목적 | 시간 |
|---------|----------|------|
| 로키 (loki) | 3문서 2유형 체계 미팅 참여 | 12:01~12:03 |

## 증거

- 미팅 기록 파일: `/home/jay/workspace/memory/meetings/2026-04-16-3docs-two-types.md` (합의안 전문 포함)
- 미팅 참가자: 7명 (6팀 5명 + 횡단조직 2명)
- 합의 상태: 전원동의 (사이클 2)
- 코드 수정: 0건 (미팅 전용 작업)

## 세션 통계
- 총 도구 호출: 3회

### 수정 파일 목록
- /home/jay/workspace/memory/meetings/2026-04-16-3docs-two-types.md: 1회 (Write)
- /home/jay/workspace/memory/reports/task-1872.md: 1회 (Write)
- /home/jay/workspace/memory/tasks/task-1872.md: 1회 (dispatch)

### 도구 사용 현황
- Write: 2회
- dispatch: 1회