oto/agent-roadmap/archive/phase/independent-control-plane/milestones/ops-rule-monorepo-alignment.md

Milestone: agent-ops 규칙 모노레포 정합화

상태

[완료]

목표

프로젝트 규칙과 domain rule을 현재 apps/runner, apps/client, services/core, packages/flutter/oto_console 모노레포 구조에 맞게 최신화한다.

범위

• agent-ops/rules/project/rules.md의 오래된 root lib/ 중심 설명을 현재 모노레포 경로로 갱신한다.
• Dart SDK, package dependency, 테스트 target 설명을 실제 workspace 구조와 맞춘다.
• domain rule의 책임 경계와 파일 경로 예시가 현재 코드 위치를 가리키도록 정리한다.

범위 제외

• 사람용 공개 가이드로 관리되는 tracked docs/의 대규모 재작성
• domain rule의 철학 또는 agent-ops 구조 변경
• 코드 구조 변경

구현 잠금

• 상태: 해제
• 결정 필요: 없음

작업 컨텍스트

• 현재 프로젝트 규칙은 root lib/ 구조, 오래된 Dart SDK 기준, path dependency 설명을 일부 유지한다.
• 실제 구현은 apps/runner, apps/client, services/core, packages/flutter/oto_console에 분산되어 있다.
• 코드 변경 전 domain rule 확인 규칙이 있으므로, 규칙 문서의 stale path는 후속 구현 판단을 흐릴 수 있다.

기능

Epic: [rules] monorepo rule alignment

• [project-map] 프로젝트 구조, 패키지 경계, 주요 entrypoint 설명을 현재 모노레포 경로로 갱신한다.
• [sdk-deps] Dart/Flutter/Go dependency와 SDK 설명을 실제 package 기준으로 정리한다.
• [domain-paths] domain rule의 파일 경로 예시와 책임 경계 설명이 현재 코드 위치와 맞는지 검토해 갱신한다.
• [test-rules] local test rule과 smoke 문서가 모노레포 target 이름과 일치하는지 확인한다.

완료 리뷰

• 상태: 승인됨
• 요청일: 2026-06-07
• 완료 근거:
  • Makefile의 runner/client/core/proto target과 agent-test/local/rules.md의 Monorepo Targets가 일치함을 확인했다.
  • agent-test/local smoke 문서의 runner test 파일 참조와 실제 apps/runner/test/** 파일 존재를 확인했다.
  • common local, agent-smoke, framework-smoke 환경 설명을 Dart/Flutter/Go monorepo 기준으로 보정했다.
• 리뷰 필요:
  • 사용자가 완료 결과를 확인했다
  • archive 이동을 승인했다
• 리뷰 코멘트: 사용자 요청에 따라 Milestone을 완료 처리하고 archive로 이동한다.