---
task_id: task-1924
type: plan
scope: task
created: 2026-04-17
updated: 2026-04-17
status: completed
---

# 계획서: task-1924 — QC 강제 실행 파이프라인 수정

**task**: task-1924
**목표**: 팀장 봇이 QC를 우회하는 3가지 구조적 결함을 수정하여 QC 파이프라인을 강제 실행
**승인**: 아누 2026-04-17 "심층 분석 결과 기반 수정 지시"
**근거**: 최근 10건 task 중 6건에서 QC 미실행 또는 부분 실행 확인

---

## 목표

1. team_short placeholder가 모든 팀 프롬프트에 포함되어 QC 경로가 올바르게 유도됨
2. 수동 .done 생성 하위호환 경로를 완전히 제거하여 --gate 사용을 필수화
3. finish-task.sh가 QC 미실행 상태(.qc-result 부재)에서 .done 생성을 차단

## 범위

### 포함
- prompts/team_prompts.py: 모든 placeholder_lines 블록에 team_short 추가
- prompts/DIRECT-WORKFLOW.md: 295~298행 하위호환 수동 .done 코드 제거
- teams/dev2/qc/qc_verify.py: --gate PASS 시 .qc-result 파일 동시 생성
- scripts/finish-task.sh: .qc-result 파일 존재 여부 검증 추가
- 관련 테스트 업데이트

### 제외 (다음 페이즈 이후)
- dev1 qc_verify.py 동일 수정 (dev1팀 소관)
- QC 프레임워크 구조 전면 재설계

## 위임 계획

- MT-1 (team_prompts.py team_short): **토르(백엔드, sonnet)**
- MT-2 (DIRECT-WORKFLOW.md 수정): **토르(백엔드, sonnet)** — MT-1과 병렬 가능하지만 동일 파일 아니므로 순차 위임
- MT-3 (qc_verify.py .qc-result 추가): **토르(백엔드, sonnet)**
- MT-4 (finish-task.sh QC 검증): **토르(백엔드, sonnet)** — MT-3 의존
- MT-5 (테스트 업데이트): **헤임달(테스터, sonnet)** — MT-1~4 완료 후

## 검증 기준

- build_prompt("dev1-team", ...) 결과에 `team_short: dev1` 포함
- build_prompt("marketing", ...) 결과에 `team_short: marketing` 포함
- DIRECT-WORKFLOW.md 295~298행 수동 .done 코드 삭제 확인
- qc_verify.py --gate PASS 시 .qc-result 파일 생성 확인
- finish-task.sh에서 .qc-result 미존재 시 .done 생성 차단 확인
- pytest tests/ -q → 0 failed