---
ui_doc_type: definition-index
surface_type: ops-dev
source_evidence:
  - type: code
    path: null
    notes: <UI 구현 근거 요약>
  - type: docs
    path: null
    notes: <컨셉/계획 근거 요약>
  - type: user
    path: null
    notes: <사용자 명시 입력 요약>
---

# UI Definition

## Purpose

<이 agent-ui가 다루는 UI 표면과 목표를 적는다.>

## Surface Type

- Type: ops-dev
- Notes: <product UI 레이어가 필요한 경우 brand/content/assets/tokens/motion 확장 후보를 적는다.>

## Source Evidence

| Type | Path | Notes |
|------|------|-------|
| code | 없음 | <UI 구현 근거 요약> |
| docs | 없음 | <컨셉/계획 근거 요약> |
| user | 없음 | <사용자 명시 입력 요약> |

## Structure

- `views/`: 화면 또는 업무 단위 정의
- `components/`: 반복 UI 구성요소 정의
- `archive/`: 현재 기준이 아닌 과거 정의/결정 로그

## Reading Rules

- 현재 UI 동기화는 이 디렉터리의 활성 문서를 기준으로 한다.
- `archive/**`는 과거 비교, 복원, 특정 근거 확인 요청이 있을 때만 읽는다.

## Sync Rules

- frame-view가 있으면 view region id와 frame region id는 동일해야 한다.
- view에서 참조한 component id는 `components/` 아래에 정의되어야 한다.
- frame은 definition을 대체하지 않는다.
- `구현됨`, `계획`, `가정`, `불명확` 상태를 섞어 쓰지 않는다.
- 기본 코드 동기화는 `.sync-state.json` 기준 이후 변경분만 대상으로 한다.
- plan-required 코드 작업의 task/UI 매핑과 완료 정합화는 `.sync-state.json.pending_code_work`를 사용한다.
- milestone-required 코드 작업의 Milestone/UI 매핑과 완료 정합화는 `.sync-state.json.pending_milestone_work`를 사용한다.
- view/component status와 validation-only frame-view를 분리하고 완료 기록은 대응하는 `reconciled_*_work`에 둔다.
- 전체 동기화는 사용자가 명시한 경우에만 수행한다.

## Decision History

- <YYYY-MM-DD>: <초기 결정 또는 변경 요약>
