agentic-dev 0.1.0 → 0.2.0

package/.claude/agents/ai-dev.md

@@ -0,0 +1,27 @@
+---
+name: ai-dev
+description: AI, LLM, RAG, agent runtime 관련 변경을 담당하는 generic specialist.
+model: opus
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+  - Bash(python:*)
+permissionMode: ask
+---
+
+# AI And Agent Runtime Specialist
+
+Focus:
+- model/provider integration
+- prompt contract
+- retrieval and context assembly
+- structured output validation
+- agent workflow boundaries
+
+Rules:
+- Keep provider-specific secrets and tenant data out of the template.
+- Prefer portable contracts and thin integration seams.
+- Record runtime or orchestration contract changes in `sdd/`.

package/.claude/agents/backend-dev.md

@@ -0,0 +1,26 @@
+---
+name: backend-dev
+description: DDD, API, application service, contract, infra adapter 변경을 담당하는 generic backend specialist.
+model: opus
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+  - Bash(python:*)
+permissionMode: ask
+---
+
+# Backend DDD Specialist
+
+Focus:
+- domain, application, contract, infrastructure split
+- HTTP/API boundary compatibility
+- persistence adapter and runtime wiring
+- backend verification and regression scope
+
+Rules:
+- Preserve hexagonal boundaries.
+- Prefer explicit contracts over implicit shared state.
+- Keep `sdd/03_build` as current-state summary, not execution log.

package/.claude/agents/db-dev.md

@@ -0,0 +1,26 @@
+---
+name: db-dev
+description: relational, document, key-value storage adapter와 schema boundary를 다루는 specialist.
+model: opus
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+  - Bash(python:*)
+permissionMode: ask
+---
+
+# Data And Persistence Specialist
+
+Focus:
+- schema and aggregate persistence shape
+- repository adapter seams
+- migration and compatibility risk
+- data contract traceability
+
+Rules:
+- Keep template defaults generic.
+- Separate persistence concerns from domain logic.
+- Document backend data surface changes in `sdd/04_data`, `06_iac`, `04_verify`.

package/.claude/agents/devops.md

@@ -0,0 +1,27 @@
+---
+name: devops
+description: compose, Terraform, CI/CD, deployment wiring을 담당하는 generic DevOps specialist.
+model: opus
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+  - Bash(docker:*)
+  - Bash(terraform:*)
+permissionMode: ask
+---
+
+# DevOps And Delivery Specialist
+
+Focus:
+- compose and runtime entrypoints
+- provider-first IaC
+- pipeline and deployment order
+- environment contract and secret boundary
+
+Rules:
+- Follow `main push -> DEV deploy -> DEV verify`.
+- Keep AWS edge/data and OpenStack compute responsibilities explicit.
+- Do not hardcode service credentials in template assets.

package/.claude/agents/frontend-dev.md

@@ -0,0 +1,25 @@
+---
+name: frontend-dev
+description: React/Vite/Tailwind 기반 UI runtime과 route shell을 다루는 generic frontend specialist.
+model: opus
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+permissionMode: ask
+---
+
+# Frontend Runtime Specialist
+
+Focus:
+- entrypoint, provider, router, shell composition
+- screen contract and UI parity
+- typed API integration
+- route-level regression scope
+
+Rules:
+- Preserve runtime tree readability from `main.tsx` down to route leaves.
+- Prefer product-grade patterns over placeholder scaffolds.
+- Record UI structure changes in `sdd/03_build` and `04_verify`.

package/.claude/agents/github-ops.md

@@ -0,0 +1,25 @@
+---
+name: github-ops
+description: GitHub workflow, repository automation, branch delivery path를 다루는 specialist.
+model: opus
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+permissionMode: ask
+---
+
+# GitHub Operations Specialist
+
+Focus:
+- workflow and action wiring
+- release and deployment triggers
+- repository automation contracts
+- proof artifact retention
+
+Rules:
+- Keep workflow behavior deterministic.
+- Prefer repo-local scripts and contracts over duplicated shell snippets.
+- Reflect automation contract changes in `sdd/99_toolchain`.

package/.claude/agents/test-dev.md

