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

55 lines
1.5 KiB
Markdown

---
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을 대체하지 않는다.
- `implemented`, `planned`, `assumed`, `unknown` 상태를 섞어 쓰지 않는다.
## Decision History
- <YYYY-MM-DD>: <초기 결정 또는 변경 요약>