agentic-dev 0.2.11 → 0.2.13

package/sdd/01_planning/10_test/README.md

@@ -1,12 +0,0 @@
-# 10 Test
-
-테스트 원천 목록을 둔다.
-
-- frontend build matrix
-- api pytest matrix
-- auth runtime smoke
-- compose validation
-
-## Canonical Docs
-
-- [templates_test_strategy.md](./templates_test_strategy.md)

package/sdd/01_planning/10_test/templates_test_strategy.md

@@ -1,60 +0,0 @@
-# templates test strategy
-
-- 작성 버전: 1.0.0
-
-## Purpose
-
-template baseline을 유지하기 위한 테스트 전략을 정의한다.
-
-## 1. Backend
-
-- `server/tests/e2e/test_domain_feature_flows.py`
-  - `AUT-F001`
-  - `AUT-F002`
-  - `USR-F001`
-  - `USR-F002`
-  - `USR-F003`
-  - `CAT-F001`
-  - `CAT-F003`
-  - `CAT-F004`
-  - `CAT-F005`
-  - `INV-F001`
-  - `INV-F002`
-  - `INV-F003`
-  - `INV-F004`
-  - `INV-F005`
-  - `INV-F006`
-  - `ORD-F001`
-  - `ORD-F002`
-  - `ORD-F003`
-  - `ORD-F004`
-  - `ORD-F005`
-  - `ORD-F006`
-  - `SHP-F001`
-  - `SHP-F002`
-  - `SHP-F003`
-  - `ALR-F001`
-  - `ALR-F002`
-  - `ALR-F003`
-  - `SUP-F001`
-  - `SUP-F002`
-  - `SUP-F003`
-  - `FUL-F001`
-  - `FUL-F002`
-  - `FUL-F003`
-- `server/tests/test_health.py`
-  - `HLT-F001`
-  - `HLT-F002`
-  - auth/user smoke
-
-## 2. Frontend
-
-- `web`, `admin`, `mobile`, `landing`는 각 서비스별 production build를 통과해야 한다.
-- screen spec은 `WEB-S001`, `ADM-S001`, `MOB-S001`, `LND-S001` 규칙으로 구현 route와 관련 feature를 함께 검증한다.
-- parity harness가 활성화되면 route-gap과 proof artifact를 추가 검증한다.
-
-## 3. CI Gate
-
-- backend: `./.venv/bin/python -m pytest -q` 또는 CI 환경의 `uv run pytest -q`
-- frontend: `pnpm build` matrix
-- toolchain: `build_screen_spec_pdf.py`, `capture_screen_assets.mjs`, `new_plan.sh` shell validation

package/sdd/01_planning/INDEX.md

@@ -1,19 +0,0 @@
-# Planning Index
-
-- [01_feature/INDEX.md](./01_feature/INDEX.md)
-- [02_screen/INDEX.md](./02_screen/INDEX.md)
-- [03_architecture/INDEX.md](./03_architecture/INDEX.md)
-- [04_data/INDEX.md](./04_data/INDEX.md)
-- [05_api/README.md](./05_api/README.md)
-- [06_iac/README.md](./06_iac/README.md)
-- [07_integration/README.md](./07_integration/README.md)
-- [08_nonfunctional/README.md](./08_nonfunctional/README.md)
-- [09_security/README.md](./09_security/README.md)
-- [10_test/README.md](./10_test/README.md)
-
-## Structure Rule
-
-- `01_feature`, `02_screen`는 실제 서비스 표면(`web`, `mobile`, `admin`, `landing`) 기준으로 유지한다.
-- `03_architecture` 이후는 서비스별 실산출물이 없으면 common-first로 유지한다.
-- `03_architecture`는 공통 문서를 먼저 두고 필요 시 `frontend/`, `backend/`, `infra/`, `tech-research/`로 세분화한다.
-- 데이터 모델링은 `04_data`에서 다루고 architecture 문서에는 중복 기록하지 않는다.

package/sdd/01_planning/README.md

