@kaydash9999/banker-plugins 0.3.0 → 0.5.0

package/skills/deep-init/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: deep-init
+description: "(banker) 코드베이스 전체에 계층형 AGENTS.md 문서를 생성·갱신(부모 역참조·MANUAL 섹션 보존). 'deep-init'/'deepinit'/'AGENTS.md 생성'/'코드베이스 문서화' 시 사용."
+---
+
+# deep-init — 계층형 AGENTS.md 초기화
+
+코드베이스 전 디렉터리에 **AI가 읽는 문서** `AGENTS.md` 를 계층형으로 생성한다. 각 파일은
+상위로 역참조(`<!-- Parent: ../AGENTS.md -->`)해 내비게이션 가능한 트리를 이룬다. (OMC
+`deepinit` 을 banker 로 이식해 **양 런타임**에 제공 — banker `ultra-init`(자율 풀사이클 빌드)과는
+별개다.)
+
+**런타임 매핑 (Claude Code ↔ Codex).** 이 스킬의 핵심 로직(디렉터리 워크 → 부모-우선 생성 →
+MANUAL 보존 병합 → 계층 검증)은 **런타임 무관**(순수 fs + 문서 생성)이다. 서브에이전트 위임만
+런타임별로 갈린다:
+- **Claude Code**: `Task(subagent_type="oh-my-claudecode:explore", model="haiku")`(디렉터리 맵),
+  `architect`(파일 분석), `writer`(문서 생성/쓰기).
+- **Codex(OMX)**: OMX 의 `worker`/`explore` 서브에이전트로 대응.
+- **위임 프레임워크 부재 시**: 위임 없이 **직접**(Read/Write/Bash + `find`/`grep`) 수행 — 성능만
+  저하되고 결과는 동일하다. (deep-init 은 프레임워크 결합이 아니라 순수 파일시스템 작업이다.)
+
+## 핵심 개념
+
+`AGENTS.md` 는 에이전트가 다음을 이해하게 돕는다: 각 디렉터리의 내용, 컴포넌트 관계, 그 영역
+작업 시 특수 지침, 의존성. 루트를 제외한 모든 `AGENTS.md` 는 상위 참조 태그를 포함한다:
+
+```
+/AGENTS.md                       ← 루트(부모 태그 없음)
+├── src/AGENTS.md                ← <!-- Parent: ../AGENTS.md -->
+│   └── src/utils/AGENTS.md      ← <!-- Parent: ../AGENTS.md -->
+└── docs/AGENTS.md               ← <!-- Parent: ../AGENTS.md -->
+```
+
+## AGENTS.md 템플릿
+
+```markdown
+<!-- Parent: {상위_상대경로}/AGENTS.md -->
+<!-- Generated: {timestamp} | Updated: {timestamp} -->
+
+# {Directory Name}
+
+## Purpose
+{이 디렉터리가 담는 것과 역할, 한 문단}
+
+## Key Files
+| File | Description |
+|------|-------------|
+| `file.ts` | 목적 한 줄 |
+
+## Subdirectories
+| Directory | Purpose |
+|-----------|---------|
+| `subdir/` | 내용 (see `subdir/AGENTS.md`) |
+
+## For AI Agents
+### Working In This Directory
+{이 영역 수정 시 특수 지침}
+### Testing Requirements
+{변경 검증 방법}
+### Common Patterns
+{여기서 쓰는 코드 패턴/규약}
+
+## Dependencies
+### Internal
+{의존하는 코드베이스 다른 부분}
+### External
+{핵심 외부 패키지}
+
+<!-- MANUAL: 이 줄 아래 수동 추가 노트는 재생성 시 보존된다 -->
+```
+
+## 실행 워크플로
+
+### Step 1 — 디렉터리 구조 매핑
+`explore`(Claude=`oh-my-claudecode:explore`/haiku, Codex=OMX explore, 부재 시 `find`)로
+재귀 나열. 제외: `node_modules · .git · dist · build · __pycache__ · .venv · coverage · .next · .nuxt`.
+
+### Step 2 — 작업 계획(depth 순)
+디렉터리별 todo 를 깊이 레벨로 조직: Level 0 `/` → Level 1 `/src`,`/docs` → Level 2 … .
+
+### Step 3 — 레벨별 생성 (부모 먼저)
+**부모 레벨을 자식보다 먼저** 생성해 부모 참조가 유효하게 한다. 각 디렉터리: 파일 읽기 → 목적·관계
+분석 → AGENTS.md 생성 → 올바른 부모 참조로 쓰기.
+
+### Step 4 — 기존 파일 비교·갱신
+이미 있으면: 기존 읽기 → 자동생성 섹션 vs `<!-- MANUAL -->` 섹션 식별 → 파일 추가/삭제/구조변경
+비교 → **자동 섹션만 갱신, MANUAL 보존**, timestamp 갱신.
+
+### Step 5 — 계층 검증
+| 검사 | 방법 | 조치 |
+|------|------|------|
+| 부모 참조 해석 | 각 `<!-- Parent: -->` 경로 존재 확인 | 경로 수정/고아 제거 |
+| 고아 AGENTS.md 없음 | 파일 위치 ↔ 디렉터리 구조 대조 | 고아 삭제 |
+| 완전성 | 전 디렉터리에 AGENTS.md 유무 | 누락 생성 |
+| timestamp 최신 | `<!-- Generated: -->` 확인 | 오래된 것 재생성 |
+
+검증 스크립트: `find . -name AGENTS.md -type f` / `grep -r "<!-- Parent:" --include=AGENTS.md .`
+
+## 빈 디렉터리 처리
+| 조건 | 조치 |
+|------|------|
+| 파일·하위 없음 | **건너뜀** (생성 안 함) |
+| 파일 없고 하위 있음 | 하위 목록만 담은 최소 AGENTS.md |
+| 생성물만(*.min.js,*.map) | 건너뜀/최소 |
+| 설정 파일만 | 설정 목적 기술 AGENTS.md |
+
+## 병렬화 규칙
+1. 같은 레벨 디렉터리 → 병렬. 2. 다른 레벨 → 순차(부모 먼저). 3. 큰 디렉터리 → 전용 에이전트.
+4. 작은 디렉터리 → 여러 개를 한 에이전트에 배치.
+
+## 품질 기준
+- **포함**: 정확한 파일 설명·올바른 부모 참조·하위 링크·AI 에이전트 지침.
+- **회피**: 일반 보일러플레이트·틀린 파일명·깨진 부모 참조·중요 파일 누락.
+
+## 함정
+- **부모 먼저** 생성하지 않으면 자식의 부모 참조가 깨진다(Step 3 순서 엄수).
+- `<!-- MANUAL -->` 아래를 재생성이 덮으면 수동 지식 소실 — Step 4 병합 필수.
+- 대량 디렉터리 재스캔 반복 금지(디렉터리 목록 캐시, 변경 없으면 skip).
+
+ARGUMENTS: [대상 경로 / 갱신 범위] (없으면 repo 루트부터 전체)

