agentic-dev 0.2.10 → 0.2.12

package/sdd/02_plan/06_iac/template_runtime_delivery.md

@@ -1,50 +0,0 @@
-# template runtime delivery
-
-- Owner: Codex
-- Status: active
-
-## Scope
-
-- In scope:
-  - root compose dev-focused runtime baseline
-  - dedicated host compose overlay positioning
-  - provider-first Terraform baseline
-  - workflow와 runtime 환경의 현재 연결 규칙
-- Out of scope:
-  - dated deploy memo
-  - service별 release timeline
-
-## Acceptance Criteria
-
-- [x] root `compose.yml`이 canonical dev-focused template runtime baseline으로 문서화된다.
-- [x] `infra/compose/dev.yml`, `infra/compose/prod.yml`이 dedicated DEV(개발계)/PROD overlay로 문서화된다.
-- [x] provider-first Terraform split(`aws/data`, `aws/domain`, `openstack/server`)이 current runtime baseline으로 문서화된다.
-
-## Execution Checklist
-
-- [x] root compose/service graph positioning을 README와 IaC 문서에 반영한다.
-- [x] dedicated host overlay 역할을 current compose baseline과 구분해 정리한다.
-- [x] toolchain policy reference와 IAC current-state 문서를 같은 runtime split으로 맞춘다.
-
-## Current Notes
-
-- current template runtime baseline은 passv-style split을 따라 root `compose.yml`을 dev-focused graph entrypoint로 둔다.
-- root `compose.yml`은 4개 frontend surface, `server`, 기본 `postgres`, optional DB profile을 함께 기동한다.
-- `infra/compose/dev.yml`, `infra/compose/prod.yml`은 dedicated host나 분리된 runtime delivery가 필요할 때 쓰는 overlay/example set이다.
-- infrastructure baseline은 `infra/terraform/README.md`를 기준으로 유지한다.
-- current canonical delivery split은 `AWS edge/domain -> OpenStack backend compute -> AWS data plane`이다.
-- CI baseline은 `.github/workflows/ci.yml`, `.github/workflows/frontend-parity.yml`를 사용한다.
-
-## Validation
-
-- current references:
-  - `README.md`
-  - `infra/compose/README.md`
-  - `sdd/99_toolchain/README.md`
-  - `sdd/99_toolchain/02_policies/compose-runtime-baseline-policy.md`
-  - `infra/terraform/README.md`
-  - `infra/terraform/aws/data/README.md`
-  - `infra/terraform/aws/domain/README.md`
-  - `infra/terraform/openstack/server/README.md`
-  - `.github/workflows/ci.yml`
-  - `.github/workflows/frontend-parity.yml`

package/sdd/02_plan/07_integration/README.md

@@ -1,5 +0,0 @@
-# Integration Planning
-
-- 이 폴더는 `sdd/02_plan` 아래에서 에이전트의 현재 개발 계획을 관리한다.
-- 내부/외부 연동 계약 정렬 계획을 현재형 durable 문서로 유지한다.
-- dated integration memo를 쌓지 않는다.

package/sdd/02_plan/07_integration/frontend_live_integration.md

@@ -1,31 +0,0 @@
-# frontend live integration
-
-- Owner: Codex
-- Status: active
-
-## Scope
-
-- In scope:
-  - web/admin/mobile/landing과 backend domain contract 연결 기준
-  - typed API helper와 current live wiring baseline
-
-## Acceptance Criteria
-
-- [x] frontend service split과 backend domain owner 매핑이 current baseline으로 정리된다.
-- [x] integration 계획은 service별 live fetch wiring을 현재형으로 설명한다.
-
-## Current Notes
-
-- `web`은 catalog/orders/support 중심 operator surface를 사용한다.
-- `admin`은 alerts, catalog, orders 관리 surface를 사용한다.
-- `mobile`은 fulfillment, shipping 중심 surface를 사용한다.
-- `landing`은 catalog/public read surface를 사용한다.
-- `client/mobile/src/lib/useSpeechRecognitionInput.ts`를 template shared utility로 유지해, 화면/입력 컴포저의 browser speech-to-text affordance를 공통 모듈로 시작할 수 있게 한다.
-
-## Validation
-
-- current references:
-  - `client/web/src`
-  - `client/admin/src`
-  - `client/mobile/src`
-  - `client/landing/src`

