---
task_id: task-1906
type: context
scope: task
created: 2026-04-16
updated: 2026-04-16
status: completed
---

# 맥락 노트: task-1906

**task**: task-1906

---

## 결정 근거

### L1 스모크테스트 삽입 위치 결정
- DIRECT-WORKFLOW.md: Step 4.7 이후 ~ Step 5 이전에 신규 Step 4.8 삽입
- 이유: .done 생성 전 마지막 실동작 검증 단계여야 하므로, 보고서 작성(Step 5) 직전이 적절
- 대안: Step 5.7(G3 검증) 직전 → 기각: 보고서에 스모크 결과를 포함해야 하므로 보고서 이전이 맞음

### team_prompts.py 삽입 위치 결정
- build_prompt() 함수의 공통 영역(720-726줄 부근, Edit 검증 리마인더 이후)에 추가
- 이유: 모든 팀 유형(direct, marketing, consulting 등)에 공통 적용되어야 함
- 대안: 각 _build_*_prompt 함수에 개별 삽입 → 기각: 중복 코드 발생, 유지보수 불리

### QC-RULES.md 항목 13 추가
- 기존 항목 12 이후에 13번 추가
- 체크박스 기준 설명은 섹션 6(수정 파일별 검증 상태) 부근에 추가

## 참조 자료

- 작업 지시서: `/home/jay/workspace/memory/tasks/task-1906.md`
- DIRECT-WORKFLOW.md: `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md`
- team_prompts.py: `/home/jay/workspace/prompts/team_prompts.py`
- QC-RULES.md: `/home/jay/workspace/teams/shared/QC-RULES.md`

## 3 Step Why 자문

1st Why: "왜 이 설계가 필요한가?" → pytest 통과 ≠ 실동작 확인. 현재 봇은 pytest + grep만 수행하고 실제 서버/UI/API 동작을 확인하지 않아, 배포 후 실패 위험이 존재.
2nd Why: "왜 워크플로우 삽입이 최선인가?" → 워크플로우와 프롬프트에 직접 삽입하면 모든 팀에 즉시 적용되고, 누락 불가.
3rd Why: "왜 대안(개인 판단 / CI 파이프라인)보다 나은가?" → 개인 판단은 생략 위험, CI 파이프라인은 현재 봇 워크플로우와 분리되어 적용 지연. 문서 직접 삽입이 가장 직접적이고 즉시 적용 가능.

## 주의사항

- team_prompts.py는 1200줄 대형 파일 → Edit 시 고유 문자열로 정확한 위치 지정 필수
- QC-RULES.md 항목 번호: 기존 12번 이후 13번 (번호 충돌 없음 확인)
- DIRECT-WORKFLOW.md에서 Step 번호: 4.8로 신규 삽입 (기존 번호 충돌 없음)