@@ -1,17 +0,0 @@
-# Planning Governance
-
-## Purpose
-
-- `sdd/01_planning/`은 현재 구현과 검수의 기준이 되는 canonical spec을 유지한다.
-- feature, screen, architecture, data, API, IAC, integration, nonfunctional, security, test planning 모두 현재 기준만 남긴다.
-
-## Final-Only Rule
-
-- planning도 날짜별 작업 메모나 히스토리성 보조 문서를 쌓지 않는다.
-- 계속 참고할 가치가 있는 리서치만 현재형 문서로 유지한다.
-- source reference가 필요하면 현재 canonical source만 남기고, raw capture log나 일회성 추출 로그는 두지 않는다.
-
-## Structure Rule
-
-- `01_feature`, `02_screen`는 실제 서비스 표면 기준으로 유지한다.
-- `03_architecture` 이후 planning 폴더는 서비스별 실산출물이 없으면 common-first 구조로 유지한다.

package/sdd/02_plan/01_feature/README.md

@@ -1,34 +0,0 @@
-# Feature TODO Rule
-
-## Common Rule
-
-- 이 폴더는 `sdd/02_plan` 아래에서 에이전트의 현재 개발 계획을 관리한다.
-- 다른 `02_plan` 폴더와 동일하게 `README.md + durable TODO 파일`만 유지하고, dated plan history는 두지 않는다.
-
-## Canonical Rule
-
-- 기능 계획은 domain별 durable TODO 파일로 관리한다.
-- 신규 작업이 생겨도 날짜별 파일을 추가하지 않는다.
-- 같은 domain 파일 안에서는 canonical 기능코드 기준 표만 계속 갱신한다.
-- service feature spec은 source reference로만 사용하고, active TODO는 domain 파일만 유지한다.
-
-## Naming
-
-- 파일명은 날짜 prefix를 쓰지 않는다.
-- 권장 형식: `{domain}_todos.md`
-
-## Location
-
-- active feature TODO는 `sdd/02_plan/01_feature/` root에 둔다.
-
-## Minimum Sections
-
-- domain summary
-- feature items
-- acceptance criteria
-- current notes
-- latest verification
-
-## Template
-
-- [`_feature_todo_template.md`](_feature_todo_template.md)

package/sdd/02_plan/01_feature/_feature_todo_template.md

@@ -1,29 +0,0 @@
-# {domain code} {domain name}
-
-- Owner: Codex
-- Status: active
-
-## Domain Summary
-
-- domain code:
-- canonical source:
-- update rule: 이 파일 안에서 feature code 기준으로 계속 갱신한다.
-
-## Feature Items
-
-| Feature Code | Use Case | Status | Current Notes |
-| --- | --- | --- | --- |
-| `{DOMAIN}-F001` |  | `planned` |  |
-
-## Acceptance Criteria
-
-- [ ] 이 파일이 해당 domain feature TODO의 single source of truth로 유지된다.
-- [ ] 신규 작업은 해당 feature code row와 current notes만 갱신한다.
-
-## Current Notes
-
-- TODO는 canonical domain feature code 기준으로만 유지한다.
-
-## Latest Verification
-
-- current plan normalization reference: `sdd/02_plan/01_feature/<domain>_todos.md`

package/sdd/02_plan/02_screen/INDEX.md

@@ -1,19 +0,0 @@
-# Screen TODO Index
-
-## Canonical Sources
-
-- [mobile_screen_spec.pdf](../../01_planning/02_screen/mobile_screen_spec.pdf)
-- [web_screen_spec.pdf](../../01_planning/02_screen/web_screen_spec.pdf)
-- [admin_screen_spec.pdf](../../01_planning/02_screen/admin_screen_spec.pdf)
-- [landing_screen_spec.pdf](../../01_planning/02_screen/landing_screen_spec.pdf)
-
-## Current Planning Templates
-
-- [README.md](./README.md)
-- [_screen_todo_template.md](./_screen_todo_template.md)
-
-## Naming Rule
-
-- active screen plan file: `<service>_todos.md`
-- screen section identifier inside file: `{SERVICE}-S{NNN}`
-- mobile legacy source key는 필요할 때만 문서 내부에서 `APP_###` field로 기록한다.

package/sdd/02_plan/02_screen/README.md