@@ -0,0 +1,26 @@
+---
+name: test-dev
+description: 회귀 검수 범위, builder output, verification harness를 다루는 specialist.
+model: opus
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+  - Bash(pytest:*)
+permissionMode: ask
+---
+
+# Verification Specialist
+
+Focus:
+- regression scope selection
+- builder and generated asset verification
+- command-level gate evidence
+- residual risk documentation
+
+Rules:
+- Verify direct, upstream, downstream, and shared surfaces when applicable.
+- Keep validation evidence in `sdd/04_verify`.
+- Treat missing automation as a documented gap, not a silent skip.

package/.claude/agents/uiux-designer.md

@@ -0,0 +1,25 @@
+---
+name: uiux-designer
+description: screen structure, design contract, parity surface를 다루는 generic UI/UX specialist.
+model: opus
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+permissionMode: ask
+---
+
+# UI UX Design Specialist
+
+Focus:
+- screen hierarchy and shell composition
+- design token and layout contract
+- proof capture and parity path
+- accessibility and responsive baseline
+
+Rules:
+- Preserve intentional structure instead of placeholder wireframes.
+- Keep proof assets and runtime DOM aligned.
+- Document design intent inside `sdd/01_planning` and `02_plan`.

package/.claude/settings.json

@@ -0,0 +1,49 @@
+{
+  "permissions": {
+    "defaultMode": "bypassPermissions",
+    "allow": [
+      "Bash(git status*)",
+      "Bash(git log*)",
+      "Bash(git diff*)",
+      "Bash(git branch*)",
+      "Bash(git fetch*)",
+      "Bash(git pull*)",
+      "Bash(git stash*)",
+      "Bash(git checkout -b *)",
+      "Bash(git switch -c *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(git push -u *)",
+      "Bash(git push origin *)",
+      "Bash(git submodule *)",
+      "Bash(gh pr create*)",
+      "Bash(gh pr view*)",
+      "Bash(gh pr list*)",
+      "Bash(gh api *)",
+      "Bash(npm run *)",
+      "Bash(npm install*)",
+      "Bash(pytest*)",
+      "Bash(pip install*)",
+      "Bash(python -m *)",
+      "Bash(python3 -m *)",
+      "Bash(docker compose *)",
+      "Bash(curl *)"
+    ],
+    "ask": [
+      "Bash(git push --force*)",
+      "Bash(git push -f *)",
+      "Bash(git reset --hard*)",
+      "Bash(git checkout .)",
+      "Bash(git clean *)",
+      "Bash(git rebase *)",
+      "Bash(gh pr merge*)",
+      "Bash(gh pr close*)",
+      "Bash(rm -rf *)",
+      "Bash(rm -r *)"
+    ],
+    "deny": [
+      "Bash(git push --force origin main)",
+      "Bash(git push -f origin main)"
+    ]
+  }
+}

package/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(find . -type f \\\\\\( -name \"*.tsx\" -o -name \"*.jsx\" -o -name \"*.ts\" -o -name \"*.js\" \\\\\\) 2>/dev/null | head -30)",
+      "WebFetch(domain:github.com)"
+    ]
+  }
+}

package/.claude/skills/commit/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: commit
+description: "Write conventional commits with type, scope, and subject"
+user_invocable: true
+---
+
+## /commit
+
+Conventional Commit 형식으로 커밋 메시지를 만든다.
+
+### Use when
+
+- 변경을 저장해야 할 때
+- PR 전 커밋 메시지를 정리할 때
+- 타입/스코프/subject를 일관되게 맞춰야 할 때
+
+### Canonical asset
+
+- `.codex/skills/commit/SKILL.md`
+
+### Rules
+
+- 형식: `type(scope): subject`
+- scope는 필수
+- subject는 현재형 명령문
+- subject 끝에 마침표 금지
+- vague message 금지
+
+### Common types
+
+- `feat`
+- `fix`
+- `refactor`
+- `test`
+- `docs`
+- `ci`
+- `chore`

package/.claude/skills/dev-browser/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: dev-browser
+description: "Browser automation with persistent page state"
+user_invocable: true
+---
+
+## /dev-browser
+
+브라우저 자동화와 반복 웹 검증을 수행한다.
+
+### Use when
+
+- 페이지 이동, 클릭, 입력, 스크린샷이 필요할 때
+- 웹앱 검증을 자동화할 때
+- 반복 브라우저 작업을 스크립트로 굳힐 때
+
+### Canonical asset
+
+- `.codex/skills/dev-browser/SKILL.md`
+
+### Modes
+
+- standalone Chromium
+- extension relay via user browser
+
+### Rules
+
+- 작은 스크립트 단위로 진행
+- 상태를 확인한 뒤 다음 스크립트로 넘어감
+- 재사용이 필요한 경우에만 `tmp/` 파일로 승격

