@kaydash9999/banker-plugins 0.1.3 → 0.2.0

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Claude Code skills + commands — QA, audit, docs, architecture, dependency setup, and wiki; the banker plugin marketplace.",
-    "version": "0.1.3"
+    "version": "0.2.0"
   },
   "plugins": [
     {

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "banker",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Claude Code plugin: QA/audit/docs/architecture skills + commands, a /banker:setup installer for OS dependencies (playwright, etc.), and wiki compaction.",
   "author": {
     "name": "smallOpenSource",

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.2.0] - 2026-07-01
+
+### Fixed
+- **Codex 스킬 미표시(#5)**: `banker setup --codex` 가 스킬을 `~/.codex/skills/banker-<name>/` 로 복사할 때 SKILL.md 프론트매터 `name:` 을 `banker-<name>` 로 재작성한다. Codex는 스킬 디렉터리명과 `name:` 일치를 요구하는데, 기존에는 `name: <name>` 그대로라 Codex가 스킬을 인식하지 못했다. `banker doctor` 에 dir==name 검증·경고와 "codex 있는데 banker 스킬 0개" 경고 추가.
+
+### Changed
+- **업데이트 시 중복 제거(#6)**: `banker setup --codex` 가 설치 전 기존 `banker-*` 스킬·프롬프트를 먼저 정리(sweep)한 뒤 클린 재설치한다. 매니페스트에서 제거·개명된 스킬의 옛 버전이 잔존하지 않는다.
+- **의존성 사전 안내(#2·#4)**: `all-in-one`·`ultra-init`·`front-qa` 에 OMC(Claude)/OMX(Codex) 전제조건 프리플라이트, 브라우저 스킬(`audit-web-page`·`game-qa`·`ultra-ui-qa`)에 playwright 전제조건 프리플라이트를 추가했다. 의존성이 없으면 "설치부터" 안내한 뒤 진행한다.
+- **README 재작성(#1)**: 과장·AI 흔적 표현을 덜어내고(과장 태그라인·불필요한 em dash 정리) 간결하고 정중한 문체로 정리했다. 빠른 시작에 Claude Code·Codex 양쪽 설치 경로를 명시하고, 라이선스/서드파티 섹션을 번들 코드(humanizer)·의존 라이브러리·연동 대상 3범주로 확장했다.
+- `sync-version` 이 `.claude-plugin/marketplace.json` 의 `metadata.version` 까지 동기화한다(과거 수동 갱신 제거).
+
+### Added
+- **`setup-omc` 스킬**: `all-in-one`·`ultra-init`·`front-qa` 가 의존하는 oh-my-claudecode(OMC)를 설치·갱신한다(Codex는 OMX `omx setup`). `/banker:setup` 멀티셀렉트에 옵션으로 추가.
+- **`setup-insane-search` Codex 지원(#7)**: `target: both` 로 승격했다. Claude는 `insane-search@gptaku-plugins`, Codex는 `codex plugin add insane-research-codex@gptaku-codex` 경로를 도구 자동 감지로 안내한다.
+- `scripts/smoke-test.js` 에 실제 설치 기반 회귀 단언 추가: 스킬 18개, `banker-*` dir==frontmatter `name`, 재설치 시 stale sweep.
+
 ## [0.1.3] - 2026-06-29
 
 ### Security

package/README.md

@@ -1,37 +1,37 @@
 # banker-plugins
 
-> *Claude Code에 QA·감사·문서·아키텍처 초능력을 한 벌로.*
+> Claude Code와 Codex CLI를 위한 QA·감사·문서·아키텍처·위키 스킬 모음.
 
 [![npm](https://img.shields.io/npm/v/@kaydash9999/banker-plugins)](https://www.npmjs.com/package/@kaydash9999/banker-plugins)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-**[빠른 시작](#빠른-시작)** · [왜 banker인가](#왜-banker인가) · [구성](#구성) · [설치 상세](#설치-상세-npm--codex) · [요구사항](#요구사항) · [라이선스](#라이선스--서드파티)
+[빠른 시작](#빠른-시작) · [구성](#구성) · [설치 상세](#설치-상세-npm--codex) · [요구사항](#요구사항) · [업데이트 / 제거](#업데이트--제거) · [라이선스 / 서드파티](#라이선스--서드파티)
 
-banker는 QA·보안 감사·문서·아키텍처·위키 작업을 위한 **스킬 24개**와 OS 의존성 설치기를 묶은 Claude Code 플러그인입니다. 설치하면 모든 스킬·커맨드가 **`/banker:<이름>`** 네임스페이스로 노출됩니다. 이 repo 자체가 **Claude Code 마켓플레이스**(`.claude-plugin/marketplace.json`)이자 **플러그인**(`.claude-plugin/plugin.json`, name `banker`)입니다.
+banker는 QA, 보안 감사, 문서, 아키텍처, 위키 작업을 위한 스킬 25개와 의존성 설치 스킬을 묶은 Claude Code 플러그인입니다. 설치하면 스킬과 커맨드가 `/banker:<이름>` 네임스페이스로 노출됩니다. 이 저장소 자체가 Claude Code 마켓플레이스(`.claude-plugin/marketplace.json`)이자 플러그인(`.claude-plugin/plugin.json`, name `banker`)이며, 도구에 무관한 스킬은 Codex CLI에도 설치됩니다.
 
-> npm 패키지(`@kaydash9999/banker-plugins`)와 GitHub repo(`smallOpenSource/banker_plugins`)는 같은 메인테이너가 관리합니다.
+> npm 패키지(`@kaydash9999/banker-plugins`)와 GitHub 저장소(`smallOpenSource/banker_plugins`)는 같은 메인테이너가 관리합니다.
 
 ## 빠른 시작
 
+**Claude Code:** 마켓플레이스로 설치
+
 ```bash
-# 1) 마켓플레이스 추가 + 플러그인 설치
 claude plugin marketplace add smallOpenSource/banker_plugins
 claude plugin install banker@banker-plugins
 ```
 
-```text
-# 2) 첫 사용 — 예: 보안 취약점 진단
-/banker:audit-security
-```
+스킬과 커맨드를 `/banker:audit-security` 처럼 `/banker:` 로 호출합니다.
 
-설치 후 스킬·커맨드는 `/banker:rfp-author`, `/banker:arch-diagram` 처럼 `/banker:` 로 호출합니다. playwright(브라우저 QA) 같은 OS 의존성이 필요한 항목은 **`/banker:setup`** 으로 골라 설치합니다.
+**Codex CLI:** npm 전역 설치 후 `banker setup`
+
+```bash
+npm i -g @kaydash9999/banker-plugins
+banker setup --codex
+```
 
-## 왜 banker인가?
+스킬을 `banker-audit-security` 처럼 `banker-<name>` 으로 호출합니다.
 
-- **스킬 24개를 한 벌로** — QA·감사·문서·아키텍처·위키를 매번 새로 만들지 않고 바로 씁니다.
-- **설치 즉시 `/banker:*`** — 마켓플레이스 한 줄, 또는 npm 전역 설치 한 줄.
-- **Claude Code + Codex 양립** — 도구-무관 스킬 17개는 Codex CLI에도 그대로 설치됩니다.
-- **OS 의존성까지** — `/banker:setup` 이 playwright·omc_hud 등을 OS에 맞춰 설치·폴백합니다.
+playwright(브라우저 QA)나 oh-my-claudecode(OMC/OMX)처럼 별도 의존성이 필요한 스킬은 실행 전에 설치부터 안내합니다(Claude Code는 `/banker:setup`).
 
 ## 구성
 
@@ -39,10 +39,10 @@ claude plugin install banker@banker-plugins
 
 | 커맨드 | 설명 |
 |---|---|
-| `/banker:front-qa` | 스펙(note) 기반 프론트엔드 구현 + 엄격 parity QA |
-| `/banker:setup` | 구성요소·OS 의존성 multi-select 설치 오케스트레이터 |
+| `/banker:front-qa` | 스펙(note) 기반 프론트엔드 구현 + parity QA |
+| `/banker:setup` | 구성요소·의존성 설치 오케스트레이터 (multi-select) |
 
-### 스킬 — QA · 감사
+### 스킬: QA · 감사
 
 | 스킬 | 설명 |
 |---|---|
@@ -52,7 +52,7 @@ claude plugin install banker@banker-plugins
 | `game-qa` | 웹 게임(Godot HTML5) 직접 플레이 QA |
 | `ultra-ui-qa` | UI를 기준(디자인 PDF/스펙)과 1:1 대조 QA |
 
-### 스킬 — 문서 · 디자인 · 위키
+### 스킬: 문서 · 디자인 · 위키
 
 | 스킬 | 설명 |
 |---|---|
@@ -66,59 +66,90 @@ claude plugin install banker@banker-plugins
 | `append_wiki` | 프로젝트 위키 문서 추가/보강 |
 | `compact-wiki` | 위키 중복 제거·supersede·병합 (무손실) |
 
-### 스킬 — 워크플로 · 유틸
+### 스킬: 워크플로 · 유틸
 
 | 스킬 | 설명 |
 |---|---|
 | `all-in-one` | 계획→구현→검증 end-to-end 오케스트레이터 |
 | `ultra-init` | 아이디어→빌드→테스트 원샷 자동 실행 |
 | `ready-compact` | 컨텍스트 compaction 직전 상태 저장/이어가기 |
-| `compact-copy` | resume 프롬프트만 추출 → 클립보드/파일(compaction 이어가기) |
+| `compact-copy` | resume 프롬프트만 추출해 클립보드/파일로(compaction 이어가기) |
 | `refresh-git-ignore` | `.gitignore` 비파괴·반복가능 갱신 |
 | `omc-reference` | OMC 에이전트/툴/스킬 레퍼런스 |
 
-### 스킬 — 설치 (`/banker:setup` 가 호출)
+### 스킬: 설치 (`/banker:setup` 가 호출)
 
 | 스킬 | 설명 |
 |---|---|
+| `setup-omc` | oh-my-claudecode(OMC) 설치·갱신 (Codex는 OMX) |
 | `setup-playwright` | Playwright + headless 브라우저 (RHEL8/Rocky8·non-root·no-conda 폴백) |
 | `setup-omc-hud` | omc_hud 상태표시줄 (OS별) |
-| `setup-insane-search` | insane-search 플러그인 설치 |
+| `setup-insane-search` | insane-search 플러그인 설치 (Claude·Codex) |
 | `setup-stitch-proxy` | Stitch 디자인 MCP 프록시 등록 |
 
-## 설치 상세 (npm + Codex)
+## 설치 상세 (npm · Codex)
 
-마켓플레이스 대신 **npm**으로 전역 설치할 수 있고, **Codex CLI**에도 스킬을 설치할 수 있습니다.
+마켓플레이스 대신 npm으로 전역 설치할 수 있고, Codex CLI에도 스킬을 설치할 수 있습니다. Codex 설치는 npm 전역 설치가 선행되어야 합니다.
 
 ```bash
 npm i -g @kaydash9999/banker-plugins
-banker setup            # Claude Code + Codex 둘 다 (대상 플래그 없으면 둘 다)
-banker setup --claude   # Claude Code만 (마켓플레이스 등록 → /banker:*)
+banker setup            # 대상 플래그가 없으면 Claude Code와 Codex 둘 다
+banker setup --claude   # Claude Code만 (마켓플레이스 등록 후 /banker:*)
 banker setup --codex    # Codex CLI만 (~/.codex/skills/banker-*)
 banker doctor           # 설치 상태 점검
 banker uninstall        # 제거
 ```
 
-- `--scope project` 로 프로젝트-로컬(`./.codex`)에 설치, `--dry-run` 으로 미리보기.
-- **non-root 전용**(전역 sudo 설치 시 root 소유 파일 방지). **postinstall 없음** — `banker setup` 을 직접 실행합니다.
-- Codex에는 **도구-무관 스킬 17개만** 설치됩니다(`codex/manifest.json`). OMC/`claude`-결합 스킬(all-in-one·ultra-init·omc-reference·setup-omc-hud/insane-search/stitch-proxy·`/banker:front-qa`)과 Claude Code 내장 `/copy` 에 의존하는 `compact-copy` 는 Claude Code 전용입니다.
-- Codex 스킬 → `~/.codex/skills/banker-<name>/` (17개). 현재 커맨드(`front-qa`·`setup`)는 둘 다 Claude 전용이라 Codex prompts는 0개입니다 — 향후 도구-무관 커맨드가 생기면 `~/.codex/prompts/banker-<name>.md`(`/banker-<name>`)로 설치됩니다. `~/.codex/AGENTS.md`는 건드리지 않습니다(omx가 재생성하므로).
+- `--scope project` 로 프로젝트 로컬(`./.codex`)에 설치하고, `--dry-run` 으로 미리 볼 수 있습니다.
+- non-root 전용입니다(전역 sudo 설치 시 root 소유 파일을 방지). postinstall이 없으므로 `banker setup` 을 직접 실행합니다.
+- Codex에는 도구에 무관한 스킬 18개가 설치됩니다(`codex/manifest.json`). 스킬은 `~/.codex/skills/banker-<name>/` 에 놓이고, 디렉터리명과 일치하도록 프론트매터 `name:` 이 `banker-<name>` 으로 재작성되어 Codex가 `banker-<name>` 으로 인식합니다.
+- OMC나 `claude` 에 결합된 스킬(all-in-one, ultra-init, omc-reference, setup-omc, setup-omc-hud, setup-stitch-proxy)과 Claude Code 내장 `/copy` 에 의존하는 compact-copy, 그리고 `/banker:front-qa`·`/banker:setup` 커맨드는 Claude Code 전용입니다.
+- `~/.codex/AGENTS.md` 는 건드리지 않습니다(omx가 재생성하므로 `~/.codex/skills/` 자동 검색에 의존).
 
 ## 요구사항
 
-- **Claude Code** (마켓플레이스 설치 경로) — 스킬은 `/banker:*` 로 동작.
-- 또는 **Node.js ≥ 16.7** (npm 전역 설치 경로) — `banker` CLI 제공.
-- 일부 스킬은 OS 의존성이 필요합니다(`/banker:setup` 으로 설치): playwright(브라우저 QA)·omc_hud 등.
+- Claude Code (마켓플레이스 경로): 스킬이 `/banker:*` 로 동작.
+- 또는 Node.js ≥ 16.7 (npm 전역 설치 경로): `banker` CLI 제공.
+- 일부 스킬은 별도 의존성이 필요하며 `/banker:setup` 으로 설치합니다. 의존성이 없으면 각 스킬이 실행 전에 설치부터 안내합니다.
+  - `all-in-one`, `ultra-init`, `/banker:front-qa`: oh-my-claudecode(OMC). Codex에서는 OMX.
+  - `audit-web-page`, `game-qa`, `ultra-ui-qa`: playwright.
 
 ## 업데이트 / 제거
 
+**Claude Code:**
+
 ```bash
 claude plugin update banker                       # 플러그인 최신화 (재시작 후 적용)
 claude plugin marketplace update banker-plugins   # 마켓플레이스 메타 갱신
 claude plugin uninstall banker                    # 제거
 ```
 
+**npm · Codex:**
+
+```bash
+npm i -g @kaydash9999/banker-plugins   # 최신 버전 설치
+banker setup                            # 재설치 (기존 banker-* 정리 후 클린 설치)
+banker uninstall                        # 제거
+```
+
+Codex는 재설치할 때마다 기존 `banker-*` 를 먼저 정리하므로 옛 버전이 중복으로 남지 않습니다.
+
 ## 라이선스 / 서드파티
 
-- **MIT** ([LICENSE](LICENSE)). Owner: [smallOpenSource](https://github.com/smallOpenSource).
-- `skills/humanizer` — [blader/humanizer](https://github.com/blader/humanizer) 기반, **MIT License** (© 2025 Siqi Chen). 원본 라이선스 고지는 `skills/humanizer/LICENSE`에 포함되어 있습니다.
+banker 자체는 **MIT** ([LICENSE](LICENSE)). Owner: [smallOpenSource](https://github.com/smallOpenSource).
+
+**번들된 코드 (이 패키지가 재배포)**
+- `skills/humanizer`: [blader/humanizer](https://github.com/blader/humanizer) 기반, **MIT License**(© 2025 Siqi Chen). 원본 라이선스 고지는 `skills/humanizer/LICENSE` 에 포함. 패턴 목록은 Wikipedia [*Signs of AI writing*](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing)(WikiProject AI Cleanup, **CC BY-SA**)에 기반합니다.
+
+코드로 포함(재배포)하는 서드파티는 `humanizer` 뿐입니다. 아래는 스킬이 **런타임에 의존하거나 연동**하는 외부 요소로, banker 가 재배포하지 않으며 각 라이선스·상표는 소유자에게 있습니다.
+
+**의존 라이브러리·도구 (사용 시 별도 설치, 라이선스는 각 프로젝트 소유)**
+- Python: python-pptx(MIT, `arch-diagram`), python-docx(MIT, `rfp-author`), Playwright(Apache-2.0, `audit-web-page`·`game-qa`·`ultra-ui-qa`), detect-secrets(Apache-2.0, `lineage` 시크릿 스캔).
+- 브라우저·렌더링: Chromium(BSD-3-Clause), SwiftShader(Apache-2.0), Xvfb·X.Org(MIT). `setup-playwright` 및 브라우저 QA 스킬이 사용.
+- 문서·다이어그램: PlantUML(GPL 계열·다중 라이선스, `arch-diagram`), Poppler(GPL, `pdftoppm`), ImageMagick(ImageMagick License, `pdf-vision-extract`).
+
+**연동·참조 (외부 프레임워크·서비스·브랜드)**
+- 프레임워크: oh-my-claudecode(OMC, **MIT**)·oh-my-codex(OMX, **MIT**), by [Yeachan-Heo](https://github.com/Yeachan-Heo). `all-in-one`·`ultra-init`·`/banker:front-qa`·`setup-omc` 가 사용.
+- 플러그인: insane-search(**MIT**, © fivetaku, [fivetaku/gptaku_plugins](https://github.com/fivetaku/gptaku_plugins)). `setup-insane-search` 가 설치.
+- 서비스·디자인(독점·상표): Notion(`make-notion-guide`), Google Stitch(`setup-stitch-proxy`), Nothing 디자인 언어(`nothing-design`).
+- QA 대상 엔진(예시): Godot(MIT), Phaser(MIT) 등(`game-qa`).

package/bin/banker.js

@@ -81,6 +81,48 @@ function copyFile(src, dest, dryRun) {
   fs.copyFileSync(src, dest);
 }
 
+// Remove every prior `banker-*` skill dir and prompt file so a re-run is a clean
+// reinstall — a skill dropped from the manifest (or renamed) never lingers as a stale duplicate.
+function sweepCodexArtifacts(base, dryRun) {
+  let removed = 0;
+  for (const sub of ['skills', 'prompts']) {
+    const dir = path.join(base, sub);
+    let entries = [];
+    try { entries = fs.readdirSync(dir).filter(d => d.startsWith('banker-')); } catch { /* dir absent */ }
+    for (const e of entries) {
+      const p = path.join(dir, e);
+      if (dryRun) { log(`  [dry-run] sweep ${p}`); continue; }
+      fs.rmSync(p, { recursive: true, force: true });
+      removed++;
+    }
+  }
+  return removed;
+}
+
+// Read a SKILL.md frontmatter `name:` (used by doctor to verify the Codex dir==name rule).
+function readSkillName(skillMd) {
+  let src;
+  try { src = fs.readFileSync(skillMd, 'utf8'); } catch { return null; }
+  const fm = src.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!fm) return null;
+  const m = fm[1].match(/^name:\s*["']?([^"'\n]+?)["']?\s*$/m);
+  return m ? m[1] : null;
+}
+
+// Codex discovers skills by directory and expects the SKILL.md frontmatter `name:` to equal the
+// directory name. Our Codex dir is `banker-<name>` (prefixed to avoid colliding with omx/system
+// skills), so rewrite ONLY the first `name:` line inside the YAML frontmatter to match.
+function setCodexSkillName(skillMd, newName, dryRun) {
+  if (dryRun) { log(`  [dry-run] set frontmatter name: ${newName}`); return; }
+  let src;
+  try { src = fs.readFileSync(skillMd, 'utf8'); } catch { return; }
+  const fm = src.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!fm) return;                                   // no frontmatter — leave untouched
+  let block = fm[1];
+  block = /^name:.*$/m.test(block) ? block.replace(/^name:.*$/m, `name: ${newName}`) : `name: ${newName}\n${block}`;
+  fs.writeFileSync(skillMd, src.slice(0, fm.index) + `---\n${block}\n---` + src.slice(fm.index + fm[0].length));
+}
+
 /* ---------- Claude Code target ---------- */
 function setupClaude(dryRun) {
   log('• Claude Code:');
@@ -95,6 +137,7 @@ function setupClaude(dryRun) {
     catch (e) { warn(`  step failed (may already be applied): ${bin} ${args.join(' ')}`); }
   }
   log('  → skills/commands available as /banker:* (reload-plugins or restart to apply).');
+  log('  → for all-in-one / ultra-init / front-qa, install OMC too: run /banker:setup and pick oh-my-claudecode (or `omc update`).');
   return true;
 }
 
@@ -105,10 +148,15 @@ function setupCodex(dryRun, scope) {
   const base = codexBase(scope);
   const skillsDir = path.join(base, 'skills');
   const promptsDir = path.join(base, 'prompts');
+  // Clean reinstall: remove any prior banker-* first so an update never leaves a stale duplicate.
+  const swept = sweepCodexArtifacts(base, dryRun);
+  if (swept) log(`  swept ${swept} prior banker-* artifact(s) before reinstall.`);
   let nSkill = 0, nCmd = 0;
   for (const s of eligible(m)) {
     if (s.type === 'skill') {
-      copyDir(path.join(PKG_ROOT, 'skills', s.name), path.join(skillsDir, `banker-${s.name}`), dryRun);
+      const dest = path.join(skillsDir, `banker-${s.name}`);
+      copyDir(path.join(PKG_ROOT, 'skills', s.name), dest, dryRun);
+      setCodexSkillName(path.join(dest, 'SKILL.md'), `banker-${s.name}`, dryRun); // dir==name (Codex discovery)
       nSkill++;
     } else if (s.type === 'command') {
       copyFile(path.join(PKG_ROOT, 'commands', `${s.name}.md`), path.join(promptsDir, `banker-${s.name}.md`), dryRun);
@@ -116,6 +164,7 @@ function setupCodex(dryRun, scope) {
     }
   }
   log(`  → ${nSkill} skills -> ${path.join(base, 'skills', 'banker-*')}, ${nCmd} prompts -> ${path.join(base, 'prompts', 'banker-*.md')}`);
+  log('  → skills are invoked as `banker-<name>` (frontmatter name rewritten to match the dir).');
   log('  → ~/.codex/AGENTS.md is NOT modified (omx regenerates it); skills auto-discovered from ~/.codex/skills/.');
   return true;
 }
@@ -133,8 +182,20 @@ function doctor() {
   try { installed = fs.readdirSync(sdir).filter(d => d.startsWith('banker-')); } catch {}
   log(`  codex CLI: ${have('codex') ? 'found' : 'NOT found'}`);
   log(`  installed banker skills in ~/.codex/skills: ${installed.length}`);
+  // Codex only discovers a skill when its dir name equals the SKILL.md `name:` — flag any mismatch.
+  const mismatched = installed
+    .map(d => ({ d, name: readSkillName(path.join(sdir, d, 'SKILL.md')) }))
+    .filter(x => x.name && x.name !== x.d);
+  if (mismatched.length) {
+    log(`  ⚠ dir/name mismatch (Codex will NOT list these) — reinstall with this version:`);
+    for (const x of mismatched) log(`      ${x.d}/  has  name: ${x.name}`);
+  }
+  if (have('codex') && installed.length === 0) log('  ⚠ codex found but 0 banker skills installed — run: banker setup --codex');
   const m = readManifest();
-  log(`  manifest: ${eligible(m).length} codex-eligible surfaces (of ${m.surfaces.length}).`);
+  const nSkills = eligible(m).filter(s => s.type === 'skill').length;
+  log(`  manifest: ${eligible(m).length} codex-eligible surfaces (${nSkills} skills) of ${m.surfaces.length}.`);
+  log('Dependencies: all-in-one / ultra-init / front-qa need OMC (Claude) or OMX (Codex); browser skills need playwright.');
+  log('  → install via /banker:setup (Claude) or the setup-* skills; skills also guide you if a dependency is missing.');
 }
 
 /* ---------- uninstall ---------- */

package/codex/manifest.json

@@ -18,14 +18,15 @@
     { "name": "refresh-git-ignore",   "type": "skill",   "target": "both",        "reason": ".gitignore refresh; tool-agnostic", "supportingFiles": [] },
     { "name": "rfp-author",           "type": "skill",   "target": "both",        "reason": "RFP authoring framework; tool-agnostic", "supportingFiles": ["references/compliance-and-ai-llm.md", "references/korean-rfp-framework.md", "references/research-provenance.md", "references/this-project-scope.md", "references/vendor-rfp-structure.md", "templates/rfp-skeleton.md", "scripts/md2docx.py"] },
     { "name": "setup-playwright",     "type": "skill",   "target": "both",        "reason": "playwright/browser install; tool-agnostic (genericize /banker:setup trigger ref for Codex)", "supportingFiles": [] },
+    { "name": "setup-insane-search",  "type": "skill",   "target": "both",        "reason": "installs the insane-search plugin; Claude via `claude plugin`, Codex via `codex plugin add insane-research-codex@gptaku-codex`", "supportingFiles": [] },
     { "name": "ultra-ui-qa",          "type": "skill",   "target": "both",        "reason": "UI vs SoT QA; tool-agnostic", "supportingFiles": [], "caveat": "needs playwright (setup-playwright)" },
 
     { "name": "all-in-one",           "type": "skill",   "target": "claude-only", "reason": "orchestrates OMC ralplan->ralph->ultraqa (Claude/OMC-specific)", "supportingFiles": [] },
     { "name": "compact-copy",         "type": "skill",   "target": "claude-only", "reason": "manipulates Claude Code /copy + response.md artifact (Claude-specific)", "caveat": "depends on Claude Code /copy builtin + /tmp/claude-<uid>/response.md internal path; may change across Claude Code versions", "supportingFiles": [] },
     { "name": "ultra-init",           "type": "skill",   "target": "claude-only", "reason": "orchestrates OMC ralplan/ultragoal/ralph/ultraqa (Claude/OMC-specific)", "supportingFiles": [] },
     { "name": "omc-reference",        "type": "skill",   "target": "claude-only", "reason": "OMC-internal agent/tool/skill registry reference", "supportingFiles": [] },
+    { "name": "setup-omc",            "type": "skill",   "target": "claude-only", "reason": "installs/refreshes oh-my-claudecode (OMC) that all-in-one/ultra-init/front-qa depend on; Codex users run `omx setup`", "supportingFiles": [] },
     { "name": "setup-omc-hud",        "type": "skill",   "target": "claude-only", "reason": "installs omc_hud (Claude Code statusline)", "supportingFiles": [] },
-    { "name": "setup-insane-search",  "type": "skill",   "target": "claude-only", "reason": "shells `claude plugin` to install a Claude Code plugin", "supportingFiles": [] },
     { "name": "setup-stitch-proxy",   "type": "skill",   "target": "claude-only", "reason": "shells `claude mcp add` (Claude Code MCP registration)", "supportingFiles": [] },
 
     { "name": "front-qa",             "type": "command", "target": "claude-only", "reason": "ralplan->ralph->loop OMC pipeline command", "supportingFiles": [] },

package/codex/transform-matrix.md

@@ -5,20 +5,21 @@ The generator (`banker setup --codex`) applies the rules below for `target: both
 
 | Source (Claude) | Codex destination | Transform |
 |---|---|---|
-| `skills/<name>/SKILL.md` (+ subtree) | `~/.codex/skills/banker-<name>/` (whole dir) | **COPY subtree** (Windows: no symlink). SKILL.md frontmatter (name+description) is identical → no body transform. Optionally strip Claude-only `/banker:`-style trigger phrases from `description`. |
+| `skills/<name>/SKILL.md` (+ subtree) | `~/.codex/skills/banker-<name>/` (whole dir) | **COPY subtree** (Windows: no symlink), then **rewrite the frontmatter `name:` to `banker-<name>`**. Codex discovers skills by directory and requires `name:` == directory name, so the prefix must be applied to both (leaving `name: <name>` while the dir is `banker-<name>` makes Codex skip the skill). `description` is left as-is. |
 | `commands/<name>.md` | `~/.codex/prompts/banker-<name>.md` | Near-identical (frontmatter `description`+`argument-hint`). Codex prompts are flat → the `banker-` prefix lives in the filename; invoked as `/banker-<name>`. |
 | (none) | `~/.codex/AGENTS.md` | **NOT TOUCHED.** omx regenerates it (clobber risk, `:7`/`:253`). Rely on `~/.codex/skills/` auto-discovery; if a listing is wanted, write ONLY inside the sanctioned `<!-- user-custom -->` region, idempotently. |
 
 ## Naming
-- Codex skill dir: `banker-<name>` (avoids collision with omx/system skills).
+- Codex skill dir **and** frontmatter `name:`: `banker-<name>` (avoids collision with omx/system skills; kept in sync so Codex discovers it).
 - Codex prompt file: `banker-<name>.md` → invoked `/banker-<name>`.
 
 ## Scope
 - `--scope user` (default) → `~/.codex/…`. `--scope project` → `./.codex/…`.
 
 ## Excluded (claude-only) — never generated for Codex
-Skills: all-in-one, compact-copy, ultra-init, omc-reference, setup-omc-hud, setup-insane-search, setup-stitch-proxy.
+Skills: all-in-one, compact-copy, ultra-init, omc-reference, setup-omc, setup-omc-hud, setup-stitch-proxy.
 Commands: front-qa, setup. (Reasons in `manifest.json`.)
+`setup-insane-search` is `both`: on Codex it drives `codex plugin add insane-research-codex@gptaku-codex`.
 
 ## Caveats (documented; not blockers)
 - `append_wiki`, `compact-wiki` — use `wiki_*` MCP at runtime → copy fine, need a wiki MCP available in Codex.

package/commands/front-qa.md

@@ -8,6 +8,12 @@ argument-hint: "[스펙/note 파일 경로 — 생략 시 docs/note.txt]"
 `$1`(없으면 `docs/note.txt`)의 요구사항을 React 프론트엔드(`$FRONTEND_DIR`, 예: `apps/web`)에 구현하고,
 **레퍼런스 구현(reference implementation — 예: 이전 Streamlit/타 빌드)과 엄격 비교 + 스펙 지시 정확 준수**를 검증한다. 모든 항목 해결까지 진행.
 
+## 0. 전제조건: OMC (없으면 설치부터)
+
+이 커맨드는 `/ralplan`·`/ralph` 등 oh-my-claudecode(OMC)에 의존한다. **진행 전 먼저 확인**하고, 없으면 **설치부터 안내**한다:
+- 확인: `command -v omc` + `/oh-my-claudecode:*` 사용 가능 여부.
+- 미설치면 `/banker:setup` → oh-my-claudecode(또는 `setup-omc` 스킬 / `omc update`)로 먼저 구성한 뒤 이어서 진행.
+
 ## 절차 (CLAUDE.md: 계획 없는 즉시실행 금지)
 
 1. **스펙 정독**: 대상 파일을 읽어 요구사항을 항목화. 코드베이스 정찰(병렬 explore/general-purpose 에이전트로

package/commands/setup.md

@@ -1,5 +1,5 @@
 ---
-description: "banker 플러그인 구성요소·OS 의존성을 multi-select로 골라 설치하는 오케스트레이터(playwright·omc-hud·insane-search·stitch-proxy)."
+description: "banker 플러그인 구성요소·의존성을 multi-select로 골라 설치하는 오케스트레이터(oh-my-claudecode·playwright·omc-hud·insane-search·stitch-proxy)."
 argument-hint: "[설치할 컴포넌트명 — 비우면 multi-select 표시]"
 ---
 
@@ -11,13 +11,15 @@ banker 플러그인이 제공하는 설치 스킬들을 **multi-select**로 골
 ## 절차
 
 1. **선택 받기**: `$ARGUMENTS` 에 컴포넌트명이 명시돼 있으면 그것만 실행(질문 생략).
-   비어 있으면 아래 4개를 `AskUserQuestion`(**multiSelect: true**)으로 제시한다:
+   비어 있으면 아래 5개를 `AskUserQuestion`(**multiSelect: true**)으로 제시한다:
+   - **setup-omc** — oh-my-claudecode(OMC) 설치/갱신. `all-in-one`·`ultra-init`·`/banker:front-qa` 의존성(Codex는 OMX).
    - **setup-playwright** — Playwright + 브라우저 + headless 디스플레이(Xvfb). RHEL8/Rocky8 등 비공식 지원·non-root·no-conda 폴백 포함. (`ultra-ui-qa`·`audit-web-page`·`game-qa` 의존성)
    - **setup-omc-hud** — omc_hud 상태표시줄 설치(OS별).
-   - **setup-insane-search** — insane-search 플러그인(차단 사이트 우회) 설치.
+   - **setup-insane-search** — insane-search 플러그인(차단 사이트 우회) 설치(Claude/Codex 양쪽 경로).
    - **setup-stitch-proxy** — Stitch(디자인 생성) MCP 프록시 등록(API key 필요).
 
 2. **실행**: 선택된 각 항목의 스킬을 `Skill` 도구로 호출한다(미선택은 건드리지 않음):
+   - setup-omc → `Skill("banker:setup-omc")`
    - setup-playwright → `Skill("banker:setup-playwright")`
    - setup-omc-hud → `Skill("banker:setup-omc-hud")`
    - setup-insane-search → `Skill("banker:setup-insane-search")`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaydash9999/banker-plugins",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "banker — Claude Code + Codex CLI plugin (QA, audit, docs, architecture, wiki skills). Install via Claude Code marketplace, or `npm i -g @kaydash9999/banker-plugins` then `banker setup`.",
   "bin": {
     "banker": "bin/banker.js"

package/skills/all-in-one/SKILL.md

@@ -20,6 +20,12 @@ level: 4
 
 [ALL-IN-ONE ACTIVATED — SEQUENTIAL 3-STAGE PIPELINE]
 
+## 0. Prerequisite: OMC (install first if missing)
+
+This skill orchestrates OMC's `ralplan` → `ralph` → `ultraqa`. **Check the dependency before running**; if it is missing, **guide installation first** rather than failing mid-pipeline:
+- Check: `command -v omc` and whether `/oh-my-claudecode:*` skills are available.
+- If missing: install via `/banker:setup` → oh-my-claudecode (or the `setup-omc` skill / `omc update`), then resume. On Codex the equivalent is OMX (`omx setup`).
+
 ## Purpose
 
 Run one substantial coding task through three independent quality gates in a

package/skills/audit-web-page/SKILL.md

@@ -10,6 +10,12 @@ description: "가동 중 웹페이지를 playwright로 라이브 점검(버튼·
 스크린샷으로 캡처해 **직접 Read로 육안 판정**한다. unit/build 게이트로 대체 불가능한
 "진짜 화면이 동작/렌더하는가"를 확증하는 마지막 검증 레인.
 
+## 0. 전제조건: playwright (없으면 설치부터)
+
+이 스킬은 playwright 브라우저가 있어야 동작한다. **진행 전 설치 여부를 먼저 확인**하고, 없으면 **설치부터 안내**한다(추정·임의 재설치 금지):
+- 확인: `ls "${PLAYWRIGHT_BROWSERS_PATH:-$HOME/.cache/ms-playwright}" 2>/dev/null | grep -qi chromium && echo ok`
+- 미설치면 먼저 `setup-playwright` 스킬로 설치(Claude Code: `/banker:setup` → setup-playwright / Codex: `banker-setup-playwright`). 설치·검증 후 이 스킬을 이어서 진행한다.
+
 ## 언제
 
 - 사용자가 `audit-web-page` 또는 "라이브로 점검/검증", "playwright로 화면 확인" 요청.

package/skills/game-qa/SKILL.md

@@ -7,6 +7,11 @@ description: "Godot HTML5 웹게임을 실제 브라우저에서 직접 플레
 
 헤드리스 CI(GREEN)와 "CLICK to start" 라벨이 **구조적으로 못 잡는** 결함 — 입력 손맛이 아니라 *렌더·HUD·입력 반영·시작·소프트락* — 을 **에이전트가 실제 브라우저에서 게임을 직접 플레이**하며 객관적으로 잡는다. (실증: 이 스킬이 '탭/클릭으로 8게임 중 7개가 시작조차 안 되는' 터치기기 쇼스토퍼를 잡았다. 헤드리스는 못 봤다.)
 
+## 0. 전제조건: playwright (없으면 설치부터)
+이 스킬은 playwright 브라우저가 있어야 동작한다. **진행 전 설치 여부를 먼저 확인**하고, 없으면 **설치부터 안내**한다(추정·임의 재설치 금지):
+- 확인: `ls "${PLAYWRIGHT_BROWSERS_PATH:-$HOME/.cache/ms-playwright}" 2>/dev/null | grep -qi chromium && echo ok`
+- 미설치면 먼저 `setup-playwright` 스킬로 설치(Claude Code: `/banker:setup` → setup-playwright / Codex: `banker-setup-playwright`). 설치·검증 후 이 스킬을 이어서 진행한다.
+
 ## 언제
 - 오너가 "네가 직접 플레이/qa해봐", "게임 테스트해봐" 류로 위임.
 - **실기기 손맛 플레이테스트 직전** 객관 점검(시작조차 안 되는 결함부터 거른다).

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

@@ -1,32 +1,43 @@
 ---
 name: setup-insane-search
-description: "insane-search(차단·봇방어 사이트 우회 검색·페치) 플러그인을 fivetaku/gptaku_plugins 마켓플레이스에서 설치(OS 무관). 'setup-insane-search'/'insane-search 설치' 또는 /banker:setup 시 사용."
+description: "insane-search(차단·봇방어 사이트 우회 검색·페치) 플러그인 설치. Claude Code=gptaku_plugins 마켓플레이스, Codex=gptaku-codex 마켓플레이스. 'setup-insane-search'/'insane-search 설치' 또는 /banker:setup 시 사용."
 ---
 
-# setup-insane-search — insane-search 플러그인 설치
+# setup-insane-search: insane-search 플러그인 설치
 
-차단 사이트 우회(WAF/봇방어, X·Reddit·YouTube·GitHub 등) 검색·페치를 제공하는 `insane-search` 를
-`fivetaku/gptaku_plugins` 마켓플레이스에서 설치한다. OS 무관(Claude Code 플러그인). 답변은 한글.
+차단 사이트 우회(WAF·봇방어; X·Reddit·YouTube·GitHub 등) 검색·페치를 제공하는 `insane-search` 플러그인을
+설치한다. 현재 도구(Claude Code / Codex)를 감지해 알맞은 경로로 진행하고, 이미 설치돼 있으면 skip(멱등). 답변은 한글.
 
-## 설치 — Claude Code 세션 안 (슬래시 커맨드)
+## Claude Code · 세션 안 (슬래시 커맨드)
 ```
 /plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git
 /plugin install insane-search@gptaku-plugins
 /reload-plugins
 ```
-
-## 또는 CLI (비대화형)
+CLI(비대화형):
 ```bash
 claude plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git
 claude plugin install insane-search@gptaku-plugins
-# 적용엔 /reload-plugins 또는 재시작 필요
+# 반영엔 /reload-plugins 또는 재시작 필요
+```
+
+## Codex CLI
+Codex는 마켓플레이스명(`gptaku-codex`)과 플러그인명(`insane-research-codex`)이 Claude와 다르다.
+```bash
+codex plugin marketplace list            # gptaku-codex 가 이미 있으면 다음 add 는 skip
+codex plugin marketplace add https://github.com/fivetaku/insane-search.git
+codex plugin add insane-research-codex@gptaku-codex
+codex plugin list                        # STATUS=installed 확인
 ```
+- `gptaku-codex` 마켓플레이스가 `marketplace list` 에 없을 때만 add 한다.
+- add 후 등록된 마켓플레이스명을 `marketplace list` 로 확인한다. 이름이 `gptaku-codex` 가 아니면 `codex plugin add insane-research-codex@<실제이름>` 으로 맞춘다.
 
 ## 검증·보고
-- `claude plugin list` 에 `insane-search` 가 보이는지.
-- **반영엔 `/reload-plugins` 또는 재시작 필요**(설치 직후 미반영은 정상).
-- 이미 설치돼 있으면 skip.
+- Claude: `claude plugin list` 에 `insane-search` 표시(반영엔 `/reload-plugins`·재시작).
+- Codex: `codex plugin list` 에서 `insane-research-codex` 가 `STATUS=installed`.
+- 이미 설치면 skip. 실패는 정직 보고(가짜 성공 금지).
 
 ## 함정
-- 마켓플레이스명은 추가 후 `claude plugin marketplace list` 로 확인(`gptaku-plugins`). 설치는 `<plugin>@<marketplace>` 형식.
-- 깃/네트워크 접근 필요(사설망이면 프록시 확인).
+- 도구별 이름이 다르다: Claude=`insane-search@gptaku-plugins`, Codex=`insane-research-codex@gptaku-codex`.
+- 설치는 `<plugin>@<marketplace>` 형식. 마켓플레이스명은 add 후 `marketplace list` 로 확인.
+- 깃·네트워크 접근 필요(사설망이면 프록시 확인).

package/skills/setup-omc/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: setup-omc
+description: "all-in-one·ultra-init·front-qa 가 의존하는 oh-my-claudecode(OMC)를 설치/갱신. Codex는 oh-my-codex(OMX). 'setup-omc'/'OMC 설치'/'oh-my-claudecode 설치' 또는 /banker:setup 시 사용."
+---
+
+# setup-omc: oh-my-claudecode(OMC) 설치/갱신
+
+banker의 오케스트레이터(`all-in-one`·`ultra-init`)와 `/banker:front-qa` 커맨드는 OMC의
+`ralplan`·`ralph`·`ultraqa` 등에 의존한다. 이 스킬은 OMC를 설치하거나 최신화한다(이미 있으면 갱신만; 멱등). 답변은 한글.
+
+## 0. 감지 (먼저, 추정 금지)
+```bash
+command -v omc >/dev/null && omc --version || echo "omc: 미설치"
+command -v claude >/dev/null || echo "claude: 미설치"
+```
+
+## Claude Code · OMC
+- **이미 설치(`omc` 존재)** 면 최신화만 한다:
+  ```bash
+  omc update      # 플러그인·npm 패키지·CLAUDE.md 동기화
+  ```
+- **미설치** 면 공식 배포처 절차를 따른다(일반적으로 npm 전역 설치 후 `omc setup`). 정확한 설치 명령이 불명확하면 추정하지 말고 사용자에게 확인한다.
+- 확인: `omc --version` + Claude 재시작·`/reload-plugins` 후 `/oh-my-claudecode:*` 노출.
+
+## Codex CLI · OMX (oh-my-codex)
+Codex에서의 대응 프레임워크는 OMX다.
+```bash
+command -v omx >/dev/null && omx setup      # 유저/프로젝트 레벨 OMX 구성(멱등)
+```
+- 미설치면 OMX 배포처 안내대로 설치 후 `omx setup`.
+
+## 검증·보고
+- OMC: `omc --version` / OMX: `omx --version`. 반영엔 재시작·`/reload-plugins`(Claude)가 필요할 수 있다.
+- 실패·불명확은 정직 보고(가짜 성공 금지).
+
+## 함정
+- OMC/OMX는 banker와 별개 프로젝트다. banker가 대신 버전을 고정하지 않고 공식 경로만 쓴다.
+- 설치 직후 미반영은 정상(재시작·reload 후 반영).

package/skills/ultra-init/SKILL.md

@@ -44,7 +44,7 @@ Several bundled skills are loop/persistence engines. To prevent competing loops,
 ### Phase 0 — Preflight (준비)
 - Resolve the brief from the skill arguments. If it is empty, ask once for the brief, then proceed.
 - Parse flags: planning depth (`--deliberate` = default, `--short` = lighter ralplan), `--gated`, `--qa <dims>`, `--critic=...`, `--plan-id <id>`.
-- Confirm the `omc` CLI is available (needed for ultragoal). If it is missing, run ultragoal in **degraded mode**: skip the durable ledger and instead write the approved plan to `plan.md` + rely on ralph's session-scoped `prd.json`. Say so explicitly when degrading.
+- **OMC prerequisite**: this skill orchestrates OMC's `ralplan`/`ralph`/`ultraqa`, so it needs the `omc` CLI. Check `command -v omc`; if missing, **guide installation first** via `/banker:setup` → oh-my-claudecode (or the `setup-omc` skill / `omc update`), then resume once it is available. Only if the user declines to install, run ultragoal in **degraded mode**: skip the durable ledger, write the approved plan to `plan.md`, and rely on ralph's session-scoped `prd.json` (say so explicitly).
 
 ### Phase 1 — PLAN: ralplan --deliberate (합의 계획)
 - Invoke `Skill("oh-my-claudecode:ralplan")` with `--deliberate <brief>` in **non-interactive** mode (so it produces the consensus-approved plan, marks it `pending approval`, and **stops without launching team/ralph itself** — ultra-init controls the hand-off).

package/skills/ultra-ui-qa/SKILL.md

@@ -8,6 +8,11 @@ description: "웹 UI를 playwright로 실제 렌더해 디자인 SoT(PDF/스펙)
 웹 앱 프론트엔드를 **실제 브라우저로 렌더링**(playwright)해 디자인 SoT(PDF/스펙)와 1:1 대조하고,
 사용자/임원이 볼 필요 없는 **내부개념 텍스트 누출**을 잡아 debug 토글로 게이트하는 UI QA 워크플로우.
 
+## 0. 전제조건: playwright (없으면 설치부터)
+이 스킬은 playwright 브라우저가 있어야 동작한다. **진행 전 설치 여부를 먼저 확인**하고, 없으면 **설치부터 안내**한다(추정·임의 재설치 금지):
+- 확인: `ls "${PLAYWRIGHT_BROWSERS_PATH:-$HOME/.cache/ms-playwright}" 2>/dev/null | grep -qi chromium && echo ok`
+- 미설치면 먼저 `setup-playwright` 스킬로 설치(Claude Code: `/banker:setup` → setup-playwright / Codex: `banker-setup-playwright`). 설치·검증 후 이 스킬을 이어서 진행한다.
+
 ## When to use
 - "ultra ui qa", "UI 대조", "디자인 PDF와 대조", "내부개념/어색한 내용 점검", "표 title·차트 크기 비교"
 - 화면/버튼/기능이 SoT(PDF + spec)대로 구현됐는지 **렌더만이 아니라 데이터·소스까지** 엄격 검사할 때