oh-my-customcodex 0.3.10 → 0.4.1

package/templates/.claude/skills/sdd-dev/templates/decision-record.md

@@ -0,0 +1,45 @@
+---
+title: {Decision title}
+date: YYYY-MM-DD
+status: proposed | accepted | superseded | deprecated
+context: guides/harness-engineering/README.md
+decision_makers: [{agent or role}]
+---
+
+# {Decision title}
+
+## Context
+
+{What is the problem and why is a decision needed? Include relevant constraints, goals, and the situation that makes this decision necessary.}
+
+## Options Considered
+
+1. **Option A**: {Description}
+   - Pros: {benefits}
+   - Cons: {drawbacks, trade-offs}
+
+2. **Option B**: {Description}
+   - Pros: {benefits}
+   - Cons: {drawbacks, trade-offs}
+
+3. **Option C** *(if applicable)*: {Description}
+   - Pros: {benefits}
+   - Cons: {drawbacks, trade-offs}
+
+## Decision
+
+**Chosen**: Option {A|B|C}
+
+{Explain the rationale for the choice. Why does this option best satisfy the constraints and goals from the Context section?}
+
+## Consequences
+
+- **Positive**: {What improves as a result of this decision}
+- **Negative**: {Trade-offs and costs accepted}
+- **Risks**: {Future considerations, potential issues to monitor}
+
+## References
+
+- guides/harness-engineering/README.md
+- {related skill or agent, e.g. .codex/skills/action-validator/SKILL.md}
+- {link to issue or PR if applicable}

package/templates/.claude/skills/secretary-routing/SKILL.md

@@ -24,6 +24,7 @@ Routes agent management tasks to the appropriate manager agent. This skill conta
 | mgr-claude-code-bible | Claude Code spec compliance | "spec check", "verify compliance" |
 | sys-memory-keeper | Memory operations | "save memory", "recall", "memory search" |
 | sys-naggy | TODO management | "todo", "track tasks", "task list" |
+| tracker-checkpoint | Pipeline checkpoint state | "pipeline resume", "checkpoint", "state restore" |
 
 ## Routing Decision (Priority Order)
 
@@ -51,6 +52,7 @@ verify   → mgr-sauron
 spec     → mgr-claude-code-bible
 memory   → sys-memory-keeper
 todo            → sys-naggy
+checkpoint      → tracker-checkpoint
 improve-report  → omcodex:improve-report (skill invocation)
 auto-improve    → omcodex:auto-improve (skill invocation)
 batch           → multiple (parallel)
@@ -106,6 +108,7 @@ When command requires multiple independent operations:
 | mgr-claude-code-bible | sonnet | Spec compliance checks |
 | sys-memory-keeper | sonnet | Memory operations, search |
 | sys-naggy | haiku | Simple TODO tracking |
+| tracker-checkpoint | sonnet | Pipeline state recovery |
 
 ## No Match Fallback
 

package/templates/.github/scripts/verify-fork-list.sh

