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

# agent-ui

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

## 대상

- 1차 대상: ops/dev UI
- 현재 기준: Flutter control surface scaffold
- 확장 후보: 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 기준을 확정하지 않는다.
- 초기 생성 이후 기본 흐름은 `agent-ui -> code` 방향이다.
- `definition/archive/**`와 `archive/user-review/**`는 과거 기록이며 일반 작업에서 읽지 않는다.

## 생성 기준

- Source mode: `code-first`
- Baseline evidence: `apps/client/lib/main.dart`, `README.md`, `docs/architecture.md`, `agent-roadmap/phase/agent-shell-iop-execution/PHASE.md`, `agent-roadmap/phase/agent-shell-iop-execution/milestones/iop-agent-run-bridge.md`
- 생성일: 2026-06-25