package/sdd/02_plan/08_nonfunctional/README.md

@@ -1,5 +0,0 @@
-# Nonfunctional Planning
-
-- 이 폴더는 `sdd/02_plan` 아래에서 에이전트의 현재 개발 계획을 관리한다.
-- 성능, 가용성, 확장성, 관측성 같은 비기능 요구 정렬 계획을 현재형 durable 문서로 유지한다.
-- dated cleanup memo를 쌓지 않는다.

package/sdd/02_plan/08_nonfunctional/repository_hygiene.md

@@ -1,26 +0,0 @@
-# repository hygiene
-
-- Owner: Codex
-- Status: active
-
-## Scope
-
-- In scope:
-  - cache artifact, generated garbage, repository hygiene baseline
-  - lint/build/test를 방해하지 않는 저장소 청결 기준
-
-## Acceptance Criteria
-
-- [x] `*.pyc`, `__pycache__`, build garbage는 committed artifact로 남지 않는다.
-- [x] SDD는 current-state 문서만 유지한다.
-
-## Current Notes
-
-- Python cache artifact와 empty cache directory는 저장소에 남기지 않는다.
-- SDD는 generated history log를 남기지 않고 current-state 문서만 유지한다.
-
-## Validation
-
-- current references:
-  - `.gitignore`
-  - `sdd/README.md`

package/sdd/02_plan/09_security/README.md

@@ -1,5 +0,0 @@
-# Security Planning
-
-- 이 폴더는 `sdd/02_plan` 아래에서 에이전트의 현재 개발 계획을 관리한다.
-- 인증, 인가, 비밀 관리, 감사 기준 정렬 계획을 현재형 durable 문서로 유지한다.
-- dated security memo를 쌓지 않는다.

package/sdd/02_plan/10_test/README.md

@@ -1,11 +0,0 @@
-# Test Planning
-
-- 이 폴더는 `sdd/02_plan` 아래에서 에이전트의 현재 개발 계획을 관리한다.
-- 이 폴더는 반복적으로 유지해야 하는 검증 전략과 테스트 계획을 durable 문서로 관리한다.
-- 날짜별 테스트 계획 메모는 두지 않고, 현재 유지해야 하는 전략과 matrix만 갱신한다.
-
-## Common Rule
-
-- 다른 `02_plan` 폴더와 동일하게 `README.md + durable 문서`만 유지한다.
-- 실제 계획은 검증 전략 문서를 직접 갱신하는 방식으로 관리하고, 날짜 기반 임시 plan 파일은 두지 않는다.
-- 검증 전략과 회귀 검수 범위 선택은 각각 durable 문서로 유지하고, direct target-only 검수로 축약하지 않는다.

package/sdd/02_plan/10_test/regression_verification.md

@@ -1,39 +0,0 @@
-# regression verification
-
-- Owner: Codex
-- Status: active
-
-## Scope
-
-- In scope:
-  - direct target 외에 upstream, downstream, shared surface까지 포함한 회귀 검수 범위 선정
-  - shared route, shell, auth/session, component, contract, generated asset, builder output 변경 시 adjacent consumer 포함 규칙
-  - 자동화가 없는 회귀 surface의 manual verification / residual risk 기록 기준
-- Out of scope:
-  - 개별 날짜별 test run history 보관
-
-## Acceptance Criteria
-
-- [x] 회귀 검수는 direct target-only로 끝내지 않는다.
-- [x] selected regression surface는 `sdd/02_plan`, `sdd/03_build`, `sdd/03_verify`에 current-state로 이어진다.
-- [x] automation gap은 scope 축소가 아니라 residual risk로 기록한다.
-
-## Execution Checklist
-
-- [x] regression surface 분류 기준을 direct, upstream, downstream, shared로 정리한다.
-- [x] shared change에서 adjacent consumer 검수 rule을 명시한다.
-- [x] manual verification과 residual risk 기록 rule을 current workflow에 반영한다.
-
-## Current Notes
-
-- 기본 최소 검수 범위는 direct target이지만, completion 판단은 selected regression surface 전체 기준으로 한다.
-- shared route, shell, auth/session, component, contract, generated asset, builder output 변경은 인접 consumer와 공용 surface까지 회귀 범위를 넓힌다.
-- 전용 automation이 아직 없으면 build, parity harness, targeted test, manual walk-through를 조합하고 미구현 automation은 residual risk로 남긴다.
-
-## Validation
-
-- current references:
-  - `AGENTS.md`
-  - `.codex/skills/sdd/SKILL.md`
-  - `sdd/99_toolchain/01_automation/README.md`
-  - `sdd/03_verify/10_test/verification_harness.md`

