AI 코딩 에이전트 거버넌스 - work session과 preflight gate

모든 AI 에이전트가 작업을 먼저 선언하게 하세요. C4 요소에 대한 advisory lease, allow·warn·deny를 답하는 preflight gate, 아키텍처가 바뀌면 열리는 Architecture Change Request.

harness

Harness

코드를 만지기 전에 모든 AI 에이전트가 작업을 선언하게 하세요

Archyl은 또 하나의 코딩 에이전트가 아닙니다. 이미 사용 중인 에이전트 -- Claude Code, Cursor, Copilot, Codex -- 위에 자리하며, 첫 줄을 쓰기 전에 모든 세션을 문서화된 아키텍처에 비추어 검사합니다.

AI 코딩 에이전트 거버넌스 | work session과 preflight gate | Archyl

work session으로 AI 코딩 에이전트를 통제하세요. C4 요소에 대한 advisory lease, allow·warn·deny를 답하는 preflight gate, 아키텍처가 바뀌면 열리는 Architecture Change Request.

AI 에이전트 거버넌스, 멀티 에이전트 아키텍처, work session, AI 에이전트 충돌, 아키텍처 가드레일

병렬 에이전트는 조용히 충돌한다

세 에이전트가 세 개의 pull request를 연다. 각각은 옳지만 합치면 시스템은 서로 다른 세 가지가 된다.

에이전트가 무엇을 하는지 아무도 모른다

에이전트는 저장소를 읽고 코드를 쓰고 pull request를 연다. 그 순간까지 의도는 팀에 보이지 않는다.

RefreshCw

힘들게 얻은 맥락이 세션과 함께 사라진다

한 에이전트가 반나절을 잃은 함정은 세션이 끝나면 사라지고, 다음 에이전트가 그대로 빠진다.

에이전트가 작업을 선언한다

start_work_session이 작업을 C4 모델에 대응시키고 advisory lease를 잡은 뒤, 관련 ADR·가드레일·이전 세션이 남긴 함정을 담은 브리핑으로 시작합니다.

Terminal

preflight gate가 답한다

allow, 이유가 명시된 warn, 또는 스키마 마이그레이션 같은 배타적 충돌에서의 deny. 코드를 쓰기 전에 하나의 판정이 나옵니다.

코딩 중에도 가드레일이 작동한다

Claude Code에서는 Guard hook이 규칙을 위반하는 수정을 기록되기 전에 막습니다. 다른 에이전트는 같은 검사를 MCP로 실행합니다.

세션이 맥락을 돌려준다

finish_work_session이 결과를 기록하고 결정과 함정을 건드린 요소에 고정하며, 아키텍처가 움직였다면 Architecture Change Request를 엽니다.

GitPullRequestArrow

Advisory lease

모든 세션은 변경할 C4 요소를 선언하고, 다음 에이전트는 누가 먼저 들어와 있는지 확인합니다.

Preflight gate

활성 lease와 컨포먼스 규칙으로 allow·warn·deny를 결정합니다. exclusive를 쓰면 세션을 아예 멈춥니다.

세션을 넘어 남는 기억

메모, 관례, 함정이 아키텍처 요소에 붙어 다음 세션에 자동으로 돌아옵니다.

Activity

Fleet console

조직의 모든 세션을 실시간으로: 누가 무엇을, 어떤 요소를 쥐고, 어떤 gate 뒤에서 작업 중인지.

Architecture Change Requests

서비스를 재구성한 에이전트는 모델을 몰래 고치는 대신 제안을 제출합니다.

MCP를 쓰는 모든 에이전트

work session 도구는 평범한 MCP이며, 16개 도구의 coding 프로필이 맥락을 좁혀 줍니다.

하나의 코드베이스에 여러 에이전트

같은 시간에 같은 container를 수정하는 두 에이전트는 리뷰가 아니라 세션 시작 시점에 알게 됩니다.