agentic-dev 0.2.3 → 0.2.6

package/sdd/99_toolchain/01_automation/README.md

@@ -44,7 +44,7 @@
 - parity harness나 build check는 회귀 검수의 일부일 뿐이고, 실제 완료 기준은 선택한 regression surface 전체에 대한 retained evidence다.
 - Playwright exactness suite가 있는 surface는 `run_playwright_exactness.py`를 canonical local gate로 사용한다.
 - shared route, shell, auth/session, shared component, API/data contract, generated asset, builder output 변경은 adjacent consumer까지 검수 범위를 넓힌다.
-- 아직 자동화가 없는 회귀 surface는 command/manual verification으로 메우고, automation gap은 `sdd/03_build`, `sdd/04_verify`에 residual risk로 남긴다.
+- 아직 자동화가 없는 회귀 surface는 command/manual verification으로 메우고, automation gap은 `sdd/03_build`, `sdd/03_verify`에 residual risk로 남긴다.
 - Browser Use나 수동 시각 점검은 Playwright exactness gate를 대체하지 않고 보강/진단 용도로만 사용한다.
 
 ## Asset Recipe Rule
@@ -72,5 +72,5 @@
   - design guide / asset / screen spec baseline 확인
   - `python3 sdd/99_toolchain/01_automation/run_playwright_exactness.py --suite <suite-id> --base-url <url>`
   - 필요하면 `--api-base-url`, `--browser`, `--grep`를 추가한다.
-  - 실행 결과와 artifact path를 `sdd/04_verify` current summary에 기록한다.
+  - 실행 결과와 artifact path를 `sdd/03_verify` current summary에 기록한다.
 - 시작점 예시는 [`../03_templates/playwright_exactness_manifest.example.py`](../03_templates/playwright_exactness_manifest.example.py)를 따른다.

package/sdd/99_toolchain/01_automation/agentic-dev/assets/repo-contract.template.json

