alt/agent-ops/skills/common/_templates/agent-ui/readme-template.md

ui_doc_type	surface_type
readme	ops-dev

agent-ui

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

대상

• 1차 대상: ops/dev UI
• 확장 후보: product UI

구조

• 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/**는 과거 기록이며 일반 작업에서 읽지 않는다.