agentic-dev 0.1.0 → 0.2.1

package/sdd/02_plan/README.md

@@ -0,0 +1,40 @@
+# 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

@@ -0,0 +1,20 @@
+# 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

@@ -0,0 +1,3 @@
+# 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

@@ -0,0 +1,20 @@
+# 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/platform`, `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

@@ -0,0 +1,20 @@
+# 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/platform 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

@@ -0,0 +1,21 @@
+# 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/platform은 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

@@ -0,0 +1,21 @@
+# 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

@@ -0,0 +1,28 @@
+# 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

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

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

@@ -0,0 +1,15 @@
+# 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

@@ -0,0 +1,13 @@
+# 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

@@ -0,0 +1,14 @@
+# 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/platform_surface.md

@@ -0,0 +1,14 @@
+# Platform 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/platform/src/main.tsx -> AuthProvider -> BrowserRouter -> client/platform/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` 체인으로 이어진다.
+- platform surface는 인증, catalog, orders baseline을 current runtime tree로 제공한다.

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

@@ -0,0 +1,25 @@
+# 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/platform/PLT-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

@@ -0,0 +1,26 @@
+# 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

@@ -0,0 +1,5 @@
+# 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

@@ -0,0 +1,5 @@
+# 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

@@ -0,0 +1,5 @@
+# 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/platform/README.md

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

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

@@ -0,0 +1,10 @@
+# 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

@@ -0,0 +1,30 @@
+# 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에서 다루도록 경계가 고정됐다.

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

@@ -0,0 +1,24 @@
+# build ast runtime tree governance
+
+## Covered Planning Artifact
+
+- `sdd/02_plan/03_architecture/build_ast_runtime_tree_governance.md`
+
+## Implemented Scope
+
+- `scripts/dev/audit_sdd_build_ast.py`가 템플릿 `sdd/03_build` current-state를 AST-style runtime tree 기준으로 점수화한다.
+- service build summary는 `main.tsx -> AuthProvider -> BrowserRouter -> App -> ProtectedRoute/shell -> route leaf -> backend contract leaf` 순서로 다시 정렬했다.
+- `.agent`, `.claude/agents`, `.claude/skills/sdd*`, `.codex/skills/SKILL.md`, `.codex/skills/sdd`를 canonical agentic surface로 추가했다.
+- infra baseline은 `aws/data`, `aws/domain`, `openstack/server` provider-first split을 기준으로 문서와 Terraform skeleton을 유지한다.
+
+## Key Modules And Contracts
+
+- `scripts/dev/audit_sdd_build_ast.py`
+- `.agent/ralph.sh`
+- `.agent/ralph-supervisor.sh`
+- `.claude/agents/`
+- `.claude/skills/sdd/SKILL.md`
+- `.claude/skills/sdd-development/SKILL.md`
+- `.codex/skills/SKILL.md`
+- `.codex/skills/sdd/SKILL.md`
+- `infra/terraform/README.md`

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

@@ -0,0 +1,18 @@
+# repository governance
+
+## Covered Planning Artifact
+
+- `sdd/02_plan/03_architecture/repository_governance.md`
+
+## Implemented Scope
+
+- 템플릿 저장소는 `server`, `client`, `infra`, `.github`, `.codex`, `sdd`를 기준으로 유지된다.
+- SDD는 final-only delivery system으로 동작한다.
+- planning data modeling root는 `04_data`로 유지된다.
+- screen build summary는 `03_build/02_screen/<service>/` split을 기준으로 유지된다.
+
+## Implementation Shape
+
+- backend는 hexagonal + DDD domain split을 사용한다.
+- frontend는 4개 service app split을 사용한다.
+- automation과 repo-local skill은 `sdd/99_toolchain`과 `.codex/skills`에 함께 정리된다.

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

