oto/agent-ui/definition/index.md
toki 4ad5a7340d feat(agent-ui): UI 정의서 및 템플릿 업데이트
- agent-ui 정의서 전체 구조 생성 (view/component/frame/wireframe)
- UI 관련 스킬 템플릿 및 규칙 문서 개선
- components: action-feedback, agent-chat-panel, artifact-list 등 20개 이상의 컴포넌트 정의서 추가
- views: agent, artifacts, executions, overview, pipelines, runners, settings 정의서 추가
2026-06-24 23:07:00 +09:00

2.8 KiB

ui_doc_type surface_type source_evidence
definition-index ops-dev
type path notes
code packages/flutter/oto_console/lib/src/oto_console_shell.dart OtoConsoleShell, rail navigation, fallback section surface 구현
type path notes
code apps/client/lib/src/app/oto_client_app.dart Host MaterialApp이 overview/runners/pipelines/executions/artifacts surface를 mount
type path notes
docs agent-roadmap/phase/control-plane-product-surface/milestones/control-plane-security-audit-surface.md 운영 보안, 감사, UI 노출 범위가 현재 Milestone에 정의됨
type path notes
docs agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md auth token reference, action outcome, 감사 metadata 노출/마스킹 기준
type path notes
user null agent-ui 생성 요청

UI Definition

Purpose

OTO Control Plane Flutter 콘솔의 운영 화면, 반복 component, 상태 표현, write action 결과 표면을 agent와 사람이 같은 기준으로 읽을 수 있게 고정한다.

Surface Type

  • Type: ops-dev
  • Notes: 현재는 운영자용 Control Plane 콘솔을 다룬다. product UI 레이어는 요청될 때 brand/content/assets/tokens/motion 문서로 확장한다.

Source Evidence

Type Path Notes
code packages/flutter/oto_console/lib/src/oto_console_shell.dart OtoConsoleShell, rail navigation, fallback section surface 구현
code apps/client/lib/src/app/oto_client_app.dart host app이 콘솔 section surface를 실제 mount
docs agent-roadmap/phase/control-plane-product-surface/milestones/control-plane-security-audit-surface.md 운영 보안, 감사, UI 노출 범위
docs agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md auth token reference와 audit metadata 노출/마스킹 기준
user 없음 agent-ui 생성 요청

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을 대체하지 않는다.
  • 문서 계획만 있는 보안/감사 항목은 구현 완료 상태로 쓰지 않는다.

Decision History

  • 2026-06-24: Flutter 콘솔 구현을 기준으로 code-first agent-ui scaffold를 생성했다.