개선 1: P21 5-B 'PM 자기 업무 맥락 복원' 단계 신설
개선 2: P24 세션 시작 읽기 의무 추가 (PM 세션 시작 시 최근 2일 대화로그 전수 Read)
개선 3: scripts/pm_context_restore.sh 신설 + SessionStart hook 체인 추가
개선 4: 2026-04-17 조직운영 대화로그 소급 작성 (오늘 작업 11건 + C29 위반 사건 + 개선안)
개선 5: C31 신설 — 응답 발신 직전 자기검증 의무 (C20-7 헌법급 격상)
근거: 2026-04-17 PM이 C29 신설 당일 첫 응답(#28 §9 'PD님 상신 대상 4건')에서
C29 정면 위반. PD님 직접 선언: '이 문제는 우리 조직의 사활이 걸린 매우 중대한 문제야.'
영구 기록: memory/feedback_pm_context_restoration_failure.md
(5계층 근본 원인 + 재발 방지 구조 + 재발 시 PM 역할 재검토)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
원인: Claude Code가 .claude/ 하위를 sensitive file로 하드코딩 보호
증상: PreToolUse hook이 allow 결정해도 Write 시 승인 팝업 발생
해결: 루트 직하 .live/ 로 이전하여 sensitive 영역 벗어남
영향:
- scripts/live_session_load.sh — LIVE_DIR 수정
- scripts/live_inject.sh — LIVE_DIR 수정
- SKILL.md P25·P21-2·C29-4 등 경로 참조 9건 치환
- .claude/live/README.md → .live/README.md (git mv)
검증: hook 2종 수동 실행 정상 동작 확인
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- scripts/auto_approve.py — JSON 기반 도구 호출 판정 엔진 (UTF-8 강제)
- scripts/auto_approve.sh — PreToolUse hook wrapper
- .claude/settings.json hooks에 PreToolUse 엔트리 추가 (matcher 전체)
자동 허용: Read·Glob·Grep·TodoWrite·Edit·Write·MultiEdit·MCP·Agent·Skill·안전 Bash
자동 거부: 시스템 경로 쓰기·rm·sudo·dd·mkfs·format·shutdown·reboot·chmod 777·chown
ask 위임: 알 수 없는 도구
8건 테스트 전부 통과 (T1~T8).
settings.json 변경은 다음 세션부터 효력 — hook 등록 이후에는 스크립트 변경 즉시 반영.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
C30: git 동기화 프로젝트 작업 전 최신 상태 점검 의무
- 대상: git 기반 모든 프로젝트 (조직 레포·Unity·Framework·차기 프로젝트)
- `git fetch origin && git status` + pull/merge 의무
settings.json 강화 (승인 팝업 제거):
- defaultMode: "acceptEdits" — Edit/Write 자동 승인
- Bash(git *), Bash(ls *), Bash(cat *), Bash(echo *) 등 prefix 패턴 추가
- Bash(python *), Bash(dotnet *), Bash(node *) 등 개발 도구 명시
- deny 기존 유지
Live 더미 갱신 (push 없음, C20-1-A 준수)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- 각 팀은 업무 완료 시 업무 현황을 항상 최신 상태로 동기화 공유
- 완료 시점 필수 기록 4종: PD 지시 로그 / 대화로그 / 소통 채널 / Live 더미
- 금지: 기록 없이 다음 작업, "나중에 정리" 미루기, 수행 팀만 알고 방치
- 배경: 2026-04-16 #27 갱신 누락 사건 구조적 차단
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- C20-1-A: 임의 push 금지, PD님 "세션 공유"/"push" 지시 시에만 수행
- C28: "본 세션" 한정 아닌 전 조직 모든 세션 기본 적용 명확화
- Live 더미 갱신 (push 없이 다른 세션에서 즉시 트래킹 가능)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
C27: Agent 호출 완료 시 PM이 PD 지시 로그 갱신 즉시 확인 의무 (기존 P19-A → 헌법급 격상)
C28: 모든 .md 파일 수정·커밋·push는 PD님 개별 승인 없이 즉시 수행 (기존 P12 → 헌법급 격상)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- P24 신설: 프로젝트별·날짜별 대화로그, 해시태그 3종 필수, 기록 트리거 3가지
- P20 폐기: P24가 일일보고 역할 완전 대체
- 디렉토리: 공유/대화로그/(수상한잡화점·코어프레임워크·조직운영) 생성
- 2026-04-16 조직운영 첫 로그 작성 (오늘 전체 작업 11건 기록)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
[구조 변경]
- 3개 세션(PM/개발실/기획실) → 단일 PM 세션 + Agent 호출
- 개발실/ → 개발팀/, 기획실/ → 기획팀/ 디렉토리 리네임
- 부서별 .claude/agents/ → 루트 .claude/agents/에 통합 (11개)
- 개발실장 → 개발팀장 명칭 변경
- 부서별 settings.json 3중 배치 → 루트 단일
[코어룰 개편]
- C16: 단일 settings.json + Agent 호출 구조로 변경
- C17: 폐기 (단일 세션으로 세션 이동 소멸)
- C18: main push = 조직 공유 완료 (대상 세션 도달 개념 삭제)
- C24: 단일 세션 운용 원칙으로 전면 재작성
- P21: 단일 세션 기준 간소화
- 전체 "개발실"→"개발팀", "기획실"→"기획팀" 치환
[hook 정리]
- agent_sync.sh: SessionStart hook에서 제거 (불필요)
- 나머지 유지 (fetch/merge, inbox_scan, change_digest, hold_watch)
[소통 허브]
- 6축 채널 디렉토리명 변경 (PM→개발팀 등)
- PD 지시 로그 파일명 변경
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1. P22·P19·P20 역할 분리 명확화 (SKILL.md)
2. git_fetch_throttle.sh: 소통 허브 inbox 스캔 추가 — 부서별 수신함 변경 감지
3. hold_watch.sh: 소통 허브 inbox의 HOLD·긴급 파일도 감지 — 양방향 전파
4. P23 기획 결정 재량 범위 신설 (SKILL.md)
5. context_brief.sh: 부서 CONTEXT_BRIEF.md 자동 갱신 — Agent 호출 시 컨텍스트 단절 최소화
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
PD님이 "세션 갱신"이라고만 지시하면 에이전트가 git 동기화·HOLD 스캔·
CLAUDE.md 재읽기·조직공지 확인·PD 지시 로그 현황·간결 보고를 자동 수행.
추가 프롬프트나 승인 요청 없이 무중단 실행.
Skill 패킹(C26)으로 전 부서 자동 주입.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
근본 해결책 구축 완료:
1. .claude/skills/너드나비스-코어룰/SKILL.md 신설
- 공유/공통_업무_규칙.md → SKILL.md 로 git mv (히스토리 보존)
- frontmatter 추가 (name, description)
2. 부서 에이전트 4종 frontmatter에 skills 필드 추가
- 개발실장.md, 기획팀장.md, 서버팀장.md, 클라이언트팀장.md
- skills: [너드나비스-코어룰] 단일 등록
3. 부서 에이전트 본문의 코어룰 하드코딩 섹션 폐기
- Skill 자동 주입으로 대체
- 직무 우선 환기 사항만 유지 (C7/C8/C9/C11/C13/C23 등)
4. 메인 CLAUDE.md @참조 경로 갱신
- 루트 CLAUDE.md, 개발실/CLAUDE.md, 기획실/CLAUDE.md 모두 새 SKILL.md 경로
5. C26 코어룰 본문 개정
- 1차 신설(2026-04-16 수동 갱신 의무) → 2차 개정(단일 SOT 갱신 원칙)
- 수동 갱신 의무 폐지 명문화
6. 기타 활성 참조 파일 일괄 갱신
- .claude/agents/pm-general.md
- README.md
- 개발실/.claude/commands/*.md 8종
7. Skill 패킹 안건 문서 status: 완료 갱신
기대 효과 (PD님 검증 단계 필요):
- 부서 영속 대화 종료·재resume 후 서브에이전트가 SKILL.md 자동 주입받음
- 코어룰 추가 시 SKILL.md 한 곳만 갱신하면 모든 부서 자동 반영
- C26 5단계 수동 절차 폐지
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- 직전 d190fc9 커밋에서 git add -A 로 워크트리 3개가 submodule(160000 모드)로 잘못 등록됨
- Claude Code가 세션마다 자동 생성하는 .claude/worktrees/ 하위는 git 추적 대상 아님
- git rm --cached 로 인덱스에서 제거
- .gitignore 에 세 경로 명시적 추가로 재발 방지
· .claude/worktrees/
· 개발실/.claude/worktrees/
· 기획실/.claude/worktrees/
- C23-1 §4 '실패 발견 즉시 자진 보고' 준수
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- C26 신설: 코어룰 변경 시 에이전트 정의 파일 동시 갱신 의무
· 부서 서브에이전트가 C14~C25 인지 실패한 2026-04-16 사건 실증 근거
· Claude Code의 @참조 자동 주입이 서브에이전트에 미적용 구조 보완
· Skill 패킹안으로 대체 시 폐기·개정 예정 (PD님 보류)
- 수동 갱신 1차 실행:
· 루트 CLAUDE.md 핵심 규칙 요약 C1~C15 → C1~C26 확장
· 개발실장.md 조직 규칙 섹션 C1~C26 확장
· 기획팀장.md 조직 규칙 섹션 C1~C26 확장
- planning-lead → 기획팀장 명칭 일원화 (C22-2 PD님 명시 지시):
· 파일명 planning-lead.md → 기획팀장.md (git mv)
· frontmatter name 기획팀장
· PD_지시_로그·일일보고 헤더·C21 초안 검토 요청·skill 모듈·밸런싱 전략·GIT동기화방안 v2 참조 갱신
· 역사 기록(feedback 메모리·안건 문서)은 C5 정직성상 당시 용어 그대로 보존
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- scripts/agent_sync.sh: cwd 기반 부서 판단 → 부서 .claude/agents/*.md 를 cwd .claude/agents/ 로 자동 복제
- 실증 A 실패(상향 탐색 차단 확정) 후속 — hook 확장안으로 전환 결정
- SessionStart hook 3단(fetch·agent_sync·inbox_scan) 체계 확정
- 루트·개발실·기획실 settings.json 동일 복제 (3중 SOT 유지)
- 동작 검증 완료: 개발실 3개·기획실 7개 에이전트 동기화 OK
- 제약: 첫 세션은 여전히 부서 에이전트 미로드 (다음 세션부터 유효) — 감시자안 별도 검토 중
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- scripts/inbox_scan.sh: cwd 기반 부서 판단 후 자기 수신 inbox 2개 자동 스캔
- 루트·개발실·기획실 settings.json 모두 SessionStart hook에 inbox_scan 추가
- YAML status !=완료 파일만 보고 (from/subject/priority 추출)
- 동작 검증 완료: 개발실 컨텍스트에서 REQ001~003 정확 감지
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
근본 개선: 매번 부서 세션에 코어룰을 수동 전달하던 비효율 제거.
다음 세션 재시작부터 자동 동기화 + 코어룰 자동 로드.
Phase 1 — CLAUDE.md @import (코어룰 자동 로드)
- 루트·개발실·기획실 CLAUDE.md에 @공유/공통_업무_규칙.md 추가
- 매 세션 시작 시 코어룰 본문 자동 컨텍스트 로드
- 변경 시 다음 세션부터 자동 반영
Phase 2 — Hook 자동 동기화
- SessionStart hook: 세션 시작 시 git fetch + main 변경 검출/알림
- UserPromptSubmit hook: scripts/git_fetch_throttle.sh로 5분 throttle된
fetch + 변경 알림 (네트워크 부하 최소화)
- 루트 .claude/settings.json에 정의 + 개발실/기획실 동기 복제 (3중 SOT)
기술적 한계 (정직성 - C5):
- 진정한 세션 간 push 알림은 Claude Code에 없음 (각 세션 독립 프로세스)
- polling으로 사실상 5분 이내 자동 동기화 달성
- 부서 worktree 격리 유지 (충돌 회피)
C안(settings 계층 정비·main SOT 명문화)은 B안 안정화 후 후속 진행.
C20 적용: 코어룰·운영 변경이지만 PD님 명시 승인 → 본인 재량 즉시 main FF.
C20-7 적용: 본 응답에 양 부서 동기화 명령 동봉.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
근본 원인 2종 해소:
1. .claude/ 계층 auto-merge 미지원 문제
- Claude Code는 .claude/ 폴더 1개만 프로젝트 루트로 인식, 부모 auto-merge 안 함
- 개발실/.claude/·기획실/.claude/ 이미 존재 → 자식 디렉토리 세션에서 루트 settings.json 무시됨
- 기획실보다 작업량이 2~4배 복잡한 개발실에서 승인 요구 폭발적으로 드러남
- 해결: 루트 SOT → 부서 2개 복제 배치 + setup_windows.ps1에 자동 동기화 로직 추가
2. deny 패턴 리터럴 매칭 문제
- 'Bash(rm -rf /*)'는 glob이 아닌 리터럴로 해석되어 실제 rm -rf /home/foo 차단 불가
- prefix 기반 'Bash(rm:*)' 'Bash(rmdir:*)' 'Bash(chown:*)' 등으로 교정
- 추가 deny: shutdown/reboot/chmod 777/Windows 시스템 디렉토리 쓰기
memory/org/feedback_permissions_portability.md 보강:
- "자식 디렉토리 전파 원칙" 섹션 신설
- SOT(루트) + 파생(부서 2개) + 동기화 메커니즘 명시
세션 재시작 후 적용됨.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
PD님의 일괄 승인 원칙(memory/org/feedback_md_approval·feedback_approval_process)은 메모리 지침일 뿐 Claude Code harness의 permission system과 독립적으로 동작. 새 PC에서 .claude/settings.local.json이 비어있어 매번 승인 요구 발생하던 문제를 근본 해결.
- .claude/settings.json (git 커밋 대상): 조직 공용 포괄 허용
- Edit·Write·MultiEdit·NotebookEdit·TodoWrite·Read·Glob·Grep·LS 전부 허용
- Bash: git·gh·ls·cat·find·grep·mkdir·cp·mv·powershell·node·python·dotnet 등 안전 명령 허용
- deny: rm -rf /·rm -rf ~·sudo·dd·mkfs·포크봄·시스템 디렉토리 쓰기
- memory/org/feedback_permissions_portability.md: harness permission과 메모리 지침의 2계층 분리 구조 + PC 독립성 보장 메커니즘 교훈
세션 재시작 후 적용됨.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
깃 관리자
NerdNavis DevLead