package/skills/deep-research/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: deep-research
+description: "(banker) 다중 소스 웹 리서치를 팬아웃해 주장을 적대적으로 팩트체크하고 확신순 인용 리포트로 합성. 'deep-research'/'딥리서치'/'심층 조사'/'출처 검증 리서치' 시 사용."
+---
+
+# deep-research — 팬아웃 + 적대적 검증 리서치
+
+질문을 여러 검색 각도로 분해해 병렬 조사하고, 소스를 fetch해 **반증 가능한 주장**을 추출하고,
+각 주장을 **적대적 다표결**로 검증한 뒤, 확신순으로 랭크한 **인용 리포트**로 합성한다.
+
+**런타임 매핑 + 충실도 정직.** 이 스킬의 *로직*(Scope→Search→Fetch→Verify→Synthesize)은 런타임
+무관이나, 구조적 병렬 실행은 런타임 프리미티브에 달렸다:
+- **Claude Code**: 하니스에 번들 `deep-research` 워크플로가 있으면 **그걸 우선**
+  (`Workflow({name:"deep-research", args:"<질문>"})` — 스키마 제약 에이전트 + 진짜 병렬 fan-out).
+  없으면 아래 절차를 `WebSearch`·`WebFetch` + 병렬 `Task` 에이전트로 **수동** 수행.
+- **Codex(OMX)**: OMX `autoresearch`/`autoresearch-goal`/`best-practice-research` 를 **우선** 사용.
+  없으면 아래 절차를 Codex 웹 검색/fetch로 수동 수행.
+- ⚠️ **충실도**: prose 수동 경로는 JS 워크플로의 스키마-제약 병렬 fan-out보다 **충실도가 낮다**
+  (병렬성·정량 투표가 근사됨). 정밀 리서치가 핵심이면 위의 네이티브 워크플로/스킬을 우선하라.
+
+## 언제 쓰나
+- 여러 소스로 **깊이·교차검증**된 사실 기반 리서치 리포트가 필요할 때.
+- 주장마다 출처·확신도가 붙은 결과가 필요할 때.
+
+## 쓰지 않을 때
+- 단발 사실 조회(웹검색 한 번이면 충분).
+- 코드베이스 내부 조사(→ deepsearch/explore).
+- 질문이 과소명세면 **먼저 2~3개 범위 질문**으로 좁힌 뒤 진행(예산·용도·지역 등).
+
+## 절차 (5단계) — 수동 경로 기준
+
+### 1. Scope
+질문을 **~5개 검색 각도**로 분해(상호보완적 관점: 정의/현황·반대근거·정량데이터·사례·시간축 등).
+
+### 2. Search
+각도마다 **병렬** 웹검색(Claude=병렬 `Task`+`WebSearch`, Codex=병렬 조사). 각 에이전트는 서로의
+결과를 모른 채 독립 탐색.
+
+### 3. Fetch
+URL 중복제거 후 상위 **≤15 소스**(`MAX_FETCH=15`) fetch → 각 소스에서 **반증 가능한 주장** 추출.
+
+### 4. Verify (적대적)
+주장마다(≤25개, `MAX_VERIFY_CLAIMS=25`) **3표 검증**(`VOTES_PER_CLAIM=3`): 각 검증자는 주장을
+**반증하도록** 지시. **2/3 이상 반증(`REFUTATIONS_REQUIRED=2`)이면 주장 폐기**. 불확실하면 반증 기본값.
+가능하면 검증자마다 다른 렌즈(정확성·출처신뢰·재현성).
+
+### 5. Synthesize
+의미 중복 주장 병합 → **확신순 랭크** → 소스 인용과 함께 리포트. 살아남은 주장·폐기된 주장·미해결
+불확실성을 구분해 제시.
+
+## 출력 형식
+- **요약**: 핵심 발견 3~5개(확신도 표기).
+- **본문**: 주장별 근거 + 출처(URL/제목) + 확신도. 상충 증거는 병기.
+- **출처 목록**: fetch·인용한 소스.
+- **한계**: 검증 폐기된 주장, 미해결 불확실성, 조사 못 한 각도.
+
+## 함정
+- **적대적 검증 생략 금지** — 그럴듯하나 틀린 주장이 살아남는다(2/3 반증 게이트가 핵심).
+- **단일 검색 각도 의존 금지** — 한 관점은 반드시 놓친다(5각도 병렬).
+- **충실도 과대주장 금지** — 수동 경로면 병렬성·정량투표가 근사임을 리포트에 밝힌다.
+- **과소명세 질문 즉시 착수 금지** — 먼저 범위를 좁혀라.
+
+ARGUMENTS: [리서치 질문] (과소명세면 먼저 범위 질문으로 좁힘)