@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+# Verify R006 Context Fork Criteria matches actual SKILL.md frontmatter.
+# Usage: bash .github/scripts/verify-fork-list.sh
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+RULE_FILE="${ROOT}/.codex/rules/MUST-agent-design.md"
+SKILLS_DIR="${ROOT}/.codex/skills"
+
+if [[ ! -f "${RULE_FILE}" ]]; then
+  echo "error: ${RULE_FILE} not found" >&2
+  exit 1
+fi
+
+if [[ ! -d "${SKILLS_DIR}" ]]; then
+  echo "error: ${SKILLS_DIR} not found" >&2
+  exit 1
+fi
+
+DOC_LINE="$(grep -E 'Current: [0-9]+/12 \(' "${RULE_FILE}" | head -1 || true)"
+
+if [[ -z "${DOC_LINE}" ]]; then
+  echo "error: R006 Context Fork Criteria line not found" >&2
+  exit 1
+fi
+
+DOC_COUNT="$(printf '%s\n' "${DOC_LINE}" | sed -E 's#.*Current: ([0-9]+)/12.*#\1#')"
+DOC_LIST="$(printf '%s\n' "${DOC_LINE}" | sed -E 's#.*Current: [0-9]+/12 \(([^)]*)\).*#\1#' | tr ',' '\n' | sed 's/^ *//; s/ *$//' | sort)"
+
+ACTUAL_LIST="$(
+  for skill_file in "${SKILLS_DIR}"/*/SKILL.md; do
+    [[ -f "${skill_file}" ]] || continue
+    if awk '
+      BEGIN { in_frontmatter = 0; found = 0 }
+      NR == 1 && $0 == "---" { in_frontmatter = 1; next }
+      in_frontmatter && $0 == "---" { exit }
+      in_frontmatter && $0 ~ /^context:[[:space:]]*fork[[:space:]]*$/ { found = 1 }
+      END { exit found ? 0 : 1 }
+    ' "${skill_file}"; then
+      skill_name="$(awk '
+        NR == 1 && $0 == "---" { in_frontmatter = 1; next }
+        in_frontmatter && $0 == "---" { exit }
+        in_frontmatter && $0 ~ /^name:[[:space:]]*/ {
+          sub(/^name:[[:space:]]*/, "")
+          gsub(/^"|"$/, "")
+          print
+          exit
+        }
+      ' "${skill_file}")"
+      if [[ -z "${skill_name}" ]]; then
+        echo "error: context: fork skill has no frontmatter name: ${skill_file}" >&2
+        exit 1
+      fi
+      printf '%s\n' "${skill_name}"
+    fi
+  done | sort
+)"
+
+ACTUAL_COUNT="$(printf '%s\n' "${ACTUAL_LIST}" | sed '/^$/d' | wc -l | tr -d ' ')"
+DOC_LIST_COUNT="$(printf '%s\n' "${DOC_LIST}" | sed '/^$/d' | wc -l | tr -d ' ')"
+
+DOC_TMP="$(mktemp)"
+ACTUAL_TMP="$(mktemp)"
+trap 'rm -f "${DOC_TMP}" "${ACTUAL_TMP}"' EXIT
+
+printf '%s\n' "${DOC_LIST}" | sed '/^$/d' > "${DOC_TMP}"
+printf '%s\n' "${ACTUAL_LIST}" | sed '/^$/d' > "${ACTUAL_TMP}"
+
+MISSING="$(comm -23 "${ACTUAL_TMP}" "${DOC_TMP}" || true)"
+EXTRA="$(comm -13 "${ACTUAL_TMP}" "${DOC_TMP}" || true)"
+
+echo "R006 documented count: ${DOC_COUNT}"
+echo "R006 listed skills: ${DOC_LIST_COUNT}"
+echo "Actual fork skill count: ${ACTUAL_COUNT}"
+echo ""
+echo "Actual fork skills:"
+sed 's/^/  - /' "${ACTUAL_TMP}"
+
+if [[ "${DOC_COUNT}" != "${ACTUAL_COUNT}" || "${DOC_LIST_COUNT}" != "${ACTUAL_COUNT}" || -n "${MISSING}" || -n "${EXTRA}" ]]; then
+  echo ""
+  echo "ERROR: R006 fork list drift detected"
+  [[ "${DOC_COUNT}" != "${ACTUAL_COUNT}" ]] && echo "  - documented count ${DOC_COUNT} != actual count ${ACTUAL_COUNT}"
+  [[ "${DOC_LIST_COUNT}" != "${ACTUAL_COUNT}" ]] && echo "  - listed skill count ${DOC_LIST_COUNT} != actual count ${ACTUAL_COUNT}"
+  if [[ -n "${MISSING}" ]]; then
+    echo "  - missing from R006:"
+    printf '%s\n' "${MISSING}" | sed 's/^/    - /'
+  fi
+  if [[ -n "${EXTRA}" ]]; then
+    echo "  - extra in R006:"
+    printf '%s\n' "${EXTRA}" | sed 's/^/    - /'
+  fi
+  echo "  Fix: update Context Fork Criteria in ${RULE_FILE}"
+  exit 1
+fi
+
+echo ""
+echo "OK: R006 fork list matches actual SKILL.md frontmatter (${ACTUAL_COUNT}/12)"

package/templates/AGENTS.md.en

