70 lines
5.8 KiB
Markdown
70 lines
5.8 KiB
Markdown
|
# feedback: dev-auditor 산출물 3종 규범 실종 패턴
|
||
|
|
|
||
|
|
**신설일**: 2026-04-18
|
||
|
|
**신설 계기**: dev-auditor 모드 C 원칙 1 재검토 감사(본 세션) 중 자기 영역 감사로 발견. 2026-04-17 dev-auditor 첫 감사 시 산출물 3종 규범(감사 보고서 md · 대화로그 엔트리 · feedback 메모리) 중 대화로그만 일부 수행, 정규 md 보고서 0건 · feedback 메모리 0건 확인.
|
||
|
|
**관련 규칙**: P27-1 (3축 감사 체계 산출물 3종), C23 (허위 보고·역할 연기 금지), C27 (Agent 호출 완료 시 로그 확인), P26 (PM 업무 정확도 보장), 본 에이전트 정의 `.claude/agents/dev-auditor.md`
|
||
|
|
**관련 사건**: 2026-04-17 PM 전수 감사 5개 Agent 병렬 투입 시 dev-auditor 호출 → 실질 산출물 md 미생성 → 2026-04-18 본 모드 C에서 자기 감사로 실증. pm-auditor `feedback_team_recording_quality.md` 패턴(팀 기록 전제 조건 허점)의 감사관 영역 변주.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 핵심 교훈
|
||
|
|
|
||
|
|
**감사관 에이전트가 "응답 텍스트"로 감사 결과를 회신하고 실제 Write 도구로 파일을 생성하지 않으면, 조직 기록 채널에는 감사 이력이 남지 않는다.** 결과적으로 차기 세션·감사 재요청 시 이전 감사 결과를 복원할 경로가 소실된다. 이는 "감사를 수행했다"는 주장과 "조직 기록에 감사 이력이 있다"는 사실 사이의 괴리이며, C23(허위 보고 금지) 경계선에 위치한다. 본 인스턴스(2026-04-17)는 완전 허위는 아니나 산출물 3종 규범을 충족시키지 못한 부분 이행이므로 **"실측 근거 반쪽 이행" 패턴**으로 영구 기록.
|
||
|
|
|
||
|
|
## 실측 근거 (2026-04-18 본 세션에서 확인)
|
||
|
|
|
||
|
|
1. **`공유/소통/dev-auditor→PM/` 실측**: `.gitkeep`만 존재, 실제 감사 보고 md **0건**. 2026-04-17에 감사가 호출되었음에도 첫 정규 md 산출물이 2026-04-18 본 보고서가 됨.
|
||
|
|
2. **`memory/feedback_dev*.md` 실측**: Glob 결과 0건. dev 영역 feedback 메모리 전무 (본 파일이 첫 등재).
|
||
|
|
3. **2026-04-17 대화로그 조직운영 엔트리**: dev-auditor 직접 명의 엔트리 미확인, PM 호출 기록에 간접 흔적만.
|
||
|
|
4. **2026-04-18 인계서(`28cd6c8`) 시사**: B4 항목이 "plan-auditor→PM .gitkeep 신설 (dev-auditor는 이미 존재)"로만 기재 — `.gitkeep` 존재만 확인했을 뿐 실제 보고 md 부재 상태를 묵시적으로 확인.
|
||
|
|
|
||
|
|
## 원인 진단 3종
|
||
|
|
|
||
|
|
### 원인 1. Agent 응답 관성 — "응답 텍스트로 끝내기"
|
||
|
|
|
||
|
|
서브에이전트가 호출되면 응답을 **자연어 요약 텍스트**로 반환하는 것이 관성적 스타일. Write 도구를 별도로 호출하여 파일을 생성하는 추가 행위가 감사관 역할에서는 필수이나, 응답 완결 시점에 파일 생성 흔적 자체 체크가 누락되기 쉬움.
|
||
|
|
|
||
|
|
### 원인 2. 호출 프롬프트의 집행 강제력 부족
|
||
|
|
|
||
|
|
2026-04-17 dev-auditor 호출 시 프롬프트에 "산출물 3종 필수 — Write 실행으로 파일 생성 후 응답 작성" 같은 명시 지시가 없었을 가능성. 본 2026-04-18 모드 C 호출 프롬프트는 "산출물 (P27-1 모드 C 규범 — 3종 필수). **감사 보고서 Write 수행, 이번에는 반드시 파일 생성**" 명시로 개선됨 → 이 프롬프트 개선이 본 파일의 생성 자체를 강제함.
|
||
|
|
|
||
|
|
### 원인 3. 감사관 자체 정의의 체크리스트 위상 낮음
|
||
|
|
|
||
|
|
`.claude/agents/dev-auditor.md`의 "산출물 3종 (매 감사 필수)"은 정의 문서 중반에 배치되어 응답 작성 시 자기 검증 체크리스트로 기능하지 못함. 응답 맨 앞·응답 마무리 지점에 **"Write 3회 완료 확인"** 강제 체크리스트가 없는 것이 구조적 허점.
|
||
|
|
|
||
|
|
## 구조적 대응안 (PM 경유 상정 권고)
|
||
|
|
|
||
|
|
### 대응 1 (즉시, 본 세션 완료 시 자동 발효)
|
||
|
|
|
||
|
|
**본 파일 자체**가 첫 교정 — `memory/feedback_dev_auditor_output_gap.md` 영구 기록으로 다음 dev-auditor 호출 시 컨텍스트 주입되어 자기 반복 방지.
|
||
|
|
|
||
|
|
### 대응 2 (PM 판단 필요, Minor)
|
||
|
|
|
||
|
|
`.claude/agents/dev-auditor.md` (+ pm/plan-auditor 3종 통일) 개정:
|
||
|
|
- "## 산출물 3종 (매 감사 필수)" 섹션을 **파일 최상단 체크리스트 형식**으로 승격
|
||
|
|
- 본문 예: "응답 작성 직전 다음 3개 Write 도구 호출 완료 여부 자기 확인: [ ] 보고서 md / [ ] 대화로그 append / [ ] feedback (해당 시). 하나라도 미이행 시 응답 차단 후 Write 수행"
|
||
|
|
|
||
|
|
### 대응 3 (PM 판단 필요, 장기)
|
||
|
|
|
||
|
|
SessionEnd hook 또는 PostToolUse hook에 **감사관 역할 Agent 응답 시 Write 흔적 검증** 로직 추가 검토. 감사관이 호출되었는데 md 생성 흔적이 없으면 리마인더 출력.
|
||
|
|
|
||
|
|
## 유사 패턴 경계
|
||
|
|
|
||
|
|
본 패턴의 변주 후보:
|
||
|
|
- **pm-auditor** 유사 실종 가능성 — `공유/소통/pm-auditor→PM/` 실측 필요 (본 보고 범위 외)
|
||
|
|
- **plan-auditor** 신설 직후 — .gitkeep만 확인하고 실제 md 생성 여부 미확인 위험
|
||
|
|
- **감사관 외 일반 서브에이전트(개발팀장·기획팀장)** 의 대화로그 엔트리 누락 — 이미 `feedback_team_recording_quality.md`로 기록됨, 본 패턴과 쌍
|
||
|
|
|
||
|
|
## 본 인스턴스 자체의 자기 검증
|
||
|
|
|
||
|
|
본 파일 작성이 완료된 뒤, 본 세션의 dev-auditor 호출은 산출물 3종 규범을 **100% 충족**:
|
||
|
|
- [x] 감사 보고서: `공유/소통/dev-auditor→PM/2026-04-18_원칙1_재검토_감사.md` Write 완료
|
||
|
|
- [x] 대화로그 엔트리: `공유/대화로그/조직운영/2026-04-18.md` append 완료
|
||
|
|
- [x] feedback 메모리: **본 파일** Write 완료
|
||
|
|
|
||
|
|
이 세 Write 도구 호출이 조직 기록 채널에 남긴 흔적이 **본 감사가 실제 수행되었다는 유일한 입증**이며, 2026-04-17 호출과의 품질 차이를 실증한다.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**본 feedback 파일의 수명**: 영구. 삭제·축약은 PD님 직접 승인 필수 (조직 기억 보호).
|