@@ -1,39 +0,0 @@
-# Screen TODO Rule
-
-## Common Rule
-
-- 이 폴더는 `sdd/02_plan` 아래에서 에이전트의 현재 개발 계획을 관리한다.
-- 다른 `02_plan` 폴더와 동일하게 `README.md + durable TODO 파일`만 유지하고, dated plan history는 두지 않는다.
-- 개발계가 있는 화면 작업은 `구현 -> build -> DEV(개발계) 배포 -> DEV 검수 -> 같은 TODO 파일 갱신`을 기본 루틴으로 둔다.
-
-## Canonical Rule
-
-- 화면 계획은 service별 durable TODO 파일로 관리한다.
-- `01_feature`와 동일하게 날짜별 작업 문서를 계속 추가하지 않는다.
-- 같은 service 파일 안에서 화면코드 기준으로 계속 갱신한다.
-- mobile source key인 `APP_###`는 파일명이 아니라 문서 내부 field로만 기록한다.
-- 과거 screen plan 문서는 별도 보관하지 않고, 현재 기준 README와 service TODO만 유지한다.
-
-## Location
-
-- 서비스별 화면 TODO는 `sdd/02_plan/02_screen/` root에 둔다.
-- 예:
-  - `sdd/02_plan/02_screen/mobile_todos.md`
-  - `sdd/02_plan/02_screen/web_todos.md`
-
-## Naming
-
-- 파일명은 날짜 prefix를 쓰지 않는다.
-- 권장 형식: `{service}_todos.md`
-
-## Minimum Sections
-
-- service summary
-- shared constraints or baseline
-- screen items
-- delivery phases or backlog
-- latest verification references
-
-## Template
-
-- [`_screen_todo_template.md`](_screen_todo_template.md)

package/sdd/02_plan/02_screen/_screen_todo_template.md

@@ -1,60 +0,0 @@
-# {service} screen TODO
-
-- Owner: Codex
-- Status: active
-
-## Service Summary
-
-- service:
-- canonical source:
-- update rule: 이 파일 안에서 화면코드 기준으로 계속 갱신한다.
-
-## Shared Constraints
-
-- source key rule:
-- route baseline:
-- shared API/modeling note:
-
-## Screen Items
-
-### {screen code} {screen name}
-
-#### Screen Summary
-
-- source key:
-- route:
-- retained runtime tree:
-- local exactness suite id:
-- canonical runner command: `python3 sdd/99_toolchain/01_automation/run_playwright_exactness.py --suite <suite-id> --base-url <url>`
-
-#### Acceptance Criteria
-
-- [ ]
-- [ ] relevant builder/design guide baseline is current for this surface
-- [ ] Playwright exactness suite exists or is extended in the same task
-- [ ] verify artifact path (`json/png`) is identified before implementation closes
-
-#### Open TODO
-
-- [ ]
-
-#### Current Notes
-
-- current scope/status notes only
-- use Browser Use/manual capture only as supplemental diagnosis when a Playwright suite already exists
-
-#### Latest Verification
-
-- current build/verify references:
-- latest exactness command:
-- latest exactness artifact:
-
-## Delivery Phases
-
-- `P0`:
-- `P1`:
-- `P2`:
-
-## Current Notes
-
-- current service-level notes only

package/sdd/02_plan/03_architecture/README.md

@@ -1,23 +0,0 @@
-# Architecture Planning
-
-- 이 폴더는 `sdd/02_plan` 아래에서 에이전트의 현재 개발 계획을 관리한다.
-- 이 폴더는 구조, 리포지토리 거버넌스, 런타임 정렬, 툴체인 규칙 같은 횡단 계획을 durable 문서로 유지한다.
-- 날짜 기반 작업 메모는 남기지 않고, 현재 적용돼야 하는 규칙과 backlog만 덮어쓴다.
-
-## Plan Rule
-
-- 다른 `02_plan` 폴더와 동일하게 `README.md + durable 문서`만 유지하고, dated plan history는 두지 않는다.
-- `sdd/02_plan`은 현재 실행해야 할 기준만 남기고, 과거 계획 히스토리는 보관하지 않는다.
-- 개발계가 있는 대상은 `구현 -> build -> main push -> DEV(개발계) 배포 -> DEV 검수 -> 문서 갱신`을 기본 루틴으로 본다.
-- feature는 domain TODO 파일 안에서 기능코드 기준으로 관리한다.
-- screen은 service TODO 파일 안에서 화면코드 기준으로 관리한다.
-- architecture, IAC, test도 dated memo 대신 section README와 durable governance 문서에서 현재 규칙만 유지한다.
-- `02_plan` section 구조와 README 규칙은 final-only 기준으로 유지한다.
-
-## Current Documents
-
-- [architecture_document_governance.md](architecture_document_governance.md)
-- [repository_governance.md](repository_governance.md)
-- [runtime_and_structure_governance.md](runtime_and_structure_governance.md)
-- [toolchain_governance.md](toolchain_governance.md)
-- [templates-hexagonal-template-architecture.md](templates-hexagonal-template-architecture.md)

