@uzysjung/agent-harness 26.83.0

package/templates/agents/silent-failure-hunter.md

@@ -0,0 +1,50 @@
+---
+name: silent-failure-hunter
+description: Review code for silent failures, swallowed errors, bad fallbacks, and missing error propagation.
+model: sonnet
+tools: [Read, Grep, Glob, Bash]
+---
+
+# Silent Failure Hunter Agent
+
+You have zero tolerance for silent failures.
+
+## Hunt Targets
+
+### 1. Empty Catch Blocks
+
+- `catch {}` or ignored exceptions
+- errors converted to `null` / empty arrays with no context
+
+### 2. Inadequate Logging
+
+- logs without enough context
+- wrong severity
+- log-and-forget handling
+
+### 3. Dangerous Fallbacks
+
+- default values that hide real failure
+- `.catch(() => [])`
+- graceful-looking paths that make downstream bugs harder to diagnose
+
+### 4. Error Propagation Issues
+
+- lost stack traces
+- generic rethrows
+- missing async handling
+
+### 5. Missing Error Handling
+
+- no timeout or error handling around network/file/db paths
+- no rollback around transactional work
+
+## Output Format
+
+For each finding:
+
+- location
+- severity
+- issue
+- impact
+- fix recommendation

package/templates/agents/strategist.md

@@ -0,0 +1,86 @@
+---
+name: strategist
+description: "Business strategy and executive document specialist. Creates proposals, due diligence reports, competitive analysis, financial models, and presentations. Use for executive-track deliverables. Integrates with Anthropic document-skills (pptx/docx/xlsx/pdf)."
+tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"]
+model: opus
+---
+
+# Strategist Agent
+
+## Expertise Domains
+
+### Proposals & Reports
+- **사업 제안서**: 문제 정의 → 솔루션 → 시장 기회 → 실행 계획 → 재무 전망
+- **Due Diligence**: 기술 DD, 재무 DD, 법률 DD 각 관점별 체크리스트
+- **경쟁 분석**: 포터 5 Forces, SWOT, 기능 비교 매트릭스, 포지셔닝 맵
+- **시장 분석**: TAM/SAM/SOM, 성장률 추정, 트렌드 분석
+- **정기 보고서**: 주간/월간 리더십 업데이트, KPI 대시보드, 이슈 에스컬레이션
+
+### Financial Modeling
+- **수익 모델**: SaaS(MRR/ARR/Churn), 트랜잭션 기반, 구독 + 사용량 하이브리드
+- **비용 구조**: 인건비, 인프라(AWS/GCP/Railway), 마케팅, 운영비
+- **시나리오 분석**: Base/Bull/Bear 3개 시나리오, 민감도 분석
+- **KPI**: CAC, LTV, LTV/CAC, Burn Rate, Runway, Unit Economics
+
+### Presentation Design
+- **구조**: 1페이지 executive summary + 3-5페이지 detail sections
+- **원칙**: 슬라이드당 하나의 메시지, 시각적 일관성, 데이터 기반
+- **도구**: Anthropic `document-skills:pptx` 연동
+
+## Document Types & Templates
+
+### 1-Page Executive Summary
+```
+[문제] → [솔루션] → [시장 기회] → [경쟁 우위] → [재무 요약] → [요청 사항]
+```
+
+### 사업 제안서 구조
+1. Executive Summary
+2. 문제 정의 & 시장 기회
+3. 솔루션 개요
+4. 비즈니스 모델
+5. 경쟁 환경 & 차별화
+6. GTM 전략
+7. 팀 구성
+8. 재무 계획 (3년)
+9. 리스크 & 완화 방안
+10. 요청 사항 & 다음 단계
+
+### 옵션 비교 테이블
+| 기준 | 가중치 | 옵션 A | 옵션 B | 옵션 C |
+|------|--------|--------|--------|--------|
+| [기준 1] | [%] | [점수] | [점수] | [점수] |
+| **가중 합계** | | | | |
+
+## Integration with document-skills
+
+- **pptx**: `document-skills:pptx` 스킬로 PowerPoint 생성/편집
+- **docx**: `document-skills:docx` 스킬로 Word 문서 생성/편집
+- **xlsx**: `document-skills:xlsx` 스킬로 Excel 스프레드시트 생성/편집
+- **pdf**: `document-skills:pdf` 스킬로 PDF 조작
+
+산출물 유형에 따라 적절한 document-skills를 자동 선택한다.
+
+## Quality Standards
+
+### 데이터 기반
+- 모든 주장에 근거(수치, 출처) 필수
+- 출처 불명 데이터는 "추정" 또는 "가정" 명시
+- 시장 데이터는 발행일 기준 2년 이내만 사용
+
+### 청중 수준 적합
+- C-level: 핵심 메시지 + 의사결정 포인트 (디테일 부록으로)
+- 실무자: 구체적 실행 계획 + 일정 + 담당자
+- 투자자: 재무 중심 + 성장 내러티브 + 리스크 대응
+
+### 한국어 비즈니스 문서 규칙
+- 존칭 일관성 유지
+- 숫자/단위 표기 통일 (천원, 백만원, 억원)
+- 영문 약어 최초 등장 시 한글 병기: "SaaS(서비스형 소프트웨어)"
+
+## Anti-Patterns
+
+- "일반적으로", "통상적으로" 등 모호한 표현 금지 — 구체적 수치 사용
+- 경쟁사 분석 시 감정적 표현 금지 — 객관적 기능/성능 비교만
+- 재무 모델에서 비현실적 성장률(연 300%+) 무비판 사용 금지
+- 근거 없는 시장 규모 추정 금지