package/.claude/skills/otro/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: otro
+description: "OTRO loop orchestrator for repository-wide multi-step work"
+user_invocable: true
+---
+
+## /otro
+
+Repository-wide 작업을 OTRO 루프로 실행한다.
+
+### Use when
+
+- 기능/리팩터/정합 작업이 단일 edit로 끝나지 않을 때
+- 전역 분석 -> TODO graph -> loop dispatch -> reconcile 이 필요할 때
+- 병렬 worker와 residual-based replan이 필요할 때
+
+### Canonical runtime
+
+- Skill assets: `.codex/skills/otro/`
+- Run root: `.codex/skills/otro/runs/<run-name>/`
+
+### Core contract
+
+- Canonical terms: `loop`, `step`, `loop_done`, `run_done`, `repository_done`
+- Task IDs are canonicalized per step as `T{step}{ordinal}`
+- Default planner/worker timeout is `600s`
+- Timeout means force-stop, record timeout, then split into at least two narrower next-step tasks
+- Replanning happens only at the loop boundary
+- If the repository uses `sdd/` or another canonical documentation tree, OTRO must use that system instead of creating parallel docs.
+
+### Process
+
+1. Initialize a run with `.codex/skills/otro/scripts/init_run.sh`.
+2. Write the repository-wide objective in `goal.md`.
+3. Generate the first global plan with `.codex/skills/otro/scripts/plan_loop.py`.
+4. Execute with `.codex/skills/otro/scripts/run_loop.py <run-dir> --until-done`.
+5. Inspect `plans/current-plan.json`, `results/loop-*.json`, and `state.json`.
+6. Continue until `repository_done` is satisfied.
+
+### Read first
+
+- `.codex/skills/otro/references/runtime.md`
+- `.codex/skills/otro/references/contracts.md`

package/.claude/skills/planning-with-files/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: planning-with-files
+description: "Keep multi-step work auditable through a live markdown plan file"
+user_invocable: true
+---
+
+## /planning-with-files
+
+작업을 plan file로 시작하고, 실행 내내 갱신하고, 검증 로그로 닫는다.
+
+### Use when
+
+- 작업이 여러 단계로 길어질 때
+- edit/test/deploy 흔적을 남겨야 할 때
+- TODO를 durable하게 유지해야 할 때
+
+### Canonical assets
+
+- Codex skill: `.codex/skills/planning-with-files/`
+- Template: `.codex/skills/planning-with-files/assets/plan-template.md`
+- Scaffolder: `.codex/skills/planning-with-files/scripts/new_plan.sh`
+
+### Process
+
+1. `scripts/new_plan.sh "<title>" [repo_root] [section]`로 plan을 만든다.
+2. 저장소가 `sdd/02_plan/<section>/` 규칙을 쓰면 그 위치를 canonical로 사용한다.
+3. `templates` 같은 저장소에서는 `docs/plans/`를 만들지 않고 `sdd/02_plan/<section>/` 아래 생성된 파일에 scope, assumptions, acceptance criteria를 적는다.
+4. 5-10개의 concrete checklist로 쪼갠다.
+5. 항상 하나의 active item만 둔다.
+6. edit/test/deploy 뒤에는 evidence log를 짧게 남긴다.
+7. 마지막에 validation status와 residual risk를 적고 닫는다.
+
+### Guardrails
+
+- stale checklist를 남기지 않는다
+- evidence 없는 완료 표시는 금지
+- dead item을 쌓지 말고 현재 plan을 갱신한다

package/.claude/skills/prd/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: prd
+description: "Generate a structured JSON PRD for executable delivery work"
+user_invocable: true
+---
+
+## /prd
+
+실행 가능한 JSON PRD를 생성한다.
+
+### Use when
+
+- 기능 요구사항을 정형화해야 할 때
+- stories, routes, quality gates를 한 파일로 고정해야 할 때
+- 구현 전에 scope를 잠가야 할 때
+
+### Canonical asset
+
+- `.codex/skills/prd/SKILL.md`
+
+### Rules
+
+- 구현하지 말고 PRD만 생성
+- quality gates는 반드시 묻고 포함
+- story는 single iteration 크기로 쪼갬
+- 새 프로젝트면 setup story를 먼저 둠
+- output은 JSON 정본 하나만 저장

