update agent-ops roadmap and rules
This commit is contained in:
parent
27689a588c
commit
0d2a11795f
10 changed files with 93 additions and 12 deletions
|
|
@ -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 문서의 구현 구체화와 잠금 해제를 사용자에게 요청한다.
|
||||
|
|
|
|||
|
|
@ -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 구체화 업데이트와 잠금 해제를 사용자에게 요청한다.
|
||||
|
|
|
|||
|
|
@ -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 필요 여부를 검토한다.
|
||||
|
|
|
|||
|
|
@ -13,6 +13,16 @@ CLI 자동화 표면 정리
|
|||
|
||||
완료
|
||||
|
||||
## 구현 잠금
|
||||
|
||||
- 상태: 해제
|
||||
- 이유: 완료된 Milestone이며 완료 기준과 완료 근거가 문서화되어 있다. 후속 확장은 별도 Milestone에서 다룬다.
|
||||
- 해제 조건:
|
||||
- [x] 완료 기준과 완료 근거가 문서화됨
|
||||
- [x] 후속 확장은 별도 Milestone에서 다룸
|
||||
- 잠금 중 금지:
|
||||
- 해당 없음
|
||||
|
||||
## 범위
|
||||
|
||||
- 기존 `-j`, `-f`, `scheduler` 모드를 유지할 호환 표면으로 정리한다.
|
||||
|
|
|
|||
|
|
@ -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 쪽 계약 문서와 구현 범위를 확정한다.
|
||||
|
|
|
|||
|
|
@ -12,6 +12,16 @@ CLI 자동화 표면 정리
|
|||
|
||||
완료
|
||||
|
||||
## 구현 잠금
|
||||
|
||||
- 상태: 해제
|
||||
- 이유: 완료된 Milestone이며 완료 기준과 완료 근거가 문서화되어 있다. 후속 확장은 별도 Milestone에서 다룬다.
|
||||
- 해제 조건:
|
||||
- [x] 완료 기준과 완료 근거가 문서화됨
|
||||
- [x] 후속 확장은 별도 Milestone에서 다룸
|
||||
- 잠금 중 금지:
|
||||
- 해당 없음
|
||||
|
||||
## 범위
|
||||
|
||||
- Jenkins 환경 변수 파싱과 일반 파일 기반 실행 경로의 경계를 명확히 한다.
|
||||
|
|
|
|||
|
|
@ -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을 먼저 확인한다.
|
||||
|
|
|
|||
|
|
@ -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이 관련될 수 있다.
|
||||
|
|
|
|||
|
|
@ -13,6 +13,16 @@ CLI 자동화 표면 정리
|
|||
|
||||
완료
|
||||
|
||||
## 구현 잠금
|
||||
|
||||
- 상태: 해제
|
||||
- 이유: 완료된 Milestone이며 완료 기준과 완료 근거가 문서화되어 있다. 후속 확장은 별도 Milestone에서 다룬다.
|
||||
- 해제 조건:
|
||||
- [x] 완료 기준과 완료 근거가 문서화됨
|
||||
- [x] 후속 확장은 별도 Milestone에서 다룸
|
||||
- 잠금 중 금지:
|
||||
- 해당 없음
|
||||
|
||||
## 범위
|
||||
|
||||
- `Command.specs`와 `Command.catalogRows`를 command catalog의 내부 단일 진실 소스로 유지한다.
|
||||
|
|
|
|||
|
|
@ -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 |
|
||||
|
|
|
|||
Loading…
Reference in a new issue