@@ -128,7 +128,7 @@ NO EXCEPTIONS. NO EXCUSES.
 project/
 +-- AGENTS.md                    # Entry point
 +-- .codex/
-|   +-- agents/                  # Subagent definitions (44 files)
+|   +-- agents/                  # Subagent definitions (49 files)
 |   +-- rules/                   # Global rules (R000-R020)
 |   +-- hooks/                   # Hook scripts (security, validation, HUD)
 |   +-- contexts/                # Context files (ecomode)
@@ -164,17 +164,18 @@ This is the core oh-my-customcodex philosophy: **"No expert? CREATE one, connect
 |------|-------|--------|
 | SW Engineer/Language | 6 | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert |
 | SW Engineer/Backend | 6 | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-express-expert, be-nestjs-expert, be-django-expert |
-| SW Engineer/Frontend | 4 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent |
+| SW Engineer/Frontend | 5 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent, fe-design-expert |
 | SW Engineer/Tooling | 3 | tool-npm-expert, tool-optimizer, tool-bun-expert |
 | DE Engineer | 6 | de-airflow-expert, de-dbt-expert, de-spark-expert, de-kafka-expert, de-snowflake-expert, de-pipeline-expert |
-| SW Engineer/Database | 3 | db-supabase-expert, db-postgres-expert, db-redis-expert |
+| SW Engineer/Database | 4 | db-supabase-expert, db-postgres-expert, db-redis-expert, db-alembic-expert |
 | Security | 1 | sec-codeql-expert |
 | SW Architect | 2 | arch-documenter, arch-speckit-agent |
 | Infra Engineer | 2 | infra-docker-expert, infra-aws-expert |
 | QA Team | 3 | qa-planner, qa-writer, qa-engineer |
 | Manager | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
-| System | 2 | sys-memory-keeper, sys-naggy |
-| **Total** | **44** | |
+| System | 3 | sys-memory-keeper, sys-naggy, tracker-checkpoint |
+| Auxiliary | 2 | slack-cli-expert, wiki-curator |
+| **Total** | **49** | |
 
 ## Agent Teams (MUST when enabled)
 
@@ -219,38 +220,23 @@ Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
 
 ## External Dependencies
 
-### Required Plugins
-
-Install via `/plugin install <name>`:
-
-| Plugin | Source | Purpose |
-|--------|--------|---------|
-| superpowers | claude-plugins-official | TDD, debugging, collaboration patterns |
-| openai-docs | superpowers-marketplace | OpenAI and Codex development documentation |
-| elements-of-style | superpowers-marketplace | Writing clarity guidelines |
-| obsidian-skills | - | Obsidian markdown support |
-| context7 | claude-plugins-official | Library documentation lookup |
-
-### Recommended MCP Servers
+### Recommended Codex MCP Servers
 
 | Server | Purpose |
 |--------|---------|
 | omx-memory | Session memory persistence (Chroma-based) |
+| context7 | Library documentation lookup MCP server when a project needs it |
 
 ### Setup Commands
 
 ```bash
-# Add marketplace
-/plugin marketplace add obra/superpowers-marketplace
-
-# Install plugins
-/plugin install superpowers
-/plugin install openai-docs
-/plugin install elements-of-style
-
 # MCP setup (omx-memory)
 npm install -g omx-memory
 omx-memory setup
 ```
 
+### Claude Code Compatibility Note
+
+Projects that run in the Claude Code plugin ecosystem may separately install plugins such as `superpowers`, `openai-docs`, `elements-of-style`, and `context7`. They are not required Codex init steps.
+
 <!-- omcodex:git-workflow -->

package/templates/AGENTS.md.ko

@@ -128,7 +128,7 @@ oh-my-customcodex로 구동됩니다.
 project/
 +-- AGENTS.md                    # 진입점
 +-- .codex/
-|   +-- agents/                  # 서브에이전트 정의 (44 파일)
+|   +-- agents/                  # 서브에이전트 정의 (49 파일)
 |   +-- rules/                   # 전역 규칙 (R000-R020)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
@@ -164,17 +164,18 @@ project/
 |------|------|----------|
 | SW Engineer/Language | 6 | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert |
 | SW Engineer/Backend | 6 | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-express-expert, be-nestjs-expert, be-django-expert |
