oh-my-customcodex 0.5.7 → 0.5.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/README.md +4 -4
  2. package/dist/cli/index.js +1 -1
  3. package/dist/index.js +1 -1
  4. package/package.json +1 -1
  5. package/templates/.claude/agents/arch-speckit-agent.md +1 -1
  6. package/templates/.claude/agents/sys-memory-keeper.md +9 -9
  7. package/templates/.claude/hooks/scripts/agent-teams-advisor.sh +4 -1
  8. package/templates/.claude/ontology/agents.yaml +16 -4
  9. package/templates/.claude/ontology/skills.yaml +9 -9
  10. package/templates/.claude/rules/MUST-agent-teams.md +85 -246
  11. package/templates/.claude/rules/SHOULD-memory-integration.md +4 -5
  12. package/templates/.claude/skills/de-lead-routing/SKILL.md +6 -13
  13. package/templates/.claude/skills/dev-lead-routing/SKILL.md +6 -13
  14. package/templates/.claude/skills/intent-detection/SKILL.md +7 -9
  15. package/templates/.claude/skills/memory-management/SKILL.md +7 -12
  16. package/templates/.claude/skills/memory-recall/SKILL.md +2 -2
  17. package/templates/.claude/skills/memory-save/SKILL.md +2 -2
  18. package/templates/.claude/skills/peer-messaging/SKILL.md +2 -2
  19. package/templates/.claude/skills/research/SKILL.md +8 -23
  20. package/templates/.claude/skills/roundtable-debate/SKILL.md +3 -4
  21. package/templates/.claude/skills/structured-dev-cycle/SKILL.md +7 -10
  22. package/templates/AGENTS.md.en +1 -2
  23. package/templates/AGENTS.md.ko +1 -2
  24. package/templates/CLAUDE.md +2 -2
  25. package/templates/CLAUDE.md.en +1 -2
  26. package/templates/CLAUDE.md.ko +1 -2
  27. package/templates/README.md +2 -2
  28. package/templates/guides/agentmemory-migration/measure-step-zero.md +13 -113
  29. package/templates/guides/agentmemory-migration/phase-1-coexist.md +18 -252
  30. package/templates/guides/index.yaml +1 -1
  31. package/templates/guides/multi-agent-debate-patterns/README.md +1 -1
  32. package/templates/guides/multi-provider-exec/README.md +9 -79
  33. package/templates/manifest.json +3 -3
  34. package/templates/.claude/skills/agora/SKILL.md +0 -209
  35. package/templates/.claude/skills/codex-exec/SKILL.md +0 -218
  36. package/templates/.claude/skills/codex-exec/scripts/codex-wrapper.cjs +0 -433
  37. package/templates/.claude/skills/gemini-exec/SKILL.md +0 -215
  38. package/templates/.claude/skills/gemini-exec/scripts/gemini-wrapper.cjs +0 -485
@@ -5,7 +5,7 @@
5
5
  ## Architecture
6
6
 
7
7
  **Primary**: Native auto memory (`memory` field in agent frontmatter). No external dependencies.
8
- **Supplementary**: AgentMemory-compatible MCP or `omx-memory` for cross-session searchable recall; legacy `claude-mem` is fallback only.
8
+ **Supplementary**: `omx-memory` or another AgentMemory-compatible MCP for cross-session searchable recall. Deprecated Chroma-based memory backends are not used in this project.
9
9
 
10
10
  Rule: If native auto memory can handle it, do NOT use a searchable MCP backend.
11
11
 
@@ -33,7 +33,7 @@ Agent frontmatter `memory: project|user|local` enables persistent memory:
33
33
 
34
34
  <!-- DETAIL: Backend Selection and Split-Brain Guard
35
35
 
36
- Prefer MCP tools named `memory_search`, `memory_add`, `observation_add`, and `memory_read`. Treat `chroma_query_documents`, `chroma_add_documents`, and `chroma_get_documents` as legacy `claude-mem` fallbacks.
36
+ Prefer MCP tools named `memory_search`, `memory_add`, `observation_add`, and `memory_read`. Do not call deprecated Chroma memory tools or wrappers in this project.
37
37
 
38
38
  If both backend families are available, warn before writing. Dual-write is acceptable only during an explicit migration window; outside that window, choose one canonical searchable backend and record which one was used in the session summary.
39
39
 
@@ -332,8 +332,8 @@ User signals session end
332
332
  2. Update native auto-memory (MEMORY.md)
333
333
  3. Return formatted summary to orchestrator
334
334
  → Orchestrator performs MCP saves directly:
335
- 1. searchable memory save (AgentMemory-compatible or omx-memory, if available via ToolSearch)
336
- 2. legacy claude-mem save only when it is the configured fallback
335
+ 1. searchable memory save (omx-memory or AgentMemory-compatible backend, if available via ToolSearch)
336
+ 2. deprecated Chroma memory backends are skipped by project policy
337
337
  (episodic-memory auto-indexes after session — no action needed)
338
338
  → Orchestrator confirms to user
