# task-608.1: superpowers 즉시 반영 3건 DIRECT-WORKFLOW.md 적용

> 작성: 오딘(dev2 팀장) | 2026-03-16

---

## SCQA

**S**: task-605.1 분석에서 superpowers 프레임워크의 14개 기능 중 즉시 반영 가치가 높은 3건(완료 전 검증 게이트, 코드 리뷰 수용 프로토콜, 합리화 방지)이 도출되었다.

**C**: 현재 DIRECT-WORKFLOW.md에는 서브에이전트의 "완료" 오보 방지, 리뷰 피드백 무비판 수용 차단, 프로세스 스킵 합리화 방지 규칙이 없어, 서브에이전트(Sonnet 팀원)가 검증 없이 완료 보고하거나, 리뷰 피드백을 무조건 수용하거나, TDD를 건너뛰는 패턴이 발생할 수 있다.

**Q**: 3건의 에이전트 행동 제어 규칙을 DIRECT-WORKFLOW.md에 기존 내용 훼손 없이 추가할 수 있는가?

**A**: DIRECT-WORKFLOW.md에 3개 섹션을 추가 완료. 기존 222줄 → 278줄로 56줄 증가. 기존 내용 0건 삭제/수정. 마크다운 구조 정상 확인.

---

## 작업 내용

task-605.1 분석 결과에서 도출된 즉시 반영 3건을 DIRECT-WORKFLOW.md에 신규 섹션으로 추가.

### 반영 1: 서브에이전트 완료 검증 게이트 (line 213-227)
- 5단계 검증 절차 (검증 명령어 식별 → 실행 → 출력 확인 → exit code 확인 → 보고)
- 금지 표현 4개 정의 ("should work", "probably passes", "I believe it works", "tested mentally")
- "증거 없는 완료 보고 = 미완료 처리" 원칙 명시

### 반영 2: 코드 리뷰 피드백 수용 프로토콜 (line 229-245)
- 4단계 수용 절차 (기술적 재진술 → 코드베이스 확인 → YAGNI 체크 → 근거 없으면 반박)
- 금지 표현 3개 정의 ("Great point!", 무비판 수용, 전항목 무조건 적용)
- 핵심 원칙 3개 (리뷰어도 틀릴 수 있음, 불필요한 수정 = 복잡도 증가, 이유 보고)

### 반영 3: 합리화 방지 (Anti-Rationalization) (line 247-266)
- HARD-GATE 3개 항목 (TDD, 완료 검증 게이트, 보고서)
- Red Flag 5개 문장 (TDD 불필요 주장, 수동 테스트 주장, 작은 수정 주장, 기억 주장, 시간 부족 주장)
- 합리화 감지 시 3단계 행동 절차

### 배치 결정
- "QC 재시도 규칙"과 "작업 규칙" 사이에 3개 섹션을 연속 배치
- 근거: 워크플로우 번호 목록(Step 1-8) 내부에 `##` 섹션을 삽입하면 마크다운 구조가 깨짐. 워크플로우 외부에 독립 섹션으로 배치하여 기존 구조 보존
- 대안 고려: Step 3-4 사이 삽입 → 번호 목록 중단으로 가독성 저하 → 기각

---

## 생성/수정 파일

- `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md` — 3개 섹션 추가 (기존 내용 삭제/수정 0건)
- `/home/jay/workspace/memory/reports/task-608.1.md` — 본 보고서 (신규)

## 테스트 결과

코드 변경 없는 문서 작업. 마크다운 구조 검증:
- 문서 총 278줄, 기존 222줄에서 56줄 추가
- `##` 헤딩 16개 (기존 13 + 신규 3)
- `###` 서브헤딩 신규 7개 추가 (금지 표현 2, 핵심 원칙 1, HARD-GATE 1, Red Flag 1, 합리화 감지 1, 리뷰 피드백 수신 시 1)
- 마크다운 구조: 정상 (헤딩 계층 일관, 목록 들여쓰기 정상, 볼드/코드 블록 균형)

## 발견 이슈 및 해결

### 자체 해결 (1건)
1. **배치 위치 결정** — Step 3-4 사이 대신 문서 끝부분에 배치
   - 상세: 작업 지시서에서 "Step 3~4 사이 또는 문서 끝부분"을 허용. Step 3-4 사이에 `##` 헤딩을 삽입하면 워크플로우 번호 목록이 중단되어 가독성 저하. 문서 끝부분(QC 재시도 규칙 ↔ 작업 규칙 사이)에 배치하여 기존 구조 보존

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

## 버그 유무

없음.

## 비고

- 문서 전용 작업(프롬프트/문서 변경)이므로 TDD, pyright, black/isort 해당 없음
- 3개 섹션의 내용은 task-608.1 작업 지시서의 코드 블록과 문자 단위로 일치하도록 작성
- 참조: task-605.1 분석 보고서 (`/home/jay/workspace/memory/reports/task-605.1.md`)