additionalContext 주입 방식 제거 및 CLAUDE.md 기반 Context 공유 체계 전환

I built sonmat to fix this. Then sonmat had the same bug.

Jun02026년 5월 3일6분intermediate

AI 요약

Context

Claude Code의 hooks를 통해 1,239자의 discipline을 additionalContext에 강제 주입하던 구조 설계. main session에는 규칙이 적용되나 실제 작업을 수행하는 worker(subagent)에게는 해당 context가 전달되지 않는 구조적 결함 발생.

Technical Solution

Hook의 역할을 behavior shaping에서 단순 side effect(디렉토리 생성 및 업데이트 확인)로 한정하는 역할 분리
discipline 저장소를 additionalContext 주입 방식에서 CLAUDE.md → discipline/core.md 파일 기반 참조 구조로 변경
main agent와 spawn된 모든 worker가 동일한 CLAUDE.md chain을 상속받아 일관된 규칙을 공유하는 아키텍처 구현
사용자가 직접 규칙을 확인하고 수정할 수 있도록 visibility를 확보하여 implicit 가드레일을 explicit 설정으로 전환
자동화된 강제 주입보다 명시적 파일 기반 참조를 통한 Context 전달의 신뢰성 확보

실천 포인트

1. 가드레일 규칙이 Worker/Subagent까지 전파되는 경로가 확보되었는지 확인하십시오.

2. Hook을 비즈니스 로직이나 행동 제어용이 아닌, 인프라 설정 및 사이드 이펙트 처리용으로만 사용하십시오.

3. 사용자에게 보이지 않는 Implicit Context 주입보다 명시적인 설정 파일 기반의 Explicit Context 관리를 우선하십시오.

태그

#Architecture #Guardrail #Subagent #Claude-Code #Context Propagation

원문 읽기