339
339
  ```
@@ -355,7 +355,6 @@ MCP tools (searchable memory backends, episodic-memory) are **orchestrator-scope
355
355
  |--------|-------|------|--------|----------|
356
356
  | Native auto-memory | sys-memory-keeper | Write | Update MEMORY.md with session learnings | Yes |
357
357
  | AgentMemory-compatible / omx-memory | Orchestrator | `memory_add` or `observation_add` | Save session summary with project, tasks, decisions | No (best-effort) |
358
- | legacy claude-mem | Orchestrator | `chroma_add_documents` or compatible save wrapper | Fallback searchable save when no preferred backend exists | No (best-effort) |
359
358
  | episodic-memory | Automatic | (auto-indexed) | No action needed — conversations are indexed automatically after session ends | N/A |
360
359
  -->
361
360
 
@@ -61,24 +61,17 @@ Check if Agent Teams is available (`OMCODEX_AGENT_TEAMS=1` or TeamCreate/SendMes
61
61
  | Cross-tool data quality analysis | Agent Teams |
62
62
  | Quick DAG/model validation | Agent Tool |
63
63
 
64
- ### Step 2: Codex-Exec Hybrid (Code Generation)
64
+ ### Step 2: External Interop Guidance (Code Generation)
65
65
  For **new pipeline code**, **DAG scaffolding**, or **SQL model generation**:
66
66
 
67
- 1. Check `/tmp/.codex-env-status-*` for codex, gemini, and rtk availability
68
- 2. If codex available AND task involves new file creation automatically delegate to `/codex-exec` for scaffolding:
69
- - Display: `[Codex Hybrid] Delegating to codex-exec...`
70
- - codex-exec generates initial code (strength: fast generation)
71
- - Selected DE expert reviews and refines codex output (strength: reasoning, quality)
72
- 3. If codex unavailable but gemini available → delegate to `/gemini-exec` for scaffolding:
73
- - Display: `[Gemini Hybrid] Delegating to gemini-exec...`
74
- - gemini-exec generates initial code
75
- - Selected DE expert reviews and refines output
76
- 4. If RTK available (`RTK=available` in env status) → optionally wrap DE expert output through RTK to reduce token consumption by 60-90%:
67
+ 1. Use the selected DE expert as the default implementation path.
68
+ 2. If the native Claude Code plugin `openai/codex-plugin-cc` is explicitly installed and requested, it may provide Codex interop for scaffolding before expert review.
69
+ 3. If RTK is available (`RTK=available` in env status), optionally wrap DE expert output through `rtk-exec` to reduce token consumption by 60-90%:
77
70
  - Display: `[RTK Proxy] Token optimization active via rtk-exec`
78
71
  - RTK acts as a transparent proxy — no change to expert selection
79
- 5. If none available → display `[External CLI] Unavailable — proceeding with {expert} directly` and use DE expert directly
72
+ 4. Otherwise display `[External CLI] Not requested — proceeding with {expert} directly` and use the expert directly.
80
73
 
81
- **Suitable**: New DAG files, dbt model scaffolding, SQL template generation
74
+ **Suitable for optional plugin interop**: New DAG files, dbt model scaffolding, SQL template generation
82
75
  **Unsuitable**: Existing pipeline modification, architecture decisions, data quality analysis
83
76
 
84
77
  ### Step 3: Expert Selection
@@ -104,24 +104,17 @@ Check if Agent Teams is available (`OMCODEX_AGENT_TEAMS=1` or TeamCreate/SendMes
104
104
  | Cross-layer debugging (FE + BE + DB) | Agent Teams |
105
105
  | Simple file search/validation | Task Tool |
106
106
 
107
- ### Step 2: Codex-Exec Hybrid (Implementation Tasks)
107
+ ### Step 2: External Interop Guidance (Implementation Tasks)
108
108
  For **new file creation**, **boilerplate**, or **test code generation**:
109
109
 
110
- 1. Check `/tmp/.codex-env-status-*` for codex, gemini, and rtk availability
111
- 2. If codex available AND task involves new file creation automatically delegate to `/codex-exec` for scaffolding:
112
- - Display: `[Codex Hybrid] Delegating to codex-exec...`
113
- - codex-exec generates initial code (strength: fast generation)
114
- - Selected Claude expert reviews and refines codex output (strength: reasoning, quality)
115
- 3. If codex unavailable but gemini available → delegate to `/gemini-exec` for scaffolding:
116
- - Display: `[Gemini Hybrid] Delegating to gemini-exec...`
117
- - gemini-exec generates initial code
118
- - Selected Claude expert reviews and refines output
119
- 4. If RTK available (`RTK=available` in env status) → optionally wrap Claude expert output through RTK to reduce token consumption by 60-90%:
110
+ 1. Use the selected expert agent as the default implementation path.
111
+ 2. If the native Claude Code plugin `openai/codex-plugin-cc` is explicitly installed and requested, it may provide Codex interop for scaffolding before expert review.
112
+ 3. If RTK is available (`RTK=available` in env status), optionally wrap expert output through `rtk-exec` to reduce token consumption by 60-90%:
120
113
  - Display: `[RTK Proxy] Token optimization active via rtk-exec`
121
114
  - RTK acts as a transparent proxy — no change to expert selection
122
- 5. If none available → display `[External CLI] Unavailable — proceeding with {expert} directly` and use Claude expert directly
115
+ 4. Otherwise display `[External CLI] Not requested — proceeding with {expert} directly` and use the expert directly.
123
116
 
124
- **Suitable**: New file creation, boilerplate, scaffolding, test code
117
+ **Suitable for optional plugin interop**: New file creation, boilerplate, scaffolding, test code
125
118
  **Unsuitable**: Existing code modification, architecture decisions, bug fixes
126
119
 
127
120
  ### Step 3: Expert Agent Selection
@@ -262,14 +262,12 @@ english:
262
262
  ```