package/sdd/02_plan/10_test/templates/README.md

@@ -1,8 +0,0 @@
-# Templates Test Plan
-
-현재 템플릿 세트의 기본 검증 계약을 둔다.
-
-- `pnpm -r build`
-- `pytest`
-- auth runtime smoke
-- compose config validation

package/sdd/02_plan/10_test/templates/ui_parity_web_contract.template.yaml

@@ -1,23 +0,0 @@
-kind: ui-parity
-metadata:
-  service: templates
-  owner: replace-me
-  generated_by: sdd/99_toolchain/01_automation/ui-parity/cli/scaffold-contract.mjs
-spec:
-  target_base_url: http://127.0.0.1:4301
-  adapter_path: client/web/scripts/ui-parity-web-adapter.mjs
-screens:
-  - id: TMP_001
-    route: /
-    reference_image: sdd/03_verify/10_test/ui_parity/reference/TMP_001.png
-    max_diff_ratio: 0
-    allow_resize: false
-    pixelmatch_threshold: 0.1
-    include_aa: true
-    capture_full_page: false
-    viewport:
-      width: 1440
-      height: 1024
-    mask_rects: []
-    notes:
-      - Replace screen ids, routes, and reference assets for the cloned service.

package/sdd/02_plan/10_test/verification_strategy.md

@@ -1,43 +0,0 @@
-# verification strategy
-
-- Owner: Codex
-- Status: active
-
-## Scope
-
-- In scope:
-  - feature/screen 구현 시 기본 검증 전략
-  - backend/frontend/build/proof 확인 조합
-- Out of scope:
-  - 개별 test run timeline 보관
-
-## Acceptance Criteria
-
-- [x] feature 변경은 최소한 관련 integration 또는 targeted verification surface를 남긴다.
-- [x] screen 변경은 build + proof 또는 targeted verification을 기본으로 한다.
-- [x] SDD verify는 durable current-summary만 유지한다.
-- [x] 회귀 검수 범위는 direct, upstream, downstream, shared surface까지 retained current-state로 선택한다.
-
-## Execution Checklist
-
-- [x] backend, frontend, proof verification 조합을 current strategy로 정리한다.
-- [x] UI parity 같은 proof harness 경로를 current structure로 맞춘다.
-- [x] verification plan도 dated memo가 아니라 durable 문서로 유지한다.
-- [x] regression surface selection baseline을 별도 durable 문서로 유지한다.
-
-## Current Notes
-
-- backend는 `pytest` targeted suite, frontend는 build, proof는 ui parity harness와 Playwright exactness runner를 기본 전략으로 둔다.
-- screen local exactness의 canonical entrypoint는 `python3 sdd/99_toolchain/01_automation/run_playwright_exactness.py --suite <suite-id> --base-url <url>`이다.
-- direct `npx playwright test ...` 호출은 디버깅 예외로만 쓰고, retained verification command는 toolchain wrapper 기준으로 남긴다.
-- screen spec/PDF generator와 parity harness는 current toolchain path를 기준으로 검증한다.
-- verify는 날짜별 memo 대신 현재 retained checks와 residual risk만 남긴다.
-- 회귀 검수는 `sdd/02_plan/10_test/regression_verification.md`를 기준으로 direct target과 upstream/downstream/shared surface를 함께 선택한다.
-- build, parity, targeted test는 selected regression surface를 채우는 수단이지 scope 자체를 대체하지 않는다.
-
-## Validation
-
-- current references:
-  - `sdd/03_verify/README.md`
-  - `sdd/03_verify/10_test/verification_harness.md`
-  - `sdd/02_plan/10_test/regression_verification.md`

