# task-383.1 완료 보고서: Sibling Tool Call Error 방지 시스템

## 작업 요약
Claude Code의 병렬 tool 호출 시 하나가 실패하면 나머지 sibling 호출이 전부 에러 처리되는 문제를 방지하기 위한 안전 규칙을 문서화하고 유틸리티 스크립트를 생성했습니다.

## 수행 작업

### 작업 1: DIRECT-WORKFLOW.md 수정
- **파일**: `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md`
- **변경**: "## 팀원 코워크" 섹션 뒤, "## 워크플로우" 섹션 앞에 "## 병렬 Tool 호출 안전 규칙" 섹션 추가
- **내용**: 5가지 규칙 (외부 호출 순차 실행, 파일 존재 확인, Bash exit code, 안전한 병렬 대상, 대형 파일 분할)

### 작업 2: teamlead-guide.md 수정
- **파일**: `/home/jay/workspace/prompts/teamlead-guide.md`
- **변경**: 섹션 1(작업 철학) 뒤, 섹션 2(실패 시나리오) 앞에 "## 섹션 1.5: 병렬 Tool 호출 안전 규칙" 추가
- **내용**: DIRECT-WORKFLOW.md와 동일한 5가지 규칙

### 작업 3: safe-gh-read.sh 생성
- **파일**: `/home/jay/workspace/scripts/safe-gh-read.sh` (신규)
- **내용**: `gh api`로 GitHub 파일을 안전하게 읽는 래퍼 스크립트
- **기능**: 인자 검증, 에러 처리, base64 디코딩을 한 번의 호출로 수행
- **실행 권한**: chmod +x 적용 완료

## 생성/수정 파일 목록
- (수정) `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md` — 병렬 호출 안전 규칙 섹션 추가
- (수정) `/home/jay/workspace/prompts/teamlead-guide.md` — 병렬 호출 안전 규칙 섹션 추가
- (신규) `/home/jay/workspace/scripts/safe-gh-read.sh` — GitHub 파일 안전 읽기 래퍼

## 테스트 결과
- `test_team_prompts.py`: 54/58 통과 (4개 기존 실패 — project_id 관련, 이번 변경과 무관)
- safe-gh-read.sh: 문법 체크 통과, usage 출력 정상

## 셀프 QC
1. **영향 분석**: 두 마크다운 파일은 섹션 추가만 수행, 기존 구조 변경 없음. 신규 스크립트는 독립 유틸리티.
2. **엣지 케이스**: safe-gh-read.sh에 인자 누락 시 usage 출력 + exit 1. gh api 실패 시 에러 메시지.
3. **작업 지시 일치**: 태스크 명세의 3가지 작업 모두 정확히 수행.
4. **에러 처리/보안**: 스크립트 입력 검증, stderr 출력, 비정상 종료 코드 반환.
5. **테스트 커버리지**: 문서 변경만이므로 Lv.1 수준. 기존 테스트 깨지지 않음.

## QC 자동 검증 결과
```json
{
  "task_id": "task-383.1",
  "overall": "PASS (조건부)",
  "checks": {
    "api_health": "SKIP (서버 작업 아님)",
    "file_check": "PASS (보고서 + .done 생성 후)",
    "data_integrity": "PASS",
    "test_runner": "SKIP (테스트 디렉토리 미지정)",
    "tdd_check": "SKIP (Lv.1 문서/스크립트 작업, TDD 적용 대상 아님)",
    "schema_contract": "SKIP",
    "pyright_check": "SKIP (Python 파일 없음)",
    "style_check": "SKIP (Python 파일 없음)",
    "scope_check": "SKIP"
  }
}
```

## 버그 유무
- 발견된 버그 없음
- 기존 test_team_prompts.py의 project_id 관련 4개 실패는 이번 작업과 무관한 기존 이슈

## 비고
- 이 작업은 Lv.1 문서/스크립트 작업이므로 TDD, worktree, pyright 적용 대상이 아닙니다.
- safe-gh-read.sh는 `gh` CLI가 설치되어 있어야 동작합니다.