263
263
  Research intent detected (confidence >= 70%)
264
264
 
265
- Check Codex CLI availability
266
- ├─ Available (codex binary + OPENAI_API_KEY)
267
- │ → Use codex-exec skill with --effort xhigh
268
- │ → Prompt: "Research and analyze: {user_request}"
269
- Returns: structured findings for orchestrator
270
- └─ Unavailable
271
- → Fall back to Claude's WebFetch/WebSearch
272
- → Orchestrator handles directly or via general-purpose agent
265
+ Use the research workflow or researcher/expert agents
266
+ ├─ Native Claude Code plugin `openai/codex-plugin-cc` explicitly installed/requested
267
+ │ → Optional Codex interop may assist analysis
268
+ └─ Otherwise
269
+ Use existing expert agents, researcher, WebFetch/WebSearch, or RTK paths
270
+ Orchestrator handles directly or via specialist agent
273
271
  ```
274
272
 
275
273
  ### Confidence Scoring
@@ -288,6 +286,6 @@ Check Codex CLI availability
288
286
  ├── Input: "{user input}"
289
287
  ├── Workflow: research-workflow
290
288
  ├── Confidence: {percentage}%
291
- ├── Method: codex-exec (xhigh) | WebFetch fallback
289
+ ├── Method: research workflow | researcher/expert agent | optional Codex plugin when requested
292
290
  └── Reason: {explanation}
293
291
  ```
@@ -7,15 +7,14 @@ user-invocable: false
7
7
 
8
8
  ## Purpose
9
9
 
10
- Provide memory persistence operations using native `MEMORY.md` first, then a searchable MCP backend for cross-session retrieval. Prefer an AgentMemory-compatible or `omx-memory` backend exposing `memory_search`, `memory_add`, and `observation_add`; use legacy `claude-mem` only as a fallback when that is the configured backend.
10
+ Provide memory persistence operations using native `MEMORY.md` first, then a searchable MCP backend for cross-session retrieval. Prefer `omx-memory` or another AgentMemory-compatible backend exposing `memory_search`, `memory_add`, and `observation_add`. Deprecated Chroma memory backends are not used in this project.
11
11
 
12
12
  ## Backend Order
13
13
 
14
14
  1. Native auto-memory: compact durable facts in `MEMORY.md`.
15
- 2. AgentMemory-compatible MCP or `omx-memory`: cross-session search, shared observations, and temporal recall.
16
- 3. Legacy `claude-mem`: fallback only when the project still exposes Chroma tools.
15
+ 2. `omx-memory` or AgentMemory-compatible MCP: cross-session search, shared observations, and temporal recall.
17
16
 
18
- When both legacy `claude-mem` and an AgentMemory-compatible backend are active, warn about split-brain storage. Dual-write is allowed only during an explicit migration window.
17
+ If multiple searchable backends are active, choose the configured canonical backend and record it in the session summary. Do not dual-write unless a migration window is explicitly documented.
19
18
 
20
19
  ## Operations
21
20
 
@@ -37,7 +36,6 @@ steps:
37
36
  3. Store in configured backend:
38
37
  - Prefer memory_add for session summaries
39
38
  - Use observation_add for atomic behavioral or project observations
40
- - Legacy fallback: chroma_add_documents
41
39
  - Include metadata
42
40
  ```
43
41
 
@@ -53,7 +51,6 @@ steps:
53
51
  - Include date for temporal searches
54
52
  2. Search configured backend:
55
53
  - Prefer memory_search
56
- - Legacy fallback: chroma_query_documents
57
54
  - Request top N results
58
55
  3. Format results:
59
56
  - Sort by relevance
@@ -68,7 +65,7 @@ operation: get
68
65
  description: Retrieve specific memory by ID
69
66
  steps:
70
67
  1. Prefer memory_read or memory_search by ID
71
- 2. Legacy fallback: chroma_get_documents with ID
68
+ 2. Fall back to `memory_search` with the ID when direct read is unavailable
72
69
  3. Return full document content
73
70
  ```
74
71
 
@@ -80,8 +77,6 @@ steps:
80
77
  # Always include project name
81
78
  memory_search({ query: "my-project {search_terms}", limit: 8 })
82
79
 
83
- # Legacy fallback
84
- chroma_query_documents(["my-project {search_terms}"])
85
80
 
86
81
  # Examples:
87
82
  memory_search({ query: "my-project authentication flow", limit: 5 })
@@ -91,8 +86,8 @@ memory_search({ query: "my-project 2025-01-24 memory system", limit: 5 })
91
86
  ### Get by ID
92
87
 
93
88
  ```python
94
- # When you have a specific document ID and only legacy tools are available
95
- chroma_get_documents(ids=["document_id"])
89
+ # When you have a specific document ID
90
+ memory_read({ id: "document_id" })
96
91
  ```
97
92
 
98
93
  ## Document Format
@@ -219,7 +214,7 @@ recall_errors:
219
214
 
220
215
  | Capability | Searchable MCP | MemKraft |
221
216
  |-----------|-----------|----------|
222
- | Session persistence | ✅ (Chroma) | ✅ (Markdown) |
217
+ | Session persistence | ✅ (approved searchable backend) | ✅ (Markdown) |
223
218
  | Entity tracking | ❌ | ✅ (person/org/concept) |