package/sdd/02_plan/99_generated/from_planning/ui_parity/.gitkeep

@@ -1 +0,0 @@
-

package/sdd/02_plan/README.md

@@ -1,40 +0,0 @@
-# Plan Governance
-
-## Purpose
-
-- `sdd/02_plan/`은 에이전트의 현재 개발 계획을 관리하는 루트다.
-- 계획 문서는 히스토리를 쌓지 않고, 대상별 durable 파일을 덮어써 최종 일관성만 유지한다.
-
-## Common Rule
-
-- `02_plan`의 모든 폴더는 같은 규칙을 따른다.
-- 각 폴더의 `README.md`는 현재 계획 규칙과 운영 방식을 설명한다.
-- 실제 계획은 대상 식별자 기준 durable 문서를 직접 갱신하는 방식으로 유지한다.
-- 개발계가 있는 대상은 `구현 -> build -> main push -> DEV(개발계) 배포 -> DEV 검수 -> 문서 갱신`을 기본 루틴으로 포함한다.
-- 날짜 기반 임시 계획 메모나 히스토리성 plan 파일은 남기지 않는다.
-
-## Section Rule
-
-- `01_feature/`: 기능별 TODO
-- `02_screen/`: 화면별 TODO
-- `03_architecture/`: 구조, 거버넌스, 마이그레이션 같은 횡단 작업
-- `04_data/`: 데이터 모델 정렬 계획
-- `05_api/`: API contract/backlog 정렬 계획
-- `06_iac/`: 인프라 작업
-- `07_integration/`: 외부/내부 연동 계획
-- `08_nonfunctional/`: 비기능 요구 정렬 계획
-- `09_security/`: 보안 계획
-- `10_test/`: 테스트 전략과 검증 계획
-
-## Durable TODO Rule
-
-- 기능 계획은 `sdd/02_plan/01_feature/<domain>_todos.md`를 갱신하고, 파일 안에서는 기능코드 기준으로만 관리한다.
-- 화면 계획은 `sdd/02_plan/02_screen/<service>_todos.md`를 갱신하고, 파일 안에서는 화면코드 기준으로 관리한다.
-- architecture, data, API, IAC, integration, nonfunctional, security, test 계획도 section별 durable 문서를 직접 갱신한다.
-- 파일명은 날짜가 아니라 대상 식별자를 기준으로 정한다.
-
-## Final-Only Rule
-
-- `sdd/02_plan`에는 dated plan history를 두지 않는다.
-- 과거 계획에서 여전히 유효한 내용은 durable governance, backlog, TODO 문서로 흡수한다.
-- runtime log나 운영 이벤트 타임라인은 backend/application logging system이 맡고, plan은 항상 현재 기준만 보여준다.

package/sdd/03_build/01_feature/README.md

@@ -1,20 +0,0 @@
-# Feature Build Summary Rule
-
-## Canonical Rule
-
-- feature 구현 결과는 overwrite-only durable build summary 파일로 관리한다.
-- planning feature spec이 서비스 legacy 축과 domain canonical 축을 함께 가질 수 있으므로, build summary는 `service/`와 `domain/`의 큰 범주로 묶어 관리한다.
-- 새 작업이 생겨도 같은 범주의 구현 설명은 같은 파일을 갱신한다.
-
-## Location
-
-- service-facing summary: `sdd/03_build/01_feature/service/`
-- domain-facing summary: `sdd/03_build/01_feature/domain/`
-
-## Recommended Sections
-
-- covered planning artifacts
-- implemented scope
-- implementation shape
-- key modules and contracts
-- current runtime or UX behavior

package/sdd/03_build/01_feature/domain/README.md