package/sdd/02_plan/03_architecture/architecture_document_governance.md

@@ -1,40 +0,0 @@
-# architecture document governance
-
-- Owner: Codex
-- Status: active
-
-## Scope
-
-- In scope:
-  - `sdd/01_planning/03_architecture` 문서 구조와 경계를 공통 규칙으로 정의한다.
-  - 아키텍처 planning 문서는 공통/일반화된 구조를 우선 기록하되, 필요 시 `frontend`, `backend`, `infra`, `tech-research`로 특화 문서를 둔다.
-  - 프런트엔드, 백엔드, 인프라의 구조/패턴/구현 선택을 architecture 범위로 유지한다.
-  - 데이터 모델링 경계는 `sdd/01_planning/04_data`로 분리한다.
-- Out of scope:
-  - feature별 business rule 상세
-  - screen별 route/CTA/전이 상세
-  - entity/schema/ERD 수준의 데이터 모델링 상세
-
-## Acceptance Criteria
-
-- [ ] `03_architecture`는 공통 아키텍처 문서와 특화 아키텍처 문서를 함께 수용하는 구조로 설명된다.
-- [ ] frontend/backend/infra가 architecture 범위에 포함된다는 점이 planning 문서에 명시된다.
-- [ ] data modeling은 `04_data` 경계로 분리된다는 점이 planning 문서에 명시된다.
-
-## Current Notes
-
-- architecture 문서는 우선 공통 구조를 설명하고, 세부 구현 논점이 필요할 때만 영역별 문서로 내려간다.
-- frontend architecture는 모듈화, 컴포넌트, store/state, domain/use case, UI/UX, storage, API adapter 패턴을 다룬다.
-- backend architecture는 DDD context 구조, context 내부 계층, 3-layer, hexagonal, monolith/MSA/EDA/CQRS 같은 패턴과 실제 구현체 선택을 다룬다.
-- infra architecture는 컨테이너, 오케스트레이션, 데이터베이스, 네트워크, 이중화, 멀티리전 같은 서비스 기반 구조를 다룬다.
-
-## Validation
-
-- current references:
-  - `sdd/01_planning/03_architecture/README.md`
-  - `sdd/01_planning/03_architecture/INDEX.md`
-  - `sdd/01_planning/03_architecture/architecture_document_structure.md`
-  - `sdd/01_planning/03_architecture/frontend/README.md`
-  - `sdd/01_planning/03_architecture/backend/README.md`
-  - `sdd/01_planning/03_architecture/infra/README.md`
-  - `sdd/01_planning/04_data/README.md`

package/sdd/02_plan/03_architecture/build_ast_runtime_tree_governance.md