224
219
  | Source attribution | ❌ | ✅ (`[Source: who, when, how]`) |
225
220
  | Auto-maintenance | ❌ | ✅ (Dream Cycle) |
@@ -8,7 +8,7 @@ user-invocable: true
8
8
 
9
9
  # Memory Recall Skill
10
10
 
11
- Search and recall relevant memories from native `MEMORY.md` plus the configured searchable MCP backend. Prefer AgentMemory-compatible or `omx-memory` tools (`memory_search`, `memory_read`); fall back to legacy `claude-mem` Chroma tools only when those are the configured backend.
11
+ Search and recall relevant memories from native `MEMORY.md` plus the configured searchable MCP backend. Prefer `omx-memory` or AgentMemory-compatible tools (`memory_search`, `memory_read`). Deprecated Chroma memory backends are not used in this project.
12
12
 
13
13
  ## Parameters
14
14
 
@@ -35,7 +35,7 @@ Search and recall relevant memories from native `MEMORY.md` plus the configured
35
35
 
36
36
  2. Search configured backend
37
37
  ├── Prefer memory_search
38
- └── Legacy fallback: chroma_query_documents
38
+ └── Report backend unavailable when no approved memory MCP is configured
39
39
 
40
40
  3. Format results
41
41
  ├── Sort by relevance score
@@ -9,7 +9,7 @@ user-invocable: true
9
9
 
10
10
  # Memory Save Skill
11
11
 
12
- Save current session context to native memory and the configured searchable MCP backend for persistence across context compaction. Prefer AgentMemory-compatible or `omx-memory` tools (`memory_add`, `observation_add`); fall back to legacy `claude-mem` only when that is the configured backend.
12
+ Save current session context to native memory and the configured searchable MCP backend for persistence across context compaction. Prefer `omx-memory` or AgentMemory-compatible tools (`memory_add`, `observation_add`). Deprecated Chroma memory backends are not used in this project.
13
13
 
14
14
  ## Options
15
15
 
@@ -38,7 +38,7 @@ Save current session context to native memory and the configured searchable MCP
38
38
  3. Store in configured backend
39
39
  ├── Prefer memory_add for summaries
40
40
  ├── Prefer observation_add for atomic learnings
41
- └── Legacy fallback: chroma_add_documents
41
+ └── Skip searchable save when no approved backend is configured
42
42
 
43
43
  4. Report result
44
44
  ```
@@ -17,7 +17,7 @@ Enables cross-session coordination between multiple GPT Codex + OMX sessions thr
17
17
  |-------|-----------|-------|----------|
18
18
  | Intra-session agents | Agent Teams (R018) | TeamCreate, SendMessage | Single session multi-agent collaboration |
19
19
  | Cross-session instances | claude-peers-mcp | list_peers, send_message | Multi-terminal/project real-time coordination |
20
- | Cross-session memory | claude-mem | save_memory, search | Async memory persistence |
20
+ | Cross-session memory | omx-memory / AgentMemory-compatible MCP | memory_add, memory_search | Async memory persistence |
21
21
 
22
22
  > **Important**: R018's `SendMessage` and claude-peers-mcp's `send_message` are different tools with different scopes. Do not confuse them.
23
23
 
@@ -54,6 +54,6 @@ claude mcp add claude-peers-mcp -- npx claude-peers-mcp
54
54
  ## Integration
55
55
 
56
56
  - Works with R018 Agent Teams (different scope, complementary)
57
- - Works with claude-mem (async vs sync messaging)
57
+ - Works with omx-memory or AgentMemory-compatible memory backends (async vs sync messaging)
58
58
  - Works with `omcodex:status` (peer discovery)
59
59
  - Broker runs on localhost:7899 (SQLite-backed)
@@ -167,17 +167,8 @@ Batch 3: T9, T10 (Innovation)
167
167
 
168
168
  Before starting verification rounds, check codex availability:
169
169
 
170
- ```bash
171
- # Run this check once before Phase 2 begins
172
- which codex &>/dev/null && [ -n "$OPENAI_API_KEY" ]
173
- # Exit 0 → codex available: enable dual-model verification (opus + codex)
174
- # Exit 1 → codex unavailable: display notice and proceed with opus-only
175
- ```
176
-
177
- If unavailable, display: `[Phase 2] Codex unavailable — opus-only verification`
178
-
179
170
  ```
180
- Team findings ──→ opus 4.6 verification ──→ codex-exec xhigh verification (if available)
171
+ Team findings ──→ opus 4.6 verification ──→ optional plugin-assisted verification
181
172
  │ │
182
173
  └── Contradiction detected? ── YES ──→ Round N+1
183
174
  NO ──→ Consensus reached → Phase 3
@@ -185,8 +176,7 @@ Team findings ──→ opus 4.6 verification ──→ codex-exec xhigh verific
185
176
 
186
177
  Each round:
187
178
  1. **opus 4.6**: Deep reasoning verification — checks logical consistency, identifies gaps, challenges assumptions
188
- 2. **codex-exec xhigh** (when available): Independent code-level verification validates technical claims, tests feasibility
189
- - If unavailable: display `[Phase 2] Round {N}: Codex unavailable, proceeding with opus verification only`
179
+ 2. **Optional Codex interop**: Use native Claude Code plugin `openai/codex-plugin-cc` only when explicitly installed/requested; otherwise use researcher or RTK-backed local evidence gathering.
190
180
  3. **Contradiction resolution**: Reconcile divergent findings between teams and verifiers
