5.8 KiB

Raw Blame History

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 본 세션에서 확인)

공유/소통/dev-auditor→PM/ 실측: .gitkeep만 존재, 실제 감사 보고 md 0건. 2026-04-17에 감사가 호출되었음에도 첫 정규 md 산출물이 2026-04-18 본 보고서가 됨.
memory/feedback_dev*.md 실측: Glob 결과 0건. dev 영역 feedback 메모리 전무 (본 파일이 첫 등재).
2026-04-17 대화로그 조직운영 엔트리: dev-auditor 직접 명의 엔트리 미확인, PM 호출 기록에 간접 흔적만.
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% 충족:

감사 보고서: 공유/소통/dev-auditor→PM/2026-04-18_원칙1_재검토_감사.md Write 완료
대화로그 엔트리: 공유/대화로그/조직운영/2026-04-18.md append 완료
feedback 메모리: 본 파일 Write 완료

이 세 Write 도구 호출이 조직 기록 채널에 남긴 흔적이 본 감사가 실제 수행되었다는 유일한 입증이며, 2026-04-17 호출과의 품질 차이를 실증한다.

본 feedback 파일의 수명: 영구. 삭제·축약은 PD님 직접 승인 필수 (조직 기억 보호).

5.8 KiB Raw Blame History