agentic-dev 0.2.11 → 0.2.13

package/sdd/99_toolchain/02_policies/convention-storage-policy.md

@@ -1,26 +0,0 @@
-# Convention Storage Policy
-
-## Purpose
-
-저장소 전반에서 반복 참조되는 컨벤션, 워크플로우, 실행 규약의 정본 위치를 고정한다.
-
-## Rules
-
-- 공통 컨벤션의 정본은 항상 `sdd/99_toolchain/02_policies`에 저장한다.
-- `AGENTS.md`에는 실행 시 반드시 기억해야 할 짧은 핵심 규칙만 둔다.
-- `sdd/`는 history 저장소가 아니라 overwrite-only current-state delivery system으로 유지한다.
-- `sdd/02_plan`의 active planning은 `01_feature`, `02_screen`, `03_architecture`, `06_iac`, `10_test` 기준 durable 문서를 직접 갱신한다.
-- feature 계획은 `<domain>_todos.md`, screen 계획은 `<service>_todos.md` 파일을 single source of truth로 사용한다.
-- 컨벤션 관련 변경은 다음 순서를 따른다.
-  1. `sdd/99_toolchain/02_policies` 문서를 먼저 수정한다.
-  2. 필요한 경우에만 `AGENTS.md`, 런북, 템플릿, 자동화 문서를 최소 범위로 동기화한다.
-- 저장소 루트 하네스(`.codex`, `.claude`)는 toolchain 정책을 구현하는 자산으로 취급한다.
-- 하네스 사용법, 자동화 진입점, 템플릿화 가능한 예시는 `sdd/99_toolchain/01_automation`에 정리한다.
-- Playwright suite registry와 canonical runner도 `sdd/99_toolchain/01_automation`이 소유한다.
-
-## Canonical References
-
-- 워크플로우/배포 규칙: `main-push-before-dev-deploy-policy.md`
-- compose/runtime 기준선: `compose-runtime-baseline-policy.md`
-- 회귀 검수 규칙: `regression-verification-policy.md`
-- 하네스 설명: `../01_automation/harness-layout.md`

package/sdd/99_toolchain/02_policies/main-push-before-dev-deploy-policy.md

@@ -1,27 +0,0 @@
-# Main Push Before DEV Deploy Policy
-
-## Purpose
-
-템플릿 저장소에서도 `branch -> main -> DEV` 반영 순서를 고정하고, 완료된 branch를 retire해 재현 가능성과 추적 가능성을 확보한다.
-
-## Required Order
-
-1. 관련 작업에 맞는 work branch를 생성한다.
-2. 관련 변경을 구현하고 work branch를 origin에 push한다.
-3. root compose baseline 또는 해당 검증 surface build를 확인한다.
-4. 관련 변경을 `main`에 반영한다.
-5. Git 원격 `main` push를 완료한다.
-6. 그 커밋 기준으로 `DEV(개발계)` 배포를 수행한다.
-7. 배포된 DEV 환경에서 실제 동작을 검증한다.
-8. 필요한 SDD 문서를 현재 상태 기준으로 갱신한다.
-9. 완료된 local/remote work branch를 삭제한다.
-
-## Rules
-
-- `DEV` 반영이 필요한 작업은 task-fit work branch를 먼저 만들고 branch push를 남긴다.
-- `DEV` 반영이 필요한 작업은 `main` push 이전에 선배포하지 않는다.
-- 수동 배포 단계여도 `branch push -> build -> main merge/push -> DEV 배포 -> DEV 검증 -> 문서 갱신` 순서를 유지한다.
-- 작업 완료 전 최소 정합성 체크로 `관련 검증 명령`, `worktree clean 상태`, `최종 변경의 main 포함 여부`를 확인한다.
-- 완료된 작업은 `main` 반영 후 local branch와 remote branch를 모두 삭제한다. 사용자가 branch 보존을 명시한 경우만 예외다.
-- 검증 중 문제가 발견되면 다시 `수정(branch) -> branch push -> build -> main merge/push -> DEV 재배포 -> DEV 재검증`을 반복한다.
-- 템플릿 샘플 앱/서버도 실제로 부팅되고 검증 가능한 상태를 유지한다.

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