@@ -1,53 +0,0 @@
-# build ast runtime tree governance
-
-- Owner: Codex
-- Status: active
-
-## Scope
-
-- In scope:
-  - `sdd/03_build` service summary를 실제 템플릿 runtime assembly 기준으로 재정렬한다.
-  - Claude/Codex/Ralph 하네스가 동일한 current-state build reading 규칙을 따르도록 canonical policy를 추가한다.
-  - `scripts/dev/audit_sdd_build_ast.py`를 템플릿 정본 gate로 유지한다.
-  - provider-first infra baseline과 build/runtime/toolchain 문서 간의 current-state drift를 줄인다.
-- Out of scope:
-  - 템플릿 앱/서버의 기능 요구사항 자체 변경
-  - 제품별 downstream branding이나 credential 값 추가
-
-## Assumptions
-
-- template repo의 `sdd/03_build`는 clone 이후 downstream repo가 그대로 이어받는 current-state 설명 문서다.
-- AST-style build 문서는 모든 관계를 하나의 트리에 과적재하지 않고, 주 runtime chain과 cross-cutting contract를 분리해 설명한다.
-- agentic harness는 repo-local path와 generic scaffold만 포함하고 실제 run 산출물은 commit 대상이 아니다.
-
-## Acceptance Criteria
-
-- [x] `scripts/dev/audit_sdd_build_ast.py`가 `ast_similarity=10`, `implementation_traceability=10`, `human_agent_readability=10`을 반환한다.
-- [x] `mobile`, `web`, `admin`, `landing` service summary가 실제 `main.tsx -> AuthProvider -> BrowserRouter -> App -> ProtectedRoute/shell -> route leaf` 체인을 반영한다.
-- [x] `README`, `AGENTS`, `CLAUDE`, toolchain policy가 `.agent`, role agent, skill alias, AST current-state 규칙을 같이 설명한다.
-- [x] template infra 문서는 provider-first baseline(`aws/data`, `aws/domain`, `openstack/server`)을 current canonical split으로 설명한다.
-
-## Execution Checklist
-
-- [x] 기존 템플릿의 agentic/toolchain/AST 누락 축을 정리한다.
-- [x] `.agent` Ralph scaffold와 Claude/Codex alias/role surface를 추가한다.
-- [x] AST audit script와 plan/build/verify current-state 문서를 추가한다.
-- [x] service build summary를 runtime tree 기준으로 재작성한다.
-- [x] infra current-state 문서를 provider-first baseline으로 갱신한다.
-- [x] root compose baseline을 provider-first runtime split까지 더 일반화할 추가 필요 여부를 follow-up으로 평가한다.
-
-## Work Log
-
-- 2026-03-19: `templates`가 starter scaffold로는 충분하지만 `passv`/`palcar`에서 검증된 agentic harness, AST build governance, provider-first infra split이 빠져 있어 canonical repo로 승격이 필요하다고 정리했다.
-- 2026-03-19: `.agent` Ralph scaffold, Claude role agent surface, Codex alias skill, OTRO validation helper 문서를 정본에 추가하기로 결정했다.
-- 2026-03-19: `sdd/03_build/01_feature/service/*.md`를 실제 템플릿 runtime composition 기준으로 다시 쓰고 AST gate로 검증하는 흐름을 고정했다.
-- 2026-03-19: infra current-state는 기존 `openstack/dev|prod` 설명에 더해 `aws/data`, `aws/domain`, `openstack/server` provider-first split을 canonical baseline으로 반영했다.
-- 2026-03-19: AST gate와 `terraform validate` 3종이 모두 통과해 canonical template upgrade의 구조적 baseline을 고정했다.
-
-## Validation
-
-- `python3 scripts/dev/audit_sdd_build_ast.py --write .agent/sdd-build-ast-audit.json`
-- `rg -n "Ralph|iteration|Current Build Note|2026-" sdd/03_build -g '*.md'`
-- `terraform -chdir=infra/terraform/aws/data init -backend=false && terraform -chdir=infra/terraform/aws/data validate`
-- `terraform -chdir=infra/terraform/aws/domain init -backend=false && terraform -chdir=infra/terraform/aws/domain validate`
-- `terraform -chdir=infra/terraform/openstack/server init -backend=false && terraform -chdir=infra/terraform/openstack/server validate`

package/sdd/02_plan/03_architecture/repository_governance.md

@@ -1,39 +0,0 @@
-# repository governance
-
-- Owner: Codex
-- Status: active
-
-## Scope
-
-- In scope:
-  - `main` canonical branch 운영
-  - repo path와 주요 문서 구조 정합성 유지
-  - SDD final-only 원칙 유지
-- Out of scope:
-  - 서비스별 feature/screen 상세 TODO
-
-## Acceptance Criteria
-
-- [x] `main`을 정본 브랜치로 유지한다.
-- [x] repo 경로와 주요 문서는 현재 `client/*`, `server/*`, `sdd/*` 구조를 기준으로 설명한다.
-- [x] plan/build/verify/operate는 dated history 없이 durable 문서만 유지한다.
-
-## Execution Checklist
-
-- [x] branch 운영 원칙을 현재 방식으로 고정한다.
-- [x] repo 주요 경로 기준을 `client/*`, `server/*`, `sdd/*` 구조로 고정한다.
-- [x] SDD final-only 원칙을 반영한다.
-
-## Current Notes
-
-- `main`을 canonical branch로 유지하는 규칙을 사용한다.
-- 템플릿 frontend 경로는 `client/web`, `client/admin`, `client/mobile`, `client/landing` 기준이다.
-- SDD는 최종 일관성 문서만 유지하고, raw 운영 로그는 runtime logging system에 남긴다.
-- data modeling 계획 루트는 `sdd/01_planning/04_data`와 `sdd/02_plan/04_data`를 기준으로 유지한다.
-
-## Validation
-
-- current references:
-  - `AGENTS.md`
-  - `sdd/03_build/03_architecture/repository_governance.md`
-  - `sdd/03_verify/03_architecture/repository_governance.md`