@@ -1,3 +0,0 @@
-# Domain Build Summaries
-
-- auth, user, catalog, inventory, orders, fulfillment, shipping, alerts, support, health current implementation을 domain-sized category로 묶어 설명한다.

package/sdd/03_build/01_feature/domain/account_and_access.md

@@ -1,20 +0,0 @@
-# Account And Access
-
-## Covered Planning Artifacts
-
-- `sdd/01_planning/01_feature/auth_feature_spec.md`
-- `sdd/01_planning/01_feature/user_feature_spec.md`
-
-## Implemented Scope
-
-- 인증과 사용자 baseline은 `auth`, `user` context로 분리되어 있다.
-- 세션 발급, current user 조회, admin user surface 같은 핵심 access 흐름은 backend context와 frontend typed API 조합으로 구성된다.
-
-## Implementation Shape
-
-- backend owner는 `server/contexts/auth`, `server/contexts/user`다.
-- frontend surface는 `client/web`, `client/admin`, `client/mobile`에서 공통 auth/session contract를 소비한다.
-
-## Current Behavior
-
-- 템플릿은 로그인, current user, basic account 관리 예시를 current baseline으로 제공한다.

package/sdd/03_build/01_feature/domain/catalog_and_inventory.md

@@ -1,20 +0,0 @@
-# Catalog And Inventory
-
-## Covered Planning Artifacts
-
-- `sdd/01_planning/01_feature/catalog_feature_spec.md`
-- `sdd/01_planning/01_feature/inventory_feature_spec.md`
-
-## Implemented Scope
-
-- 상품/카탈로그와 재고 baseline은 `catalog`, `inventory` context로 분리되어 있다.
-- landing/web surface는 catalog read model을, admin surface는 catalog/inventory 관리 contract를 사용한다.
-
-## Implementation Shape
-
-- backend owner는 `server/contexts/catalog`, `server/contexts/inventory`다.
-- frontend는 service별 `client/*/src/api` 계층에서 typed response를 통해 contract를 소비한다.
-
-## Current Behavior
-
-- landing은 catalog discovery baseline, admin은 catalog/inventory 관리 baseline을 제공한다.

package/sdd/03_build/01_feature/domain/ordering_and_fulfillment.md

@@ -1,21 +0,0 @@
-# Ordering And Fulfillment
-
-## Covered Planning Artifacts
-
-- `sdd/01_planning/01_feature/order_feature_spec.md`
-- `sdd/01_planning/01_feature/fulfillment_feature_spec.md`
-- `sdd/01_planning/01_feature/shipping_feature_spec.md`
-
-## Implemented Scope
-
-- 주문, 처리, 배송 baseline은 `orders`, `fulfillment`, `shipping` context로 분리되어 있다.
-- mobile/operator surface는 fulfillment/shipping read model을 사용하고, admin/web은 order overview contract를 사용한다.
-
-## Implementation Shape
-
-- backend owner는 `server/contexts/orders`, `server/contexts/fulfillment`, `server/contexts/shipping`이다.
-- frontend는 route/page 단위에서 typed API module을 통해 current contract를 소비한다.
-
-## Current Behavior
-
-- 템플릿은 주문 상태, 처리 현황, 배송 현황 같은 e-commerce baseline 흐름을 current example로 제공한다.

package/sdd/03_build/01_feature/domain/support_and_observability.md

@@ -1,21 +0,0 @@
-# Support And Observability
-
-## Covered Planning Artifacts
-
-- `sdd/01_planning/01_feature/alerts_feature_spec.md`
-- `sdd/01_planning/01_feature/support_feature_spec.md`
-- `sdd/01_planning/01_feature/health_feature_spec.md`
-
-## Implemented Scope
-
-- admin alerts, support content, health probe baseline은 `alerts`, `support`, `health` context로 분리되어 있다.
-- admin surface는 alerts/support current contract를, runtime baseline은 health probe를 사용한다.
-
-## Implementation Shape
-
-- backend owner는 `server/contexts/alerts`, `server/contexts/support`, `server/contexts/health`다.
-- frontend는 admin 중심의 typed API와 status surface로 current contract를 노출한다.
-
-## Current Behavior
-
-- 템플릿은 운영 알림, 고객지원, health probe baseline을 current implementation 예시로 제공한다.