package/skills/docs-setup/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: docs-setup
+description: "(banker) arch-diagram·pdf-vision-extract 의존성(python-pptx·pymupdf·plantuml)을 python 환경 감지/선택 후 설치. 'docs-setup'/'문서 툴 설치'/'pptx·pymupdf·plantuml 설치' 또는 /banker:setup 시 사용."
+---
+
+# docs-setup — 문서 생성 툴 설치 (python-pptx·pymupdf·plantuml)
+
+arch-diagram(편집 가능 PPTX + PlantUML 렌더)과 pdf-vision-extract(PDF→PNG)가 쓰는 python/java 툴을
+설치한다. **python 환경을 먼저 감지·선택**(질문 또는 자동)하고, system pip 의 sdist 빌드 실패(RHEL8
+헤더 갭 등)를 피하려 **venv/conda 를 우선**한다. 설치는 **멱등**(이미 있으면 skip·검증만). 답변은 한글(기술 토큰 영문).
+
+**런타임:** OS-레벨 설치라 **런타임 무관**(Claude Code·Codex 동일 동작). 선택 UI만 다르다 —
+Claude=`AskUserQuestion`, Codex=후보 목록 제시 후 사용자 응답.
+
+## 0. 감지 (먼저 — 추정 금지)
+```bash
+for t in python3 pip conda java dot; do command -v $t >/dev/null && echo "$t=yes" || echo "$t=no"; done
+[ -f ~/bin/plantuml.jar ] && echo "plantuml.jar=yes" || echo "plantuml.jar=no"
+[ -f /etc/os-release ] && . /etc/os-release && echo "distro=$ID ${VERSION_ID}"
+python3 -c "import pptx" 2>/dev/null && echo "python-pptx=yes" || echo "python-pptx=no"
+python3 -c "import fitz" 2>/dev/null && echo "pymupdf=yes" || echo "pymupdf=no"
+# 후보 python 스캔 (⚠️ pymupdf/playwright 는 python 3.8+ 필요 — 3.6/3.7 은 휠 없음)
+for v in 3.13 3.12 3.11 3.10 3.9 3.8; do command -v python$v >/dev/null && echo "python$v=$(python$v --version 2>&1)"; done
+ls -d ~/.venvs/*/bin/python ~/miniconda3/envs/*/bin/python /usr/bin/python3* 2>/dev/null
+conda env list 2>/dev/null
+```
+
+## 1. python 환경 선택 (질문 또는 자동)
+- **`--python <path>`**: 주어진 인터프리터 사용.
+- **`--ask`**: 위 스캔 후보를 제시하고 사용자가 택함(Claude=`AskUserQuestion`, Codex=목록 제시).
+- **자동(기본)**: **python 3.8+** 인터프리터로 전용 venv 를 만든다. ⚠️ **system `python3` 가 3.6/3.7 이면 pymupdf/playwright 휠이 없어 실패**(실측: RHEL8 기본 `python3`=3.6 → `No matching distribution`/sdist 빌드 실패) → 위 스캔의 `python3.12`/`python3.11` 등 최신을 우선. 우선순위 = 활성 conda 환경 > 기존 `~/.venvs/banker-docs` > **최신 python3.x 신규 venv**:
+  ```bash
+  PY_BASE="$(command -v python3.12 || command -v python3.11 || command -v python3)"   # 3.8+ 우선
+  "$PY_BASE" -m venv ~/.venvs/banker-docs
+  ~/.venvs/banker-docs/bin/pip install -U pip        # 최신 pip = wheel 우선(빌드 회피)
+  PY=~/.venvs/banker-docs/bin/python
+  ```
+  conda 선호 시: `conda create -y -n banker-docs python=3.11 && PY=$(conda run -n banker-docs which python)`.
+
+## 2. python 라이브러리 설치
+```bash
+"$PY" -m pip install -U python-pptx pymupdf     # 최신 pip 면 wheel 로 설치(빌드 없음)
+```
+- 그래도 빌드 실패(휠 부재·헤더 부재)면 **정직 보고**: root 면 `dnf install -y gcc zlib-devel libjpeg-turbo-devel`(Pillow 빌드용) 후 재시도, 아니면 conda 경로 권장(가짜 성공 금지).
+
+## 3. plantuml (arch-diagram 의 PlantUML 렌더)
+java 필요(`java -version`). plantuml.jar + 래퍼:
+```bash
+mkdir -p ~/bin
+[ -f ~/bin/plantuml.jar ] || curl -fsSL -o ~/bin/plantuml.jar \
+  https://github.com/plantuml/plantuml/releases/latest/download/plantuml.jar
+cat > ~/bin/plantuml <<'EOF'
+#!/bin/bash
+exec java -jar "$HOME/bin/plantuml.jar" "$@"
+EOF
+chmod +x ~/bin/plantuml
+grep -q 'HOME/bin' <<<"$PATH" || echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
+```
+- **graphviz(dot)**: PlantUML 의 일부 다이어그램(시퀀스 외)이 요구. `dnf install -y graphviz`(root) / `brew install graphviz`(mac). 없으면 시퀀스·컴포넌트류는 dot 없이 렌더됨(정직 안내).
+- java 부재: `dnf install -y java-21-openjdk`(root) / `brew install openjdk` / 관리자 요청.
+
+## 4. 소비 스킬 연결
+- **arch-diagram**: `build_pptx_template.py` 를 위 `$PY`(python-pptx)로 실행. PlantUML 은 `~/bin/plantuml`.
+- **pdf-vision-extract**: pymupdf(`import fitz`)를 `$PY` 로 실행.
+- 선택한 인터프리터 경로를 **보고**하고, 소비 스킬 실행 시 그 python 을 쓰도록 안내(예: `~/.venvs/banker-docs/bin/python`). 설치 python 과 소비 python 이 달라지면 `ModuleNotFoundError`.
+
+## 5. 검증 (보고 의무)
+```bash
+"$PY" -c "import pptx, fitz; print('pptx', pptx.__version__, '| pymupdf OK')"
+~/bin/plantuml -version 2>/dev/null | head -1 || java -jar ~/bin/plantuml.jar -version 2>/dev/null | head -1
+command -v dot >/dev/null && dot -V 2>&1 | head -1 || echo "graphviz(dot) 없음(시퀀스류는 OK)"
+```
+4-field 보고: 변경(설치 항목·venv 경로·env 파일) / Evidence(위 출력) / 검증(import·-version OK) / Unknown(관리자 권한 라이브러리 미설치 등).
+
+## 함정
+- **system pip 빌드 벽**: RHEL8 등에서 Pillow sdist 빌드 실패 → 최신 pip + venv 로 **wheel** 설치가 안전. 안 되면 dnf dev 헤더 or conda(정직 보고).
+- **python 경로 혼선**: 설치 python 과 소비 스킬 python 이 다르면 `ModuleNotFoundError` → 선택한 `$PY` 명시·재사용.
+- **plantuml java/dot 의존**: java 없으면 렌더 불가, dot 없으면 일부 다이어그램만 제한 → 정직 안내.
+- **PATH 미적용**: `~/.bashrc` 는 새 셸에만 → 현재 셸엔 `source ~/.bashrc` 또는 절대경로.
+
+ARGUMENTS: [--python <path>] [--ask] (없으면 자동 감지 — 전용 venv 우선)