191
181
  4. **Convergence check**: All major claims verified with no outstanding contradictions → proceed
192
182
 
@@ -319,16 +309,11 @@ Round N:
319
309
  - Internal consistency (breadth ↔ depth alignment)
320
310
  - Cross-domain consistency (security ↔ architecture)
321
311
  - Evidence quality (claims without backing)
322
- Step 2: codex-exec validates technical claims (when available):
323
- a. Invoke: /codex-exec with findings from all teams
324
- b. Prompt: "Validate technical claims: {findings}.
325
- Check code patterns, benchmark reproducibility,
326
- dependency resolution."
327
- c. Effort: --effort xhigh
328
- d. Parse: contradictions → merge with opus findings
329
- e. On timeout/error: log "[Phase 2] Round {N}: codex-exec error — {reason},
330
- continuing with opus results only"
331
- If unavailable: log "[Phase 2] Round {N}: Codex unavailable, proceeding with opus verification only"
312
+ Step 2: Optional plugin-assisted validation (only if `openai/codex-plugin-cc` is explicitly installed/requested):
313
+ a. Validate technical claims against code patterns, benchmark reproducibility,
314
+ and dependency resolution.
315
+ b. Parse contradictions merge with opus findings.
316
+ c. On unavailable plugin or error: log "[Phase 2] Round {N}: optional Codex interop unavailable — continuing with opus/researcher results".
332
317
  Step 3: Compile contradiction list
333
318
  - 0 contradictions → CONVERGED
334
319
  - >0 contradictions → feedback to relevant teams → Round N+1
@@ -410,7 +395,7 @@ This advisory is informational only and does not block execution.
410
395
 
411
396
  | Scenario | Fallback |
412
397
  |----------|----------|
413
- | codex-exec unavailable | opus-only verification (still min 2 rounds) |
398
+ | Optional Codex plugin unavailable | opus/researcher verification (still min 2 rounds) |
414
399
  | Agent Teams unavailable | Standard Agent tool with R009 batching |
415
400
  | Partial team failure | Synthesize from available results, note gaps in report |
416
401
  | GitHub issue creation fails | Output report to conversation only |
@@ -12,7 +12,7 @@ version: 1.0.0
12
12
 
13
13
  ## Purpose
14
14
 
15
- Run a bounded debate when convergence would hide useful disagreement. Unlike `agora`, which drives toward consensus, this workflow preserves minority positions and requires explicit justification before dismissing them.
15
+ Run a bounded debate when convergence would hide useful disagreement. Use this workflow when debate should preserve minority positions and require explicit justification before dismissing them.
16
16
 
17
17
  ## When To Use
18
18
 
@@ -54,11 +54,10 @@ Hard cap: two debate rounds. If the decision still depends on missing facts, sto
54
54
  {adopt | defer | reject | gather-more-evidence}
55
55
  ```
56
56
 
57
- ## Relationship To Agora
57
+ ## Relationship To Other Review Workflows
58
58
 
59
59
  | Workflow | Goal | Best For |
60
60
  |----------|------|----------|
61
- | `agora` | adversarial consensus | release gates, spec approval |
62
61
  | `roundtable-debate` | dissent preservation | ambiguous strategy, architectural tradeoffs |
63
62
 
64
- Use `agora --anti-groupthink` when you need consensus plus explicit dissent handling.
63
+ Use `roundtable-debate` when current guidance needs adversarial review plus explicit dissent handling.
@@ -93,15 +93,12 @@ A PreToolUse hook in `.codex/hooks/hooks.json` checks this marker and blocks Wri
93
93
  └── Output: Implementation complete
94
94
  ```
95
95
 
96
- **Codex-Exec Hybrid Option**: When entering Stage 3:
97
- 1. Check `/tmp/.codex-env-status-*` for codex CLI availability
98
- 2. If available AND task involves new file creation automatically delegate scaffolding to `/codex-exec`:
99
- - Display: `[Codex Hybrid] Delegating scaffolding to codex-exec...`
100
- - codex-exec generates initial code (strength: fast generation)
101
- - Claude expert reviews and refines codex output (strength: reasoning, quality)
102
- 3. If unavailable → display `[Codex] Unavailable — proceeding with Claude experts directly` and proceed with standard implementation via Claude experts
103
-
104
- Suitable for codex hybrid: new files, boilerplate, test stubs, scaffolding
96
+ **Optional Codex Plugin Interop**: When entering Stage 3:
97
+ 1. Use domain expert agents as the default implementation path.
98
+ 2. If the native Claude Code plugin `openai/codex-plugin-cc` is explicitly installed and requested, it may provide Codex interop for new-file scaffolding before expert review.
99
+ 3. Otherwise display `[Codex Plugin] Not requested proceeding with expert agents directly` and proceed with standard implementation.
100
+
101
+ Suitable for optional plugin interop: new files, boilerplate, test stubs, scaffolding
105
102
  Not suitable: modifying existing code, architecture-dependent changes
106
103
 
107
104
  **Exit criteria**: All planned files created/modified, tests written.
@@ -157,7 +154,7 @@ The stage marker file (`/tmp/.codex-dev-stage`) is read by a PreToolUse hook tha
157
154
  For complex tasks, Agent Teams is **preferred** when available (R018):