-| SW Engineer/Frontend | 4 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent |
+| SW Engineer/Frontend | 5 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent, fe-design-expert |
 | SW Engineer/Tooling | 3 | tool-npm-expert, tool-optimizer, tool-bun-expert |
 | DE Engineer | 6 | de-airflow-expert, de-dbt-expert, de-spark-expert, de-kafka-expert, de-snowflake-expert, de-pipeline-expert |
-| SW Engineer/Database | 3 | db-supabase-expert, db-postgres-expert, db-redis-expert |
+| SW Engineer/Database | 4 | db-supabase-expert, db-postgres-expert, db-redis-expert, db-alembic-expert |
 | Security | 1 | sec-codeql-expert |
 | SW Architect | 2 | arch-documenter, arch-speckit-agent |
 | Infra Engineer | 2 | infra-docker-expert, infra-aws-expert |
 | QA Team | 3 | qa-planner, qa-writer, qa-engineer |
 | Manager | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
-| System | 2 | sys-memory-keeper, sys-naggy |
-| **총계** | **44** | |
+| System | 3 | sys-memory-keeper, sys-naggy, tracker-checkpoint |
+| Auxiliary | 2 | slack-cli-expert, wiki-curator |
+| **총계** | **49** | |
 
 ## Agent Teams (MUST when enabled)
 
@@ -219,38 +220,23 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
 
 ## 외부 의존성
 
-### 필수 플러그인
-
-`/plugin install <이름>`으로 설치:
-
-| 플러그인 | 소스 | 용도 |
-|----------|------|------|
-| superpowers | claude-plugins-official | TDD, 디버깅, 협업 패턴 |
-| openai-docs | superpowers-marketplace | Codex CLI 개발 문서 |
-| elements-of-style | superpowers-marketplace | 글쓰기 명확성 가이드라인 |
-| obsidian-skills | - | 옵시디언 마크다운 지원 |
-| context7 | claude-plugins-official | 라이브러리 문서 조회 |
-
-### 권장 MCP 서버
+### Codex 권장 MCP 서버
 
 | 서버 | 용도 |
 |------|------|
 | omx-memory | 세션 메모리 영속성 (Chroma 기반) |
+| context7 | 라이브러리 문서 조회용 MCP 서버 (프로젝트 필요 시 설정) |
 
 ### 설치 명령어
 
 ```bash
-# 마켓플레이스 추가
-/plugin marketplace add obra/superpowers-marketplace
-
-# 플러그인 설치
-/plugin install superpowers
-/plugin install openai-docs
-/plugin install elements-of-style
-
 # MCP 설정 (omx-memory)
 npm install -g omx-memory
 omx-memory setup
 ```
 
+### Claude Code 호환 참고
+
+Claude Code 플러그인 생태계를 쓰는 프로젝트에서는 `superpowers`, `openai-docs`, `elements-of-style`, `context7` 같은 플러그인을 별도로 설치할 수 있습니다. Codex 초기화의 필수 단계는 아닙니다.
+
 <!-- omcodex:git-workflow -->

package/templates/CLAUDE.md

@@ -114,7 +114,7 @@ oh-my-customcodex로 구동됩니다.
 project/
 +-- AGENTS.md                    # 진입점
 +-- .codex/
-|   +-- agents/                  # 서브에이전트 정의 (48 파일)
+|   +-- agents/                  # 서브에이전트 정의 (49 파일)
 |   +-- rules/                   # 전역 규칙 (R000-R022)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
@@ -166,7 +166,7 @@ oh-my-customcodex는 소프트웨어 컴파일과 동일한 구조를 따릅니
 | SW Engineer/Language | 6 | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert |
 | SW Engineer/Backend | 6 | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-express-expert, be-nestjs-expert, be-django-expert |
 | SW Engineer/Frontend | 5 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent, fe-design-expert |
-| SW Engineer/Tooling | 4 | tool-npm-expert, tool-optimizer, tool-bun-expert, slack-cli-expert |
+| SW Engineer/Tooling | 3 | tool-npm-expert, tool-optimizer, tool-bun-expert |
 | DE Engineer | 6 | de-airflow-expert, de-dbt-expert, de-spark-expert, de-kafka-expert, de-snowflake-expert, de-pipeline-expert |
 | SW Engineer/Database | 4 | db-supabase-expert, db-postgres-expert, db-redis-expert, db-alembic-expert |
 | Security | 1 | sec-codeql-expert |