package/sdd/03_build/01_feature/domain_surfaces.md

@@ -1,28 +0,0 @@
-# domain surfaces
-
-## Covered Planning Artifact
-
-- `sdd/01_planning/01_feature/INDEX.md`
-
-## Implemented Scope
-
-- backend domain baseline은 `auth`, `user`, `catalog`, `inventory`, `orders`, `fulfillment`, `shipping`, `alerts`, `support`, `health` context를 중심으로 구성되어 있다.
-- 각 domain feature spec은 현재 `server/contexts/*` 구현 owner 기준으로 유지된다.
-
-## Implementation Shape
-
-- API entrypoint는 `server/main.py`에서 통합되고, domain logic은 `server/contexts/*`에 분리된다.
-- feature spec은 backend owner 기준으로 canonical domain split을 유지한다.
-
-## Key Modules And Contracts
-
-- `server/contexts/auth`
-- `server/contexts/user`
-- `server/contexts/catalog`
-- `server/contexts/inventory`
-- `server/contexts/orders`
-- `server/contexts/fulfillment`
-- `server/contexts/shipping`
-- `server/contexts/alerts`
-- `server/contexts/support`
-- `server/contexts/health`

package/sdd/03_build/01_feature/service/README.md

@@ -1,3 +0,0 @@
-# Service Build Summaries
-
-- web, admin, mobile, landing current implementation을 service baseline 기준으로 설명한다.

package/sdd/03_build/01_feature/service/admin_surface.md

@@ -1,15 +0,0 @@
-# Admin Surface
-
-## Covered Planning Artifacts
-
-- `sdd/01_planning/01_feature/alerts_feature_spec.md`
-- `sdd/01_planning/01_feature/catalog_feature_spec.md`
-- `sdd/01_planning/01_feature/inventory_feature_spec.md`
-- `sdd/01_planning/01_feature/support_feature_spec.md`
-
-## Implemented Scope
-
-- runtime root는 `client/admin/src/main.tsx -> AuthProvider -> BrowserRouter -> client/admin/src/app/App.tsx` 순서로 조립된다.
-- public leaf는 `AdminLoginPage`이며, gated branch는 `ProtectedRoute -> AdminShell` 뒤에 `/`, `/queue`, `/support` route leaf를 둔다.
-- route leaf는 `AdminDashboardPage`, `AdminQueuePage`, `AdminSupportPage`로 끝나고 backend leaf는 `server/main.py -> server/api/http/app.py -> server/api/http/router.py -> contexts/alerts/contracts/http/router.py`, `contexts/inventory/contracts/http/router.py`, `contexts/support/contracts/http/router.py` 체인으로 이어진다.
-- admin surface는 alerts, inventory, support baseline을 current runtime tree로 제공한다.

package/sdd/03_build/01_feature/service/landing_surface.md

@@ -1,13 +0,0 @@
-# Landing Surface
-
-## Covered Planning Artifacts
-
-- `sdd/01_planning/01_feature/catalog_feature_spec.md`
-- `sdd/01_planning/01_feature/health_feature_spec.md`
-
-## Implemented Scope
-
-- runtime root는 `client/landing/src/main.tsx -> AuthProvider -> BrowserRouter -> client/landing/src/App.tsx` 순서로 조립된다.
-- public branch는 `/`의 `LandingHomePage`, `/login`의 `LandingLoginPage`로 끝나며 gated branch는 `ProtectedRoute -> LandingShell -> /workspace -> LandingWorkspacePage` 체인이다.
-- backend leaf는 `server/main.py -> server/api/http/app.py -> server/api/http/router.py -> contexts/catalog/contracts/http/router.py`, `contexts/health/contracts/http/router.py`, `contexts/user/contracts/http/router.py` 체인으로 이어진다.
-- landing surface는 public discovery와 authenticated workspace baseline을 current runtime tree로 제공한다.

package/sdd/03_build/01_feature/service/mobile_surface.md