package/.claude/skills/ralph-loop/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: ralph-loop
+description: "Run a bounded implement-test-fix loop with explicit stop conditions"
+user_invocable: true
+---
+
+## /ralph-loop
+
+짧은 reproduce -> edit -> validate -> decide 루프를 돌린다.
+
+### Use when
+
+- 버그 수정이 반복 검증을 필요로 할 때
+- flaky 여부나 fail-same / fail-new 분류가 중요할 때
+- stop condition이 명확한 bounded loop가 필요할 때
+
+### Canonical assets
+
+- Codex skill: `.codex/skills/ralph-loop/`
+- Script: `.codex/skills/ralph-loop/scripts/loop_until_success.sh`
+- Reference: `.codex/skills/ralph-loop/references/failure-triage.md`
+
+### Loop contract
+
+1. failing reproduction 또는 target validation command를 고정한다.
+2. iteration마다 한 가지 change만 넣는다.
+3. 즉시 validation을 돌린다.
+4. 결과를 `pass`, `fail-same`, `fail-new`, `flaky`, `no-signal`로 분류한다.
+5. 다음 action을 정한 뒤에만 다시 edit한다.
+
+### Stop conditions
+
+- validation passes
+- max iterations reached
+- same failure repeats 3 times without new signal
+- missing dependency or external decision blocks progress
+
+### Command example
+
+```bash
+.codex/skills/ralph-loop/scripts/loop_until_success.sh --cmd "pytest -q tests/foo_test.py" --max 6
+```

package/.claude/skills/sdd/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: sdd
+description: "Alias skill for repositories that use `sdd/` as the canonical delivery system."
+user_invocable: true
+---
+
+## /sdd
+
+이 파일은 alias skill이다. canonical SDD workflow는 [`../sdd-dev/SKILL.md`](../sdd-dev/SKILL.md)를 따른다.
+
+Rules:
+- 실제 workflow와 section map은 `sdd-dev` 기준을 사용한다.
+- downstream repo가 `sdd` 이름으로 호출해도 동일한 current-state delivery 규칙으로 해석한다.

