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.
- package/README.md +4 -4
- package/dist/cli/index.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/agents/arch-speckit-agent.md +1 -1
- package/templates/.claude/agents/sys-memory-keeper.md +9 -9
- package/templates/.claude/hooks/scripts/agent-teams-advisor.sh +4 -1
- package/templates/.claude/ontology/agents.yaml +16 -4
- package/templates/.claude/ontology/skills.yaml +9 -9
- package/templates/.claude/rules/MUST-agent-teams.md +85 -246
- package/templates/.claude/rules/SHOULD-memory-integration.md +4 -5
- package/templates/.claude/skills/de-lead-routing/SKILL.md +6 -13
- package/templates/.claude/skills/dev-lead-routing/SKILL.md +6 -13
- package/templates/.claude/skills/intent-detection/SKILL.md +7 -9
- package/templates/.claude/skills/memory-management/SKILL.md +7 -12
- package/templates/.claude/skills/memory-recall/SKILL.md +2 -2
- package/templates/.claude/skills/memory-save/SKILL.md +2 -2
- package/templates/.claude/skills/peer-messaging/SKILL.md +2 -2
- package/templates/.claude/skills/research/SKILL.md +8 -23
- package/templates/.claude/skills/roundtable-debate/SKILL.md +3 -4
- package/templates/.claude/skills/structured-dev-cycle/SKILL.md +7 -10
- package/templates/AGENTS.md.en +1 -2
- package/templates/AGENTS.md.ko +1 -2
- package/templates/CLAUDE.md +2 -2
- package/templates/CLAUDE.md.en +1 -2
- package/templates/CLAUDE.md.ko +1 -2
- package/templates/README.md +2 -2
- package/templates/guides/agentmemory-migration/measure-step-zero.md +13 -113
- package/templates/guides/agentmemory-migration/phase-1-coexist.md +18 -252
- package/templates/guides/index.yaml +1 -1
- package/templates/guides/multi-agent-debate-patterns/README.md +1 -1
- package/templates/guides/multi-provider-exec/README.md +9 -79
- package/templates/manifest.json +3 -3
- package/templates/.claude/skills/agora/SKILL.md +0 -209
- package/templates/.claude/skills/codex-exec/SKILL.md +0 -218
- package/templates/.claude/skills/codex-exec/scripts/codex-wrapper.cjs +0 -433
- package/templates/.claude/skills/gemini-exec/SKILL.md +0 -215
- 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
|
|
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`.
|
|
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 (
|
|
336
|
-
2.
|
|
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:
|
|
64
|
+
### Step 2: External Interop Guidance (Code Generation)
|
|
65
65
|
For **new pipeline code**, **DAG scaffolding**, or **SQL model generation**:
|
|
66
66
|
|
|
67
|
-
1.
|
|
68
|
-
2. If
|
|
69
|
-
|
|
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
|
-
|
|
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:
|
|
107
|
+
### Step 2: External Interop Guidance (Implementation Tasks)
|
|
108
108
|
For **new file creation**, **boilerplate**, or **test code generation**:
|
|
109
109
|
|
|
110
|
-
1.
|
|
111
|
-
2. If
|
|
112
|
-
|
|
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
|
-
|
|
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
|
-
|
|
266
|
-
├─
|
|
267
|
-
│ →
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
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:
|
|
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
|
|
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
|
|
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
|
-
|
|
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.
|
|
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
|
|
95
|
-
|
|
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 | ✅ (
|
|
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
|
|
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
|
-
└──
|
|
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
|
|
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
|
-
└──
|
|
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 |
|
|
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
|
|
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 ──→
|
|
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-
|
|
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:
|
|
323
|
-
a.
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
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
|
-
|
|
|
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.
|
|
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
|
|
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 `
|
|
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
|
|
97
|
-
1.
|
|
98
|
-
2. If
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
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-
|
|
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.
|
package/templates/AGENTS.md.en
CHANGED
|
@@ -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 (
|
|
136
|
+
| +-- skills/ # Installed skills (120 directories)
|
|
138
137
|
+-- guides/ # Reference docs (51 topics)
|
|
139
138
|
```
|
|
140
139
|
|
package/templates/AGENTS.md.ko
CHANGED
|
@@ -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/ # 설치된 스킬 (
|
|
136
|
+
| +-- skills/ # 설치된 스킬 (120 디렉토리)
|
|
138
137
|
+-- guides/ # 레퍼런스 문서 (51 토픽)
|
|
139
138
|
```
|
|
140
139
|
|
package/templates/CLAUDE.md
CHANGED
|
@@ -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`, `/
|
|
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/ # 스킬 (
|
|
122
|
+
| +-- skills/ # 스킬 (120 디렉토리)
|
|
123
123
|
+-- guides/ # 레퍼런스 문서 (51 토픽)
|
|
124
124
|
```
|
|
125
125
|
|
package/templates/CLAUDE.md.en
CHANGED
|
@@ -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 (
|
|
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)
|
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -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/ # 스킬 (
|
|
135
|
+
| +-- skills/ # 스킬 (120 디렉토리)
|
|
137
136
|
| +-- rules/ # 전역 규칙 (22 파일)
|
|
138
137
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
139
138
|
| +-- contexts/ # 컨텍스트 파일 (4 파일)
|
package/templates/README.md
CHANGED
|
@@ -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 (
|
|
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 (
|
|
68
|
+
### Skills (120)
|
|
69
69
|
|
|
70
70
|
`templates/.claude/skills/*/SKILL.md`
|
|
71
71
|
|
|
@@ -1,120 +1,20 @@
|
|
|
1
|
-
#
|
|
1
|
+
# External Memory Migration — Retired Measurement Plan
|
|
2
2
|
|
|
3
|
-
>
|
|
4
|
-
>
|
|
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
|
-
|
|
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
|
-
|
|
10
|
+
## Replacement Workflow
|
|
12
11
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
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
|
-
|
|
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.
|