---
ui_doc_type: readme
surface_type: ops-dev
---

# agent-ui

이 디렉터리는 IOP Flutter client와 embeddable console package의 UI 의도, 화면 구조, 반복 구성요소를 동기화하기 위한 작업 문맥 저장소다.

## 대상

- 1차 대상: ops/dev UI
- 현재 source-mode: code-first
- 확장 후보: product UI layer, visual frame, brand/content/assets/tokens/motion

## 구조

- `definition/`: 현재 UI 정의 source of truth
- `definition/views/`: console section 또는 업무 화면 단위 정의
- `definition/components/`: 반복 UI 구성요소 정의
- `frame/`: visual source가 있는 view의 wireframe 연결
- `archive/user-review/`: 해결된 사용자 리뷰 로그

## 기본 규칙

- 현재 기준은 `definition/**`에 둔다.
- visual wireframe은 visual source가 있을 때만 `frame/views/**`에 둔다.
- `.excalidraw` 파일만으로 UI 기준을 확정하지 않는다.
- `definition/archive/**`와 `archive/user-review/**`는 과거 기록이며 일반 작업에서 읽지 않는다.
- 구현 코드 근거가 있는 항목만 `구현됨`으로 표시한다.
