제품 · work plane

액세스 맵이 아닌 절반

이 사이트의 대부분은 에이전트가 무엇에 도달할 수 있는지를 설명합니다. 이 페이지는 에이전트와 세션이 작업 자체를 어떻게 조정하는지, 그리고 각 구성 요소의 실제 범위가 현재 어디까지인지를 설명합니다.

존재하는 이유

work plane 없는 거버넌스는 조치할 대상이 없는 대시보드입니다

Olivares AI에는 두 측면이 있으며 동일한 바이너리로 함께 제공됩니다. 한쪽은 작업을 실행하고 연결하며, 다른 쪽은 이를 보고 거버닝합니다. 어느 쪽도 다른 쪽의 장식이 아닙니다. 거버넌스 없는 work plane은 나중에 아무도 설명할 수 없는 작업이고, work plane 없는 거버넌스는 조치할 대상이 없는 대시보드입니다.

이 측면이 해결하려는 문제는 가정이 아닙니다. 이 프로젝트가 자체 개발 과정에서 실제로 겪은 문제입니다. 서로를 볼 수 없는 세션, 세션 간에 어긋나는 상태, 두 번 수행된 작업, 한 터미널에만 남아 있다가 터미널을 닫으면 사라지는 결정이 여기에 해당합니다.

실재하는 것과 그렇지 않은 것

각 구성 요소와 실제 도달 범위

경계는 문구로 약속하는 것이 아니라 코드로 강제합니다. 구성 요소의 범위가 개념보다 좁으면 그 제한을 여기에 명시하고 테스트로 그 범위를 유지합니다.

Work items

운영 중 · 공개 API

설명, 출처, 종속성, 인수 기준, 결정, 담당자, 자체 이벤트 이력을 갖춘 작업 단위입니다. 영속적으로 저장되며 REST, CLI, 프로세스 내부 호출자가 공유하는 하나의 명령 문서에 따라 구동됩니다.

modules/sessions/work_model.go · modules/sessions/work_api.go

Leases

운영 중 · 공개 API

fencing으로 보호되고 만료되는 권한 형태의 소유권입니다. 획득, 갱신, 해제, 인수, 취소할 수 있습니다. 오래되어 유효하지 않은 lease의 보유자는 work item에 계속 작업할 수 없으며, 동시 획득에서는 정확히 한 주체만 성공합니다.

modules/sessions/work_lease.go

메시지, 확인 응답, 인계

운영 중 · 의도적으로 범위 제한

work item에 바인딩된 영속적 대화로, replay와 오래된 epoch 거부를 지원합니다. 확인 응답은 짚고 넘어갈 가치가 있습니다. 조정은 메시지가 전달되지 않아서보다 메시지를 보고도 조치하지 않아서 훨씬 더 자주 실패하며, ‘읽음’과 ‘답변함’은 더 이상 같은 말이 아닙니다.

오케스트레이션 워크플로 내부에서는 실제로 작동합니다. 모든 영역을 아우르는 범용 수신함은 의도적으로 연결하지 않았으며, 이는 약속이 아니라 강제되는 제한입니다. 부팅 테스트는 부팅이 바인딩하는 권한 소스와 그 순서를 고정하고, 알려진 네 가지 준비 단계 활성화 중 어느 하나라도 발생하면 실패합니다. 이것은 완전한 allowlist가 아닙니다. 다른 selector를 사용하는 향후 경로에는 별도 테스트 사례가 필요합니다. 다만 준비된 경로 중 하나를 실수로 연결하면 프로덕션에서 놀라는 대신 테스트가 실패합니다.

modules/sessions/communication_model.go(구조) · communication_ack_service.go 및 communication_ack_apply.go(확인 응답 경로와 epoch 검사) · cmd/olivares/communicationauthorityboot_test.go(공개 plane을 연결되지 않은 상태로 유지하는 부팅 테스트)

work item용 시작

운영 중 · 의도적으로 범위 제한

예약하고 lease를 획득한 다음에만 세션을 시작합니다. work, epoch, fence, execution을 영속화하므로 재시도는 두 번째 실행이 아니라 안전한 재시도가 됩니다.

오케스트레이션을 통해서만 제공되며 독립 실행형 진입점이 아닙니다.

modules/sessions/runtime_work_launch.go

A2A를 통한 원격 실행

운영 중 · 의도적으로 범위 제한

인가된 peer에서 작업을 계획, 테스트, 시작, 관찰, 취소하고 무엇을 위임했으며 무엇이 돌아왔는지에 대한 영속적 수신 기록을 남깁니다.

대상이 구성된 경우에만 마운트됩니다. 인가된 대상이 없으면 연결부는 전혀 마운트되지 않습니다. 구성 파일에 요청이 적혀 있다는 이유만으로 임의의 peer에 작업을 보내는 경로는 없습니다.

cmd/olivares/wire.go · cmd/olivares/orchremote.go

Shadow mode와 작업의 최종 결정 권한

존재하지 않음 · 구현 없음

work plane이 결정 주체가 되기 전에 현재 운영 중인 시스템과 이중으로 보고하고 comparator로 비교하는 방식입니다.

‘곧 제공’도 ‘부분 구현’도 아닙니다. 존재하지 않습니다. 현재 배포에서는 work plane에 세션에 대한 최종 결정권을 넘길 수 없으며, 제품의 어떤 내용도 이 기능을 제공한다는 뜻으로 해석해서는 안 됩니다. 만약 구현된다면 기존 소스와의 비교 기간이라는 작동 증거를 갖춰 제공됩니다. 단순한 버전 변경으로 제공되지 않습니다.

설계만 존재

이 페이지를 읽는 방법

‘서로 대화하는 에이전트’에 대한 정직한 설명

Work items와 leases는 현재 직접 사용할 수 있는 일반 API 표면입니다. 에이전트 간 대화는 실제로 작동하고 영속적이지만 오케스트레이션 워크플로로 범위가 제한됩니다. 임의의 에이전트를 위한 범용 메시지 버스는 없습니다. 원격 위임은 작동하며 알 수 없는 peer를 거부합니다.

존재하지 않는 항목을 인터페이스에서 ‘곧 제공’으로 표시하지 않습니다. 위에서 ‘존재하지 않음’으로 명시합니다. 그러지 않으면 통합 과정에서 이를 알아내느라 오후를 쓰게 됩니다. 이 프로젝트는 바로 그런 주장을 거부합니다. 트러스트 센터와 Claude Code의 거버넌스 방식도 확인하십시오.