package/sdd/02_plan/03_architecture/runtime_and_structure_governance.md

@@ -1,38 +0,0 @@
-# runtime and structure governance
-
-- Owner: Codex
-- Status: active
-
-## Scope
-
-- In scope:
-  - template repo의 `server/*`, `client/*`, `infra/*` current 구조 기준 유지
-  - screen PDF, toolchain, runtime entrypoint 같은 현재 구조 설명
-- Out of scope:
-  - 서비스별 구현 상세
-
-## Acceptance Criteria
-
-- [x] repo structure 설명은 현재 폴더 구조를 기준으로 유지한다.
-- [x] runtime path와 screen planning path는 현재 canonical 위치만 가리킨다.
-- [x] dated refactor memo 없이 current structure만 남긴다.
-
-## Execution Checklist
-
-- [x] repo structure 기준 경로를 다시 점검한다.
-- [x] stale path reference를 current path로 교체한다.
-- [x] runtime/structure 설명을 durable 문서로 유지한다.
-
-## Current Notes
-
-- backend는 `server/contexts/*`, frontend는 `client/*`, 인프라는 `infra/*` current structure를 기준으로 설명한다.
-- screen planning은 `sdd/01_planning/02_screen/*.pdf`를 canonical source로 유지한다.
-- architecture planning은 root common docs + `frontend/`, `backend/`, `infra/`, `tech-research/` split을 기준으로 유지한다.
-- 저장소 구조 정렬 결과는 현재 디렉터리 기준만 남긴다.
-
-## Validation
-
-- current references:
-  - `sdd/01_planning/README.md`
-  - `sdd/03_build/03_architecture/repository_governance.md`
-  - `sdd/03_verify/03_architecture/repository_governance.md`

package/sdd/02_plan/03_architecture/templates-hexagonal-template-architecture.md

@@ -1,9 +0,0 @@
-# Templates Hexagonal Template Architecture
-
-현재 템플릿 레포의 기본 아키텍처 원칙:
-
-- 프론트는 `React + Tailwind + CSS token surface`
-- 백엔드는 `hexagonal + DDD`
-- 컨텍스트 외부 진입점은 `contracts`
-- adapter는 교환 가능해야 하며 application/domain은 저장소 세부사항을 직접 알지 않는다
-- 데이터 모델링 상세는 architecture가 아니라 `04_data`에서 다룬다

package/sdd/02_plan/03_architecture/toolchain_governance.md