@@ -9,18 +9,18 @@
     "canonical_targets_dir": "sdd/02_plan"
   },
   "frontend": {
-    "default_target": "platform",
+    "default_target": "web",
     "targets": {
-      "platform": {
-        "dir": "client/platform",
-        "adapter_path": "client/platform/scripts/ui-parity-platform-adapter.mjs",
-        "screens_path": "client/platform/src/lib/specScreens.json",
-        "routes_path": "client/platform/src/lib/specRouteCatalog.json",
+      "web": {
+        "dir": "client/web",
+        "adapter_path": "client/web/scripts/ui-parity-web-adapter.mjs",
+        "screens_path": "client/web/src/lib/specScreens.json",
+        "routes_path": "client/web/src/lib/specRouteCatalog.json",
         "preview_url": "http://127.0.0.1:4301",
-        "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_platform_contract.yaml",
-        "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_platform_route_gap_report.json",
-        "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_platform_route_gap_report.md",
-        "proof_output": "sdd/04_verify/10_test/ui_parity/templates_platform_agentic_dev_latest.json"
+        "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_web_contract.yaml",
+        "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.json",
+        "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.md",
+        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_web_agentic_dev_latest.json"
       },
       "mobile": {
         "dir": "client/mobile",
@@ -31,7 +31,7 @@
         "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_mobile_contract.yaml",
         "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_mobile_route_gap_report.json",
         "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_mobile_route_gap_report.md",
-        "proof_output": "sdd/04_verify/10_test/ui_parity/templates_mobile_agentic_dev_latest.json"
+        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_mobile_agentic_dev_latest.json"
       },
       "admin": {
         "dir": "client/admin",
@@ -42,7 +42,7 @@
         "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_admin_contract.yaml",
         "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_admin_route_gap_report.json",
         "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_admin_route_gap_report.md",
-        "proof_output": "sdd/04_verify/10_test/ui_parity/templates_admin_agentic_dev_latest.json"
+        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_admin_agentic_dev_latest.json"
       },
       "landing": {
         "dir": "client/landing",
@@ -53,7 +53,7 @@
         "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_landing_contract.yaml",
         "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_landing_route_gap_report.json",
         "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_landing_route_gap_report.md",
-        "proof_output": "sdd/04_verify/10_test/ui_parity/templates_landing_agentic_dev_latest.json"
+        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_landing_agentic_dev_latest.json"
       }
     }
   },
@@ -65,8 +65,8 @@
     "verify_dev": "echo 'replace verify_dev command' >&2"
   },
   "artifacts": {
-    "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_platform_route_gap_report.json",
-    "proof_output": "sdd/04_verify/10_test/ui_parity/replace_agentic_dev_latest.json"
+    "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.json",
+    "proof_output": "sdd/03_verify/10_test/ui_parity/replace_agentic_dev_latest.json"
   },
   "notes": [
     "Replace the commands and proof output path after cloning the template.",

package/sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh

@@ -47,7 +47,7 @@ PY
 target_name="$(read_target_value "name")"
 target_dir="$(read_target_value "target.dir")"
 preview_url="$(read_target_value "target.preview_url")"
-preview_log="${repo_root}/sdd/04_verify/10_test/ui_parity/${target_name}-preview.log"
+preview_log="${repo_root}/sdd/03_verify/10_test/ui_parity/${target_name}-preview.log"
 preview_pid=""
 
 cleanup() {

package/sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json

@@ -9,18 +9,18 @@
     "canonical_targets_dir": "sdd/02_plan"
   },
   "frontend": {
-    "default_target": "platform",
+    "default_target": "web",
     "targets": {
-      "platform": {
-        "dir": "client/platform",
-        "adapter_path": "client/platform/scripts/ui-parity-platform-adapter.mjs",
-        "screens_path": "client/platform/src/lib/specScreens.json",
-        "routes_path": "client/platform/src/lib/specRouteCatalog.json",
+      "web": {
+        "dir": "client/web",
+        "adapter_path": "client/web/scripts/ui-parity-web-adapter.mjs",
+        "screens_path": "client/web/src/lib/specScreens.json",
+        "routes_path": "client/web/src/lib/specRouteCatalog.json",
         "preview_url": "http://127.0.0.1:4301",
-        "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_platform_contract.yaml",
-        "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_platform_route_gap_report.json",
-        "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_platform_route_gap_report.md",
-        "proof_output": "sdd/04_verify/10_test/ui_parity/templates_platform_agentic_dev_latest.json"
+        "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_web_contract.yaml",
+        "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.json",
+        "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.md",
+        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_web_agentic_dev_latest.json"
       },
       "mobile": {
         "dir": "client/mobile",
@@ -31,7 +31,7 @@
         "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_mobile_contract.yaml",
         "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_mobile_route_gap_report.json",
         "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_mobile_route_gap_report.md",
-        "proof_output": "sdd/04_verify/10_test/ui_parity/templates_mobile_agentic_dev_latest.json"
+        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_mobile_agentic_dev_latest.json"
       },
       "admin": {
         "dir": "client/admin",
@@ -42,7 +42,7 @@
         "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_admin_contract.yaml",
         "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_admin_route_gap_report.json",
         "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_admin_route_gap_report.md",
-        "proof_output": "sdd/04_verify/10_test/ui_parity/templates_admin_agentic_dev_latest.json"
+        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_admin_agentic_dev_latest.json"
       },
       "landing": {
         "dir": "client/landing",
@@ -53,7 +53,7 @@
         "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_landing_contract.yaml",
         "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_landing_route_gap_report.json",
         "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_landing_route_gap_report.md",
-        "proof_output": "sdd/04_verify/10_test/ui_parity/templates_landing_agentic_dev_latest.json"
+        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_landing_agentic_dev_latest.json"
       }
     }
   },
@@ -62,11 +62,11 @@
     "build": "bash sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh build .",
     "proof": "bash sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh proof .",
     "deploy_dev": "echo 'configure deploy_dev command in sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json for the cloned service' >&2",
-    "verify_dev": "test -f \"$PWD/sdd/04_verify/10_test/ui_parity/templates_platform_agentic_dev_latest.json\" && echo verify-dev-placeholder-ok"
+    "verify_dev": "test -f \"$PWD/sdd/03_verify/10_test/ui_parity/templates_web_agentic_dev_latest.json\" && echo verify-dev-placeholder-ok"
   },
   "artifacts": {
-    "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_platform_route_gap_report.json",
-    "proof_output": "sdd/04_verify/10_test/ui_parity/templates_platform_agentic_dev_latest.json"
+    "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.json",
+    "proof_output": "sdd/03_verify/10_test/ui_parity/templates_web_agentic_dev_latest.json"
   },
   "notes": [
     "This template contract is intentionally self-contained and points at repo-local 99_toolchain automation.",

package/sdd/99_toolchain/01_automation/agentic-parity-harness-design.md

@@ -46,7 +46,7 @@
 - deterministic proof:
   - `proof`는 strict parity 또는 동등한 결정적 UI 증거를 남겨야 한다.
 - evidence-first:
-  - 성공/실패는 콘솔 로그가 아니라 `sdd/04_verify/...` 산출물로 판단한다.
+  - 성공/실패는 콘솔 로그가 아니라 `sdd/03_verify/...` 산출물로 판단한다.
 - deploy discipline:
   - DEV 반영이 필요한 작업은 `main push -> DEV deploy -> DEV verify`를 따른다.
 - external integration boundary:
@@ -96,7 +96,7 @@
     "verify_dev": "<repo-local DEV verify command>"
   },
   "artifacts": {
-    "proof_output": "sdd/04_verify/10_test/<tool>/<latest>.json"
+    "proof_output": "sdd/03_verify/10_test/<tool>/<latest>.json"
   }
 }
 ```
@@ -118,7 +118,7 @@ Frontend-capable template에는 다음 두 층이 있어야 한다.
 - toolchain-owned engine:
   - `sdd/99_toolchain/01_automation/ui-parity/*`
 - app-specific adapter:
-  - `frontend/scripts/ui-parity-platform-adapter.mjs`
+  - `frontend/scripts/ui-parity-web-adapter.mjs`
 
 참조 구현 기준으로 초기 이관 대상 스크립트 묶음은 다음과 같다.
 
@@ -161,7 +161,7 @@ Frontend-capable template에는 다음 두 층이 있어야 한다.
 
 - `sdd/02_plan/10_test/<service>/ui_parity_<target>_contract.yaml`
 - `sdd/02_plan/99_generated/from_planning/ui_parity/`
-- `sdd/04_verify/10_test/ui_parity/`
+- `sdd/03_verify/10_test/ui_parity/`
 
 권장 evidence 구조:
 
@@ -224,7 +224,7 @@ Frontend-capable template에는 다음 두 층이 있어야 한다.
 - `sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json`
 - `.codex/agentic-dev.json`
 - `.claude/agentic-dev.json`
-- `frontend/scripts/ui-parity-platform-adapter.mjs`
+- `frontend/scripts/ui-parity-web-adapter.mjs`
 - app-side collector upload adapter
 - repo-local loop/sweep scripts
 - evidence path declarations
@@ -260,16 +260,16 @@ Frontend-capable template에는 다음 두 층이 있어야 한다.
 - `sdd/99_toolchain/01_automation/agentic-dev/` vendored runtime
 - `sdd/99_toolchain/01_automation/ui-parity/` parity tooling
 - optional `scripts/dev/` parity orchestration wrappers
-- `sdd/02_plan/10_test/templates/ui_parity_platform_contract.template.yaml`
+- `sdd/02_plan/10_test/templates/ui_parity_web_contract.template.yaml`
 - `sdd/02_plan/99_generated/from_planning/ui_parity/.gitkeep`
-- `sdd/04_verify/10_test/ui_parity/.gitkeep`
+- `sdd/03_verify/10_test/ui_parity/.gitkeep`
 
 ### Frontend template
 
-`templates/client/platform` 또는 별도 frontend template에는 다음을 넣는다.
+`templates/client/web` 또는 별도 frontend template에는 다음을 넣는다.
 
 - parity npm scripts
-- `client/platform/scripts/ui-parity-platform-adapter.mjs`
+- `client/web/scripts/ui-parity-web-adapter.mjs`
 - minimal screen catalog / route catalog placeholder
 - proof output path convention
 

package/sdd/99_toolchain/01_automation/capture_screen_assets.mjs

@@ -11,7 +11,7 @@ const require = createRequire(import.meta.url);
 function loadPlaywright() {
   const resolutionRoots = [
     ROOT,
-    path.join(ROOT, "client/platform"),
+    path.join(ROOT, "client/web"),
     path.join(ROOT, "client/admin"),
     path.join(ROOT, "client/mobile"),
     path.join(ROOT, "client/landing"),
@@ -32,12 +32,12 @@ function loadPlaywright() {
 const { chromium } = loadPlaywright();
 
 const manifests = {
-  platform: {
+  web: {
     baseUrl: "http://127.0.0.1:3001",
     apiBase: "http://127.0.0.1:8000/api/v1",
-    storageKey: "platform.auth.token",
+    storageKey: "web.auth.token",
     credentials: { email: "admin@example.com", password: "<CHANGE_ME>" },
-    assetDir: path.join(ROOT, "sdd/99_toolchain/01_automation/assets/platform_screen_capture"),
+    assetDir: path.join(ROOT, "sdd/99_toolchain/01_automation/assets/web_screen_capture"),
     screens: [
       { route: "/login", asset: "login.png", requiresAuth: false },
       { route: "/", asset: "dashboard.png", requiresAuth: true },

package/sdd/99_toolchain/01_automation/harness-layout.md

@@ -24,9 +24,9 @@
 
 - UI parity와 `agentic-dev` 강제 흐름은 [agentic-parity-harness-design.md](agentic-parity-harness-design.md)에 정의된 계약을 따른다.
 - parity 실행 도구 자체의 소유 위치와 계층 분리는 [parity-execution-tooling-design.md](parity-execution-tooling-design.md)를 따른다.
-- 프론트 템플릿 복제 직후에는 `bash sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh . platform`을 먼저 실행해 repo contract와 route-gap/generated parity 기초 자산을 만든다.
+- 프론트 템플릿 복제 직후에는 `bash sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh . web`을 먼저 실행해 repo contract와 route-gap/generated parity 기초 자산을 만든다.
 - `mobile`도 같은 parity target 규약을 따르며 `run_frontend_target.sh ... mobile`으로 동일하게 실행한다.
-- 첫 실행 검증은 `bash sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh . platform`으로 route-gap gate와 proof gate까지 닫는다.
+- 첫 실행 검증은 `bash sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh . web`으로 route-gap gate와 proof gate까지 닫는다.
 
 ## Sanitization Rules
 

package/sdd/99_toolchain/01_automation/parity-execution-tooling-design.md

@@ -109,7 +109,7 @@ UI parity 관련 `실행 도구`는 `sdd/99_toolchain/01_automation`의 소유
 
 위치:
 
-- `frontend/scripts/ui-parity-platform-adapter.mjs`
+- `frontend/scripts/ui-parity-web-adapter.mjs`
 - 또는 `frontend/src/lib/ui-parity/*`
 
 역할:
@@ -158,11 +158,11 @@ sdd/
   02_plan/
     10_test/
       <service>/
-        ui_parity_platform_contract.yaml
+        ui_parity_web_contract.yaml
     99_generated/
       from_planning/
         ui_parity/
-  04_verify/
+  03_verify/
     10_test/
       ui_parity/
   99_toolchain/
@@ -184,7 +184,7 @@ sdd/
 
 frontend/
   scripts/
-    ui-parity-platform-adapter.mjs
+    ui-parity-web-adapter.mjs
   src/
     lib/
       specScreens.json
@@ -209,12 +209,12 @@ frontend/
 - `sdd/99_toolchain/01_automation/agentic-dev/run_repo_phase.sh`가 contract를 읽는다.
 - contract의 `proof`는 `sdd/99_toolchain/01_automation/ui-parity/cli/run-proof`를 호출한다.
 - `run-proof`는 app adapter를 읽고 strict parity를 실행한다.
-- 결과는 `sdd/04_verify/10_test/ui_parity/...`에 저장한다.
+- 결과는 `sdd/03_verify/10_test/ui_parity/...`에 저장한다.
 
 예시 shape:
 
 ```json
-"proof": "node sdd/99_toolchain/01_automation/ui-parity/cli/run-proof.mjs --adapter frontend/scripts/ui-parity-platform-adapter.mjs --contract sdd/02_plan/10_test/<service>/ui_parity_platform_contract.yaml --out sdd/04_verify/10_test/ui_parity/<service>_agentic_dev_latest.json"
+"proof": "node sdd/99_toolchain/01_automation/ui-parity/cli/run-proof.mjs --adapter frontend/scripts/ui-parity-web-adapter.mjs --contract sdd/02_plan/10_test/<service>/ui_parity_web_contract.yaml --out sdd/03_verify/10_test/ui_parity/<service>_agentic_dev_latest.json"
 ```
 
 ### deploy_dev
@@ -307,7 +307,7 @@ agentic contract는 parity 내부 로직을 몰라도 된다.
 현재 reference implementation에서 템플릿 정본으로 승격할 때는 다음 순서를 권장한다.
 
 1. `frontend/scripts/ui-parity-*.mjs` 중 app-agnostic 로직을 `sdd/99_toolchain/01_automation/ui-parity/`로 이동
-2. app-specific 로직만 `frontend/scripts/ui-parity-platform-adapter.mjs`로 축소
+2. app-specific 로직만 `frontend/scripts/ui-parity-web-adapter.mjs`로 축소
 3. `agentic-dev` runner를 `sdd/99_toolchain/01_automation/agentic-dev/`로 이동
 4. `sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json`은 새 toolchain CLI를 호출하도록 단순화
 5. `scripts/dev/*parity*.sh`는 필요할 때만 repo별로 추가하고, base template에는 포함하지 않는다

package/sdd/99_toolchain/01_automation/screen_spec_manifest.py

@@ -44,26 +44,26 @@ def screen(
 
 
 SCREEN_MANIFESTS = {
-    "platform": {
-        "title": "Templates Platform Screen Spec",
-        "service_label": "platform",
-        "output": str(SCREEN_DIR / "platform_screen_spec.pdf"),
-        "asset_dir": str(ASSET_DIR / "platform_screen_capture"),
+    "web": {
+        "title": "Templates Web Screen Spec",
+        "service_label": "web",
+        "output": str(SCREEN_DIR / "web_screen_spec.pdf"),
+        "asset_dir": str(ASSET_DIR / "web_screen_capture"),
         "base_url": "http://127.0.0.1:3001",
         "api_base": "http://127.0.0.1:8000/api/v1",
-        "storage_key": "platform.auth.token",
+        "storage_key": "web.auth.token",
         "capture_policy": DESKTOP_CAPTURE_POLICY,
         "trim_background": False,
-        "cover_note": "첫 페이지는 platform 화면코드 인덱스다. 이후 페이지는 좌측 화면 캡처와 우측 번호형 기능 테이블을 함께 제공한다.",
+        "cover_note": "첫 페이지는 web 화면코드 인덱스다. 이후 페이지는 좌측 화면 캡처와 우측 번호형 기능 테이블을 함께 제공한다.",
         "source_refs": [
-            {"label": "implementation", "path": "client/platform/src/app/App.tsx"},
-            {"label": "implementation", "path": "client/platform/src/pages"},
-            {"label": "capture assets", "path": "sdd/99_toolchain/01_automation/assets/platform_screen_capture"},
+            {"label": "implementation", "path": "client/web/src/app/App.tsx"},
+            {"label": "implementation", "path": "client/web/src/pages"},
+            {"label": "capture assets", "path": "sdd/99_toolchain/01_automation/assets/web_screen_capture"},
         ],
         "screens": [
             screen(
-                code="PLT-S001",
-                name="Platform Login",
+                code="WEB-S001",
+                name="Web Login",
                 route="/login",
                 access="public",
                 features=["AUT-F001", "AUT-F002"],
@@ -71,14 +71,14 @@ SCREEN_MANIFESTS = {
                 requires_auth=False,
                 callouts=[
                     ((0.25, 0.31), "서비스 소개 카피", "실제 API 인증 흐름과 로그인 이후 앱 셸 진입 방식을 좌측 설명 영역에서 안내한다."),
-                    ((0.78, 0.21), "Sign in 헤더", "플랫폼 로그인 목적과 예시 계정 프리셋 상태를 보여준다."),
+                    ((0.78, 0.21), "Sign in 헤더", "web 로그인 목적과 예시 계정 프리셋 상태를 보여준다."),
                     ((0.78, 0.38), "자격 증명 입력", "이메일과 비밀번호를 입력하고 오류 상태를 같은 카드 안에서 확인한다."),
                     ((0.78, 0.48), "Continue CTA", "인증 성공 시 저장된 토큰으로 `auth/me`를 다시 호출한 뒤 보호 라우트로 이동한다."),
                 ],
             ),
             screen(
-                code="PLT-S002",
-                name="Platform Dashboard",
+                code="WEB-S002",
+                name="Web Dashboard",
                 route="/",
                 access="protected",
                 features=["AUT-F002", "ORD-F001"],
@@ -92,8 +92,8 @@ SCREEN_MANIFESTS = {
                 ],
             ),
             screen(
-                code="PLT-S003",
-                name="Platform Orders",
+                code="WEB-S003",
+                name="Web Orders",
                 route="/orders",
                 access="protected",
                 features=["AUT-F002", "ORD-F002"],

package/sdd/99_toolchain/01_automation/ui-parity/README.md

@@ -13,7 +13,7 @@
 복제 직후 초기화:
 
 ```bash
-bash sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh . platform
+bash sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh . web
 ```
 
 이 명령은 다음을 생성한다.
@@ -21,21 +21,21 @@ bash sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh . platfo
 - `sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json`
 - `.codex/agentic-dev.json`
 - `.claude/agentic-dev.json`
-- `sdd/02_plan/10_test/templates/ui_parity_platform_contract.yaml`
+- `sdd/02_plan/10_test/templates/ui_parity_web_contract.yaml`
 - `sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_route_gap_report.json`
 - `sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_route_gap_report.md`
 
 대상 프론트 선택:
 
 - 기본 대상은 `sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json`의 `frontend.default_target`에서 결정한다.
-- `platform`, `mobile`, `admin`, `landing` 같은 각 프론트는 `frontend.targets.<id>`에 `dir`, `adapter_path`, `screens_path`, `routes_path`, `preview_url`을 선언한다.
-  예시 `dir` 값은 `client/platform`처럼 실제 디렉터리 경로를 가리킨다.
+- `web`, `mobile`, `admin`, `landing` 같은 각 프론트는 `frontend.targets.<id>`에 `dir`, `adapter_path`, `screens_path`, `routes_path`, `preview_url`을 선언한다.
+  예시 `dir` 값은 `client/web`처럼 실제 디렉터리 경로를 가리킨다.
 - `init_frontend_parity.sh`, `bootstrap_frontend_parity.sh`, `run_frontend_target.sh`는 모두 이 metadata만 읽고 동작한다.
 
 첫 proof 부트스트랩:
 
 ```bash
-bash sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh . platform
+bash sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh . web
 ```
 
 이 명령은 preview 서버를 띄운 뒤 reference materialization, route-gap gate, proof gate까지 수행한다.
@@ -45,13 +45,13 @@ bash sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh . p
 
 ```bash
 node sdd/99_toolchain/01_automation/ui-parity/cli/scaffold-contract.mjs \
-  --adapter client/platform/scripts/ui-parity-platform-adapter.mjs \
-  --out sdd/02_plan/10_test/templates/ui_parity_platform_contract.yaml
+  --adapter client/web/scripts/ui-parity-web-adapter.mjs \
+  --out sdd/02_plan/10_test/templates/ui_parity_web_contract.yaml
 
 node sdd/99_toolchain/01_automation/ui-parity/cli/run-proof.mjs \
-  --adapter client/platform/scripts/ui-parity-platform-adapter.mjs \
-  --contract sdd/02_plan/10_test/templates/ui_parity_platform_contract.yaml \
-  --out sdd/04_verify/10_test/ui_parity/templates_platform_agentic_dev_latest.json
+  --adapter client/web/scripts/ui-parity-web-adapter.mjs \
+  --contract sdd/02_plan/10_test/templates/ui_parity_web_contract.yaml \
+  --out sdd/03_verify/10_test/ui_parity/templates_web_agentic_dev_latest.json
 ```
 
 관련 계약:

package/sdd/99_toolchain/01_automation/ui-parity/cli/materialize-reference-assets.mjs

@@ -40,7 +40,7 @@ let generated = 0;
 for (const screen of contract.screens) {
   const targetPath = path.resolve(
     repoRoot,
-    screen.referenceImage ?? `sdd/04_verify/10_test/ui_parity/reference/${sanitizeFileName(screen.id)}.png`,
+    screen.referenceImage ?? `sdd/03_verify/10_test/ui_parity/reference/${sanitizeFileName(screen.id)}.png`,
   );
   await captureScreen({
     browser: runtime.browser,

package/sdd/99_toolchain/01_automation/ui-parity/cli/scaffold-contract.mjs

@@ -38,13 +38,13 @@ function renderYaml(adapterPath, adapter) {
   if (screens.length === 0) {
     lines.push("  - id: TMP_001");
     lines.push("    route: /");
-    lines.push("    reference_image: sdd/04_verify/10_test/ui_parity/reference/TMP_001.png");
+    lines.push("    reference_image: sdd/03_verify/10_test/ui_parity/reference/TMP_001.png");
   } else {
     for (const screen of screens) {
       lines.push(`  - id: ${screen.id}`);
       lines.push(`    route: ${screen.route}`);
       lines.push(
-        `    reference_image: ${screen.referenceImage ?? `sdd/04_verify/10_test/ui_parity/reference/${screen.id}.png`}`,
+        `    reference_image: ${screen.referenceImage ?? `sdd/03_verify/10_test/ui_parity/reference/${screen.id}.png`}`,
       );
     }
   }

package/sdd/99_toolchain/01_automation/ui-parity/core/proof-runner.mjs

@@ -147,7 +147,7 @@ export async function runProof({
       referenceImage:
         configuredScreen.referenceImage ??
         configuredScreen.reference_image ??
-        `sdd/04_verify/10_test/ui_parity/reference/${configuredScreen.id}.png`,
+        `sdd/03_verify/10_test/ui_parity/reference/${configuredScreen.id}.png`,
     };
     const stem = sanitizeFileName(screen.id || screen.route);
     const actualPath = path.join(actualRoot, `${stem}.png`);

package/sdd/99_toolchain/01_automation/ui-parity/interfaces/ui-parity-artifact-layout.md

@@ -2,12 +2,12 @@
 
 권장 루트:
 
-- `sdd/04_verify/10_test/ui_parity/`
+- `sdd/03_verify/10_test/ui_parity/`
 
 필수 파일:
 
 - latest proof json
-  - 예: `templates_platform_agentic_dev_latest.json`
+  - 예: `templates_web_agentic_dev_latest.json`
 
 권장 하위 구조:
 

package/sdd/99_toolchain/01_automation/ui-parity/interfaces/ui-parity-route-gap-interface.md

@@ -76,7 +76,7 @@ planning evidence 필드:
 
 주요 생성 경로 예시:
 
-- `sdd/02_plan/99_generated/from_planning/ui_parity/platform.route_gap_report.json`
-- `sdd/02_plan/99_generated/from_planning/ui_parity/platform.route_gap_report.md`
+- `sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.json`
+- `sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.md`
 - `sdd/02_plan/99_generated/from_planning/ui_parity/mobile.route_gap_report.json`
 - `sdd/02_plan/99_generated/from_planning/ui_parity/mobile.route_gap_report.md`

package/sdd/99_toolchain/02_policies/build-ast-governance-policy.md

@@ -10,7 +10,7 @@
 - 기본 설명 순서는 `entry -> provider/router -> auth/session gate -> shell -> route leaf -> backend contract leaf`다.
 - shared shell, auth/session, data contract, transport split은 route leaf 이후 cross-cutting link로 연결한다.
 - `sdd/03_build`에는 dated memo, Ralph iteration narrative, run id, turn-specific 회고를 남기지 않는다.
-- 구조 current-state 적합성은 `scripts/dev/audit_sdd_build_ast.py`로 검증하고 결과는 `sdd/04_verify/03_architecture`에 유지한다.
+- 구조 current-state 적합성은 `scripts/dev/audit_sdd_build_ast.py`로 검증하고 결과는 `sdd/03_verify/03_architecture`에 유지한다.
 - downstream 저장소는 이 정책과 audit script를 함께 복제해야 한다.
 
 ## Canonical References
@@ -19,4 +19,4 @@
 - `scripts/dev/audit_sdd_build_ast.py`
 - `sdd/02_plan/03_architecture/build_ast_runtime_tree_governance.md`
 - `sdd/03_build/03_architecture/build_ast_runtime_tree_governance.md`
-- `sdd/04_verify/03_architecture/build_ast_runtime_tree_governance.md`
+- `sdd/03_verify/03_architecture/build_ast_runtime_tree_governance.md`

package/sdd/99_toolchain/02_policies/compose-runtime-baseline-policy.md

@@ -12,7 +12,7 @@
 - compose 문서는 root compose baseline과 dedicated overlay를 혼동하지 않고 current-state 역할로만 설명한다.
 - browser-facing 환경 변수(`VITE_API_BASE_URL` 등)는 컨테이너 내부 DNS가 아니라 실제 브라우저가 도달 가능한 URL을 사용한다.
 - remote delivery topology는 `AWS edge/domain -> OpenStack backend compute -> AWS data plane` current split을 기준으로 설명한다.
-- compose baseline이나 topology가 바뀌면 `README.md`, `infra/compose/README.md`, `sdd/02_plan/06_iac`, `sdd/03_build/06_iac`, `sdd/04_verify/06_iac`를 같은 변경 단위로 동기화한다.
+- compose baseline이나 topology가 바뀌면 `README.md`, `infra/compose/README.md`, `sdd/02_plan/06_iac`, `sdd/03_build/06_iac`, `sdd/03_verify/06_iac`를 같은 변경 단위로 동기화한다.
 
 ## Canonical References
 
@@ -21,4 +21,4 @@
 - `infra/terraform/README.md`
 - `sdd/02_plan/06_iac/template_runtime_delivery.md`
 - `sdd/03_build/06_iac/template_runtime_delivery.md`
-- `sdd/04_verify/06_iac/template_runtime_delivery.md`
+- `sdd/03_verify/06_iac/template_runtime_delivery.md`

package/sdd/99_toolchain/02_policies/regression-verification-policy.md

@@ -12,7 +12,7 @@
 - Playwright exactness suite가 있는 screen/local UI surface는 `sdd/99_toolchain/01_automation/run_playwright_exactness.py`를 canonical local gate로 사용한다.
 - direct `npx playwright test ...` 호출은 디버깅 예외로만 쓰고, retained verification command는 toolchain wrapper 기준으로 남긴다.
 - 자동화가 없는 회귀 surface는 가능한 command/manual verification으로 대체하고, automation gap은 residual risk로 남긴다.
-- 선택한 회귀 검수 범위, 실행한 check, 생략 사유, residual risk는 `sdd/02_plan`, `sdd/03_build`, `sdd/04_verify`에 current-state로 유지한다.
+- 선택한 회귀 검수 범위, 실행한 check, 생략 사유, residual risk는 `sdd/02_plan`, `sdd/03_build`, `sdd/03_verify`에 current-state로 유지한다.
 
 ## Canonical References
 

package/sdd/99_toolchain/03_templates/playwright_exactness_manifest.example.py

@@ -14,7 +14,7 @@ PLAYWRIGHT_SUITES = [
         "id": "shared-shell-regression",
         "spec": "shared-shell-regression.spec.js",
         "kind": "shared-ui-regression",
-        "service": "platform",
+        "service": "web",
         "targets": ["shared-shell"],
         "description": "example shared shell regression batch",
     },

package/sdd/99_toolchain/README.md

@@ -20,4 +20,4 @@
 - compose/runtime 기준선은 `02_policies/compose-runtime-baseline-policy.md`를 정본으로 사용한다.
 - 현재 canonical screen toolchain은 `build_screen_spec_pdf.py`, `capture_screen_assets.mjs`, `screen_spec_manifest.py`다.
 - Claude/Codex/Ralph 하네스는 저장소 루트 `.claude`, `.codex`, `.agent`에 두고, 그 계약 설명은 `01_automation`과 `02_policies`에 둔다.
-- `sdd/03_build`는 AST-style runtime tree current-state를 유지하고, 관련 gate는 `scripts/dev/audit_sdd_build_ast.py`와 `04_verify` summary로 관리한다.
+- `sdd/03_build`는 AST-style runtime tree current-state를 유지하고, 관련 gate는 `scripts/dev/audit_sdd_build_ast.py`와 `03_verify` summary로 관리한다.

package/sdd/README.md

@@ -16,6 +16,6 @@
 - `01_planning/`: 현재 canonical spec과 source reference
 - `02_plan/`: 에이전트의 current executable plan
 - `03_build/`: 현재 구현 요약
-- `04_verify/`: 현재 retained verification summary
+- `03_verify/`: 현재 retained verification summary
 - `05_operate/`: 현재 delivery status와 runbook
 - `99_toolchain/`: SDD를 유지하는 생성기, 자동화, 정책 문서

package/server/data/README.md

@@ -12,7 +12,7 @@
 - `bootstrap/users.json`: user profile bootstrap 원본
 - `bootstrap/catalog_products.json`: catalog product 원본
 - `bootstrap/inventory_levels.json`: inventory level 원본
-- `bootstrap/orders.json`: platform/admin order surface 원본
+- `bootstrap/orders.json`: web/admin order surface 원본
 - `bootstrap/fulfillment_tasks.json`: mobile fulfillment board task 원본
 - `bootstrap/fulfillment_events.json`: mobile fulfillment timeline 원본
 - `bootstrap/fulfillment_notes.json`: mobile fulfillment note 원본

package/client/platform/Dockerfile.dev

@@ -1,18 +0,0 @@
-FROM node:20-slim
-
-WORKDIR /app
-
-RUN npm install -g pnpm@10.32.0
-
-COPY pnpm-lock.yaml pnpm-workspace.yaml ./
-COPY client/platform/package.json ./client/platform/package.json
-
-RUN pnpm install --frozen-lockfile --filter @do4ai/client-platform-template...
-
-COPY client/platform ./client/platform
-
-WORKDIR /app/client/platform
-
-EXPOSE 3001
-
-CMD ["sh", "-lc", "pnpm exec vite --host 0.0.0.0 --port ${PORT:-3001}"]