31 lines
1.3 KiB
Markdown
31 lines
1.3 KiB
Markdown
---
|
|
ui_doc_type: readme
|
|
surface_type: 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`을 따른다.
|