@@ -1,98 +0,0 @@
-# toolchain governance
-
-- Owner: Codex
-- Status: active
-
-## Scope
-
-- In scope:
-  - `sdd/99_toolchain` 아래 자동화 도구와 policy 문서의 current rule 유지
-  - Playwright exactness runner/manifest를 local screen regression의 canonical gate로 유지
-  - skill/tooling path와 proof artifact path 정렬
-  - local Claude/Codex `sdd` skill의 canonical path와 실제 저장소 구조 정렬
-  - `sdd` skill의 rollout gate를 explicit deployment scope 기준으로 제한
-  - 존재하지 않는 template builder file을 required canonical path처럼 안내하지 않도록 정리
-  - 프로젝트 루트에서 `sdd` skill을 설명하는 단일 entrypoint 문서 유지
-  - 루트 `SDD_SKILL.md`가 workflow, `sdd/` 구조, flow별 설명까지 포함하도록 확장
-  - 루트 `SDD_SKILL.md`가 toolchain, visual fidelity, exactness, functional alignment 구조까지 설명하도록 확장
-  - 루트 `SDD_SKILL.md`가 `sdd` 스킬의 trigger, non-use case, governance, section map, schema parity, regression, rollout, completion gate까지 포함하도록 확장
-  - ignored 상태였던 durable local scaffold/config를 template-tracked asset으로 승격
-- Out of scope:
-  - 개별 서비스 구현
-
-## Acceptance Criteria
-
-- [x] skill/tooling 관련 경로가 current SDD 구조를 가리킨다.
-- [x] proof artifact 예시도 final-only verify structure를 따른다.
-- [x] toolchain 설명은 현재 workflow rule만 남긴다.
-- [x] 화면명세 기반 정적 자산은 canonical `스펙에셋빌더` 선행 추출 rule을 current workflow로 유지한다.
-- [x] 회귀 검수 범위 선택 rule이 policy, toolchain, skill, SDD test 문서에 공통 반영된다.
-- [x] `.claude/skills/sdd-dev/SKILL.md`의 Codex canonical path가 실제 `.codex/skills/sdd/` 구조를 가리킨다.
-- [x] `sdd` skill은 rollout이 explicit scope일 때만 DEV/PROD/rollback gate를 completion bar로 해석한다.
-- [x] 디자인 가이드 builder 안내는 현재 저장소에 실제로 존재하는 automation inventory 기준으로만 적는다.
-- [x] 프로젝트 루트에서 `sdd` skill 용도와 canonical path를 빠르게 확인할 수 있는 단일 markdown entrypoint가 있다.
-- [x] `SDD_SKILL.md`는 요약 수준을 넘어서 workflow, folder structure, flow별 역할을 명확하게 설명한다.
-- [x] `SDD_SKILL.md`는 toolchain 역할과 visual fidelity / exactness / 기능 정합성 구조를 명확하게 설명한다.
-- [x] `SDD_SKILL.md`는 `sdd` 스킬의 거의 전체 해설서 수준으로 trigger, artifact rule, rollout gate, completion gate까지 설명한다.
-- [x] durable local scaffold/config 파일은 tracked asset으로 승격되고, generated/cache artifact는 계속 ignore된다.
-- [x] Playwright screen exactness는 ad-hoc CLI가 아니라 `sdd/99_toolchain/01_automation/` wrapper/manifest 기준으로 실행한다.
-
-## Execution Checklist
-
-- [x] stale verify/build path를 current path로 교체한다.
-- [x] toolchain README와 design note를 current governance와 정렬한다.
-- [x] reusable template path를 final-only 구조에 맞춘다.
-- [x] screen-spec static asset extraction rule을 skill과 toolchain 문서에 공통 반영한다.
-- [x] regression verification rule을 policy, skill, toolchain, test planning에 공통 반영한다.
-- [x] Claude `sdd-dev` alias가 stale `.codex/skills/sdd-dev/` 경로를 참조하지 않도록 정리한다.
-- [x] Codex/Claude `sdd` skill에서 rollout gate를 explicit deployment scope 조건으로 정리한다.
-- [x] 존재하지 않는 `screen_design_guide_builder.py`를 template canonical file처럼 적지 않도록 수정한다.
-- [x] 루트에 `sdd` skill 요약 문서를 추가하고 canonical source를 명시한다.
-- [x] 루트 `SDD_SKILL.md`에 workflow 단계, section 역할, flow별 상세 설명을 보강한다.
-- [x] 루트 `SDD_SKILL.md`에 toolchain, parity/proof, exactness, functional alignment 설명을 추가한다.
-- [x] 루트 `SDD_SKILL.md`에 trigger rule, non-use case, governance, section routing, schema parity, regression, completion gate 설명을 추가한다.
-- [x] `.claude/settings.local.json`, `.agent/sdd-build-ast-audit.json`, `.agent/runs/README.md`를 tracked asset으로 승격한다.
-- [x] `node_modules`, `dist`, `.venv`, `.terraform`, cache 계열은 generated/local artifact로 계속 제외한다.
-- [x] Playwright exactness suite registry와 runner를 toolchain canonical entrypoint로 편입한다.
-- [x] screen template가 suite id와 canonical runner command를 기본 항목으로 가진다.
-
-## Current Notes
-
-- toolchain은 `sdd/99_toolchain/01_automation`, `02_policies`, `03_templates` current split을 따른다.
-- Playwright local exactness는 `run_playwright_exactness.py`와 `playwright_exactness_manifest.py`를 canonical entrypoint로 사용한다.
-- screen 작업은 가능하면 `npx playwright test ...`를 직접 쓰지 않고 toolchain runner를 통해 suite id 기준으로 실행한다.
-- proof artifact는 `sdd/03_verify/10_test/ui_parity/` current path를 기준으로 관리한다.
-- toolchain 정책 문서의 정본은 `sdd/99_toolchain/02_policies`에 둔다.
-- skill/tooling 사용 여부는 개별 dated memo가 아니라 현재 workflow rule로만 유지한다.
-- 화면명세서의 icon/image/logo 등 재사용 가능한 정적 자산은 `spec_asset_builder.py` 또는 wrapper를 먼저 사용해 추출하고, 수동 재작성은 builder가 표현하지 못하는 경우에만 예외로 허용한다.
-- reusable asset planning root는 `sdd/01_planning/02_screen/assets/`이고, local Codex/Claude `sdd` skill도 같은 경로 기준으로 유지한다.
-- 회귀 검수는 direct target-only 확인으로 끝내지 않고, `sdd/02_plan/10_test/regression_verification.md` 기준으로 selected surface를 retained current-state로 남긴다.
-- Claude `sdd-dev` canonical asset reference는 현재 저장소의 `.codex/skills/sdd/` path를 기준으로 맞춘다.
-- rollout, DEV/PROD gate, rollback rule은 사용자가 배포를 요청했거나 저장소의 current policy/plan이 rollout을 completion bar로 올린 경우에만 강제한다.
-- 디자인 가이드 builder reference는 실제 존재하는 automation inventory를 기준으로 적고, 없는 file path를 canonical prerequisite처럼 고정하지 않는다.
-- 루트 `SDD_SKILL.md`는 단순 요약이 아니라 입문용 설명 문서로 유지하되, canonical rule은 local skill 원문과 toolchain policy에 둔다.
-- 루트 `SDD_SKILL.md`는 builder/harness/policy가 visual fidelity, exactness, 기능 정합성을 어떻게 연결하는지까지 설명한다.
-- 루트 `SDD_SKILL.md`는 skill 원문을 읽기 전에 전체 mental model을 잡는 해설서 역할을 하도록 유지한다.
-- `.claude/settings.local.json`은 local permission preset이지만 현재 템플릿이 재사용하는 scaffold로 승격한다.
-- `.agent/sdd-build-ast-audit.json`과 `.agent/runs/README.md`는 Ralph/AST scaffold의 durable template asset으로 승격한다.
-- generated output인 `dist`, `node_modules`, `.venv`, `.terraform`, cache, runtime run output은 계속 template commit 대상에서 제외한다.
-
-## Validation
-
-- current references:
-  - `AGENTS.md`
-  - `.codex/skills/sdd/SKILL.md`
-  - `.claude/skills/sdd/SKILL.md`
-  - `.claude/skills/sdd-dev/SKILL.md`
-  - `.claude/settings.local.json`
-  - `.agent/sdd-build-ast-audit.json`
-  - `.agent/runs/README.md`
-  - `SDD_SKILL.md`
-  - `sdd/01_planning/02_screen/assets/README.md`
-  - `sdd/99_toolchain/01_automation/README.md`
-  - `sdd/99_toolchain/01_automation/playwright_exactness_manifest.py`
-  - `sdd/99_toolchain/01_automation/run_playwright_exactness.py`
-  - `sdd/02_plan/10_test/verification_strategy.md`
-  - `sdd/03_verify/10_test/verification_harness.md`
-  - `sdd/99_toolchain/02_policies/regression-verification-policy.md`
-  - `sdd/02_plan/10_test/regression_verification.md`