@@ -1,22 +0,0 @@
-# Regression Verification Policy
-
-## Purpose
-
-템플릿 저장소에서도 회귀 검수 범위를 direct target에 한정하지 않고, retained current-state workflow로 고정한다.
-
-## Rules
-
-- `sdd` 작업은 direct target verification만으로 완료 처리하지 않는다.
-- 회귀 검수 범위는 `sdd/02_plan/10_test/regression_verification.md`를 기준으로 direct, upstream, downstream, shared surface까지 선택한다.
-- shared route, shell, auth/session, component, contract, generated asset, builder output을 변경한 경우 adjacent consumer와 shared surface를 함께 검수한다.
-- 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/03_verify`에 current-state로 유지한다.
-
-## Canonical References
-
-- `AGENTS.md`
-- `.codex/skills/sdd/SKILL.md`
-- `sdd/99_toolchain/01_automation/README.md`
-- `sdd/02_plan/10_test/regression_verification.md`

package/sdd/99_toolchain/03_templates/.gitkeep

@@ -1 +0,0 @@
-

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

@@ -1,38 +0,0 @@
-from __future__ import annotations
-
-from pathlib import Path
-
-
-ROOT = Path(__file__).resolve().parents[3]
-SCREEN_SPEC = ROOT / "sdd/01_planning/02_screen/mobile_screen_spec.pdf"
-OUTPUT_DIR = ROOT / "sdd/99_toolchain/03_templates/generated_assets"
-
-# Template example output lives under `03_templates/generated_assets`.
-# Replace this path with the consuming project's runtime asset directory.
-
-
-ASSET_RECIPES = [
-    {
-        "id": "example-brand-lockup-source",
-        "source": {"kind": "pdf_page", "path": SCREEN_SPEC, "page": 2, "dpi": 150},
-        "crop_box": (294, 750, 738, 1151),
-        "transparent_white_threshold": 245,
-        "trim": True,
-        "children": [
-            {
-                "id": "example-brand-lockup",
-                "output": OUTPUT_DIR / "example-brand-lockup.svg",
-            },
-            {
-                "id": "example-brand-mark",
-                "crop_box": (123, 0, 288, 180),
-                "output": OUTPUT_DIR / "example-brand-mark.svg",
-            },
-            {
-                "id": "example-brand-wordmark",
-                "crop_box": (50, 324, 363, 381),
-                "output": OUTPUT_DIR / "example-brand-wordmark.svg",
-            },
-        ],
-    }
-]

package/sdd/99_toolchain/03_templates/generated_assets/README.md

@@ -1,11 +0,0 @@
-# Example Generated Assets
-
-## Role
-
-- 이 폴더는 `스펙에셋빌더` example manifest 실행 결과를 저장한다.
-- template consumer는 이 산출물을 golden sample로 보고 자신의 project-specific output 경로로 치환하면 된다.
-
-## Regeneration
-
-- `python3 sdd/99_toolchain/01_automation/spec_asset_builder.py --manifest sdd/99_toolchain/03_templates/asset_recipe_manifest.example.py --verify-exact`
-- 또는 `python3 sdd/99_toolchain/01_automation/build_asset_recipes.py --verify-exact`

package/sdd/99_toolchain/03_templates/generated_assets/example-brand-lockup.svg

@@ -1,3 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="444" height="273" viewBox="0 0 444 273" fill="none" role="img" aria-hidden="true">
-  <image width="444" height="273" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbwAAAERCAYAAAAAMhLvAAAEe0lEQVR4nO3dQUrDUBRA0Uaz/3VWpDpIUSftd2AXIEJMm3sOZNDBI2+QcElo6bS8HccBAHbuaesFAOA/CB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQMJ8nZ633gEAVjeNMbbeAQBW55UmAAmCB0CC4AGQIHgAJAgeAAmCB0CC4AGQIHgAJAgeAAmCB0CC4AGQIHgAJAgeAAmCB0CC4AGQMB9fXv0hHgC7N59O71vvAACrm5bzlyc8AHZvvlwuW+8AAKubxvCAB8D+zcv5c/x8WXPcjul2/PbzI81e/3Aes/c/+0jXoNn7vY7M7v1+nZbzxzgAwM75HR4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACYIHQILgAZAgeAAkCB4ACd/iAv4AZg+FSAAAAABJRU5ErkJggg==" />
-</svg>

package/sdd/99_toolchain/03_templates/generated_assets/example-brand-mark.svg

@@ -1,3 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="165" height="180" viewBox="0 0 165 180" fill="none" role="img" aria-hidden="true">
-  <image width="165" height="180" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAKUAAAC0CAYAAAD1oezkAAACRElEQVR4nO3bsU6EQBRAUVj5/+9cY1YLiG7DjoU2mGhhwy3OSSgImfCKmyEhMK+v1zFByOXsAeAnUZIjSnJESY4oyRElOaIkR5TkiJIcUZIjSnJESY4oyRElOaIkR5TkiJIcUZIjSnJESY4oyRElOaIkR5TkiJIcUZIjSnJESY4oyRElOaIkR5TkiJIcUZIjSnJESY4oyRElOaIkR5TkiJIcUZIjSnJESY4oyRElOaIkR5TkiJIcUZIjSnJESY4oyRElOaIkR5TkiJIcUZIjSnJESY4oyRElOaIkR5TkiJIcUZIjSnKWx/x09gxwMI8xzp4BDjy+yRElOaIkR5TkiJIcUZIjSnJESY4oyRElOaIkR5TkiJIcUZIjSnKW6/OLDypJWW63t7NngIN53e52SlKWfd/PngEO/KNDzrJuH2Oa5unrGN/Hb+ePP67V1l7+cR9rC2vndXu3VZLiPSU5oiRHlOSIkhxRkiNKckRJjijJESU5oiRHlOSIkhxRkiNKckRJjijJESU5oiRHlOSIkhxRkiNKckRJjijJESU5oiRHlOSIkhxRkiNKckRJjijJESU5oiRHlOSIkhxRkiNKckRJjijJESU5oiRHlOSIkhxRkiNKckRJjijJESU5oiRHlOSIkhxRkiNKckRJjijJESU5oiRHlOSIkhxRkiNKckRJjijJESU5oiRHlOSIkhxRkiNKckRJjijJESU5oiRHlOSIkhxRkiNKckRJjijJESU5oiRHlOSIkhxRkiNKckRJjijJ+QQO+HVFgvyROwAAAABJRU5ErkJggg==" />
-</svg>

package/sdd/99_toolchain/03_templates/generated_assets/example-brand-wordmark.svg

@@ -1,3 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="313" height="57" viewBox="0 0 313 57" fill="none" role="img" aria-hidden="true">
-  <image width="313" height="57" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAATkAAAA5CAYAAABNllxFAAAAXElEQVR4nO3BAQ0AAADCoPdPbQ8HFAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwKEBFwwAAbnbqkcAAAAASUVORK5CYII=" />
-</svg>

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

@@ -1,21 +0,0 @@
-from __future__ import annotations
-
-
-PLAYWRIGHT_SUITES = [
-    {
-        "id": "service-screen-batch",
-        "spec": "service-screen-batch.spec.js",
-        "kind": "screen-exactness",
-        "service": "mobile",
-        "targets": ["SERVICE-S001", "SERVICE-S002"],
-        "description": "example screen exactness batch",
-    },
-    {
-        "id": "shared-shell-regression",
-        "spec": "shared-shell-regression.spec.js",
-        "kind": "shared-ui-regression",
-        "service": "web",
-        "targets": ["shared-shell"],
-        "description": "example shared shell regression batch",
-    },
-]

package/sdd/99_toolchain/README.md

@@ -1,23 +0,0 @@
-# Toolchain
-
-`99_toolchain`은 SDD 산출물을 만들고 검증하는 generator, harness, 정책 문서를 둔다.
-
-## Structure
-
-- `01_automation`
-  - SDD generator, parity harness, projection 문서, capture automation, agentic repo contract
-- `02_policies`
-  - 저장소 공통 규칙의 정본
-- `03_templates`
-  - 재사용 가능한 템플릿 자산
-
-## Rule
-
-- planning 산출물은 `01_planning`에 둔다.
-- 그 planning 산출물을 생성하거나 검증하는 스크립트와 asset은 `99_toolchain`에 둔다.
-- screen spec generator, capture policy, manifest는 `01_automation`에 둔다.
-- 정책 문서는 `02_policies`를 정본으로 사용하고, `AGENTS.md`에는 핵심 실행 규칙만 요약한다.
-- 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`와 `03_verify` summary로 관리한다.

package/sdd/README.md

@@ -1,21 +0,0 @@
-# SDD Governance
-
-## Purpose
-
-- `sdd/`는 템플릿 레포의 canonical delivery system이다.
-- 모든 SDD 산출물은 현재 기준의 최종 일관성만 설명한다.
-
-## Final-Only Rule
-
-- `sdd/` 안에는 날짜별 히스토리, archive, release log, gate log 같은 누적 기록을 두지 않는다.
-- 같은 대상의 후속 작업은 새 문서를 만들지 않고 기존 durable 문서를 덮어써 갱신한다.
-- raw runtime log, backend log, infrastructure log는 SDD가 아니라 해당 운영 시스템의 역할이다.
-
-## Section Map
-
-- `01_planning/`: 현재 canonical spec과 source reference
-- `02_plan/`: 에이전트의 current executable plan
-- `03_build/`: 현재 구현 요약
-- `03_verify/`: 현재 retained verification summary
-- `05_operate/`: 현재 delivery status와 runbook
-- `99_toolchain/`: SDD를 유지하는 생성기, 자동화, 정책 문서