# task-1309.1 MoAI-ADK 검증 발견 이슈 6건 해결 보고서

**작업자**: 이참나 (dev7-team)
**작업일**: 2026-04-01
**검증 레벨**: critical

---

## S - Situation

task-1306.1(5팀 검증)에서 MoAI-ADK 전체 도입 검증 시 6건의 이슈가 발견되었다. 4건은 5팀이 자체 해결했고, 2건(TRUST 5 문서화 누락, test_dispatch.py 환경변수 의존 실패)은 범위 외로 미해결 상태였다.

## C - Complication

미해결 2건이 잔존하면 (1) QC-RULES.md에 TRUST 5 품질 차원이 문서화되지 않아 팀 간 QC 일관성 저하, (2) test_dispatch.py가 환경 의존적이면 CI 환경에서 44건 실패 반복 위험이 있었다.

## Q - Question

6건 전부(기해결 4건 확인 + 미해결 2건 해결)를 완료하여 MoAI-ADK 도입 정합성을 확보할 수 있는가?

## A - Answer

6건 전부 해결 확인 완료. 기해결 4건 정상 확인, test_dispatch.py는 task-1303.1의 conftest.py 수정으로 이미 해결(141 passed), TRUST 5는 QC-RULES.md 문서화 + dev7 qc_verify.py에 로직 추가로 해결. 전체 테스트 291건 통과(0 fail), pyright 에러 0건.

---

## 작업 상세

### 이슈 1: organization-structure.json haiku 잔존 — 확인 완료

- 컨설팅/출판 3명(폴리뮤니아, 아스클레피오스, 테미스) 모두 sonnet으로 동기화 확인
- 잔여 haiku 참조 10건은 의도적 할당(에코/픽셀/아르고스 등 실행/테스터 역할)

### 이슈 2: 테스트 기대값 불일치 3건 — 확인 완료

- Phase 1+2 플래그 활성화 상태 반영: 32 passed (0.19s)

### 이슈 3: p4-monitoring-weekly.md 미존재 — 확인 완료

- `/home/jay/workspace/memory/reports/p4-monitoring-weekly.md` 존재 확인 (1015 bytes)

### 이슈 4: 스펙 파일명 불일치 — 확인 완료

- 3개 심링크 정상: spec-p1-1.md, spec-p1-2.md, spec-p1-7.md

### 이슈 5: TRUST 5 QC-RULES.md 문서화 누락 — 해결

- **QC-RULES.md**: 섹션 4.7 "TRUST 5 품질 차원 (v3.6 신설)" 추가
  - T/R/U/S/T 5차원 정의, verifier 매핑, 판정 규칙, 구현 요구사항 문서화
  - 변경 이력에 v3.6 항목 추가
- **dev7/qc/qc_verify.py**: TRUST 5 검증 로직 추가
  - TRUST_MAP + TRUST_INDEPENDENT 상수
  - _build_trust_summary() 함수
  - build_result()에 trust5_tagging_enabled 플래그 연동

### 이슈 6: test_dispatch.py 44건 실패 — 이미 해결 확인

- task-1303.1에서 conftest.py에 monkeypatch.setenv() 11개 더미 환경변수 주입으로 해결 완료
- .env.keys 없이 141 passed (0.73s) 확인

---

## 발견 이슈 및 해결

### 자체 해결 (3건)

1. **dev7 qc_verify.py TRUST 5 로직 부재** — dev1 구현 참조하여 TRUST_MAP, _build_trust_summary, build_result TRUST 태그 로직 추가
   - 수정: `/home/jay/workspace/teams/dev7/qc/qc_verify.py` (line 53-61, 374-392, 395-417)

2. **QC-RULES.md TRUST 5 문서 부재** — 섹션 4.7 신설, 변경 이력 v3.6 추가
   - 수정: `/home/jay/workspace/teams/shared/QC-RULES.md` (line 194-226, 258)

3. **organization-structure.json haiku 잔존 혼동 가능성** — 잔여 10건 haiku 참조가 의도적 할당(실행/테스터 역할)임을 확인, 문제 아님으로 판정

---

## 테스트 결과

| 테스트 구분 | 전체 | 통과 | 실패 |
|-------------|------|------|------|
| test_dispatch.py | 141 | 141 | 0 |
| test_team_prompts.py | 111 | 111 | 0 |
| Phase 1+2 (feature_flags + progressive_disclosure + rw_isolation + hooks_enforcement) | 32 | 32 | 0 |
| integration/ | 7 | 7 | 0 |
| **합계** | **291** | **291** | **0** |

- pyright: teams/dev7/qc/qc_verify.py → 0 errors, 0 warnings

---

## 셀프 QC 체크리스트

- [x] 1. 영향 파일: QC-RULES.md(shared, 문서만), qc_verify.py(dev7, TRUST 5 출력 추가). 기존 QC 판정 로직 변경 없음
- [x] 2. 엣지 케이스: trust5_tagging_enabled=false 시 trust_summary 미포함(기존 동작 유지), feature_flags.json 미존재 시 조용히 pass
- [x] 3. 작업 지시 일치: 6건 전부 확인/해결 완료
- [x] 4. 에러 처리/보안: FileNotFoundError, JSONDecodeError 예외 처리됨, 보안 키 하드코딩 없음
- [x] 5. 테스트 커버리지: 291건 전체 통과
- [x] 6. 이슈 전부 해결: 3건 자체 해결 (상세 기재)
- [x] 7. 코드 아키텍처: dev1 구현과 동일 패턴 유지, SOLID/DRY 위반 없음
- [x] 8. 인터페이스 변경: build_result() 출력에 trust_summary 필드 추가 (선택적, 기존 호환)

---

## 산출물

- `/home/jay/workspace/teams/shared/QC-RULES.md` (TRUST 5 섹션 추가)
- `/home/jay/workspace/teams/dev7/qc/qc_verify.py` (TRUST 5 로직 추가)
- `/home/jay/workspace/memory/reports/task-1309.1.md` (본 보고서)