@@ -174,8 +174,9 @@ oh-my-customcodex는 소프트웨어 컴파일과 동일한 구조를 따릅니
 | Infra Engineer | 2 | infra-docker-expert, infra-aws-expert |
 | QA Team | 3 | qa-planner, qa-writer, qa-engineer |
 | Manager | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
-| System | 3 | sys-memory-keeper, sys-naggy, wiki-curator |
-| **총계** | **48** | |
+| System | 3 | sys-memory-keeper, sys-naggy, tracker-checkpoint |
+| Auxiliary | 2 | slack-cli-expert, wiki-curator |
+| **총계** | **49** | |
 
 ## Agent Teams (MUST when enabled)
 

package/templates/CLAUDE.md.en

@@ -131,7 +131,7 @@ NO EXCEPTIONS. NO EXCUSES.
 project/
 +-- AGENTS.md                    # Entry point
 +-- .codex/
-|   +-- agents/                  # Subagent definitions (48 files)
+|   +-- agents/                  # Subagent definitions (49 files)
 |   +-- skills/                  # Skills (109 directories)
 |   +-- rules/                   # Global rules (22 files)
 |   +-- hooks/                   # Hook scripts (security, validation, HUD)
@@ -167,7 +167,7 @@ This is the core oh-my-customcodex philosophy: **"No expert? CREATE one, connect
 | SW Engineer/Language | 6 | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert |
 | SW Engineer/Backend | 6 | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-express-expert, be-nestjs-expert, be-django-expert |
 | SW Engineer/Frontend | 5 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent, fe-design-expert |
-| SW Engineer/Tooling | 4 | tool-npm-expert, tool-optimizer, tool-bun-expert, slack-cli-expert |
+| SW Engineer/Tooling | 3 | tool-npm-expert, tool-optimizer, tool-bun-expert |
 | DE Engineer | 6 | de-airflow-expert, de-dbt-expert, de-spark-expert, de-kafka-expert, de-snowflake-expert, de-pipeline-expert |
 | SW Engineer/Database | 4 | db-supabase-expert, db-postgres-expert, db-redis-expert, db-alembic-expert |
 | Security | 1 | sec-codeql-expert |
@@ -175,8 +175,9 @@ This is the core oh-my-customcodex philosophy: **"No expert? CREATE one, connect
 | Infra Engineer | 2 | infra-docker-expert, infra-aws-expert |
 | QA Team | 3 | qa-planner, qa-writer, qa-engineer |
 | Manager | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
-| System | 3 | sys-memory-keeper, sys-naggy, wiki-curator |
-| **Total** | **48** | |
+| System | 3 | sys-memory-keeper, sys-naggy, tracker-checkpoint |
+| Auxiliary | 2 | slack-cli-expert, wiki-curator |
+| **Total** | **49** | |
 
 ## Agent Teams (MUST when enabled)
 
@@ -221,9 +222,9 @@ Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
 
 ## External Dependencies
 
-### Required Plugins
+### Claude Code Plugins
 
-Install via `/plugin install <name>`:
+Install in Claude Code via `/plugin install <name>`:
 
 | Plugin | Source | Purpose |
 |--------|--------|---------|
@@ -239,7 +240,7 @@ Install via `/plugin install <name>`:
 |--------|---------|
 | omx-memory | Session memory persistence |
 