package/skills/harness-factory/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: harness-factory
+description: "(banker) revfactory/harness(팀 아키텍처 팩토리) 플러그인 설치·구성·사용안내. Claude=harness@harness-marketplace, Codex=meta-harness. 'harness-factory'/'하네스 팩토리'/'에이전트팀 생성' 또는 /banker:setup 시 사용."
+---
+
+# harness-factory: revfactory/harness 팀 아키텍처 팩토리 설치·구성
+
+`harness`는 도메인을 한 줄로 받아 `.claude/agents/`+`.claude/skills/`(전문 에이전트팀 + 그 에이전트가 쓸
+스킬)를 생성하는 **메타 스킬**이다. 이 플러그인의 본체는 설치물이 아니라 **방법론**이다. 따라서 이
+스킬은 설치에서 그치지 않고 구성(experimental flag 영속화)과 사용 안내(모드·패턴·비용 가드)까지
+책임진다. 이미 설치돼 있으면 갱신·재확인만 한다(멱등). 답변은 한글.
+
+## 런타임 배선
+- **Claude Code** = `revfactory/harness` 플러그인(마켓플레이스 설치, 네이티브 팀 프리미티브 사용).
+- **Codex** = `SaehwanPark/meta-harness`(별개 레포·Python 인스톨러·파일 handoff). Codex엔 네이티브 팀
+  프리미티브가 없어 파일 기반 순차 handoff로 우회한다(banker의 OMX 패턴과 동일 원리).
+
+## 0. 감지 (먼저, 추정 금지)
+```bash
+command -v claude >/dev/null && claude --version || echo "claude: 미설치"
+ls -la .claude/agents .claude/skills 2>/dev/null   # 기존 harness 산출물 흔적 감사
+```
+- **v2.1.178 경계 주의**: 그 이후 버전은 `TeamCreate`/`TeamDelete` 도구가 제거되고 팀이 세션 시작 시
+  자동 구성된다. harness SKILL.md·OMC 문서의 `TeamCreate` 호출 예시가 현행 CLI와 어긋날 수 있다.
+  버전을 확인하고 **불일치 가능성을 사용자에게 정직히 고지**한다(가짜 확신 금지).
+- 기존 `.claude/agents/`·`.claude/skills/`·`CLAUDE.md`에 harness 흔적이 있으면 신규 생성이 아니라
+  확장·유지보수로 다룬다(harness 자신의 Phase 0 감사 원칙).
+
+## 1. 설치
+### Claude Code
+세션 안(슬래시 커맨드):
+```
+/plugin marketplace add revfactory/harness
+/plugin install harness@harness-marketplace
+/reload-plugins
+```
+- **정답 슬러그는 `harness@harness-marketplace` 하나뿐이다.** 하드코딩한다. 저장소 문서가 3-way로
+  어긋나 있으니(KO/JA README=`harness-marketplace`[`harness@` 접두 누락], quickstart=`harness@harness`
+  [마켓플레이스 접미 오류]) 그대로 복붙하지 말 것.
+- 설치 전 `claude plugin marketplace list`로 등록명을 재확인한다.
+- 대안(마켓플레이스 없이 글로벌 스킬 직접 설치): `cp -r skills/harness ~/.claude/skills/harness`.
+
+### Codex CLI
+마켓플레이스 개념이 없고 Python 인스톨러를 쓴다:
+```bash
+git clone https://github.com/SaehwanPark/meta-harness
+cd meta-harness
+python3 scripts/install_harness.py --scope user --layout codex
+# 프로젝트 범위: python3 scripts/install_harness.py --scope project --target <repo> --layout codex
+```
+
+## 2. 구성 (핵심)
+팀 프리미티브는 **experimental flag로 게이트**된다. 셸 세션이 아니라 `settings.json`에 영속화한다:
+```json
+{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }
+```
+- 셸 `export`는 **그 셸에서 띄운 claude에만** 적용되어 재시작 후 유실된다. 반드시 `settings.json`
+  `env`에 기록해야 영속한다.
+- 미설정 시 **에러 없이 조용히 단일 에이전트로 폴백**되어 Pipeline/Fan-out-in/Supervisor/Hierarchical
+  패턴이 소리 없이 깨진다(harness 관리자가 `docs/experimental-dependency.md`에 공식 인정). Claude Code
+  v2.x+ 필요.
+
+## 3. 사용 안내 (요약; 심층은 설치된 플러그인 references/ 위임)
+> harness 자신이 6종 references/(패턴 카탈로그·오케스트레이터 템플릿·팀 예시·skill writing/testing·QA)로
+> Progressive Disclosure한다. 여기서는 요약만 담고, 깊이는 설치된 플러그인의 references/를 읽게 위임한다
+> (상류 문서를 verbatim 복사하지 않는다).
+
+**(a) 모드 결정트리** (team / subagent / hybrid):
+- 2+ 에이전트 + 실시간 상호통신(교차검증·발견 공유)이 가치를 더하면 → **team**.
+- 단일 작업·독립 병렬·결과만 반환이면 → **subagent**(경량·토큰효율).
+- 공식 비용지침: **순차·동일 파일 편집·의존성 많은 작업은 subagent/단일세션이 유리**하다. harness의
+  "2+면 팀 기본"과 어긋날 수 있으니, 팀이 정말 필요한지 재확인하는 게이트를 둔다.
+
+**(b) 6개 아키텍처 패턴**(1줄):
+- **Pipeline** (순차 의존): n 출력이 n+1 입력.
+- **Fan-out/Fan-in** (병렬+집계): 팀모드가 가장 자연스럽다.
+- **Expert Pool** (라우팅 택1): 라우터가 입력 분류 후 전문가 하나 호출, subagent 적합.
+- **Producer-Reviewer** (생성·검증): 재시도 캡 2-3(무한루프 방지).
+- **Supervisor** (동적 분배): 중앙이 런타임 조건으로 워커 배정.
+- **Hierarchical** (재귀 위임): 깊이 ≤ 2(3+는 지연·컨텍스트 손실).
+
+**(c) 비용 가드**: 팀 실행은 단일세션 대비 **약 7× 토큰**(공식). 그러므로:
+- 팀 규모 **3-5명**(집중된 3명 > 분산된 5명).
+- 워커 모델은 **Sonnet** 기본.
+- 작업 완료 즉시 종료. spawn 프롬프트는 간결하게.
+
+## 4. 리스크 고지
+harness는 실험적 팀 API에 의존한다. `docs/experimental-dependency.md`가 3시나리오를 자체 정의한다:
+- **A** 플래그 제거(GA 승격) / **B** Managed Agents 서버사이드 실행으로 대체 / **C** 하위호환 없는
+  시그니처 변경.
+- **C는 v2.1.178에서 사실상 현실화된 정황이다**(`TeamCreate`/`TeamDelete` 제거). 설치 시 "실험적 기능
+  의존"이라는 사실을 반드시 드러낸다.
+- **부작용(read-only 아님)**: 실행 시 사용자 프로젝트에 파일을 직접 생성한다(`.claude/agents/`·
+  `.claude/skills/`·중간산출물 `_workspace/`). 기존 파일 충돌 처리·CLAUDE.md 포인터 등록을 안내한다.
+
+## 검증 (보고 의무)
+1. **산출물**: `ls -la .claude/agents .claude/skills` 로 에이전트/스킬 파일이 실제 생성됐는지.
+2. **flag 영속**: `settings.json`에 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`이 기록됐는지.
+3. **팀 스폰**: 간단한 샘플 태스크로 **팀이 실제로 스폰되는지**(무증상 단일 에이전트 폴백이 아닌지).
+4. **Codex**: meta-harness 산출물(스킬·`_workspace/` handoff)이 생성됐는지.
+
+보고는 4필드로 한다: **감지(버전·기존흔적) · 설치(플러그인 or meta-harness) · 구성(flag 영속) ·
+검증(산출물·팀스폰)**. 실패·불명확은 정직 보고(가짜 성공 금지).
+
+## 함정
+- **3-way 설치명령 버그**: 유일 정답은 `harness@harness-marketplace`. KO/JA README·quickstart는 틀림.
+- **무증상 폴백**: flag 없으면 팀 패턴이 조용히 단일 에이전트로 저하(에러 안 남).
+- **비용 7×**: 팀은 고토큰. 규모·모델·종료 가드 없이 돌리지 말 것.
+- **버전 drift**: v2.1.178에서 `TeamCreate`/`TeamDelete` 제거. 상류 문서의 팀 호출 예시가 현행과 어긋남.
+- **릴리스/태그 0건**: GitHub Releases·Tags 모두 없음. 버전 근거는 오직 `plugin.json`의 `1.2.0`.
+- **라이선스 Apache-2.0**: 연동·참조이지 banker 재배포가 아니다. 상류 references/를 verbatim 복사하지
+  않고 설치된 플러그인 자체를 가리킨다.
+
+ARGUMENTS: `[--scope user|project]` (Codex meta-harness 설치 범위; 기본 user)

package/skills/humanizer/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: humanizer
 version: 2.8.0
-description: "AI가 쓴 듯한 영문 글(em-dash 남발·rule-of-three·홍보성 표현·수동태 등)을 제거해 사람이 쓴 자연스러운 문체로 윤문 — 'humanizer'/'remove AI writing'/'sound more human'/'natural' 시 사용."
+description: "(banker) AI가 쓴 듯한 영문 글의 흔적을 제거해 자연스러운 문체로 윤문. 'humanizer'/'remove AI writing'/'sound more human'/'natural' 시 사용."
 license: MIT
 compatibility: claude-code opencode
 allowed-tools:

package/skills/lineage/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: lineage
-description: "현재 세션 대화를 카카오톡 스타일 단일 HTML 파일로 export(답변=1줄 요약+클릭 펼침) — 'lineage'/'대화 export'/'카톡 스타일 html' 시 사용."
+description: "(banker) 현재 세션 대화를 카카오톡 스타일 단일 HTML로 export(답변=1줄 요약+클릭 펼침). 'lineage'/'대화 export'/'카톡 스타일 html' 시 사용."
 invocation: /lineage
 version: 1.0.0
 schema_version: 1

package/skills/make-notion-guide/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: make-notion-guide
-description: "프로젝트의 실제 API/인터페이스를 노션 체크박스 토글 양식의 개발자 호출 가이드 문서로 작성 — 'make-notion-guide'/'노션 가이드'/'API 호출 문서를 노션 양식' 시 사용."
+description: "(banker) 실제 API/인터페이스를 노션 토글 양식의 개발자 호출 가이드로 작성. 'make-notion-guide'/'노션 가이드'/'API 호출 문서를 노션 양식' 시 사용."
 ---
 
 # Make-Notion-Guide: 노션 양식 개발자 가이드 작성

package/skills/nothing-design/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: nothing-design
-description: "Nothing 브랜드 스타일(미니멀·도트매트릭스·모노크롬)의 UI 디자인을 적용 — 'Nothing style'/'Nothing design'/'/nothing-design' 시 사용. 일반 UI 작업에서 자동 트리거 금지."
+description: "(banker) Nothing 브랜드 스타일(미니멀·도트매트릭스·모노크롬) UI 디자인 적용. 'Nothing style'/'Nothing design'/'/nothing-design' 시 사용(일반 UI 작업 자동 트리거 금지)."
 version: 3.0.0
 allowed-tools: [Read, Write, Edit, Glob, Grep]
 ---

package/skills/omc-reference/SKILL.md

@@ -1,12 +1,14 @@
 ---
 name: omc-reference
-description: "OMC 에이전트 카탈로그·사용 가능 툴·팀 파이프라인·커밋 규약·스킬 레지스트리 레퍼런스 — 에이전트 위임·OMC 툴·팀·커밋·스킬 사용 시 자동 로드."
+description: "(banker) OMC/OMX 에이전트·툴·팀·커밋·스킬 레지스트리 레퍼런스(양 런타임 병기). 에이전트 위임·OMC/OMX 툴·팀·커밋·스킬 사용 시 자동 로드."
 user-invocable: false
 ---
 
 # OMC Reference
 
-Use this built-in reference when you need detailed OMC catalog information that does not need to live in every `CLAUDE.md` session.
+Use this built-in reference when you need detailed agent/tool/skill catalog information that does not need to live in every `CLAUDE.md` / `AGENTS.md` session.
+
+**런타임 — 이 문서는 양 런타임 카탈로그를 병기한다.** Claude Code는 **OMC(oh-my-claudecode)**, Codex CLI는 대응 프레임워크 **OMX(oh-my-codex)** 를 쓴다. 아래 §Agent Catalog ~ §Commit Protocol 은 **OMC(Claude)** 기준이고, 말미의 **§OMX (Codex) Catalog** 에 OMX 대응 카탈로그를 실측 정리했다. 이름이 대체로 대응하나 1:1은 아닐 수 있으니 설치 환경(`~/.claude` ↔ `~/.codex`) 기준으로 확인하라.
 
 ## Agent Catalog
 
@@ -139,3 +141,34 @@ Confidence: high
 Scope-risk: narrow
 Not-tested: End-to-end plugin marketplace install in a fresh Claude profile
 ```