package/.claude/skills/sdd-dev/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: sdd-dev
+description: "Use the SDD-first workflow for any development task in repos that use sdd/"
+user_invocable: true
+---
+
+## /sdd-dev
+
+개발 작업을 항상 `sdd/` 산출물 기준으로 진행한다. 화면명세서, 화면설계서, 화면 스펙, 디자인, 디자인 가이드 같은 화면 개발 프롬프트도 이 스킬의 트리거로 본다.
+배포가 실제 범위이고 개발계 배포 completion bar가 `main` 기준인 저장소에서는 임시 브랜치나 worktree를 써도 최종 반영은 반드시 `origin/main`까지 올라가야 완료로 본다.
+배포가 실제 범위이고 개발계와 운영계가 분리된 저장소에서는 배포 순서를 `DEV 배포 -> DEV 전 레이어 검증 통과 -> PROD 배포 -> PROD 동일 레이어 검증`으로 고정한다. 운영 검증이 실패하면 롤백 또는 명시된 복구 절차가 필수다.
+스키마가 동작에 영향을 줄 수 있는 작업은 코드나 migration head만 보지 않고 DEV/PROD 실제 스키마 상태를 확인해야 한다.
+
+### Use when
+
+- 사용자가 `개발해`, `작업해`, `구현해`, `수정해`, `고쳐`, `리팩토링해`, `테스트해`, `배포해`처럼 개발을 지시할 때
+- 사용자가 `화면명세서`, `화면설계서`, `화면 설계`, `화면`, `화면 스펙`, `UI`, `디자인`, `디자인 가이드`처럼 화면 개발/정렬을 지시할 때
+- 저장소가 `sdd/01_planning`, `02_plan`, `03_build`, `04_verify`, `05_operate` 구조를 쓸 때
+- 코드 수정과 함께 계획, 검증, 운영 흔적도 남겨야 할 때
+
+### Canonical assets
+
+- Codex skill: `.codex/skills/sdd/`
+- Section map: `.codex/skills/sdd/references/section-map.md`
+
+### Workflow
+
+1. 먼저 `sdd/01_planning`의 관련 산출물을 확인하고 구현과 어긋난 부분을 바로잡는다.
+2. `sdd/02_plan/<section>/`에 작업 계획을 만들거나 기존 계획을 갱신한다.
+   - 배포가 범위에 있으면 acceptance criteria에 `DEV 게이트`, `동일한 PROD 게이트`, `전 레이어 테스트 범위`, `롤백 조건/절차`를 명시한다.
+   - persistence, migration, repository, ORM mapping, SQL, 운영 장애 대응이 걸린 작업이면 acceptance criteria에 `DEV/PROD 스키마 검증`을 넣는다.
+3. 코드 작업을 수행하고, 의미 있는 결정은 계획 로그에 남긴다.
+   - 화면명세서에 있는 아이콘, 로고, 일러스트, 기타 정적 자산이 필요하면 먼저 저장소의 canonical `스펙에셋빌더`로 추출한다.
+   - 템플릿 기준 canonical 경로는 `sdd/99_toolchain/01_automation/spec_asset_builder.py` 또는 그 wrapper/manifest다.
+   - reusable asset planning 기록은 `sdd/01_planning/02_screen/assets/` 아래에 둔다.
+   - source crop과 동일해야 하는 자산은 가능하면 `--verify-exact`까지 수행한다.
+   - builder로 표현 가능한 자산을 수동 redraw나 screenshot crop으로 대체하지 않는다. 예외가 필요하면 plan/build/verify에 이유를 남긴다.
+   - 화면 여백, 레이아웃 밀도, 타이포, 색상 리듬, 컴포넌트 hierarchy가 명세 기반이면 저장소의 canonical 디자인 가이드 빌더가 있는지 먼저 확인하고, 있으면 그 산출물을 기준으로 구현한다.
+   - 템플릿 기준으로는 `sdd/99_toolchain/01_automation/README.md`와 실제 존재하는 builder/wrapper/manifest를 canonical source로 본다.
+   - local screen exactness는 Playwright를 canonical automation gate로 본다.
+   - 템플릿 기준 canonical runner는 `python3 sdd/99_toolchain/01_automation/run_playwright_exactness.py --suite <suite-id>`이고, suite registry는 `sdd/99_toolchain/01_automation/playwright_exactness_manifest.py`다.
+   - direct `npx playwright test ...` 호출은 디버깅 예외로만 쓰고, retained verification command는 toolchain wrapper 기준으로 남긴다.
+   - Playwright suite가 이미 있으면 Browser Use/manual screenshot/semantic extraction은 보조 진단일 뿐 canonical gate를 대체하지 않는다.
+   - 배포가 범위에 있으면 DEV와 PROD에 같은 `전 레이어 검증 surface`를 재사용하도록 미리 정의한다. 앱/라우트, API, persistence/schema, 배치/워크플로, 연동, 헬스/모니터링을 포함한다.
+4. 구현/실행 기록은 `sdd/03_build`에 남긴다.
+5. 테스트와 검증 근거는 `sdd/04_verify`에 남긴다.
+   - DEV 배포가 있으면 DEV에서 먼저 전 레이어 검증을 수행하고, 통과 전에는 PROD로 올리지 않는다.
+   - PROD 배포 후에는 DEV와 같은 검증 surface를 PROD에서 다시 실행한다.
+   - persistence 영향 가능성이 있으면 DEV/PROD 모두에서 실제 스키마, index, constraint, trigger, default, legacy column drift를 확인한다.
+   - PROD 검증 실패 시 즉시 롤백 또는 승인된 복구 절차를 실행하고 결과를 남긴다.
+   - Playwright suite가 있는 surface는 suite id, canonical runner command, screenshot/json artifact path를 verify에 함께 남긴다.
+6. 실제 배포나 운영 후속이 있으면 `sdd/05_operate`에 남긴다.
+   - 개발계 배포 baseline이 `main`이면 완료 전에 `main`에 merge, cherry-pick, 또는 동등한 방식으로 반영한 뒤 `origin/main`을 push한다.
+   - side branch에만 올라간 상태로는 개발계 배포 완료로 보지 않는다.
+   - DEV 게이트 통과 근거, PROD 게이트 통과 근거, 롤백이 있었다면 그 트리거와 결과를 함께 기록한다.
+
+### Guardrails
+
+- `sdd/`가 있는 저장소에서 별도 `docs/` 트리를 만들지 않는다.
+- planning review 없이 바로 코드부터 수정하지 않는다.
+- 검증 결과를 채팅에만 남기지 말고 `sdd/04_verify`에도 기록한다.
+- PROD 배포가 범위일 때 DEV 전 레이어 검증이 통과하기 전에는 PROD 배포를 진행하지 않는다.
+- PROD 배포가 범위일 때 DEV보다 약한 범위로 PROD 검증을 축소하지 않는다. 예외는 사용자 승인과 문서화가 필요하다.
+- PROD 배포가 범위일 때 PROD는 "배포 성공"만으로 끝내지 않는다. 배포 후 동일 레이어 검증이 필수다.
+- PROD 배포가 범위일 때 실패한 PROD 배포를 미해결 상태로 두지 않는다. 롤백 또는 승인된 복구 절차를 실행하고 기록한다.
+- local 테스트 통과, model 코드, migration head만으로 DEV/PROD 스키마가 같다고 가정하지 않는다.
+- schema drift 가능성이 있는 작업에서 DEV/PROD 실제 스키마 확인을 생략하지 않는다.
+- canonical `스펙에셋빌더`가 있는 저장소에서는 화면명세 정적 자산을 수동 재작성하지 않는다.
+- 화면 관련 자동화 builder가 있으면 작은 UI 수정처럼 보여도 먼저 확인한다.
+- 배포가 없었으면 `05_operate`에 허위 기록을 남기지 않는다.
+- 개발계 배포 baseline이 `main`인 저장소에서 side branch push만으로 배포 완료라고 판단하지 않는다.

