Builder Rollout

1. rollout 목표

Builder rollout의 목적은 "새 UI를 크게 만든다"가 아니라 "제품 화면 품질의 기준선을 고정한다"였습니다. 그래서 전체 Builder를 한 번에 옮기지 않고, manifest와 layout, 홈/템플릿 화면, playground adapter demo, 그리고 실제 data-sources/settings 화면 순으로 좁게 적용했습니다.

지금의 의미는 더 큽니다. 이 rollout은 opt-shell가 정말로 design harness engineering layer인지 증명하는 현재 운영 기준선입니다. 즉, 문서에서 말한 mission, recipe, agent contract가 실제 제품 화면, generated docs, `opt harness check/doctor`, activation gate에 그대로 반영되어야 합니다. 현재는 workspace-first runtime, project screen rollout, fullscreen-tool surface contract, proof-aware activation이 함께 닫힌 상태입니다.

최근에는 여기에 사용자-facing harness manager도 추가됐습니다. 이제 Builder 안에서 workspace가 여러 draft harness를 만들고, review 탭에서 compare summary와 approval state, 그리고 DESIGN.md alignment readiness를 함께 확인하고, Preview에서 current draft 기준 fresh proof를 캡처하고, demo fixture와 workspace live preview로 결과를 이해한 뒤, active harness를 직접 교체할 수 있습니다. activation 이후 이력은 detail 화면의 activity feed에서 timeline, learnings, exportable intelligence snapshot으로 바로 확인됩니다.

2. Builder manifest snapshot

현재 Builder는 넓은 content width, sidebar navigation, reduced motion, card chrome adapter를 기본 정책으로 둡니다. 이 defaults가 rollout 전반의 일관된 리듬을 만듭니다.

import { createShellApp } from "@reopt-ai/opt-shell/core";

export const builderHarness = createShellApp({
  id: "reopt-builder",
  label: "reopt design Builder",
  description:
    "Internal-first harness for the Builder experience, page rhythm, and shared state UX.",
  audience: "internal",
  routeGroups: [
    {
      id: "projects",
      label: "Projects",
      href: "/builder/projects",
    },
    {
      id: "templates",
      label: "Templates",
      href: "/builder/starters",
    },
  ],
  defaults: {
    density: "comfortable",
    contentWidth: "wide",
    navigationMode: "sidebar",
    motionPolicy: "reduced",
    stateLabels: {
      loading: "Builder 화면을 불러오는 중입니다.",
      emptyTitle: "표시할 항목이 없습니다",
      emptyDescription: "새 항목을 만들거나 현재 필터를 조정해 보세요.",
      errorTitle: "Builder 화면을 표시하지 못했습니다",
    },
    adapters: {
      datagrid: { chrome: "card" },
      editor: { chrome: "card" },
    },
  },
});

3. 현재 적용 범위

4. rollout이 닫은 것

5. rollout을 묶는 기준 문서

6. 현재 운영 기준선