+
+## OMX (Codex) Catalog
+
+**런타임:** oh-my-codex(OMX), Codex CLI. 설치/점검 `omx setup` · `omx doctor`. 스킬은
+`~/.codex/skills/<name>/SKILL.md`(**dir == frontmatter name**)를 자동탐색. 실측 기준 oh-my-codex
+0.18.16 — 버전에 따라 목록이 바뀔 수 있으니 설치 환경에서 확인.
+
+### OMX Agent Prompts
+`~/.codex/prompts/*.md` (OMX 오케스트레이션이 사용). OMC 에이전트에 대응 + Codex 확장:
+- 대응: `analyst` · `architect` · `critic` · `debugger` · `executor` · `verifier` · `explore` · `planner` · `git-master` · `designer` · `qa-tester` · `security-reviewer` · `test-engineer` · `writer` · `code-reviewer` · `code-simplifier`
+- 확장: `vision` · `researcher` · `ux-researcher` · `product-manager` · `product-analyst` · `information-architect` · `dependency-expert` · `api-reviewer` · `performance-reviewer` · `quality-reviewer` · `quality-strategist` · `style-reviewer` · `scholastic` · `team-orchestrator` · `team-executor` · `build-fixer` · `sisyphus-lite` · `prometheus-strict-{metis,momus,oracle}`
+
+### OMX Skills Registry
+`$<name>` 로 호출:
+- **오케스트레이션**: `ralph` · `ralplan` · `ultraqa` · `ultrawork` · `ultragoal` · `autopilot` · `team` · `swarm` · `pipeline` · `tdd` · `ai-slop-cleaner` · `visual-ralph` · `visual-verdict` · `ralph-init`
+- **리서치/분석**: `autoresearch` · `autoresearch-goal` · `best-practice-research` · `deepsearch` · `analyze` · `trace`
+- **자문/리뷰**: `ask`(로컬 Claude/Gemini 자문 통합 진입점; 구 `ask-claude`·`ask-gemini` 스킬도 병존) · `review` · `code-review` · `security-review`
+- **셋업/유틸**: `omx-setup` · `doctor` · `hud` · `wiki` · `note` · `skill` · `help` · `configure-notifications` · `ecomode` · `design` · `frontend-ui-ux` · `web-clone` · `build-fix` · `performance-goal` · `prometheus-strict` · `deep-interview` · `worker`
+
+### OMX Interfaces
+- **스킬**: `~/.codex/skills/<name>/`(dir==name). **커맨드/프롬프트**: `~/.codex/prompts/<name>.md`(스킬 목록과 별개 표면).
+- **외부 LLM**: `$ask`(로컬 Claude/Gemini CLI 자문).
+- **MCP**: `codex mcp add <NAME> (--url <URL> | -- <COMMAND>...)`.
+- **`/copy` 등 슬래시 명령은 Codex TUI 내장**(컴파일 바이너리 — `~/.codex/skills`·`prompts`·`--help` 목록엔 안 뜸).
+- ⚠️ `~/.codex/AGENTS.md` 본문은 `omx setup/doctor` 가 재생성 → **직접 쓰지 말 것**(조각 소실).
+
+### OMC ↔ OMX 대응
+OMC(Claude) ↔ OMX(Codex) 는 대체로 대칭이다: `claude mcp`↔`codex mcp`, `~/.claude`↔`~/.codex`,
+`/copy`(양쪽 내장), 에이전트/스킬 이름 대응(1:1은 아님). banker/join-us 스킬은 양 런타임에 동일
+본문으로 배포되며(Codex 복사 시 frontmatter `name:`만 `<plugin>-<name>` 으로 재작성) 본문이
+**런타임 인식**으로 두 형태를 병기한다.