@@ -0,0 +1,36 @@
+# toolchain governance
+
+## Covered Planning Artifact
+
+- `sdd/02_plan/03_architecture/toolchain_governance.md`
+
+## Implemented Scope
+
+- toolchain policy 정본에 regression verification rule을 추가했다.
+- Playwright exactness runner/manifest를 local screen exactness의 canonical toolchain entrypoint로 추가했다.
+- `AGENTS.md`, `.codex/skills/sdd/SKILL.md`, `sdd/99_toolchain/01_automation/README.md`가 같은 회귀 검수 기준을 공유한다.
+- reusable asset planning root를 `sdd/01_planning/02_screen/assets/`로 정리하고, local Codex/Claude `sdd` skill에 같은 path를 반영했다.
+- `sdd/02_plan/10_test`, `sdd/03_build/10_test`, `sdd/04_verify/10_test`에 regression verification current-state 문서를 추가했다.
+- `.claude/skills/sdd-dev/SKILL.md`의 stale Codex canonical path를 현재 `.codex/skills/sdd/` 구조로 교체했다.
+- `.codex/skills/sdd/SKILL.md`와 `.claude/skills/sdd-dev/SKILL.md`에서 DEV/PROD rollout gate를 explicit deployment scope 조건으로 제한했다.
+- 디자인 가이드 builder 안내는 고정 file path 대신 `sdd/99_toolchain/01_automation/README.md`와 실제 존재하는 builder inventory 기준으로 정리했다.
+- 프로젝트 루트에 `SDD_SKILL.md`를 추가해 `sdd` skill의 용도, canonical path, 핵심 guardrail을 한 파일에서 요약했다.
+- `SDD_SKILL.md`를 확장해 workflow 단계, `sdd/` folder structure, feature/screen/architecture/data/test/operate flow 설명을 명시적으로 정리했다.
+- `SDD_SKILL.md`를 추가 확장해 toolchain, visual fidelity, exactness, functional alignment를 builder/harness/contract 관점으로 설명했다.
+- `SDD_SKILL.md`를 다시 확장해 trigger, non-use case, artifact governance, section routing, schema parity, regression verification, rollout, completion gate까지 포함하는 루트 해설서로 정리했다.
+- ignored 상태였던 `.claude/settings.local.json`, `.agent/sdd-build-ast-audit.json`, `.agent/runs/README.md`를 template-tracked asset으로 승격했다.
+- generated/cache 성격의 `node_modules`, `dist`, `.venv`, `.terraform`, runtime run output은 ignore 유지 대상으로 명시했다.
+
+## Implementation Shape
+
+- 정책 정본은 `sdd/99_toolchain/02_policies/regression-verification-policy.md`에 둔다.
+- 실행 요약은 `AGENTS.md`, skill rule은 `.codex/skills/sdd/SKILL.md`와 `.claude/skills/sdd/SKILL.md`, toolchain entry는 `sdd/99_toolchain/01_automation/README.md`가 담당한다.
+- Playwright suite registry는 `playwright_exactness_manifest.py`, canonical runner는 `run_playwright_exactness.py`가 담당한다.
+- 회귀 검수는 direct/upstream/downstream/shared surface selection을 retained SDD workflow로 유지한다.
+- local Claude alias는 현재 Codex canonical skill path를 stale alias path 없이 직접 가리킨다.
+- rollout은 `sdd/05_operate` 존재만으로 자동 요구되지 않고, explicit deployment scope 또는 저장소 completion policy가 있을 때만 gate가 열린다.
+- 루트 entrypoint 문서는 입문 설명을 담당하고, canonical 판단 기준은 local skill 원문과 toolchain policy가 담당한다.
+- 루트 entrypoint 문서는 visual proof와 functional proof를 분리해서 설명하고, 둘 다 retained evidence가 필요하다는 점을 명시한다.
+- 루트 entrypoint 문서는 skill 전체 mental model을 설명하고, 실제 강제 rule은 canonical skill/policy 문서가 담당한다.
+- local-only scaffold 중 downstream repo가 그대로 재사용해야 하는 파일은 ignore 예외로 승격하고, generated artifact는 계속 배제한다.
+- screen template는 suite id, canonical runner command, artifact path를 기본 항목으로 요구한다.

package/sdd/03_build/06_iac/README.md

@@ -0,0 +1,3 @@
+# IaC Build Summary
+
+- 현재 delivery/runtime 구조를 요약한다.

package/sdd/03_build/06_iac/dev_runtime_delivery.md