package/templates/antigravity/AGENTS.md.template

@@ -0,0 +1,58 @@
+# {PROJECT_NAME} — Antigravity Agent Guide
+
+> **Generated from**: `.claude/CLAUDE.md` via TS CLI `src/antigravity/transform.ts`
+> **Antigravity**: 2.0+ (`agy` CLI + desktop IDE)
+> **Location**: workspace rule — `.agents/rules/uzys-harness.md`
+
+## Project Rules
+
+{PROJECT_RULES}
+
+## Workflow Gates
+
+```
+Define(/uzys-spec) → Plan(/uzys-plan) → Build(/uzys-build) → Verify(/uzys-test) → Review(/uzys-review) → Ship(/uzys-ship)
+```
+
+각 단계 완료 없이 다음 진행 금지. 6-Gate workflow 는 `uzys-harness 6-Gate workflow` opt-in 시에만 `.agents/workflows/` 에 설치됨.
+
+**Hotfix 단축**: Build → Verify → Ship (긴급 수정에 한함)
+**Executive track**: 6단계 게이트 미적용. 자연어 요청 → strategist + document-skills → 산출물 → 검토.
+
+## Command Reference (Antigravity workflows)
+
+`.agents/workflows/uzys-{phase}.md` 파일은 `/` prefix 슬래시로 호출됨:
+
+| Slash | 용도 |
+|-------|------|
+| `/uzys-spec` | Define — 구조화된 스펙 작성 |
+| `/uzys-plan` | Plan — 검증 가능한 작은 단위로 분해 |
+| `/uzys-build` | Build — TDD 점진적 구현 |
+| `/uzys-test` | Verify — 테스트 실행 + 커버리지 |
+| `/uzys-review` | Review — 5축 리뷰 (correctness, readability, architecture, security, performance) |
+| `/uzys-ship` | Ship — 프리런치 체크리스트 + 배포 |
+
+Antigravity 는 워크플로우를 파일명 기반 `/` 슬래시로 호출 → `uzys-{phase}.md` = `/uzys-{phase}`. Claude Code 원본은 `/uzys:*` 유지.
+
+## Protected Files (DO NOT EDIT)
+
+- `.env*`, `**/credentials.json`
+- `*.lock`, `package-lock.json`, `pnpm-lock.yaml`, `poetry.lock`, `Cargo.lock`, `uv.lock`
+- `.git/` 내부 파일 (커밋 메시지/hook 제외)
+- `~/.gemini/`, `~/.claude/`, `~/.codex/` 글로벌 (D16 보호)
+
+보호 영역 이슈 발견 시 **보고만**. 직접 수정 금지.
+
+## Scopes
+
+| Scope | 위치 | 비고 |
+|-------|------|------|
+| Workspace skills | `.agents/skills/` | 본 프로젝트 한정 (Codex 공유) |
+| Workspace workflows | `.agents/workflows/` | 본 프로젝트 한정 |
+| Workspace rules | `.agents/rules/` | 본 문서 |
+| Global rules | `~/.gemini/GEMINI.md` | 사용자 직접 관리 (harness 미터치) |
+| Global skills | `~/.gemini/antigravity/skills/` | `--with-antigravity-global` + `--scope global` opt-in 시만 |
+
+---
+
+*이 문서는 자동 생성됨. 수동 편집 시 harness 재설치가 덮어쓸 수 있음. 원본은 `.claude/CLAUDE.md` 또는 `templates/CLAUDE.md`.*