package/skills/pdf-vision-extract/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pdf-vision-extract
-description: "비주얼 위주 PDF(UI 목업·디자인 스펙·다이어그램)를 고해상도 per-page PNG로 변환해 레이아웃 손실 없이 비전 입력으로 읽기 — 'pdf-vision-extract'/'PDF를 이미지로'/'디자인 PDF 추출' 시 사용."
+description: "(banker) 비주얼 위주 PDF를 고해상도 per-page PNG로 변환해 레이아웃 손실 없이 비전 입력으로 읽기. 'pdf-vision-extract'/'PDF를 이미지로'/'디자인 PDF 추출' 시 사용."
 ---
 
 # pdf-vision-extract

package/skills/play-qa/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: play-qa
-description: "Godot HTML5 웹게임을 실제 브라우저에서 직접 플레이하며 렌더·입력·시작 실패 등 객관 결함을 QA(playwright) — 'play-qa'/'게임 직접 qa'/'네가 직접 플레이해봐'/'in-browser 플레이테스트' 시 사용."
+description: "(banker) Godot HTML5 웹게임을 실제 브라우저에서 직접 플레이하며 렌더·입력·시작 결함을 QA(playwright). 'play-qa'/'게임 직접 qa'/'네가 직접 플레이해봐'/'in-browser 플레이테스트' 시 사용."
 ---
 
 # play-qa: 에이전트가 직접 브라우저에서 게임을 플레이·QA

