| 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 truthframe/: 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을 따른다.
