gito/agent-ui/README.md

ui_doc_type	surface_type
readme	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