-### Setup Commands
+### Claude Code Setup Commands
 
 ```bash
 # Add marketplace

package/templates/CLAUDE.md.ko

@@ -131,7 +131,7 @@ oh-my-customcodex로 구동됩니다.
 project/
 +-- AGENTS.md                    # 진입점
 +-- .codex/
-|   +-- agents/                  # 서브에이전트 정의 (48 파일)
+|   +-- agents/                  # 서브에이전트 정의 (49 파일)
 |   +-- skills/                  # 스킬 (109 디렉토리)
 |   +-- rules/                   # 전역 규칙 (22 파일)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
@@ -167,7 +167,7 @@ project/
 | SW Engineer/Language | 6 | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert |
 | SW Engineer/Backend | 6 | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-express-expert, be-nestjs-expert, be-django-expert |
 | SW Engineer/Frontend | 5 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent, fe-design-expert |
-| SW Engineer/Tooling | 4 | tool-npm-expert, tool-optimizer, tool-bun-expert, slack-cli-expert |
+| SW Engineer/Tooling | 3 | tool-npm-expert, tool-optimizer, tool-bun-expert |
 | DE Engineer | 6 | de-airflow-expert, de-dbt-expert, de-spark-expert, de-kafka-expert, de-snowflake-expert, de-pipeline-expert |
 | SW Engineer/Database | 4 | db-supabase-expert, db-postgres-expert, db-redis-expert, db-alembic-expert |
 | Security | 1 | sec-codeql-expert |
@@ -175,8 +175,9 @@ project/
 | Infra Engineer | 2 | infra-docker-expert, infra-aws-expert |
 | QA Team | 3 | qa-planner, qa-writer, qa-engineer |
 | Manager | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
-| System | 3 | sys-memory-keeper, sys-naggy, wiki-curator |
-| **총계** | **48** | |
+| System | 3 | sys-memory-keeper, sys-naggy, tracker-checkpoint |
+| Auxiliary | 2 | slack-cli-expert, wiki-curator |
+| **총계** | **49** | |
 
 ## Agent Teams (MUST when enabled)
 
@@ -221,9 +222,9 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
 
 ## 외부 의존성
 
-### 필수 플러그인
+### Claude Code 플러그인
 
-`/plugin install <이름>`으로 설치:
+Claude Code 환경에서 `/plugin install <이름>`으로 설치:
 
 | 플러그인 | 소스 | 용도 |
 |----------|------|------|
@@ -239,7 +240,7 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
 |------|------|
 | omx-memory | 세션 메모리 영속성 |
 
-### 설치 명령어
+### Claude Code 설치 명령어
 
 ```bash
 # 마켓플레이스 추가

package/templates/guides/agent-eval/README.md

@@ -0,0 +1,48 @@
+# Agent Eval Guide
+
+## Evaluation Order
+
+Agent evaluation uses two phases:
+
+1. **Correctness gate**: verify the task outcome against explicit acceptance criteria.
+2. **Efficiency review**: compare only correctness-passing runs against an ideal trajectory.
+
+Do not optimize step count or latency before correctness is proven.
+
+## Four Metrics
+
+| Metric | Definition | Typical Use |
+|--------|------------|-------------|
+| `correctness` | Passed criteria divided by total criteria | Release or completion gate |
+| `step_ratio` | Observed steps divided by ideal steps | Detect avoidable loops |
+| `tool_call_ratio` | Observed tool calls divided by ideal tool calls | Detect noisy retrieval or tool misuse |
+| `latency_ratio` | Observed duration divided by ideal duration | Detect runtime regressions |
+
+## Ideal Trajectory
+
+```yaml
+task: "create a small routing skill"
+capability: "tool_use"
+ideal:
+  steps: 5
+  tool_calls: 8
+  latency_ms: 180000
+acceptance_criteria:
+  - "Skill frontmatter is valid"
+  - "Routing docs reference the skill"
+  - "Tests or static checks pass"
+```
+
+## Interpreting Ratios
+
+- `1.00`: observed matched the ideal.
+- `< 1.00`: faster or shorter than ideal; verify no evidence was skipped.
+- `1.00-1.25`: usually acceptable.
+- `> 1.25`: advisory improvement candidate.
+- correctness below `1.00`: fail regardless of efficiency.
+
+## Integration
+
+- Use `agent-eval-framework` for task-level scoring.
+- Use `harness-eval` when running repeatable benchmark suites.
+- Use `omcustomcodex:improve-report` to turn repeated ratio regressions into improvement suggestions.

package/templates/guides/agent-eval/index.yaml

@@ -0,0 +1,6 @@
+name: agent-eval
+description: Quantitative agent evaluation with correctness-first 4-metric evidence
+source:
+  type: internal
+files:
+  - README.md

