oto/agent-ui/README.md

ui_doc_type	surface_type
readme	ops-dev

agent-ui

이 디렉터리는 AI agent와 사람이 OTO Control Plane UI 의도, 화면 구조, 와이어프레임, 반복 구성요소를 동기화하기 위한 작업 문맥 저장소다.

대상

• 1차 대상: ops/dev UI
• 현재 표면: Flutter OTO Console client
• 확장 후보: product UI 레이어가 필요해지면 brand, content, assets, tokens, motion 정의를 이 구조 위에 추가한다.

구조

• definition/: 현재 UI 정의 source of truth
• frame/: visual source가 있는 view의 wireframe 연결
• .sync-state.json: agent-ui -> code 동기화 기준점
• USER_REVIEW.md: 사용자 판단이 필요한 활성 질문이 생길 때만 생성
• archive/user-review/: 해결된 사용자 리뷰 로그

기본 규칙

• 현재 기준은 definition/**에 둔다.
• visual wireframe은 visual source가 있을 때만 frame/**에 둔다.
• .excalidraw 파일만으로 UI 기준을 확정하지 않는다.
• definition/archive/**와 archive/user-review/**는 과거 기록이며 일반 작업에서 읽지 않는다.
• 상태는 구현됨, 계획, 가정, 불명확 중 하나로 표시한다.
• 초기 생성 이후 기본 흐름은 agent-ui -> code 방향이며, 코드 동기화 기준은 .sync-state.json을 따른다.