158
155
  - Plan: architect agent
159
156
  - Verify: reviewer agent(s) — multi-model-verification via Agent Teams
160
- - Implement: domain expert agent (+ codex-exec hybrid if available)
157
+ - Implement: domain expert agent (+ optional `openai/codex-plugin-cc` interop only when explicitly installed/requested)
161
158
  - Compound: QA agent
162
159
 
163
160
  When Agent Teams is enabled AND task involves 3+ agents or review→fix cycles, using Agent Teams is MANDATORY per R018.
@@ -110,7 +110,6 @@ NO EXCEPTIONS. NO EXCUSES.
110
110
  | `/omcustomcodex:npm-version` | Manage semantic versions |
111
111
  | `/omcustomcodex:npm-audit` | Audit dependencies |
112
112
  | `/omcustomcodex-release-notes` | Generate release notes from git history |
113
- | `/codex-exec` | Execute Codex CLI prompts |
114
113
  | `/optimize-analyze` | Analyze bundle and performance |
115
114
  | `/optimize-bundle` | Optimize bundle size |
116
115
  | `/optimize-report` | Generate optimization report |
@@ -134,7 +133,7 @@ project/
134
133
  | +-- hooks/ # Hook scripts (security, validation, HUD)
135
134
  | +-- contexts/ # Context files (ecomode)
136
135
  +-- .agents/
137
- | +-- skills/ # Installed skills (123 directories)
136
+ | +-- skills/ # Installed skills (120 directories)
138
137
  +-- guides/ # Reference docs (51 topics)
139
138
  ```
140
139
 
@@ -110,7 +110,6 @@ oh-my-customcodex로 구동됩니다.
110
110
  | `/omcustomcodex:npm-version` | 시맨틱 버전 관리 |
111
111
  | `/omcustomcodex:npm-audit` | 의존성 감사 |
112
112
  | `/omcustomcodex-release-notes` | 릴리즈 노트 생성 (git 히스토리 기반) |
113
- | `/codex-exec` | Codex CLI 프롬프트 실행 |
114
113
  | `/optimize-analyze` | 번들 및 성능 분석 |
115
114
  | `/optimize-bundle` | 번들 크기 최적화 |
116
115
  | `/optimize-report` | 최적화 리포트 생성 |
@@ -134,7 +133,7 @@ project/
134
133
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
135
134
  | +-- contexts/ # 컨텍스트 파일 (ecomode)
136
135
  +-- .agents/
137
- | +-- skills/ # 설치된 스킬 (123 디렉토리)
136
+ | +-- skills/ # 설치된 스킬 (120 디렉토리)
138
137
  +-- guides/ # 레퍼런스 문서 (51 토픽)
139
138
  ```
140
139
 
@@ -102,7 +102,7 @@ oh-my-customcodex로 구동됩니다.
102
102
  | 개발 | `/omcustomcodex:goal`, `/dev-review`, `/dev-refactor`, `/sdd-dev`, `/structured-dev-cycle` | 목표 실행, 코드 리뷰, 리팩토링, SDD |
103
103
  | 검증 | `/omcustomcodex:sauron-watch`, `/deep-verify`, `/adversarial-review` | R017 검증, 릴리즈 품질, 보안 리뷰 |
104
104
  | 릴리즈 | `/pipeline auto-dev`, `/omcustomcodex-release-notes`, `/release-plan` | 자동 개발, 릴리즈 노트 |
105
- | 리서치 | `/research`, `/scout`, `/deep-plan`, `/omcustomcodex:agora` | 병렬 분석, URL 평가, 연구 계획 |
105
+ | 리서치 | `/research`, `/scout`, `/deep-plan`, `/roundtable-debate` | 병렬 분석, URL 평가, 토론형 검증 |
106
106
  | 메모리 | `/memory-save`, `/memory-recall` | 세션 메모리 관리 |
107
107
  | 시스템 | `/token-efficiency-audit`, `/pre-generation-arch-check`, `/omcustomcodex:lists`, `/omcustomcodex:status`, `/omcustomcodex:help` | 토큰 효율/아키텍처 감사, 전체 목록, 상태, 도움말 |
108
108
 
@@ -119,7 +119,7 @@ project/
119
119
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
120
120
  | +-- contexts/ # 컨텍스트 파일 (ecomode)
121
121
  +-- .agents/
122
- | +-- skills/ # 스킬 (123 디렉토리)
122
+ | +-- skills/ # 스킬 (120 디렉토리)
123
123
  +-- guides/ # 레퍼런스 문서 (51 토픽)
