From 0d2a11795f174c9adaf3cf30551ba2cb2ad61d1d Mon Sep 17 00:00:00 2001 From: toki Date: Sun, 24 May 2026 06:14:56 +0900 Subject: [PATCH] update agent-ops roadmap and rules --- agent-ops/roadmap/ROADMAP.md | 5 ++++- agent-ops/roadmap/current.md | 3 ++- .../roadmap/milestones/agent-message-protocol.md | 15 +++++++++++++++ .../roadmap/milestones/cli-automation-baseline.md | 10 ++++++++++ .../roadmap/milestones/edge-bootstrap-contract.md | 14 ++++++++++++++ .../milestones/jenkins-compatibility-boundary.md | 10 ++++++++++ .../roadmap/milestones/oto-agent-registration.md | 14 ++++++++++++++ .../roadmap/milestones/remote-run-lifecycle.md | 14 ++++++++++++++ .../milestones/structured-automation-surface.md | 10 ++++++++++ agent-ops/rules/project/rules.md | 10 ---------- 10 files changed, 93 insertions(+), 12 deletions(-) diff --git a/agent-ops/roadmap/ROADMAP.md b/agent-ops/roadmap/ROADMAP.md index ec8c6d2..ffe80f3 100644 --- a/agent-ops/roadmap/ROADMAP.md +++ b/agent-ops/roadmap/ROADMAP.md @@ -21,7 +21,7 @@ OTO는 YAML 기반 빌드/배포 파이프라인을 실행하는 Dart CLI에서 ### Edge bootstrap 기반 `oto-agent` -- [Edge bootstrap 계약](milestones/edge-bootstrap-contract.md) - 상태: 보류; 목표: Jenkins node 연결식 UX를 Edge bootstrap 설치/등록 계약으로 정리한다. iop 선행 진행을 기다린다. +- [Edge bootstrap 계약](milestones/edge-bootstrap-contract.md) - 상태: 보류; 목표: Jenkins node 연결식 UX를 Edge bootstrap 설치/등록 계약으로 정리한다. iop의 Agent Bootstrap과 OTO 등록 기준 정리를 기다린다. - [`oto-agent` 등록 흐름](milestones/oto-agent-registration.md) - 상태: 계획; 목표: `oto-agent` 설치 후 Edge 직접 outbound 등록 흐름을 구현 가능한 단위로 정리한다. ### 메시지 기반 빌드 에이전트 @@ -36,6 +36,9 @@ OTO는 YAML 기반 빌드/배포 파이프라인을 실행하는 Dart CLI에서 - `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다. - `current.md`에는 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다. - 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다. +- 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. - 활성 Milestone 밖의 작업이면 이 문서의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. - 이 문서는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다. - 상세 작업과 완료 기준은 각 Milestone 문서의 체크리스트로 관리한다. +- 선택된 Milestone의 `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 코드 구현, `agent-task` 구현 계획 생성, 세부 API/파일 구조 확정을 시작하지 않는다. +- `구현 잠금`이 없거나 잠긴 Milestone은 사용자가 "진행"을 요청해도 우회하지 않고, 먼저 Milestone 문서의 구현 구체화와 잠금 해제를 사용자에게 요청한다. diff --git a/agent-ops/roadmap/current.md b/agent-ops/roadmap/current.md index 778c986..cae958e 100644 --- a/agent-ops/roadmap/current.md +++ b/agent-ops/roadmap/current.md @@ -2,7 +2,7 @@ ## 활성 Milestone -- Edge bootstrap 계약 (보류 - iop 선행 진행 대기): agent-ops/roadmap/milestones/edge-bootstrap-contract.md +- Edge bootstrap 계약: agent-ops/roadmap/milestones/edge-bootstrap-contract.md ## 선택 규칙 @@ -10,3 +10,4 @@ - 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 Milestone을 선택하고 같은 세션에서 1회 읽는다. - 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. - 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. +- 선택된 Milestone의 `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 구현이나 구현 계획을 시작하지 않고, 먼저 Milestone 구체화 업데이트와 잠금 해제를 사용자에게 요청한다. diff --git a/agent-ops/roadmap/milestones/agent-message-protocol.md b/agent-ops/roadmap/milestones/agent-message-protocol.md index 556e780..84ae567 100644 --- a/agent-ops/roadmap/milestones/agent-message-protocol.md +++ b/agent-ops/roadmap/milestones/agent-message-protocol.md @@ -12,6 +12,19 @@ 계획 +## 구현 잠금 + +- 상태: 잠금 +- 이유: OTO agent 등록 경계와 iop Edge 쪽 specialized domain agent protocol 경계가 먼저 정리되어야 하는 계약 Milestone이다. +- 해제 조건: + - [ ] OTO agent 등록 흐름과 Edge 직접 outbound 연결 책임 경계가 문서화됨 + - [ ] register, capabilities, run request, event, cancel, status 메시지의 소유 repo와 proto-socket 경계가 구체화됨 + - [ ] 사용자가 이 Milestone의 구현 구체화와 잠금 해제를 명시적으로 승인함 +- 잠금 중 금지: + - 코드 구현 또는 `agent-task` 구현 계획 생성 + - proto 파일, 생성 코드, 메시지 버전을 추측해 확정 + - 기존 YAML 실행 경로를 대체하는 새 원격 DSL을 선확정 + ## 범위 - agent register, capabilities, run request, step event, log stream, artifact event, cancel, status, self-update 메시지의 최소 필드를 정의한다. @@ -40,4 +53,6 @@ ## 작업 컨텍스트 - CLI 자동화 표면 정리 단계의 구조화 실행 결과와 step event 기준을 먼저 확인한다. +- 선행 Milestone: `oto-agent` 등록 흐름 +- 관련 iop Milestone: `../iop/agent-ops/roadmap/milestones/agent-bootstrap-oto-enrollment.md` - 프로토콜 파일이나 생성 코드가 추가되면 관련 도메인 rule 또는 새 도메인 rule 필요 여부를 검토한다. diff --git a/agent-ops/roadmap/milestones/cli-automation-baseline.md b/agent-ops/roadmap/milestones/cli-automation-baseline.md index a0ec89d..bb53b7d 100644 --- a/agent-ops/roadmap/milestones/cli-automation-baseline.md +++ b/agent-ops/roadmap/milestones/cli-automation-baseline.md @@ -13,6 +13,16 @@ CLI 자동화 표면 정리 완료 +## 구현 잠금 + +- 상태: 해제 +- 이유: 완료된 Milestone이며 완료 기준과 완료 근거가 문서화되어 있다. 후속 확장은 별도 Milestone에서 다룬다. +- 해제 조건: + - [x] 완료 기준과 완료 근거가 문서화됨 + - [x] 후속 확장은 별도 Milestone에서 다룸 +- 잠금 중 금지: + - 해당 없음 + ## 범위 - 기존 `-j`, `-f`, `scheduler` 모드를 유지할 호환 표면으로 정리한다. diff --git a/agent-ops/roadmap/milestones/edge-bootstrap-contract.md b/agent-ops/roadmap/milestones/edge-bootstrap-contract.md index ebf2c79..fd9e4ca 100644 --- a/agent-ops/roadmap/milestones/edge-bootstrap-contract.md +++ b/agent-ops/roadmap/milestones/edge-bootstrap-contract.md @@ -13,6 +13,19 @@ Edge bootstrap 기반 `oto-agent` 보류 +## 구현 잠금 + +- 상태: 잠금 +- 이유: iop의 Agent Bootstrap과 OTO 등록에서 Edge bootstrap 사용자 흐름, bootstrap command 요구사항, 보안 모드 기준이 아직 확정되지 않은 보류 Milestone이다. +- 해제 조건: + - [ ] iop의 Agent Bootstrap과 OTO 등록에서 agent registry, bootstrap command, credential 흐름, 보안 검증 기준이 문서화됨 + - [ ] OTO 설치/등록 책임과 iop Edge 책임 경계가 구체화됨 + - [ ] 사용자가 이 Milestone의 구현 구체화와 잠금 해제를 명시적으로 승인함 +- 잠금 중 금지: + - 코드 구현 또는 `agent-task` 구현 계획 생성 + - Edge 서버 API, agent registry, credential schema를 OTO에서 추측해 확정 + - `iop-node` 연동 또는 메시지 기반 run request 프로토콜을 선구현 + ## 범위 - Jenkins node를 연결하듯 Edge에서 agent 생성과 bootstrap command 발급을 시작하는 사용자 흐름을 정의한다. @@ -46,5 +59,6 @@ Edge bootstrap 기반 `oto-agent` - 기존 packaging 자료와 설치 스크립트(`assets/package/**`, `assets/script/**`)를 먼저 확인한다. - framework, cli 도메인 rule이 관련될 수 있다. +- 선행 iop Milestone: `../iop/agent-ops/roadmap/milestones/agent-bootstrap-oto-enrollment.md` - 보류 사유: Edge bootstrap 계약은 iop에서 선행 진행되어야 하므로 OTO 쪽 작업은 pending 상태로 둔다. - 재개 조건: iop에서 Edge bootstrap 사용자 흐름, bootstrap command 요구사항, 보안 모드 기준이 먼저 정리된 뒤 OTO 쪽 계약 문서와 구현 범위를 확정한다. diff --git a/agent-ops/roadmap/milestones/jenkins-compatibility-boundary.md b/agent-ops/roadmap/milestones/jenkins-compatibility-boundary.md index a09d8b7..8681948 100644 --- a/agent-ops/roadmap/milestones/jenkins-compatibility-boundary.md +++ b/agent-ops/roadmap/milestones/jenkins-compatibility-boundary.md @@ -12,6 +12,16 @@ CLI 자동화 표면 정리 완료 +## 구현 잠금 + +- 상태: 해제 +- 이유: 완료된 Milestone이며 완료 기준과 완료 근거가 문서화되어 있다. 후속 확장은 별도 Milestone에서 다룬다. +- 해제 조건: + - [x] 완료 기준과 완료 근거가 문서화됨 + - [x] 후속 확장은 별도 Milestone에서 다룸 +- 잠금 중 금지: + - 해당 없음 + ## 범위 - Jenkins 환경 변수 파싱과 일반 파일 기반 실행 경로의 경계를 명확히 한다. diff --git a/agent-ops/roadmap/milestones/oto-agent-registration.md b/agent-ops/roadmap/milestones/oto-agent-registration.md index 4ed21dc..919049d 100644 --- a/agent-ops/roadmap/milestones/oto-agent-registration.md +++ b/agent-ops/roadmap/milestones/oto-agent-registration.md @@ -12,6 +12,19 @@ Edge bootstrap 기반 `oto-agent` 계획 +## 구현 잠금 + +- 상태: 잠금 +- 이유: Edge bootstrap 계약과 iop의 Agent Bootstrap과 OTO 등록이 선행되어야 하며, token, Edge identity, binary integrity, 재시도 기준이 아직 구현 가능한 수준으로 확정되지 않았다. +- 해제 조건: + - [ ] Edge bootstrap 계약의 사용자 흐름, command 형식, 보안 모드 기준이 문서화됨 + - [ ] bootstrap token, Edge identity 검증, binary integrity, 등록 상태 전이가 구체화됨 + - [ ] 사용자가 이 Milestone의 구현 구체화와 잠금 해제를 명시적으로 승인함 +- 잠금 중 금지: + - 코드 구현 또는 `agent-task` 구현 계획 생성 + - credential schema, service 등록 방식, 파일 경로를 추측해 확정 + - generic node agent 기능 또는 `iop-node` 경유 구조를 섞어 구현 + ## 범위 - one-time bootstrap token 검증 흐름을 정의한다. @@ -41,4 +54,5 @@ Edge bootstrap 기반 `oto-agent` ## 작업 컨텍스트 - Edge bootstrap 기반 `oto-agent` 작업 전에는 Edge bootstrap 계약을 먼저 확인한다. +- 선행 iop Milestone: `../iop/agent-ops/roadmap/milestones/agent-bootstrap-oto-enrollment.md` - 네트워크, 설치, packaging 관련 코드나 문서가 추가될 경우 관련 도메인 rule을 먼저 확인한다. diff --git a/agent-ops/roadmap/milestones/remote-run-lifecycle.md b/agent-ops/roadmap/milestones/remote-run-lifecycle.md index fc3c8a5..6a2f14d 100644 --- a/agent-ops/roadmap/milestones/remote-run-lifecycle.md +++ b/agent-ops/roadmap/milestones/remote-run-lifecycle.md @@ -12,6 +12,19 @@ Edge가 OTO agent에 파이프라인 실행을 요청하고, agent가 실행 진 계획 +## 구현 잠금 + +- 상태: 잠금 +- 이유: agent 메시지 프로토콜과 OTO agent 등록 흐름이 먼저 확정되어야 원격 실행 생명주기를 구현 가능한 단위로 나눌 수 있다. +- 해제 조건: + - [ ] agent 메시지 프로토콜의 방향성, 최소 필드, 실패 응답, capability 협상 기준이 문서화됨 + - [ ] run request와 YAML pipeline 실행 입력의 연결 기준, event/artifact/cancel/status/self-update 책임이 구체화됨 + - [ ] 사용자가 이 Milestone의 구현 구체화와 잠금 해제를 명시적으로 승인함 +- 잠금 중 금지: + - 코드 구현 또는 `agent-task` 구현 계획 생성 + - Edge scheduling policy, artifact transport, self-update 절차를 추측해 확정 + - generic remote shell agent 기능으로 범위를 확장 + ## 범위 - run request를 기존 YAML 파이프라인과 커맨드 확장 모델에 연결한다. @@ -41,4 +54,5 @@ Edge가 OTO agent에 파이프라인 실행을 요청하고, agent가 실행 진 ## 작업 컨텍스트 - agent 메시지 프로토콜과 CLI 자동화 표면 정리 단계의 구조화 출력 기준을 먼저 확인한다. +- 선행 Milestone: agent 메시지 프로토콜 - pipeline, command, core 도메인 rule이 관련될 수 있다. diff --git a/agent-ops/roadmap/milestones/structured-automation-surface.md b/agent-ops/roadmap/milestones/structured-automation-surface.md index 28d022a..2229b49 100644 --- a/agent-ops/roadmap/milestones/structured-automation-surface.md +++ b/agent-ops/roadmap/milestones/structured-automation-surface.md @@ -13,6 +13,16 @@ CLI 자동화 표면 정리 완료 +## 구현 잠금 + +- 상태: 해제 +- 이유: 완료된 Milestone이며 완료 기준과 완료 근거가 문서화되어 있다. 후속 확장은 별도 Milestone에서 다룬다. +- 해제 조건: + - [x] 완료 기준과 완료 근거가 문서화됨 + - [x] 후속 확장은 별도 Milestone에서 다룸 +- 잠금 중 금지: + - 해당 없음 + ## 범위 - `Command.specs`와 `Command.catalogRows`를 command catalog의 내부 단일 진실 소스로 유지한다. diff --git a/agent-ops/rules/project/rules.md b/agent-ops/rules/project/rules.md index 16729e2..21ead8e 100644 --- a/agent-ops/rules/project/rules.md +++ b/agent-ops/rules/project/rules.md @@ -94,16 +94,6 @@ lib/ - 더 구체적인 경로 패턴이 있으면 그 rule을 우선 적용한다. - 이미 읽은 domain rule은 같은 세션에서 반복해서 읽지 않는다. -## 마일스톤 컨텍스트 로딩 - -- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 먼저 읽는다. -- `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다. -- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다. -- 요청이 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. -- 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. -- `agent-ops/roadmap/ROADMAP.md`는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다. -- 작업 요청이 선택된 Milestone의 목표 또는 범위 제외 항목과 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다. - ## 도메인 매핑 | 경로 패턴 | 도메인 | rules.md |