@@ -1,14 +0,0 @@
-# Mobile Surface
-
-## Covered Planning Artifacts
-
-- `sdd/01_planning/01_feature/auth_feature_spec.md`
-- `sdd/01_planning/01_feature/fulfillment_feature_spec.md`
-- `sdd/01_planning/01_feature/shipping_feature_spec.md`
-
-## Implemented Scope
-
-- runtime root는 `client/mobile/src/main.tsx -> AuthProvider -> BrowserRouter -> client/mobile/src/app/App.tsx` 순서로 조립된다.
-- public leaf는 `LoginPage` 하나이며, gated branch는 `ProtectedRoute -> InShell` 뒤에 `/`, `/fulfillment`, `/shipping` route leaf를 둔다.
-- route leaf는 `DashboardPage`, `FulfillmentPage`, `ShippingPage`로 끝나고 backend leaf는 `server/main.py -> server/api/http/app.py -> server/api/http/router.py -> contexts/auth/contracts/http/router.py`, `contexts/fulfillment/contracts/http/router.py`, `contexts/shipping/contracts/http/router.py` 체인으로 이어진다.
-- mobile surface는 auth, fulfillment, shipping baseline을 current runtime tree로 제공한다.

package/sdd/03_build/01_feature/service/web_surface.md

@@ -1,14 +0,0 @@
-# Web Surface
-
-## Covered Planning Artifacts
-
-- `sdd/01_planning/01_feature/auth_feature_spec.md`
-- `sdd/01_planning/01_feature/catalog_feature_spec.md`
-- `sdd/01_planning/01_feature/order_feature_spec.md`
-
-## Implemented Scope
-
-- runtime root는 `client/web/src/main.tsx -> AuthProvider -> BrowserRouter -> client/web/src/app/App.tsx` 순서로 조립된다.
-- public leaf는 `LoginPage`이며, gated branch는 `ProtectedRoute -> AppShell` 뒤에 `/`와 `/orders` route leaf를 둔다.
-- route leaf는 `DashboardPage`, `OrdersPage`로 끝나고 backend leaf는 `server/main.py -> server/api/http/app.py -> server/api/http/router.py -> contexts/auth/contracts/http/router.py`, `contexts/catalog/contracts/http/router.py`, `contexts/orders/contracts/http/router.py` 체인으로 이어진다.
-- web surface는 인증, catalog, orders baseline을 current runtime tree로 제공한다.

package/sdd/03_build/02_screen/README.md

@@ -1,25 +0,0 @@
-# Screen Build Summary Rule
-
-## Canonical Rule
-
-- screen 구현 결과는 screen별 overwrite-only durable build summary 파일로 관리한다.
-- planning service split을 그대로 따라 `sdd/03_build/02_screen/<service>/` 아래에 둔다.
-- screen summary는 현재 구현 상태만 설명하고, dated execution history를 별도 섹션으로 두지 않는다.
-
-## Location
-
-- 예:
-  - `sdd/03_build/02_screen/mobile/MOB-S001_example.md`
-  - `sdd/03_build/02_screen/web/WEB-S001_example.md`
-
-## Recommended Sections
-
-- covered planning artifact
-- implemented scope
-- implementation shape
-- key modules/assets/contracts
-- current user-visible behavior
-
-## Template
-
-- [`_screen_build_template.md`](_screen_build_template.md)

package/sdd/03_build/02_screen/_screen_build_template.md

@@ -1,26 +0,0 @@
-# Screen Build Summary Template
-
-## Covered Planning Artifact
-
-- `sdd/01_planning/02_screen/<screen_spec>.pdf`
-
-## Implemented Scope
-
--
-
-## Implementation Shape
-
--
-
-## Key Modules, Assets, And Contracts
-
--
-- canonical Playwright suite id:
-- canonical exactness runner: `python3 sdd/99_toolchain/01_automation/run_playwright_exactness.py --suite <suite-id> --base-url <url>`
-- exactness harness:
-- results artifact:
-
-## Current User-Visible Behavior
-
--
-- local exactness gate status:

package/sdd/03_build/02_screen/admin/README.md