124
124
  ```
125
125
 
@@ -112,7 +112,6 @@ NO EXCEPTIONS. NO EXCUSES.
112
112
  | `/omcustomcodex:npm-version` | Manage semantic versions |
113
113
  | `/omcustomcodex:npm-audit` | Audit dependencies |
114
114
  | `/omcustomcodex-release-notes` | Generate release notes from git history |
115
- | `/codex-exec` | Execute Codex CLI prompts |
116
115
  | `/optimize-analyze` | Analyze bundle and performance |
117
116
  | `/optimize-bundle` | Optimize bundle size |
118
117
  | `/optimize-report` | Generate optimization report |
@@ -133,7 +132,7 @@ project/
133
132
  +-- AGENTS.md # Entry point
134
133
  +-- .codex/
135
134
  | +-- agents/ # Subagent definitions (50 files)
136
- | +-- skills/ # Skills (123 directories)
135
+ | +-- skills/ # Skills (120 directories)
137
136
  | +-- rules/ # Global rules (22 files)
138
137
  | +-- hooks/ # Hook scripts (security, validation, HUD)
139
138
  | +-- contexts/ # Context files (4 files)
@@ -112,7 +112,6 @@ oh-my-customcodex로 구동됩니다.
112
112
  | `/omcustomcodex:npm-version` | 시맨틱 버전 관리 |
113
113
  | `/omcustomcodex:npm-audit` | 의존성 감사 |
114
114
  | `/omcustomcodex-release-notes` | 릴리즈 노트 생성 (git 히스토리 기반) |
115
- | `/codex-exec` | Codex CLI 프롬프트 실행 |
116
115
  | `/optimize-analyze` | 번들 및 성능 분석 |
117
116
  | `/optimize-bundle` | 번들 크기 최적화 |
118
117
  | `/optimize-report` | 최적화 리포트 생성 |
@@ -133,7 +132,7 @@ project/
133
132
  +-- AGENTS.md # 진입점
134
133
  +-- .codex/
135
134
  | +-- agents/ # 서브에이전트 정의 (50 파일)
136
- | +-- skills/ # 스킬 (123 디렉토리)
135
+ | +-- skills/ # 스킬 (120 디렉토리)
137
136
  | +-- rules/ # 전역 규칙 (22 파일)
138
137
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
139
138
  | +-- contexts/ # 컨텍스트 파일 (4 파일)
@@ -46,7 +46,7 @@ templates/
46
46
  +-- workflows/ # project-level pipeline definitions
47
47
  +-- .claude/
48
48
  | +-- agents/ # agent definitions (50 files)
49
- | +-- skills/ # skill modules (123 SKILL.md files)
49
+ | +-- skills/ # skill modules (120 SKILL.md files)
50
50
  | +-- rules/ # global rules (22 files)
51
51
  | +-- hooks/ # hook registry and scripts (40 scripts)
52
52
  | +-- contexts/ # context files
@@ -65,7 +65,7 @@ The counts below should stay aligned with `templates/manifest.json`, README comp
65
65
 
66
66
  Flat agent definition files. During Codex installation these land under `.codex/agents/`.
67
67
 
68
- ### Skills (123)
68
+ ### Skills (120)
69
69
 
70
70
  `templates/.claude/skills/*/SKILL.md`
71
71
 
@@ -1,120 +1,20 @@
1
- # AgentMemory 마이그레이션단계 0: MEASURE (사용 빈도 측정)
1
+ # External Memory Migration Retired Measurement Plan
2
2
 
3
- > **목적**: Phase 1 (COEXIST) 진입 전, claude-mem skill 실제 호출 빈도 데이터를 수집하여 가설 기반 자산 처리표를 검증한다.
4
- > **관련 이슈**: #1169 본문 조치 5
5
- > **참고 메모리**: `feedback_claude_mem_maintenance`, `project_sequencing_alpha_beta_gamma`
3
+ > **Status**: Retired by #1426. The project no longer measures or operates the deprecated Chroma-based memory plugin.
4
+ > **Current policy**: Native auto-memory is primary; `omx-memory` or an AgentMemory-compatible MCP may be used only as an approved searchable supplement.
6
5
 
7
- ---
6
+ ## Decision
8
7
 
9
- ## 1. 목적
8
+ The previous measurement-first migration plan is obsolete. The project no longer needs usage baselining for the deprecated plugin because that backend is no longer an accepted dependency.
10
9
 
11
- AgentMemory 마이그레이션 계획(`feedback_claude_mem_maintenance.md`)에는 12개 claude-mem skill의 처리 방향이 가설로 기재되어 있다. 특히 폐기 후보 5종(`make-plan`, `do`, `babysit`, `wowerpoint`, `knowledge-agent`, `pathfinder`)은 "미사용 또는 저빈도"라는 가정 위에 놓여 있다.
10
+ ## Replacement Workflow
12
11
 
13
- 단계에서는 실측 데이터로 가설을 검증한다. 데이터 없이 Phase 1에 진입하면:
14
- - 실제로 자주 쓰이던 skill을 폐기하여 사용자 워크플로우가 깨질 있다.
15
- - 자산 처리표 재설계 비용이 Phase 2~3로 이월된다.
12
+ 1. Keep durable agent facts in native `MEMORY.md` files.
13
+ 2. Use `memory_search`, `memory_read`, `memory_add`, or `observation_add` only when an approved searchable backend is configured.
14
+ 3. Skip searchable persistence when no approved backend is available; do not install or invoke deprecated Chroma memory tooling.
15
+ 4. Record memory-backend decisions in R011 and the session summary.
16
16
 
17
- ---
17
+ ## Verification
18
18
 
19
- ## 2. 실행 방법
20
-
21
- ```bash
22
- # 기본 실행 (최근 7일, 리포트를 ~/.claude/measure-claude-mem-usage-YYYY-MM-DD.md 에 저장)
23
- bash scripts/measure-claude-mem-usage.sh
24
-
25
- # 최근 14일 스캔
26
- bash scripts/measure-claude-mem-usage.sh --days 14
27
-
28
- # 출력 경로 지정
29
- bash scripts/measure-claude-mem-usage.sh --output ~/Documents/claude-mem-usage.md
30
-
31
- # 헤더 없이 실행 (CI/파이프라인 삽입용)
32
- bash scripts/measure-claude-mem-usage.sh --quiet
33
- ```
34
-
35
- ### 스캔 대상 경로
36
-
37
- | 경로 | 설명 |
38
- |------|------|
39
- | `~/.claude-mem/archives/` | claude-mem MCP 아카이브 (`.jsonl`, `.json`) |
40
- | `~/.claude/projects/*/session-*.jsonl` | Claude Code 세션 로그 |
41
-
42
- 둘 중 하나가 없어도 스크립트는 조용히 skip하고 나머지를 스캔한다.
43
-
44
- ---
45
-
46
- ## 3. 1주 수집 계획
47
-
48
- | 시점 | 작업 |
49
- |------|------|
50
- | **Day 1** | 첫 측정 — 베이스라인 (`--days 7` 기준 기존 archives 기반) |
51
- | **Day 4** | 중간 측정 — 추이 확인 (`--days 4`) |
52
- | **Day 7** | 최종 측정 — 자산 처리표 재검토 및 Phase 1 GO/NO-GO 결정 |
53
-
54
- 세 시점 모두 `--output` 경로를 달리 지정하여 비교 가능한 파일로 보관한다:
55
-
56
- ```bash
57
- bash scripts/measure-claude-mem-usage.sh --output ~/.claude/claude-mem-day1.md
58
- bash scripts/measure-claude-mem-usage.sh --days 4 --output ~/.claude/claude-mem-day4.md
59
- bash scripts/measure-claude-mem-usage.sh --days 7 --output ~/.claude/claude-mem-day7.md
60
- ```
61
-
62
- ---
63
-
64
- ## 4. 해석 기준
65
-
66
- | 호출 수 | 신호 | 권장 조치 |
67
- |---------|------|----------|
68
- | **0** | 미사용 | 폐기 안전 — 1주 후 처리 결정 |
69
- | **1-3** | 가끔 사용 | wrapper 또는 대체 도구 매핑 필요 |
70
- | **4+** | 정기 사용 | 폐기 시 대체 도구 명확화 필수 |
71
-
72
- 폐기 후보 5종 기준 예상:
73
- - `make-plan`, `do`, `babysit` → 0 예상 (native AgentMemory로 대체 완료)
74
- - `wowerpoint`, `knowledge-agent`, `pathfinder` → 0~1 예상 (특수 목적 skill)
75
-
76
- 실측값이 예상과 다를 경우 자산 처리표를 수정한 후 Phase 1에 진입한다.
77
-
78
- ---
79
-
80
- ## 5. 결과 활용
81
-
82
- ### 5-1. #1169에 리포트 첨부
83
-
84
- ```bash
85
- gh issue comment 1169 --body-file ~/.claude/claude-mem-day7.md
86
- ```
87
-
88
- ### 5-2. 자산 처리표 갱신
89
-
90
- `.claude/agent-memory/sys-memory-keeper/feedback_claude_mem_maintenance.md` 내 "처리 방향" 열을 실측값 기반으로 업데이트한다.
91
-
92
- ### 5-3. Phase 1 GO/NO-GO 결정
93
-
94
- | 조건 | 결정 |
95
- |------|------|
96
- | 폐기 후보 모두 호출 수 0 | GO — Phase 1 진입 |
97
- | 폐기 후보 중 1개 이상 호출 수 1-3 | CONDITIONAL GO — 대체 도구 매핑 완료 후 진입 |
98
- | 폐기 후보 중 1개 이상 호출 수 4+ | NO-GO — 처리표 재설계 후 재측정 |
99
-
100
- ---
101
-
102
- ## 6. 한계 및 주의사항
103
-
104
- | 항목 | 설명 |
105
- |------|------|
106
- | archives 미존재 | `~/.claude-mem/archives/` 없으면 카운트 0 (정상 — silent skip) |
107
- | 세션 로그 형식 변경 | Claude Code 업데이트로 `session-*.jsonl` 구조가 변경되면 grep 패턴 수정 필요 |
108
- | claude-mem MCP telemetry 미사용 | 외부 도구 의존 최소화 원칙에 따라 MCP 자체 지표는 사용하지 않음 |
109
- | grep 기반 측정 | 같은 파일에 skill 이름이 여러 줄 등장하면 복수 카운트됨 (과대 계산 가능성) |
110
- | macOS/Linux 호환 | `stat` 옵션 차이를 스크립트 내에서 자동 처리 (`-f %m` vs `-c %Y`) |
111
-
112
- ---
113
-
114
- ## 7. 참고
115
-
116
- - **이슈**: [#1169](../../.github/ — `gh issue view 1169`)
117
- - **자산 처리표**: `.claude/agent-memory/sys-memory-keeper/feedback_claude_mem_maintenance.md`
118
- - **시퀀싱 메모리**: `.claude/agent-memory/mgr-creator/project_sequencing_alpha_beta_gamma.md` (또는 해당 메모리 파일)
119
- - **스크립트**: `scripts/measure-claude-mem-usage.sh`
120
- - **Phase 1 가이드**: `guides/agentmemory-migration/` (이 디렉토리에 추가 예정)
19
+ - Repository search should not find active instructions for removed memory-plugin names or plugin-specific tool calls.
20
+ - Memory skills must mention native memory and approved searchable MCP tools, not legacy plugin-specific commands.