package/sdd/02_plan/04_data/README.md

@@ -1,5 +0,0 @@
-# Data Planning
-
-- 이 폴더는 `sdd/02_plan` 아래에서 에이전트의 현재 개발 계획을 관리한다.
-- 데이터 모델, 관계, 키 정책 정렬 계획을 현재형 durable 문서로 유지한다.
-- dated data planning memo를 쌓지 않는다.

package/sdd/02_plan/05_api/README.md

@@ -1,5 +0,0 @@
-# API Planning
-
-- 이 폴더는 `sdd/02_plan` 아래에서 에이전트의 현재 개발 계획을 관리한다.
-- API contract, request/response, transport rule 정렬 계획을 현재형 durable 문서로 유지한다.
-- dated API planning memo를 쌓지 않는다.

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

@@ -1,11 +0,0 @@
-# IaC Planning
-
-- 이 폴더는 `sdd/02_plan` 아래에서 에이전트의 현재 개발 계획을 관리한다.
-- 이 폴더는 배포, 런타임, 데이터베이스 운영 계획을 durable 문서로 유지한다.
-- dated deploy plan은 남기지 않고, 현재 유효한 delivery/runtime 계획만 갱신한다.
-
-## Common Rule
-
-- 다른 `02_plan` 폴더와 동일하게 `README.md + durable 문서`만 유지한다.
-- 실제 계획은 대상 문서를 직접 갱신하는 방식으로 관리하고, 날짜 기반 임시 plan 파일은 두지 않는다.
-- 개발계가 있는 대상은 `build -> main push -> DEV(개발계) 배포 -> DEV(개발계) 검수`를 delivery 기본 루틴으로 포함한다.