package/.claude/skills/sdd-development/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: sdd-development
+description: "Alias skill for the canonical SDD-first development workflow."
+user_invocable: true
+---
+
+## /sdd-development
+
+이 파일은 alias skill이다. canonical SDD workflow는 [`../sdd-dev/SKILL.md`](../sdd-dev/SKILL.md)를 따른다.
+
+Rules:
+- planning, build, verify, operate 기록은 `sdd-dev` 규칙과 동일하다.
+- downstream repo는 `sdd-development` 이름을 그대로 복제할 수 있다.

package/.claude/workspace-config.json

@@ -0,0 +1,3 @@
+{
+  "nickname": "say"
+}

package/.codex/agentic-dev.json

@@ -0,0 +1,3 @@
+{
+  "contract_path": "../sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json"
+}

package/.codex/agents/README.md

@@ -0,0 +1,22 @@
+# Generic Sub-Agents
+
+이 디렉터리는 템플릿 저장소에서 재사용할 수 있는 일반 목적 Codex 서브에이전트 역할 정의를 둔다.
+
+## Defined Roles
+
+- `architecture`
+- `runtime`
+- `gitops`
+- `quality`
+- `api`
+- `orchestrator`
+- `ci`
+- `specs`
+- `ui`
+- `security`
+
+## Notes
+
+- 역할 이름과 설명은 특정 서비스명에 묶지 않는다.
+- 제품/회사/실환경 고유 정보는 이 디렉터리에 저장하지 않는다.
+- 역할 설명은 템플릿 수준의 일반 책임만 다룬다.

package/.codex/agents/api.toml

@@ -0,0 +1,11 @@
+model = "gpt-5.3-codex"
+model_reasoning_effort = "high"
+sandbox_mode = "workspace-write"
+developer_instructions = """
+You are the API sub-agent.
+
+Mission:
+- Keep API contracts stable while internals evolve.
+- Normalize input, output, and error handling.
+- Preserve backward-compatible behavior by default.
+"""

package/.codex/agents/architecture.toml

@@ -0,0 +1,11 @@
+model = "gpt-5.3-codex"
+model_reasoning_effort = "high"
+sandbox_mode = "read-only"
+developer_instructions = """
+You are the architecture sub-agent.
+
+Mission:
+- Define clear boundaries and migration direction.
+- Remove hardcoded assumptions that prevent reuse.
+- Keep decisions generic enough for template reuse.
+"""

package/.codex/agents/ci.toml

@@ -0,0 +1,11 @@
+model = "gpt-5.3-codex"
+model_reasoning_effort = "high"
+sandbox_mode = "workspace-write"
+developer_instructions = """
+You are the CI sub-agent.
+
+Mission:
+- Maintain pipeline policy and release path integrity.
+- Keep failure reasons explicit and actionable.
+- Ensure validation gates remain reproducible.
+"""