@@ -0,0 +1,10 @@
+# dev runtime delivery
+
+## Covered Planning Artifacts
+
+- `sdd/02_plan/06_iac/dev_runtime_delivery.md`
+
+## Implemented Scope
+
+- 템플릿 repo는 frontend build, backend test, screen spec capture/PDF generation을 current delivery baseline으로 유지한다.
+- runtime bootstrap과 proof tooling은 `sdd/99_toolchain/01_automation` current path를 기준으로 설명한다.

package/sdd/03_build/06_iac/template_runtime_delivery.md

@@ -0,0 +1,49 @@
+# template runtime delivery
+
+## Covered Planning Artifact
+
+- `sdd/02_plan/06_iac/template_runtime_delivery.md`
+
+## Structure Tree
+
+- template runtime delivery
+  - root compose baseline
+    - 4개 frontend surface
+    - `server` HTTP runtime
+    - 기본 `postgres`
+    - optional DB profile: `mysql`, `mariadb`, `mongo`
+  - dedicated host overlay
+    - `infra/compose/dev.yml`
+    - `infra/compose/prod.yml`
+  - provider-first delivery topology
+    - `infra/terraform/aws/domain`
+    - `infra/terraform/openstack/server`
+    - `infra/terraform/aws/data`
+
+## Cross-Cutting Links
+
+- root `compose.yml`은 템플릿 저장소의 canonical dev-focused runtime baseline이자 초기 검증 진입점이다.
+- `infra/compose/dev.yml`, `infra/compose/prod.yml`은 dedicated DEV(개발계)/PROD host layout을 위한 overlay다.
+- remote delivery topology는 `AWS edge/domain -> OpenStack backend compute -> AWS data plane` current split을 따른다.
+- CI workflow는 current compose/runtime baseline과 provider-first Terraform skeleton을 함께 검증한다.
+
+## Key Modules And Contracts
+
+- `compose.yml`
+- `.env.example`
+- `server/Dockerfile.dev`
+- `server/docker-entrypoint.sh`
+- `client/landing/Dockerfile.dev`
+- `client/platform/Dockerfile.dev`
+- `client/mobile/Dockerfile.dev`
+- `client/admin/Dockerfile.dev`
+- `infra/compose/dev.yml`
+- `infra/compose/prod.yml`
+- `infra/compose/.env.dev.example`
+- `infra/compose/.env.prod.example`
+- `infra/terraform/README.md`
+- `infra/terraform/aws/data/`
+- `infra/terraform/aws/domain/`
+- `infra/terraform/openstack/server/`
+- `.github/workflows/ci.yml`
+- `.github/workflows/frontend-parity.yml`

package/sdd/03_build/07_integration/README.md

@@ -0,0 +1,3 @@
+# Integration Build Summary
+
+- frontend/backend current integration surface를 요약한다.

package/sdd/03_build/07_integration/frontend_live_integration.md

@@ -0,0 +1,11 @@
+# frontend live integration
+
+## Covered Planning Artifact
+
+- `sdd/02_plan/07_integration/frontend_live_integration.md`
+
+## Implemented Scope
+
+- service app은 backend domain contract와 typed API helper를 통해 연결된다.
+- landing/catalog, mobile/fulfillment-shipping, admin/alerts-orders, platform/catalog-orders-support 흐름을 current baseline으로 유지한다.
+- mobile template shared lib에 `useSpeechRecognitionInput.ts`를 추가해 browser Web Speech API 입력을 consumer screen에서 재사용할 수 있게 했다.

package/sdd/03_build/08_nonfunctional/README.md

@@ -0,0 +1,3 @@
+# Nonfunctional Build Summary
+
+- repository hygiene와 buildable baseline 같은 비기능 구현 요약을 유지한다.

package/sdd/03_build/08_nonfunctional/repository_hygiene.md

@@ -0,0 +1,10 @@
+# repository hygiene
+
+## Covered Planning Artifact
+
+- `sdd/02_plan/08_nonfunctional/repository_hygiene.md`
+
+## Implemented Scope
+
+- 저장소는 cache artifact 없는 상태를 baseline으로 유지한다.
+- final-only SDD governance가 repo hygiene baseline에 포함된다.

