Spec-Time Shape 속성 정의를 통한 10개 AI Agent 병렬 실행 환경 구축

Context

다수 AI Agent가 동일 Repo에서 병렬 작업 시 발생하는 파일 충돌 문제를 해결하기 위해 4단계의 Runtime 방어 체계를 구축했으나, 이는 이미 발생한 충돌에 대응하는 Reactive 방식이라는 한계 존재.

Technical Solution

• Runtime 대응에서 Spec-Time 정의로 패러다임을 전환하여 충돌 가능성을 구조적으로 차단하는 아키텍처 설계
• architectural-shape 속성을 도입하여 Feature를 plugin(수직적 기능)과 core(횡단 관심사) 두 가지 타입으로 분류
• shape="plugin" 설정 시 전용 디렉토리(src/plugins/<name>/)를 할당하여 Agent 간 파일 수정 영역을 물리적으로 분리
• shape="core" 설정 시 touches_files 명시를 강제하고 Scheduler가 이를 기반으로 상호 배제(Mutual Exclusion) 제어
• 아키텍처 의도를 Spec에 인코딩하여 Scheduler가 실행 전 단계에서 충돌 가능성을 예측하고 제어하는 구조 구현
• 복잡한 Taxonomy 대신 2가지 단순 값만 유지함으로써 Scheduling 로직의 복잡도를 낮추고 확장성 확보