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