원문 캡처 · github.com
원문 캡처 · github.com

foundry-protocol은 AI 에이전트가 복잡한 작업을 나눠 수행하도록 조율하는 재사용 가능한 프레임워크다. Claude의 계획 수립과 하위 에이전트 실행을 사람의 검증 절차와 결합하며, 프로젝트에서 얻은 일반화 가능한 교훈을 다음 프로젝트에 반영한다.

이 프레임워크는 규정 준수 감사 프로젝트의 경험(T0-T5, 작업 지시서 25건, 2026-09)을 바탕으로 만들었다. 이후 여러 에이전트를 활용한 프로젝트에서 수십 건의 작업 지시서를 ACCEPTED 상태로 처리한 경험을 토대로 자율 실행 주기, 작업 재개, 형식 계약 등의 요소를 더했다. 이 과정에는 속도 제한과 계정 간 재개가 포함됐다. 사람의 검증 게이트는 각 작업을 최소 하나의 PR과 완료 작업 보고서로 연결한다.

새 프로젝트에 적용하려면 저장소의 부트스트랩 스크립트를 실행한다.

sh
/path/to/foundry-protocol/scripts/bootstrap-project.sh /path/to/project "Project Name"

스크립트는 대상 프로젝트에 프로토콜 문서와 작업 지시서·검증 게이트 템플릿, 설정 파일, 로그, 이력 디렉터리를 만들고 관련 스크립트와 프로젝트별 메모리 템플릿을 복사한다. 기존에 파일이 없을 때만 로깅 훅을 .claude/settings.json에 추가한다. 적용 뒤에는 해당 프로젝트의 사실과 공유 맥락을 ORCHESTRATION.md에 채우고, 첫 작업 지시서를 만들기 전에 LESSONS.md를 확인한 다음 프로토콜을 따른다.

기존 프로젝트에 프레임워크를 업데이트할 때는 먼저 계획을 확인하고, 이후 적용한다.

sh
/path/to/foundry-protocol/scripts/update-project.sh /path/to/project # dry run: shows the plan
/path/to/foundry-protocol/scripts/update-project.sh /path/to/project --apply # applies it

업데이트는 관리 대상 파일의 기준 사본과 프레임워크 버전을 기록해 변경 여부를 비교한다. 프로젝트에서 수정하지 않은 파일은 새 버전으로 교체하고, 양쪽에서 수정한 파일은 충돌 없는 경우에만 3방향 병합을 적용한다. 변경이 겹치면 프로젝트 파일은 그대로 두고 .conflict 파일에 병합 결과를 기록하므로 수동으로 해결해야 한다. 기준 사본이 없는 이전 프로젝트는 동일한 파일을 관리 대상으로 채택하고, 차이가 있는 파일은 수동 검토가 필요한 충돌로 알린다. 프로젝트 이름과 기본 브랜치, 저장소를 가리키는 상대 링크는 업데이트 과정에서 되돌아가지 않도록 처리한다.

plugin/에는 반복 절차를 수행하는 Claude Skills인 bootstrap-project, close-work-order-cycle, write-project-memory가 포함된다. 저장소의 plugin/ 디렉터리를 Claude Code의 개인 스킬 디렉터리에 심볼릭 링크로 연결하면 세션과 프로젝트에서 사용할 수 있다.

sh
ln -s /path/to/foundry-protocol/plugin <claude-skills-dir>/foundry-protocol
claude plugin validate <claude-skills-dir>/foundry-protocol # confirm
claude plugin list # should list foundry-protocol@skills-dir

프로젝트별 메모리와 공통 교훈은 별도로 관리한다. 계획 역할의 Claude는 관련 작업 주기마다 해당 프로젝트의 docs/memory/entries/에 프로젝트 고유의 사실과 결정을 기록한다. 여러 프로젝트에 적용할 수 있는 교훈은 보통 단계 종료 때 저장소의 LESSONS.md에 정리한다. 프레임워크 설명 문서는 교훈이 프로토콜 자체의 변경을 뜻할 때만 수정한다.

저장소는 αIAt(https://aiat.pt)와 Guilherme da Silveira가 만들고 관리하며, MIT 라이선스로 배포한다. runtime/의 agno/AgentOS 기반 기능은 실험 단계이며, 프로토콜의 안정적인 구성 요소로 지원되지 않는다. 저장소와 라이선스는 GitHub에서 확인할 수 있다.