package/skills/ralph-qa/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: ralph-qa
+description: "(banker) 작업 결과를 별도 세션·다른 LLM으로 ralplan+critic 로직으로 독립 검증/개선 반복(자기승인 방지). 'ralph-qa'/'교차검증'/'다른 LLM으로 검증'/'독립 QA' 시 사용."
+---
+
+# ralph-qa — 교차-LLM 독립 검증 루프
+
+방금 만든 작업 결과를 **같은 모델·같은 세션이 자기채점**하는 대신, **다른 LLM + 다른 세션**에
+넘겨 `ralplan --deliberate`(설계 optimal 검토)와 `ralph --critic=critic`(수용 기준 검증) 로직을
+적용하고, 지적을 반영해 **APPROVE까지 반복**한다. 핵심 가치는 **독립성**(anti-self-approval):
+저자와 검증자가 다른 모델이라야 편향·맹점이 드러난다.
+
+**런타임 매핑 (다른-LLM 경로).**
+- **Claude Code(OMC)**: `omc ask codex --agent-prompt critic "..."`(= ralph의 `--critic=codex` 경로),
+  또는 `/ccg`(Codex+Gemini+Claude 합의 레인), 또는 `omc ask gemini`. 검증자 = **Codex/Gemini**.
+- **Codex(OMX)**: OMX `$ask`(구 `ask-claude`/`ask-gemini` 통합 진입점) 로 **Claude/Gemini** 에게 검증 위임.
+- 저자 런타임과 **다른** 모델을 고르는 게 목적 — 대응 경로가 없으면 최소한 **다른 세션·다른 에이전트
+  프롬프트**로라도 독립성을 확보한다(완전 독립엔 미달임을 명시).
+
+**모델·effort.** `--model <id>` 로 검증 LLM을 지정(예: 강한 추론 모델). effort 지원 모델은
+`--effort xhigh` 전달. ⚠️ 사용자가 예로 든 `gpt-5.6-sol` 은 **미인식 모델 ID** — 리터럴로 박지 말고
+**설치 환경에서 사용 가능한 다른-LLM으로 파라미터화**하라(기본은 위 매핑의 기본 경로).
+
+## 언제 쓰나
+- 방금 완성한 구현/설계/문서를 **배포·확정 전** 독립 검증하고 싶을 때.
+- ralph/all-in-one이 끝난 뒤 **다른 모델의 시각**으로 한 번 더 거르고 싶을 때.
+- 되돌리기 어렵거나 파급 큰 산출물(마이그레이션·공개 API·배포물).
+
+## 쓰지 않을 때
+- 사소한 변경(교차-LLM 왕복 비용이 이득을 초과).
+- 다른 LLM 프로바이더 auth가 없고 대체 독립 경로도 없을 때(→ 최소 같은-런타임 `critic` 에이전트로 폴백).
+
+## 워크플로
+
+### 1. 입력 확보
+검증 대상 = {작업 결과 요약 + **수용 기준(acceptance criteria)** + 변경 파일 목록 + 관련 코드}.
+기준이 없으면 원 작업에서 도출(vague "잘 됐나?" 금지 — 검증 가능한 기준으로).
+
+### 2. 다른 LLM·다른 세션으로 위임 (독립성)
+위 런타임 매핑 경로로 **두 렌즈**를 함께 요청(`--lens` 로 선택, 기본 both):
+- **ralplan --deliberate 렌즈**: 이 접근이 **optimal** 한가? 더 단순·빠르·유지보수 좋은 대안이 있나?
+  프리모템 3시나리오, 원칙 위반 여부.
+- **ralph --critic=critic 렌즈**: **수용 기준 하나하나**를 신선한 증거로 검증. 변경 파일뿐 아니라
+  **관련 코드(호출자·피호출자·공유 타입·인접 모듈)** 까지 검토.
+
+### 3. 판정 수신 → 반영
+외부 LLM의 판정(`APPROVE` / `ITERATE` / `REJECT`)과 구체 이슈를 받는다. `APPROVE` 아니면:
+원 런타임에서 이슈 수정 → **같은 외부 LLM으로 재검증**(2단계 반복).
+
+### 4. 종료
+- `APPROVE` → 검증 통과 보고(검증자 모델·판정 근거 명시).
+- 같은 이슈가 **3회+ 재발** → 근본 블로커로 보고(무한루프 금지).
+- auth/프로바이더 장애 → 정직히 보고하고 폴백 경로 안내(같은-런타임 critic).
+
+## 플래그
+| 플래그 | 효과 | 기본 |
+|---|---|---|
+| `--model <id>` | 검증 LLM 모델 지정 | 런타임 매핑 기본 경로 |
+| `--effort xhigh` | effort 지원 모델에 전달 | 미지정 |
+| `--lens=critic\|plan\|both` | 적용 렌즈 | both |
+| `--max=N` | 최대 반복 | 5 |
+
+## 함정
+- **자기채점 금지가 본질** — 저자 모델·세션으로 검증하면 독립성이 사라진다. 반드시 **다른 LLM**.
+- **auth env**: 비대화형 셸은 `~/.bashrc` 미로드로 프로바이더 토큰이 없으면 `401`(스킬 문제 아님).
+  `source ~/.bashrc` 후 교차-LLM 호출. 토큰 자체가 없으면 폴백 경로로.
+- **모델명 하드코딩 금지** — 예시 모델(`gpt-5.6-sol` 등)을 리터럴로 박지 말고 파라미터화.
+- **수용 기준 없이 검증 금지** — "잘 됐나?"가 아니라 검증 가능한 기준 대비 판정.
+
+ARGUMENTS: [--model <id>] [--effort xhigh] [--lens=critic|plan|both] [--max=N] [검증 대상/기준]

