Repository navigation
Architecture
한국어 | English
AGS는 전문 판단, 흐름 연결, 실행 검사, 호스트 연결을 분리합니다.
┌─────────────────────────────────────────────┐
│ User / Lead Session │
└──────────────────────┬──────────────────────┘
│ goal / scope
▼
┌─────────────────────────────────────────────┐
│ Orchestrator │
│ capability selection / ordering / handoff │
└──────────────┬──────────────────────────────┘
│
┌───────┴────────┐
▼ ▼
┌───────────────┐ ┌───────────────┐
│ Specialist │ │ Specialist │
│ Skills │ │ Skills │
└───────┬───────┘ └───────┬───────┘
│ provider results │
└─────────┬──────────┘
▼
┌─────────────────────────────────────────────┐
│ Local MCP + Contracts + SQLite │
│ plan / revision / evidence / completion │
└──────────────────────┬──────────────────────┘
│
┌────────┴────────┐
▼ ▼
Codex Adapter Claude Adapter
hooks / wake hooks / inbox
skills/<specialist>/는 특정 판단 책임을 가집니다.
한 스킬이 모든 문제를 해결하도록 만들기보다, 작업 계약·변경 범위·위험 점검·증거 검증·독립 감사·실패 진단처럼 책임을 나눕니다.
이 분리는 서로 다른 판단을 독립적으로 검토할 수 있게 합니다.
orchestrator는 현재 설치된 provider의 capability와 선택 조건을 조회해 필요한 흐름을 구성합니다.
일반 workflow, bootstrap, recovery provider를 구분하며 산출물 의존성을 만족시키는 순서로 실행을 연결합니다.
중요한 점은 오케스트레이터가 전문 스킬의 내용을 대신하지 않는다는 것입니다.
AGS의 단계와 산출물은 명시적 계약을 사용합니다.
대표 계약에는 다음이 포함됩니다.
TaskEnvelopeSkillDescriptorProviderResultWorkflowPlanStageResultWorkflowReceipt
이 구조 덕분에 “어떤 단계가 무엇을 입력받고 무엇을 남겨야 하는가”를 런타임에서 검사할 수 있습니다.
MCP 실행 계층은 다음을 담당합니다.
- 계획 서명과 결속
- 실행 순서
- revision
- stage 결과 형식
- artifact 의존성
- 필수 단계
- unresolved blocker
- 완료 조건
- 실행 관측 claim
- 상태 복원
Workflow 상태는 SQLite에 남아 서버 재시작 뒤에도 이어갈 수 있습니다.
Codex와 Claude Code는 세션 ID, hook 이벤트, transcript, wake 방식과 설치 형식이 다릅니다.
AGS는 이 차이를 공용 계약 안으로 직접 끌어들이지 않고 adapter와 overlay로 변환합니다.
따라서 공통 계층의 핵심 개념은 특정 제품 이름에 닫히지 않습니다.
Strict workflow에서 caller가 JSON으로 “나는 높은 모델을 썼다”고 주장하는 값은 신뢰하지 않습니다.
지원되는 host adapter가 실제 호출에서 관측한 model, reasoning effort, session, turn, tool-use 정보를 결속해 전달하며, 서버는 binding·freshness·one-use 조건을 검사합니다.
이 기능은 모델 품질 자체를 보장하는 것이 아니라 낮은 실행 설정이 높은 신뢰 단계로 조용히 통과하는 경로를 차단하는 실행 거버넌스입니다.
Session Board와 PEER messaging은 workflow DB와 별개의 협업 계층입니다.
- Session Board: 현재 누가 무엇을 맡았는지 찾음
- Messaging: 실제 요청과 결과를 전달함
- ACK: 메시지 처리 상태를 나타냄
- Wake: 유휴 세션에 재개 신호를 전달함
각 기능의 의미를 합쳐서 해석하지 않는 것이 중요합니다.
긴 단일 작업은 별도 continuity SQLite에 checkpoint를 남길 수 있습니다.
Workflow 원장은 workflow DB에 유지하고, direct task의 재개 정보는 continuity DB에 분리합니다.
이 구조는 장기 작업의 재개와 통합 workflow의 감사 원장을 서로 다른 책임으로 유지합니다.