package/templates/guides/browser-automation/README.md

@@ -75,6 +75,18 @@ Capture at least one of:
 
 When summarizing evidence for the model, preserve reference tokens and URLs so follow-up steps can still target the right page elements.
 
+## Build + Vision + Verify Loop
+
+For browser-visible changes, treat a successful build as the start of verification, not the end:
+
+1. Build or start the local app.
+2. Open the page in the available browser surface.
+3. Capture screenshot, console, and network evidence.
+4. Feed concrete failures back to the implementation agent.
+5. Repeat until build, render, and runtime evidence all pass.
+
+This is the Codex Browser Use pattern in portable form. Prefer the in-app Browser Use plugin when available; otherwise use Playwright or the existing browser MCP surface.
+
 ## Design And Strategy Workflows
 
 ### Product strategy sessions

package/templates/guides/index.yaml

@@ -40,6 +40,18 @@ guides:
     source:
       type: internal
 
+  - name: agent-eval
+    description: Quantitative agent evaluation with correctness-first 4-metric evidence
+    path: ./agent-eval/
+    source:
+      type: internal
+
+  - name: multi-agent-debate-patterns
+    description: Anti-groupthink debate patterns for Agora and roundtable-debate workflows
+    path: ./multi-agent-debate-patterns/
+    source:
+      type: internal
+
   # Languages
   - name: golang
     description: Go language reference from Effective Go

package/templates/guides/multi-agent-debate-patterns/README.md

@@ -0,0 +1,26 @@
+# Multi-Agent Debate Patterns
+
+## Pattern Choice
+
+| Pattern | Goal | Use When |
+|---------|------|----------|
+| `agora` | Reach adversarial consensus | Release gates, design approval, high-risk specs |
+| `roundtable-debate` | Preserve dissent | Strategy choices, tradeoffs, ambiguous product or architecture decisions |
+
+## Failure Modes
+
+- **Anchoring**: later reviewers inherit the first opinion.
+- **Groupthink**: reviewers converge because convergence looks productive.
+- **Degeneration of thought**: debate continues without adding new evidence.
+
+## Controls
+
+1. Start with independent parallel analysis.
+2. Assign a devil's advocate.
+3. Protect minority findings unless explicitly rejected with evidence.
+4. Cap debate at two rounds.
+5. Switch from debate to evidence gathering when facts are missing.
+
+## Decision Record
+
+Keep the final recommendation, rejected alternatives, and protected dissent together. Future agents should be able to see not only what was chosen, but which minority risk remains live.

package/templates/guides/multi-agent-debate-patterns/index.yaml

@@ -0,0 +1,6 @@
+name: multi-agent-debate-patterns
+description: Anti-groupthink debate patterns for Agora and roundtable-debate workflows
+source:
+  type: internal
+files:
+  - README.md

package/templates/manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.3.10",
-  "lastUpdated": "2026-04-24T09:10:47.000Z",
+  "version": "0.4.1",
+  "lastUpdated": "2026-04-27T01:00:00.000Z",
   "components": [
     {
       "name": "rules",
@@ -12,19 +12,19 @@
       "name": "agents",
       "path": ".codex/agents",
       "description": "AI agent definitions (flat .md files with prefixes)",
-      "files": 48
+      "files": 49
     },
     {
       "name": "skills",
       "path": ".agents/skills",
       "description": "Reusable skill modules (project-scoped repo skills)",
-      "files": 112
+      "files": 114
     },
     {
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 40
+      "files": 42
     },
     {
       "name": "hooks",

package/templates/workflows/auto-dev.yaml

@@ -29,7 +29,13 @@ steps:
     foreach: release-group
 
   - name: implement
-    prompt: "Execute implementation plan with appropriate agents"
+    prompt: |
+      Execute implementation plan with appropriate agents.
+
+      Codex-native sensitive-path policy:
+      - Codex-managed `.codex/` edits use the normal edit/patch flow.
+      - Do not adopt upstream Claude-only `/tmp` bypass guidance as the default path.
+      - If a port requires `.claude` template parity changes, make the change explicit and verify sensitive-path guard tests.
     description: Execute implementation plan with appropriate agents
     foreach: planned-issue