agent-ui/
  README.md
  USER_REVIEW.md # 선택: 사용자 판단이 필요한 활성 리뷰

  archive/
    user-review/
      user_review_001.log

  definition/
    index.md # UI 정의 전체 인덱스, 원칙, view/component/frame 참조 규칙

    views/ # 화면/업무 단위의 현재 UI 정의 source of truth
      index.md # 전체 view tree, navigation 관계, 공통 상태/권한 규칙

      dashboard/
        index.md # dashboard view의 기준 정의서
        job-dashboard.md # dashboard 내부의 job 요약/상태 영역 정의
        job-detail-dashboard.md # dashboard 내부의 job 상세 요약 영역 정의

      jobs/
        index.md # jobs view의 기준 정의서
        build.md # jobs 하위 build 흐름/영역 정의

    components/ # 반복 UI 구성요소의 정의. 구현 API가 아니라 사용 규칙 중심
      index.md # component 목록, 공통 작성 규칙, view 정의서와의 연결 규칙

      data-table/
        index.md # data-table component의 기준 정의서
        build-result.md # build result table 변형/컬럼/상태 정의
        job-list.md # job list table 변형/컬럼/상태 정의

      status-badge/
        index.md # status-badge component의 기준 정의서

    archive/ # 현재 기준이 아닌 과거 결정/폐기 정의 로그. 기본 작업에서는 읽지 않음
      views/ # views와 동일 tree 구조를 유지하고 .log로 보관
        dashboard/
          index.log
          job-dashboard.log
          job-detail-dashboard.log

        jobs/
          index.log
          build.log

      components/ # components와 동일 tree 구조를 유지하고 .log로 보관
        data-table/
          index.log
          build-result.log
          job-list.log

        status-badge/
          index.log

  frame/
    index.md # 와이어프레임 인덱스. view별 frame 파일 위치와 형식을 안내

    views/
      dashboard/
        index.md # dashboard frame과 definition 연결 문서
        wire.excalidraw
        job-dashboard.png
        job-detail-dashboard.png

      jobs/
        index.md # jobs frame과 definition 연결 문서
        wire.excalidraw
        build.png
