# task-1169.1 완료 보고서

**S**: 보고서 산출물 섹션에서 파일을 `slide{1-5}.png (5개)` 같은 축약형으로 기재하여, 대시보드에서 개별 파일을 클릭하여 열어볼 수 없는 상태였다.

**C**: 대시보드 UX 상 개별 파일 경로가 없으면 산출물 확인이 불가능하며, 이 규칙이 QC-RULES, SCQA 보고서 템플릿, team_prompts.py 어디에도 명시되어 있지 않아 반복 발생 가능성이 있었다.

**Q**: 3개 핵심 파일에 "산출물 개별 파일 나열 필수" 규칙을 추가하여 문제를 근본적으로 방지할 수 있는가?

**A**: 3개 파일에 규칙을 추가 완료. QC-RULES.md v3.5 신설, SCQA 템플릿에 표기 규칙 섹션 추가, team_prompts.py의 `_build_verification_section`에 인라인 경고 1줄 추가. 기존 코드/문서 구조 훼손 없이 적용됨.

## 수정 파일 목록

- `/home/jay/workspace/teams/shared/QC-RULES.md` — §4.5 산출물 파일 표기 규칙 섹션 신설 + 변경 이력 v3.5 추가
- `/home/jay/workspace/memory/specs/scqa-report-template.md` — "산출물 파일 표기 규칙" 섹션 신설
- `/home/jay/workspace/prompts/team_prompts.py` — `_build_verification_section` 함수에 산출물 표기 경고 1줄 추가 (line 867)

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **QC-RULES.md 섹션 번호 배치** — §4와 §5 사이에 §4.5로 자연스럽게 삽입하여 기존 번호 체계 유지
2. **SCQA 템플릿 삽입 위치** — "토큰 사용량" 섹션 앞에 배치하여 보고서 본문 영역 내 산출물 규칙이 자연스럽게 위치
3. **team_prompts.py f-string 이스케이프** — 중괄호 포함 문자열(`{1-5}`)이 f-string이 아닌 일반 문자열이므로 이스케이프 불필요 확인

### 범위 외 미해결 (0건)
없음

## pyright 진단 결과
기존 경고만 존재 (이번 변경과 무관):
- `Import "utils.composite_constants" could not be resolved` — 기존 이슈
- `"Tuple" is not accessed` — 기존 미사용 import
- 기타 미사용 변수 경고 — 마케팅/컨설팅 프롬프트 함수의 공통 인터페이스 유지용 파라미터

## QC 자동 검증 결과

- **전체**: WARN (7 PASS, 4 SKIP, 1 WARN)
- **test_runner**: PASS — pytest 111건 전체 통과 (0.19s)
- **pyright_check**: PASS — 에러 0건
- **file_check**: PASS — 3개 수정 파일 + 보고서 존재 확인
- **style_check**: WARN — black 포맷 차이 (기존 이슈, 이번 변경 무관)
- **Gate**: PASS → .done 파일 자동 생성 완료