graphify install A안 정의 모호 → 공유 globals/CLAUDE.md 오염 사고

날짜: 2026-06-09 (KST)
노드: 🖥 데스크탑(사고 발생) / 🏭 맥미니(오케스트레이터·수습) / 💻 노트북(차단 조치)
분류: 멀티노드 롤아웃 / 공유 글로벌룰 오염 / 프롬프트 정합성
심각도: 중 (전파 직전 차단, 실피해 0)

증상

graphify(코드→knowledge graph AST tier, 무료) 5노드 롤아웃 중, 데스크탑이 graphify install --platform claude를 실행해 전 노드 공유 claude-skills/globals/CLAUDE.md에 /graphify 트리거 3줄을 추가하고 repo 루트에 graphify/ 스킬 디렉토리를 생성. 같은 롤아웃에서 라이덴은 install을 안 하고 바이너리만 깔아(안1) 노드별 해석이 정반대로 갈림.

라이덴(오늘 2026-06-09) 동일 재발: 어제 데스크탑 사고 후 codex-mesh-vote 로 안1(install 금지) 을 결정·5노드 통일했는데도, 오늘 라이덴에서 graphify 설치 서브커맨드를 또 실행해 같은 공유 globals 가 또 오염됨. 정책 결정만으론 재발한다는 걸 실증 — 사람이 지키는 결정이 아니라 기술적 강제장치가 있어야 막힌다.

근본 원인 (2중)

프롬프트 정합성 결손: graphify 롤아웃 작업을 노드에 돌릴 때 A안의 핵심 제약(“install 미실행 = 하니스/공유 config 무변경, 바이너리만 + 수동 graphify update”)을 프롬프트에 명시하지 않음. “graphify AST tier 도입” 수준의 모호한 지시 → 데스크탑은 “install 하되 자동 훅만 빼면 A안”으로, 라이덴은 “install 자체를 안 함”으로 해석. tasks.md 마킹(T-260608-67)도 “4노드 A안 per-node 적용”만 적고 install 금지를 명시 안 함.
심링크로 install이 공유 repo를 오염: ~/.claude/skills → ~/claude-skills(repo 전체) 심링크 구조라, graphify install --platform claude가 만든 산출물이 (a) ~/claude-skills/globals/CLAUDE.md(전 노드 symlink + 매 turn 로딩 핵심 글로벌룰)에 트리거를 박고 (b) skills/graphify가 아니라 repo 루트 ~/claude-skills/graphify/에 박힘. install 도구가 개인 하니스가 아니라 공유 SoT를 건드리는 구조를 사전에 인지 못 함.

영향 / 위험

globals/CLAUDE.md는 5노드 symlink 공유 + 매 turn 로딩. 본진·맥미니는 claude-skills main 직접 push 권한이 있어, 오염된 채 무심코 push되면 전 노드로 graphify 트리거가 전파 + 매 turn 토큰 증가(영구 비용)가 됐을 것.
데스크탑은 prefix 브랜치라 변경이 미커밋(working tree M) 상태 → 실제 전파는 0이었음(운+격리).

차단·수습 경위

노트북이 본진·맥미니 수동워커 토글 OFF → graphify install 큐가 push 권한 노드로 발사되는 고위험 경로 차단.
맥미니가 데스크탑 working tree 실측(M globals/CLAUDE.md, origin 미반영) → 전파 0 확인.
codex-mesh-vote(본진 노드매핑)로 A안 표준 결정: 안1 만장일치(codex 4/4). Gemini(안2)·DeepSeek(하이브리드) 이질표는 “globals 건드리는 한 같은 전파 리스크”로 기각.
데스크탑 원복: git checkout -- globals/CLAUDE.md(트리거 제거, M 해소) + rm -rf ~/claude-skills/graphify(루트 산출물) + 바이너리 유지. git status clean 검증.
노트북·라이덴·본진·맥미니는 이미 안1(바이너리만/미install) 실측 확인 → 5노드 안1 통일.

결정 (5노드 표준)

안1: 바이너리(uv tool graphifyy)만 설치, graphify install은 안 함, 공유 globals/CLAUDE.md 무변경, AST tier는 수동 graphify update <repo>(무료). 근거: 공유 글로벌룰 오염·전파·매-turn 토큰 영구비용 회피, /graphify 트리거 편의는 그 비용 대비 작음.

재발 방지

멀티노드 install/설치성 작업 게이트: 노드에 “install / 설치 / 도입” 류 작업을 위임할 때, 프롬프트에 “공유 config·하니스(globals/CLAUDE.md, .claude, git훅) 변경 여부”를 명시적으로 박는다(변경 0 / 변경 허용 중 택1). 모호하면 노드별 해석이 갈린다.
install 도구의 공유 repo 오염 사전 점검: ~/.claude/skills → ~/claude-skills 심링크 탓에, .claude 대상 install 류가 공유 repo(globals + 루트)를 건드릴 수 있다. install 류 도입 전 “이 도구가 공유 SoT를 건드리나?” 1회 점검.
push 권한 노드 우선 차단: 공유 글로벌룰을 건드릴 수 있는 작업은 main 직접 push 권한 노드(본진·맥미니)부터 토글/수신 차단(전파 반경이 가장 큼).
PreToolUse 훅 graphify-install-guard.sh (claude-automations 28487ff, 5노드 settings.json Bash matcher 등록): graphify 설치 서브커맨드 실행을 차단(forcing function). 정책(안1)만으론 라이덴에서 재발했으므로 기술적 강제장치로 박음. 단위테스트 8/8 PASS(uv tool install graphifyy·graphify update·graphify explain 은 미차단, 설치 서브커맨드만 차단). 탈출구 GRAPHIFY_INSTALL_OVERRIDE=1(의도된 설치만 통과).
auto-use wrinkle: mesh-vote 승자는 B(repo-local .claude/skills auto-use)였으나, 노드 세션이 home cwd 에서 돌아 repo-local 설정이 자동 발동 불가 → auto-use 미채택, 수동 운용으로 확정(T-260609-06 P2). ‘좋은 설계’ 도 실행 환경(세션 cwd)과 안 맞으면 미채택.
차단 훅 over-match(false positive) 주의: 훅이 Bash command 문자열의 graphify <서브커맨드>install 패턴을 매치하므로, 명령을 실행이 아니라 텍스트로 전달하는 경우(디렉티브 설명문/echo/doc 에 명령어 문자열이 섞인 경우)까지 매치될 수 있음 → 전달 텍스트 sanitize 필요(보안 분류기의 cyber 어휘 회피와 동형). 향후 훅 정교화 여지 = 실제 invocation 과 인용을 구분.