출처 보기 (zhanghandong.github.io/harness-engineering-from-cc-to-ai-coding)유민수 개발자 (www.deformatic.ai.kr) 작성
한국어 번역 아카이브Claude Code Harness
파트 VII: AI 에이전트 빌더를 위한 교훈appendix-a-file-index원문 링크

부록 A: 핵심 파일 색인

Claude Code Harness 문서 아카이브

부록 A: 키 파일 인덱스

이 부록에는 Claude Code v2.1.88 소스 코드의 주요 파일과 해당 책임이 하위 시스템별로 그룹화되어 나열되어 있습니다. 파일 경로는 restored-src/src/를 기준으로 합니다.

진입점 및 코어 루프

파일책임관련 장
main.tsxCLI 진입점, 병렬 프리페치, 지연 가져오기, 기능 플래그 게이팅제1장
query.ts에이전트 루프 메인 루프, queryLoop 상태 머신제3장
query/transitions.ts루프 전환 유형: Continue, Terminal제3장

도구 시스템

파일책임관련 장
Tool.ts도구 인터페이스 계약, TOOL_DEFAULTS 페일클로즈 기본값2장, 25장
tools.ts도구 등록, 기능 플래그 조건부 로딩제2장
services/tools/toolOrchestration.ts도구 실행 오케스트레이션, partitionToolCalls 동시성 파티셔닝제4장
services/tools/toolExecution.ts단일 도구 실행 수명주기제4장
services/tools/StreamingToolExecutor.ts스트리밍 도구 실행자제4장
tools/BashTool/Git 안전 프로토콜을 포함한 Bash 도구 구현8장, 27장
tools/FileEditTool/파일 편집 도구, "편집 전 읽기" 시행8장, 27장
tools/FileReadTool/파일 읽기 도구, 기본 2000줄제8장
tools/GrepTool/ripgrep 기반 검색 도구제8장
tools/AgentTool/하위 에이전트 생성 도구8장, 20장
tools/SkillTool/스킬 발동 도구8장, 22장
tools/SkillTool/prompt.ts스킬 목록 예산: 상황 창의 1%12장, 26장

시스템 프롬프트

파일책임관련 장
constants/prompts.ts시스템 신속한 구축, SYSTEM_PROMPT_DYNAMIC_BOUNDARY5장, 6장, 25장
constants/systemPromptSections.ts캐시 제어 범위가 있는 섹션 레지스트리제5장
constants/toolLimits.ts도구 결과 예산 상수12장, 26장

API 및 캐싱

파일책임관련 장
services/api/claude.tsAPI 호출 구성, 캐시 중단점 배치제13장
services/api/promptCacheBreakDetection.ts캐시 중단 감지, PreviousState 추적14, 25장
utils/api.tssplitSysPromptPrefix() 3방향 캐시 분할5장, 13장

컨텍스트 압축

파일책임관련 장
services/compact/compact.ts압축 오케스트레이션, POST_COMPACT_MAX_FILES_TO_RESTORE9장, 10장
services/compact/autoCompact.ts자동 압축 임계값 및 회로 차단기9장, 25장, 26장
services/compact/prompt.ts압축 프롬프트 템플릿9장, 28장
services/compact/microCompact.ts시간 기반 미세 압축제11장
services/compact/apiMicrocompact.tsAPI 기반 캐시된 마이크로 압축제11장

권한 및 보안

파일책임관련 장
utils/permissions/yoloClassifier.tsYOLO 자동 모드 분류기17장
utils/permissions/denialTracking.ts거부 추적, DENIAL_LIMITS17, 27장
tools/BashTool/bashPermissions.tsBash 명령 권한 확인제16장

CLAUDE.md 및 기술

파일책임관련 장
utils/claudemd.tsCLAUDE.md 로딩 및 주입, 4계층 우선순위19장
skills/bundled/내장된 기술 디렉토리22장
skills/loadSkillsDir.ts사용자 정의 스킬 발견22장
skills/mcpSkillBuilders.tsMCP-스킬 브리지22장

다중 에이전트 오케스트레이션

파일책임관련 장
coordinator/coordinatorMode.ts코디네이터 모드 구현제20장
utils/teammate.ts팀원 에이전트 도구제20장
utils/swarm/teammatePromptAddendum.ts팀원 프롬프트 부록 콘텐츠제20장

도구 결과 및 저장

파일책임관련 장
utils/toolResultStorage.ts큰 결과 지속성, 잘림 미리보기12장, 28장
utils/toolSchemaCache.ts도구 스키마 캐싱제15장

교차 세션 메모리

파일책임관련 장
memdir/memdir.tsMEMORY.md 인덱스 및 주제 파일 로딩, 시스템 프롬프트 삽입24장
memdir/paths.ts메모리 디렉터리 경로 확인, 3단계 우선 순위 체인24장
services/extractMemories/extractMemories.tsFork 에이전트 자동 메모리 추출24장
services/SessionMemory/sessionMemory.ts압축을 위한 롤링 세션 요약24장
utils/sessionStorage.tsJSONL 세션 기록 저장 및 복구24장
tools/AgentTool/agentMemory.ts하위 에이전트 지속성 및 VCS 스냅샷24장
services/autoDream/autoDream.ts밤새 기억 통합 및 정리24장

원격 측정 및 관찰 가능성

파일책임관련 장
services/analytics/index.ts이벤트 진입점, 대기열 연결 패턴, PII 태그 유형29장
services/analytics/sink.ts이중 경로 디스패치(Datadog + 1P), 샘플링29장
services/analytics/firstPartyEventLogger.tsOTel BatchLogRecordProcessor 통합29장
services/analytics/firstPartyEventLoggingExporter.ts사용자 정의 내보내기, 디스크 영구 재시도29장
services/analytics/metadata.ts이벤트 메타데이터, 도구 이름 삭제, PII 등급29장
services/analytics/datadog.tsDatadog 허용 목록, 일괄 플러시29장
services/analytics/sinkKillswitch.ts원격 회로 차단기(tengu_frond_boric)29장
services/api/logging.tsAPI 3가지 이벤트 모델(쿼리/성공/오류)29장
services/api/withRetry.ts원격 측정, 게이트웨이 지문 감지 재시도29장
utils/debug.ts디버그 로깅, --debug 플래그29장
utils/diagLogs.tsPII가 없는 컨테이너 진단29장
utils/errorLogSink.ts오류 파일 로깅29장
utils/telemetry/sessionTracing.tsOTel 범위, 3단계 추적29장
utils/telemetry/perfettoTracing.tsPerfetto 시각화 추적29장
utils/gracefulShutdown.ts계단식 시간 초과 단계적 종료29장
cost-tracker.ts비용 추적, 세션 간 지속성29장

구성 및 상태

파일책임관련 장
utils/effort.ts노력 수준 구문 분석21장
utils/fastMode.ts빠른 모드 관리21장
utils/managedEnvConstants.ts관리형 환경 변수 허용 목록부록 B
screens/REPL.tsx주요 대화형 인터페이스(5000개 이상의 라인 React 구성 요소)제1장