Multi-Repo 환경 최적화를 위한 Agentic Worktree 기반 분산 협업 워크플로우

My Agentic Engineering Workflow

Wynand Pieters2026년 6월 21일11분intermediate

AI 요약

Context

다국어 및 다중 스택 기반의 Microservices 아키텍처에서 단일 컨텍스트 기반 AI 도구의 한계 직면. Monorepo 중심의 기존 AI 에이전트 툴들이 복잡한 Multi-Repo 의존성 관리와 컨텍스트 오버플로우 문제를 해결하지 못하는 상황 분석.

Technical Solution

~/Source/mains 디렉토리를 통한 Single Source of Truth 유지 및 각 레포지토리별 CLAUDE.md 배치로 컨텍스트 파편화 방지
Git Worktree를 활용한 ~/Source/worktrees 구조 설계로 다수 기능 구현 및 버그 수정을 병렬적으로 처리하는 격리 환경 구축
Planning Agent와 Worker Agent의 역할을 분리하여 Planning 단계의 고밀도 컨텍스트가 Worker 단계의 Token 소모 및 간섭을 일으키지 않도록 설계
/handoff 명령어를 통한 정밀한 컨텍스트 추출 및 handoff.md 기반의 에이전트 간 비동기 협업 체계 구축
rtk Rust 바이너리 프록시 도입을 통한 Token Reduction 및 DocsExplorer 서브에이전트를 통한 메인 컨텍스트 오염 방지
Security Hooks 및 Canary files를 활용한 7-layer Prompt Injection 방어 체계 구축으로 코드 안전성 확보

실천 포인트

- 각 레포지토리 루트에 `CLAUDE.md`를 작성하여 프로젝트 특화 지침 및 ADR 참조 경로 명시 - 복잡한 기능 구현 시 Planning 전용 세션에서 설계를 확정한 후 Handoff 문서를 통해 Worker 에이전트로 업무 이관 - Multi-Repo 수정 시 Git Worktree를 활용하여 브랜치 스위칭 비용을 제거하고 독립적인 작업 공간 확보 - 에이전트의 결과물을 'Trust but Verify' 관점에서 리뷰하는 최종 승인 프로세스 수립

태그

#Multi-repo #MCP #Git Worktree #Agentic Workflow #Context Window Optimization

원문 읽기