package/templates/codex/AGENTS.md.template

@@ -0,0 +1,94 @@
+# {PROJECT_NAME} — Codex Agent Guide
+
+> **Generated from**: `.claude/CLAUDE.md` via `scripts/claude-to-codex.sh` (Phase C)
+> **Codex Version**: 0.124.0+
+> **Linked SPEC**: `docs/specs/codex-compat.md`
+
+## Project Rules
+
+{PROJECT_RULES}
+
+## Workflow Gates
+
+```
+Define(/uzys-spec) → Plan(/uzys-plan) → Build(/uzys-build) → Verify(/uzys-test) → Review(/uzys-review) → Ship(/uzys-ship)
+```
+
+각 단계 완료 없이 다음 진행 금지. 건너뛰기 시도 시 `pre_tool_use` hook이 exit 2로 차단.
+
+**Hotfix 단축**: Build → Verify → Ship (긴급 수정에 한함)
+
+**Executive track**: 6단계 게이트 미적용. 자연어 요청 → strategist + document-skills → 산출물 → 검토.
+
+## Session Start
+
+매 세션 시작 시:
+1. `git pull --rebase`
+2. `docs/SPEC.md` 및 `docs/specs/*.md` 재참조 (Persistent Anchor)
+3. `docs/todo.md` 현재 Phase 확인
+
+`session_start` hook이 자동 수행. Hook 실패 시 수동 수행.
+
+## Protected Files (DO NOT EDIT)
+
+Codex `sandbox_mode = "workspace-write"` + `approval_policy = "on-request"` 가 1차 방어. LLM 추가 준수:
+
+- `.env*`
+- `**/credentials.json`
+- `*.lock`, `package-lock.json`, `pnpm-lock.yaml`, `poetry.lock`, `Cargo.lock`, `uv.lock`
+- `.git/` 내부 파일 (커밋 메시지/hook 제외)
+- `~/.codex/`, `~/.claude/` 글로벌 (D16 보호)
+
+보호 영역 이슈 발견 시 **보고만**. 직접 수정 금지.
+
+## Git Policy
+
+- 코드/문서 변경 시 **즉시 commit**. "나중에 한꺼번에" 금지.
+- `main` 직접 커밋 금지. feature branch 사용.
+- 세션 시작 시 `git pull` 필수.
+- Conventional Commits — `<type>: <description>` (feat, fix, refactor, docs, test, chore, perf, ci)
+
+## Command Reference (Codex slash)
+
+| Slash | 용도 |
+|-------|------|
+| `/uzys-spec` | Define — 구조화된 스펙 작성 |
+| `/uzys-plan` | Plan — 검증 가능한 작은 단위로 분해 |
+| `/uzys-build` | Build — TDD 점진적 구현 |
+| `/uzys-test` | Verify — 테스트 실행 + 커버리지 |
+| `/uzys-review` | Review — 5축 리뷰 (correctness, readability, architecture, security, performance) |
+| `/uzys-ship` | Ship — 프리런치 체크리스트 + 배포 |
+
+Codex는 slash namespace(`uzys:`)를 지원하지 않아 `uzys-*` 형식으로 rename됨. Claude Code 원본은 `/uzys:*` 유지.
+
+## Agents (subagent, multi_agent stable)
+
+| Agent | Model | 역할 |
+|-------|-------|------|
+| reviewer | opus | 검증 전용 (SOD). 5축 리뷰 |
+| data-analyst | opus | Python / DuckDB / Trino / ML / PySide6 |
+| strategist | opus | 제안서 / DD / PPT / 경쟁분석 / 재무모델 |
+| code-reviewer | sonnet | 일상적 코드 리뷰 |
+| security-reviewer | sonnet | OWASP Top 10, 보안 패턴 |
+
+subagent 호출은 `spawn_agent / wait_agent / close_agent` 툴. 부모 컨텍스트 격리.
+
+## Hooks 현황 (Codex 0.124.0 실측 제약)
+
+- `pre_tool_use` / `post_tool_use` — **Bash 툴 한정 발화** (Issue #16732). ApplyPatch(파일 쓰기) 가로채기는 불가. `sandbox_mode` + `approval_policy`로 대체 보호.
+- 프로젝트 `.codex/config.toml` 훅은 사용자 `~/.codex/config.toml`에 trust entry 등록된 경우에만 로드.
+- 인터랙티브 세션 hook 로딩 bug (Issue #17532) 존재 가능 — `codex exec` 비대화형은 정상.
+
+## Experience Accumulation
+
+- Codex `memories` feature (experimental) — Claude auto memory 유사
+- 검증된 learning만 Rules 승격
+
+## Context Management
+
+- SPEC/PRD 매 세션 시작 시 재참조 (Persistent Anchor)
+- `child_agents_md` feature flag는 **under development, disabled** — AGENTS.md 디렉토리 계층 merge 사용 불가. 글로벌 `~/.codex/AGENTS.md` + 프로젝트 `AGENTS.md` 2단만 사용.
+
+---
+
+*이 문서는 자동 생성됨. 수동 편집 시 `scripts/claude-to-codex.sh` 재실행이 덮어쓸 수 있음. 원본은 `.claude/CLAUDE.md` 또는 `templates/CLAUDE.md`.*

package/templates/codex/README.md

@@ -0,0 +1,69 @@
+# templates/codex/ — Codex CLI 배포 템플릿
+
+> **Linked SPEC**: `docs/specs/codex-compat.md` Phase B
+> **Linked ADR**: `docs/decisions/ADR-002-codex-hook-gap.md` v2
+> **Codex Version**: 0.124.0+ (`codex_hooks=stable, multi_agent=stable, plugins=stable` 전제)
+
+## 목적
+
+Claude Code SSOT(`templates/`, `.claude/`)에서 Codex CLI 프로젝트로 **포맷 변환**하여 설치할 때 사용되는 템플릿 집합. 변환 로직은 `scripts/claude-to-codex.sh` (Phase C)에서 구현.
+
+## 디렉토리 레이아웃
+
+```
+templates/codex/
+├── README.md                        # 본 파일
+├── AGENTS.md.template               # 프로젝트 AGENTS.md (CLAUDE.md에서 생성)
+├── config.toml.template             # 프로젝트 .codex/config.toml (hooks + mcp + sandbox)
+├── hooks/                           # Shell 스크립트 (.claude/hooks/ 재사용 가능)
+│   ├── README.md                    # 포팅 상태 + Event 매핑
+│   ├── gate-check.sh                # pre_tool_use matcher="Skill"
+│   ├── hito-counter.sh              # user_prompt_submit
+│   ├── session-start.sh             # session_start
+│   └── uncommitted-check.sh         # post_tool_use (Bash 한정)
+└── skills/                          # 6 uzys skills (Codex skill 포맷)
+    ├── uzys-spec/SKILL.md
+    ├── uzys-plan/SKILL.md
+    ├── uzys-build/SKILL.md
+    ├── uzys-test/SKILL.md
+    ├── uzys-review/SKILL.md
+    └── uzys-ship/SKILL.md
+```
+
+## 설치 대상 경로 (`setup-harness.sh --cli=codex` 실행 후)
+
+| 템플릿 | 대상 경로 |
+|--------|-----------|
+| `AGENTS.md.template` | `<project>/AGENTS.md` |
+| `config.toml.template` | `<project>/.codex/config.toml` |
+| `hooks/*.sh` | `<project>/.codex/hooks/*.sh` |
+| `skills/uzys-*/` | `~/.codex/skills/uzys-*/` (공식 $CODEX_HOME/skills) |
+| 사용자 `~/.codex/config.toml`에 trust 등록 추가 | (D4 opt-in 확인) |
+
+## Hook Event 매핑 (Claude → Codex)
+
+| Claude | Codex event (snake_case) | Blockable | 제약 |
+|--------|--------------------------|-----------|------|
+| `SessionStart` | `session_start` | ❌ | — |
+| `UserPromptSubmit` | `user_prompt_submit` | ✅ (exit 2) | matcher 무시 |
+| `PreToolUse` (Skill) | `pre_tool_use` matcher="Skill" | ✅ | **Bash 툴 한정 발화 (Issue #16732)** |
+| `PreToolUse` (Write) | — | — | **Codex `sandbox_mode`로 이관** (ADR-002 v2 D3) |
+| `PostToolUse` | `post_tool_use` | ❌ | Bash 한정 |
+| `Stop` | `stop` | ✅ | — |
+
+stdin JSON 필드(`session_id`, `cwd`, `tool_name`, `tool_input`, `hook_event_name`)는 Claude ↔ Codex 공통 → **shell 스크립트 본체 재사용**.
+
+## 미구현 (후속 Phase)
+
+- `AGENTS.md.template` 본문 — CLAUDE.md에서 변환 (Phase C)
+- `hooks/*.sh` 본체 — `.claude/hooks/` 에서 포팅 (Phase C)
+- `skills/uzys-*/SKILL.md` 본문 — `.claude/commands/uzys/*.md`에서 포팅 + slash prefix rename (Phase C)
+- `setup-harness.sh --cli=codex` 경로 — Phase D
+- Trust entry 확인 프롬프트 — Phase D
+- `--cli=codex` dogfood 검증 — Phase F
+
+## DO NOT CHANGE
+
+- `.claude/` (Claude SSOT) — 절대 수정 금지
+- `~/.codex/` 글로벌 — `setup-harness.sh`가 opt-in 확인 후에만 trust 등록
+- 본 디렉토리 `AGENTS.md.template`과 `config.toml.template`의 플레이스홀더 토큰 (Phase C 변환 스크립트 계약)

package/templates/codex/config.toml.template

@@ -0,0 +1,108 @@
+# Codex 프로젝트 설정 — {PROJECT_NAME}
+# 위치: <project>/.codex/config.toml
+# 생성: setup-harness.sh --cli=codex (Phase D)
+#
+# 참조:
+# - docs/decisions/ADR-002-codex-hook-gap.md v2
+# - docs/specs/codex-compat.md §3.4 OQ2 (trust entry 규약)
+#
+# 주의:
+# - 프로젝트 스코프 hook은 사용자 ~/.codex/config.toml에 trust entry 등록 후에만 로드됨
+# - `{...}` 플레이스홀더는 scripts/claude-to-codex.sh 에서 치환됨
+
+# ============================================================
+# Sandbox & Approval (파일 쓰기 보호 — ADR-002 v2 D3)
+# ============================================================
+approval_policy = "on-request"
+sandbox_mode = "workspace-write"
+
+[sandbox_workspace_write]
+# 기본 쓰기 허용: 프로젝트 디렉토리 + /tmp
+writable_roots = [
+    "{PROJECT_DIR}",
+    "/tmp",
+]
+network_access = true
+# 민감 경로(.env, credentials, lock)는 AGENTS.md에 명시 — LLM 보조 방어
+
+# ============================================================
+# Model & Reasoning
+# ============================================================
+# model = "gpt-5-codex"                # 필요 시 활성화. 생략하면 기본값 사용
+# model_reasoning_effort = "medium"
+
+# ============================================================
+# Analytics
+# ============================================================
+[analytics]
+enabled = true
+
+# ============================================================
+# Hooks — Claude Code `.claude/settings.json` hooks 블록에서 포맷 변환
+# Event 이벤트 매핑: ADR-002 v2 D2 / templates/codex/README.md
+# ============================================================
+
+# SessionStart: git pull + SPEC 재참조 안내
+[[hooks.session_start]]
+name = "session-start"
+command = ["{PROJECT_DIR}/.codex/hooks/session-start.sh"]
+type = "command"
+timeout = 10
+async = false
+
+# UserPromptSubmit: HITO(Human-In-The-Loop Interrupts) 카운트
+[[hooks.user_prompt_submit]]
+name = "hito-counter"
+command = ["{PROJECT_DIR}/.codex/hooks/hito-counter.sh"]
+type = "command"
+timeout = 5
+async = true    # non-blocking 측정
+
+# PreToolUse(Skill matcher): Phase 순서 강제 (exit 2로 차단)
+# 주의: Issue #16732 — Bash 툴에만 발화. ApplyPatch(파일 쓰기)에는 fire 안 함
+[[hooks.pre_tool_use]]
+name = "gate-check"
+command = ["{PROJECT_DIR}/.codex/hooks/gate-check.sh"]
+type = "command"
+timeout = 10
+matcher = "Skill"
+async = false
+
+# PostToolUse: 미커밋 파일 경고 (Bash 한정)
+[[hooks.post_tool_use]]
+name = "uncommitted-check"
+command = ["{PROJECT_DIR}/.codex/hooks/uncommitted-check.sh"]
+type = "command"
+timeout = 5
+async = false
+
+# ============================================================
+# MCP Servers — .mcp.json에서 포맷 변환
+# 조건부 포함: Track 따라 setup-harness가 추가
+# ============================================================
+
+[mcp_servers.context7]
+command = "npx"
+args = ["-y", "@upstash/context7-mcp"]
+
+# github MCP (필요 시 활성화)
+# [mcp_servers.github]
+# command = "npx"
+# args = ["-y", "@modelcontextprotocol/server-github"]
+# env = { GITHUB_PERSONAL_ACCESS_TOKEN = "{GITHUB_TOKEN}" }
+
+# Railway MCP (csr-fastify/csr-fastapi/ssr-*/full 에서만)
+# [mcp_servers.railway]
+# command = "npx"
+# args = ["-y", "railway-mcp-server"]
+
+# ============================================================
+# Features (본 설치가 사용하는 stable feature 명시)
+# ============================================================
+[features]
+codex_hooks = true           # stable, 기본값 true — 명시적 확정
+multi_agent = true           # stable — subagent SOD
+plugins = true               # stable — plugin 번들 호환
+tool_search = true           # stable
+skill_mcp_dependency_install = true  # skill이 MCP 자동 설치
+child_agents_md = false      # under dev — 본 SPEC 범위 밖

package/templates/codex/hooks/README.md

@@ -0,0 +1,40 @@
+# templates/codex/hooks/ — Codex Hook 스크립트
+
+> **Linked**: `docs/decisions/ADR-002-codex-hook-gap.md` v2 D1~D5
+> **Transform**: `scripts/claude-to-codex.sh` (Phase C)가 `.claude/hooks/*.sh`를 대부분 그대로 포팅
+
+## Hook 매핑 요약
+
+| Codex event (snake_case) | 스크립트 | 원본 (Claude) | 상태 |
+|--------------------------|----------|---------------|------|
+| `session_start` | `session-start.sh` | `.claude/hooks/session-start.sh` | Phase C 포팅 예정 |
+| `user_prompt_submit` | `hito-counter.sh` | `.claude/hooks/hito-counter.sh` | Phase C 포팅 예정 |
+| `pre_tool_use` matcher="Skill" | `gate-check.sh` | `.claude/hooks/gate-check.sh` | Phase C 포팅 예정 |
+| `post_tool_use` | `uncommitted-check.sh` | `.claude/hooks/uncommitted-check.sh` | Phase C 포팅 예정 |
+| ❌ (hook 사용 안 함) | ❌ | `.claude/hooks/protect-files.sh` | **Codex sandbox로 이관 (ADR-002 v2 D3)** |
+
+## stdin/stdout 호환
+
+Claude Code hook 스크립트가 stdin에서 읽는 필드는 Codex에서도 동일 이름으로 제공됨. 본체 수정 불필요:
+
+- stdin 공통: `session_id, transcript_path, cwd, permission_mode, hook_event_name` (PascalCase)
+- stdin 이벤트별: `tool_name, tool_input, tool_use_id, prompt, source, model`
+- stdout: `systemMessage, additionalContext, updatedInput, decision (allow|deny|ask), reason, continue`
+- exit 0 = 성공 / exit 2 = blockable 차단 (stderr → reason) / 기타 = non-blocking error
+
+## 치명적 제약 — Issue #16732
+
+`pre_tool_use` / `post_tool_use` 가 Bash 툴에만 발화. ApplyPatch(파일 쓰기)에 대해선 fire 안 함.
+
+**영향**:
+- `gate-check.sh` matcher="Skill" — Claude Code에서도 Skill matcher 대상이므로 **영향 없음** (Skill 호출 경로는 Bash shell이 감싸므로 발화)
+- `uncommitted-check.sh` — 파일 저장 후 감지가 필요한 경우 ApplyPatch 이후 상태는 못 잡음. Bash 커밋/저장 경로는 잡힘. Codex `stop` 이벤트(turn 종료) 추가 등록으로 보완 가능 (Phase C 설계 옵션)
+
+## 미구현
+
+- 각 `.sh` 스크립트 본체 — Phase C에서 `.claude/hooks/`에서 포팅
+- 포팅 과정에서 Codex 전용 env var(`CODEX_HOME` 등) 대응 필요 시 wrapper 추가
+
+## 보안
+
+Codex `sandbox_mode = "workspace-write"` + `approval_policy = "on-request"` 가 파일 쓰기 1차 방어. Hook 스크립트는 보조 역할.

package/templates/codex/hooks/gate-check.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# Placeholder — Phase C에서 `.claude/hooks/gate-check.sh`로부터 포팅
+# stdin JSON 필드는 Claude Code와 호환 (ADR-002 v2 D5)
+# Codex event 매핑은 templates/codex/hooks/README.md 참조
+set -euo pipefail
+echo "not-yet-implemented (Phase C)" >&2
+exit 0

package/templates/codex/hooks/hito-counter.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# Placeholder — Phase C에서 `.claude/hooks/hito-counter.sh`로부터 포팅
+# stdin JSON 필드는 Claude Code와 호환 (ADR-002 v2 D5)
+# Codex event 매핑은 templates/codex/hooks/README.md 참조
+set -euo pipefail
+echo "not-yet-implemented (Phase C)" >&2
+exit 0

package/templates/codex/hooks/session-start.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# Placeholder — Phase C에서 `.claude/hooks/session-start.sh`로부터 포팅
+# stdin JSON 필드는 Claude Code와 호환 (ADR-002 v2 D5)
+# Codex event 매핑은 templates/codex/hooks/README.md 참조
+set -euo pipefail
+echo "not-yet-implemented (Phase C)" >&2
+exit 0

package/templates/codex/hooks/uncommitted-check.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# Placeholder — Phase C에서 `.claude/hooks/uncommitted-check.sh`로부터 포팅
+# stdin JSON 필드는 Claude Code와 호환 (ADR-002 v2 D5)
+# Codex event 매핑은 templates/codex/hooks/README.md 참조
+set -euo pipefail
+echo "not-yet-implemented (Phase C)" >&2
+exit 0

package/templates/codex/skills/uzys-build/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: uzys-build
+description: "Build phase — TDD로 점진적 구현한다. Codex 포팅 (원본: .claude/commands/uzys/build.md)"
+---
+
+# /uzys-build — build Phase (Codex)
+
+> **Generated from**: `.claude/commands/uzys/build.md` via `scripts/claude-to-codex.sh` (Phase C)
+> **Slash**: `/uzys-build`
+
+## Pre-flight
+
+이 skill 호출 전 확인:
+- 직전 phase 완료 체크: `docs/todo.md`에서 이전 Phase 체크박스 확인
+- `pre_tool_use` hook이 Skill matcher로 순서 강제 (Codex hook 시스템, ADR-002 v2)
+- 직전 phase 미완료 시 exit 2로 차단됨
+
+## Goal
+
+{SKILL_BODY_PLACEHOLDER}
+
+---
+
+*Phase C에서 본 SKILL.md 본문이 `.claude/commands/uzys/build.md`로부터 포팅됨.*

package/templates/codex/skills/uzys-plan/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: uzys-plan
+description: "Plan phase — 작업을 검증 가능한 작은 단위로 분해한다. Codex 포팅 (원본: .claude/commands/uzys/plan.md)"
+---
+
+# /uzys-plan — plan Phase (Codex)
+
+> **Generated from**: `.claude/commands/uzys/plan.md` via `scripts/claude-to-codex.sh` (Phase C)
+> **Slash**: `/uzys-plan`
+
+## Pre-flight
+
+이 skill 호출 전 확인:
+- 직전 phase 완료 체크: `docs/todo.md`에서 이전 Phase 체크박스 확인
+- `pre_tool_use` hook이 Skill matcher로 순서 강제 (Codex hook 시스템, ADR-002 v2)
+- 직전 phase 미완료 시 exit 2로 차단됨
+
+## Goal
+
+{SKILL_BODY_PLACEHOLDER}
+
+---
+
+*Phase C에서 본 SKILL.md 본문이 `.claude/commands/uzys/plan.md`로부터 포팅됨.*

package/templates/codex/skills/uzys-review/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: uzys-review
+description: "Review phase — 다중 관점 리뷰로 품질을 검증한다. Codex 포팅 (원본: .claude/commands/uzys/review.md)"
+---
+
+# /uzys-review — review Phase (Codex)
+
+> **Generated from**: `.claude/commands/uzys/review.md` via `scripts/claude-to-codex.sh` (Phase C)
+> **Slash**: `/uzys-review`
+
+## Pre-flight
+
+이 skill 호출 전 확인:
+- 직전 phase 완료 체크: `docs/todo.md`에서 이전 Phase 체크박스 확인
+- `pre_tool_use` hook이 Skill matcher로 순서 강제 (Codex hook 시스템, ADR-002 v2)
+- 직전 phase 미완료 시 exit 2로 차단됨
+
+## Goal
+
+{SKILL_BODY_PLACEHOLDER}
+
+---
+
+*Phase C에서 본 SKILL.md 본문이 `.claude/commands/uzys/review.md`로부터 포팅됨.*

package/templates/codex/skills/uzys-ship/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: uzys-ship
+description: "Ship phase — 프리런치 체크리스트 실행 후 배포한다. Codex 포팅 (원본: .claude/commands/uzys/ship.md)"
+---
+
+# /uzys-ship — ship Phase (Codex)
+
+> **Generated from**: `.claude/commands/uzys/ship.md` via `scripts/claude-to-codex.sh` (Phase C)
+> **Slash**: `/uzys-ship`
+
+## Pre-flight
+
+이 skill 호출 전 확인:
+- 직전 phase 완료 체크: `docs/todo.md`에서 이전 Phase 체크박스 확인
+- `pre_tool_use` hook이 Skill matcher로 순서 강제 (Codex hook 시스템, ADR-002 v2)
+- 직전 phase 미완료 시 exit 2로 차단됨
+
+## Goal
+
+{SKILL_BODY_PLACEHOLDER}
+
+---
+
+*Phase C에서 본 SKILL.md 본문이 `.claude/commands/uzys/ship.md`로부터 포팅됨.*

package/templates/codex/skills/uzys-spec/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: uzys-spec
+description: "Define phase — 구조화된 스펙을 코드 작성 전에 작성한다. Codex 포팅 (원본: .claude/commands/uzys/spec.md)"
+---
+
+# /uzys-spec — Define Phase (Codex)
+
+> **Generated from**: `.claude/commands/uzys/spec.md` via `scripts/claude-to-codex.sh` (Phase C)
+> **Slash**: `/uzys-spec` (Codex namespace 미지원으로 `:` → `-` rename)
+
+## Pre-flight
+
+이 skill 호출 전 확인:
+- 직전 단계 없음 (최초 진입점)
+- `docs/SPEC.md` 또는 `docs/specs/<feature>.md`가 아직 없거나 갱신 필요한 상황
+
+## Goal
+
+{SKILL_BODY_PLACEHOLDER}
+
+## Codex 제약 참고
+
+- `pre_tool_use` hook이 Bash 툴만 감지 (Issue #16732) — spec 작성 시 ApplyPatch 경로는 sandbox가 보호
+- `child_agents_md=disabled` — docs/specs/*.md 계층 merge 수동 관리 필요
+
+---
+
+*Phase C에서 본 SKILL.md 본문이 `.claude/commands/uzys/spec.md`로부터 포팅됨.*