@@ -1,5 +0,0 @@
-# Admin Screen Build Summaries
-
-- current source: `sdd/01_planning/02_screen/admin_screen_spec.pdf`
-- 이 폴더는 admin screen별 build summary를 유지한다.
-- 현재 admin baseline은 alerts, catalog/inventory, support 운영 surface를 기준으로 해석한다.

package/sdd/03_build/02_screen/landing/README.md

@@ -1,5 +0,0 @@
-# Landing Screen Build Summaries
-
-- current source: `sdd/01_planning/02_screen/landing_screen_spec.pdf`
-- 이 폴더는 landing screen별 build summary를 유지한다.
-- 현재 landing baseline은 catalog discovery와 public entry surface를 기준으로 해석한다.

package/sdd/03_build/02_screen/mobile/README.md

@@ -1,5 +0,0 @@
-# Mobile Screen Build Summaries
-
-- current source: `sdd/01_planning/02_screen/mobile_screen_spec.pdf`
-- 이 폴더는 mobile screen별 build summary를 유지한다.
-- 현재 mobile baseline은 auth, fulfillment, shipping surface를 기준으로 해석한다.

package/sdd/03_build/02_screen/web/README.md

@@ -1,5 +0,0 @@
-# Web Screen Build Summaries
-
-- current source: `sdd/01_planning/02_screen/web_screen_spec.pdf`
-- 이 폴더는 web screen별 build summary를 유지한다.
-- 현재 web baseline은 dashboard, catalog, orders surface를 기준으로 해석한다.

package/sdd/03_build/03_architecture/README.md

@@ -1,10 +0,0 @@
-# Architecture Build Summary
-
-- 저장해둘 가치가 있는 구조/거버넌스 구현 요약을 current-state로 유지한다.
-- planning architecture governance가 실제 저장소 구조와 문서 구조에 어떻게 반영됐는지를 durable summary로 남긴다.
-
-## Current Documents
-
-- [architecture_document_governance.md](architecture_document_governance.md)
-- [repository_governance.md](repository_governance.md)
-- [toolchain_governance.md](toolchain_governance.md)

package/sdd/03_build/03_architecture/architecture_document_governance.md

@@ -1,30 +0,0 @@
-# architecture document governance
-
-## Covered Planning Artifacts
-
-- `sdd/02_plan/03_architecture/architecture_document_governance.md`
-
-## Implemented Scope
-
-- `03_architecture` planning root를 공통 아키텍처와 특화 아키텍처를 함께 담는 구조로 정리했다.
-- architecture planning이 `frontend`, `backend`, `infra`, `tech-research` split을 사용할 수 있게 맞췄다.
-- 데이터 모델링은 `04_data` 경계로 분리된다는 점을 planning 문서에 반영했다.
-
-## Implementation Shape
-
-- 공통 구조 문서 [`architecture_document_structure.md`](../../01_planning/03_architecture/architecture_document_structure.md)에서 architecture 범위와 문서 구조를 고정했다.
-- `frontend/`, `backend/`, `infra/`, `tech-research/` 하위 README를 추가해 특화 문서의 canonical 위치를 만들었다.
-- `04_data` README/INDEX는 데이터 모델링 planning root라는 경계를 설명하도록 맞췄다.
-
-## Key Modules And Contracts
-
-- [`sdd/01_planning/03_architecture/README.md`](../../01_planning/03_architecture/README.md)
-- [`sdd/01_planning/03_architecture/INDEX.md`](../../01_planning/03_architecture/INDEX.md)
-- [`sdd/01_planning/03_architecture/architecture_document_structure.md`](../../01_planning/03_architecture/architecture_document_structure.md)
-- [`sdd/01_planning/04_data/README.md`](../../01_planning/04_data/README.md)
-- [`sdd/02_plan/03_architecture/architecture_document_governance.md`](../../02_plan/03_architecture/architecture_document_governance.md)
-
-## Current Behavior
-
-- architecture planning은 root common docs와 specialized subfolders를 함께 갖는 구조로 정리돼 있다.
-- 데이터 모델링은 architecture 문서가 아니라 `04_data` planning root에서 다루도록 경계가 고정됐다.