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

1.5 KiB

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

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

  • : <초기 결정 또는 변경 요약>