package/sdd/03_build/10_test/README.md

@@ -0,0 +1,9 @@
+# Test Build Summary
+
+- 반복 사용하는 검증 harness와 parity surface를 current-state로 요약한다.
+- regression verification current-state summary도 같은 section에서 유지한다.
+
+## Current Documents
+
+- [verification_harness.md](verification_harness.md)
+- [regression_verification.md](regression_verification.md)

package/sdd/03_build/10_test/regression_verification.md

@@ -0,0 +1,16 @@
+# regression verification
+
+## Covered Planning Artifact
+
+- `sdd/02_plan/10_test/regression_verification.md`
+
+## Implemented Scope
+
+- regression verification을 direct/upstream/downstream/shared surface selection 기준으로 템플릿 workflow에 반영했다.
+- selected regression surface는 `AGENTS.md`, skill, toolchain, test planning 문서와 연결된다.
+- automation gap은 scope 축소가 아니라 residual risk 문서화 대상으로 유지한다.
+
+## Implementation Shape
+
+- direct target-only verification 금지 rule을 policy, skill, toolchain entrypoint에 공통 반영했다.
+- test harness 문서는 regression surface selection을 대체하지 않고, 선택된 surface를 검증하는 실행 수단으로 정리했다.

package/sdd/03_build/10_test/verification_harness.md

@@ -0,0 +1,11 @@
+# verification harness
+
+## Covered Planning Artifact
+
+- `sdd/02_plan/10_test/verification_strategy.md`
+
+## Implemented Scope
+
+- backend pytest, frontend build, parity harness가 current verification surface다.
+- parity artifact는 stable current path를 사용하도록 유지한다.
+- regression verification baseline은 별도 durable 문서에서 selected surface를 정하고, harness는 그 surface를 채우는 실행 수단으로 사용한다.

package/sdd/03_build/README.md

@@ -0,0 +1,35 @@
+# Build Governance
+
+## Purpose
+
+- `sdd/03_build/`는 실제 구현 결과를 사람이 빠르게 읽을 수 있게 정리하는 루트다.
+- `02_plan`이 무엇을 할지 관리한다면, `03_build`는 무엇으로 어떻게 구현했는지를 정리한다.
+
+## Canonical Rule
+
+- `sdd/03_build/`의 durable section은 `sdd/02_plan/`의 top-level 구조를 그대로 따른다.
+- feature 구현 요약은 `sdd/03_build/01_feature/` 아래 service 또는 domain 단위의 큰 범주 build summary로 유지한다.
+- screen 구현 요약은 `sdd/03_build/02_screen/<service>/` 아래 screen별 durable build summary로 유지한다.
+- architecture, delivery, validation harness처럼 장기 유지가 필요한 요약은 대응되는 section 번호 아래에 둔다.
+- build summary는 TODO보다 상세해야 하며, 최소한 다음을 포함한다:
+  - 어떤 planning 산출물을 현재 문서가 흡수하는지
+  - 구현된 범위
+  - 실제 사용한 모듈/컴포넌트/자산/계약
+  - 현재 구현 형태 요약
+  - 현재 사용자/운영자 관점에서 보이는 동작
+- build summary 본문은 현재 구현 상태만 설명하고, 일시적 작업 순서나 시행착오는 SDD에 별도 누적하지 않는다.
+
+## Overwrite Rule
+
+- `sdd/03_build`는 dated execution history를 보관하지 않는다.
+- 같은 feature, screen, architecture, delivery 영역의 후속 작업이 생기면 기존 build summary 파일을 덮어써서 최종 일관성만 유지한다.
+
+## Sections
+
+- `01_feature/`: 기능별 구현 요약
+- `02_screen/`: 화면별 구현 요약
+- `03_architecture/`: 저장해둘 가치가 있는 구조/거버넌스 구현 요약
+- `06_iac/`: 배포/런타임 delivery 요약
+- `07_integration/`: 연동 구현 요약
+- `08_nonfunctional/`: 비기능 구현 요약
+- `10_test/`: 반복 사용되는 검증 harness/validation surface 요약