package/skills/ready-compact/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ready-compact
-description: "컨텍스트 compaction 직전 진행 상태를 저장하고, 이후 붙여넣어 끊김 없이 이어갈 resume 프롬프트를 생성 — 'ready-compact'/'compact 준비'/'이어서 하게 준비'/'이어갈 프롬프트' 시 사용."
+description: "(banker) 컨텍스트 compaction 직전 진행 상태를 저장하고 이어갈 resume 프롬프트를 생성. 'ready-compact'/'compact 준비'/'이어서 하게 준비'/'이어갈 프롬프트' 시 사용."
 ---
 
 # ready-compact — compaction 전 상태 저장 + resume 프롬프트

package/skills/refresh-git-ignore/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: refresh-git-ignore
-description: "현재 repo의 .gitignore를 비파괴·반복가능하게 갱신(런타임/빌드 아티팩트만 추가, 추적 중 파일 보호) — 'refresh-git-ignore'/'.gitignore 갱신·정리'/'git status 잡음 줄여' 시 사용."
+description: "(banker) repo의 .gitignore를 비파괴·반복가능하게 갱신(런타임/빌드 아티팩트만 추가, 추적 파일 보호). 'refresh-git-ignore'/'.gitignore 갱신·정리'/'git status 잡음 줄여' 시 사용."
 ---
 
 # refresh-git-ignore — .gitignore 안전 갱신

package/skills/rfp-author/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rfp-author
-description: "소프트웨어 외주 제안요청서(RFP)를 한국 공공/금융 + 국제 SW외주 + AI/LLM 골격으로 저작(검증 reference·채울 템플릿 번들) — 'rfp'/'제안요청서'/'RFP 작성'/'외주 RFP' 시 사용."
+description: "(banker) 소프트웨어 외주 제안요청서(RFP)를 한국 공공/금융+국제+AI/LLM 골격으로 저작. 'rfp'/'제안요청서'/'RFP 작성'/'외주 RFP' 시 사용."
 ---
 
 # rfp-author — 외주 제안요청서(RFP) 저작 (요건 발의형 기본)

package/skills/setup-insane-search/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: setup-insane-search
-description: "insane-search(차단·봇방어 사이트 우회 검색·페치) 플러그인 설치. Claude Code=gptaku_plugins 마켓플레이스, Codex=gptaku-codex 마켓플레이스. 'setup-insane-search'/'insane-search 설치' 또는 /banker:setup 시 사용."
+description: "(banker) insane-search(차단·봇방어 사이트 우회 검색·페치) 플러그인 설치(Claude=gptaku_plugins, Codex=gptaku-codex). 'setup-insane-search'/'insane-search 설치' 또는 /banker:setup 시 사용."
 ---
 
 # setup-insane-search: insane-search 플러그인 설치