oh-my-customcodex 0.4.13 → 0.4.15

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 CHANGED
@@ -13,7 +13,7 @@
13
13
 
14
14
  **[한국어 문서 (Korean)](./README_ko.md)**
15
15
 
16
- 49 agents. 117 skills. 22 rules. One command.
16
+ 49 agents. 118 skills. 22 rules. One command.
17
17
 
18
18
  ```bash
19
19
  npm install -g oh-my-customcodex && cd your-project && omcustomcodex init
@@ -134,7 +134,7 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
134
134
 
135
135
  ---
136
136
 
137
- ### Skills (117)
137
+ ### Skills (118)
138
138
 
139
139
  | Category | Count | Includes |
140
140
  |----------|-------|----------|
@@ -170,6 +170,7 @@ All commands are invoked inside the oh-my-customcodex GPT Codex + OMX session.
170
170
  | `/ambiguity-gate` | Pre-routing ambiguity analysis |
171
171
  | `/pre-generation-arch-check` | Check architecture risks before implementation |
172
172
  | `/adversarial-review` | Attacker-mindset security code review |
173
+ | `/goal` | Keep a concrete objective in view through planning, execution, and verification |
173
174
  | `/pipeline` | Execute YAML-defined pipelines |
174
175
  | `/pipeline resume` | Resume a halted pipeline from last failure point |
175
176
 
@@ -286,7 +287,7 @@ your-project/
286
287
  │ ├── contexts/ # 4 shared context files
287
288
  │ └── ontology/ # Knowledge graph for RAG
288
289
  ├── .agents/
289
- │ └── skills/ # 117 installed skill modules
290
+ │ └── skills/ # 118 installed skill modules
290
291
  └── guides/ # 47 reference documents
291
292
  ```
292
293
 
package/dist/cli/index.js CHANGED
@@ -3091,7 +3091,7 @@ var init_package = __esm(() => {
3091
3091
  workspaces: [
3092
3092
  "packages/*"
3093
3093
  ],
3094
- version: "0.4.13",
3094
+ version: "0.4.15",
3095
3095
  requiresCC: ">=2.1.121",
3096
3096
  claudeCode: {
3097
3097
  minimumVersion: "2.1.121",
package/dist/index.js CHANGED
@@ -2180,7 +2180,7 @@ var package_default = {
2180
2180
  workspaces: [
2181
2181
  "packages/*"
2182
2182
  ],
2183
- version: "0.4.13",
2183
+ version: "0.4.15",
2184
2184
  requiresCC: ">=2.1.121",
2185
2185
  claudeCode: {
2186
2186
  minimumVersion: "2.1.121",
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "workspaces": [
4
4
  "packages/*"
5
5
  ],
6
- "version": "0.4.13",
6
+ "version": "0.4.15",
7
7
  "requiresCC": ">=2.1.121",
8
8
  "claudeCode": {
9
9
  "minimumVersion": "2.1.121",
@@ -45,6 +45,10 @@ classes:
45
45
  skills: [status, help, lists]
46
46
  description: "System information and utilities"
47
47
 
48
+ GoalWorkflowSkill:
49
+ skills: [goal]
50
+ description: "Goal-to-execution workflow coordination"
51
+
48
52
  VerificationSkill:
49
53
  skills: [sauron-watch]
50
54
  description: "Verification and compliance"
@@ -174,6 +178,16 @@ skills:
174
178
  keywords: [review, code-review, best-practices, quality]
175
179
  rule_references: []
176
180
 
181
+ goal:
182
+ class: GoalWorkflowSkill
183
+ description: "Goal-to-execution workflow for disciplined Codex + OMX task completion"
184
+ user_invocable: true
185
+ model_invocable: true
186
+ scope: core
187
+ summary: "Keep a concrete objective visible through clarification, planning, execution, verification, and completion reporting"
188
+ keywords: [goal, objective, planning, execution, verification, completion]
189
+ rule_references: [R020]
190
+
177
191
  docker-best-practices:
178
192
  class: BestPracticeSkill
179
193
  description: "Docker patterns for optimized containerization"
@@ -0,0 +1,86 @@
1
+ ---
2
+ name: goal
3
+ description: Goal-to-execution workflow for disciplined Codex + OMX task completion
4
+ scope: core
5
+ version: 1.0.0
6
+ user-invocable: true
7
+ argument-hint: "<objective>"
8
+ ---
9
+
10
+ # /goal - Goal-To-Execution Workflow
11
+
12
+ Use `/goal <objective>` when the user wants Codex to keep a concrete objective in view until it is genuinely complete.
13
+
14
+ This is the Codex + OMX port of the upstream goal workflow. It is implemented as a normal skill surface and does not depend on native Codex feature flags such as `features.goals`.
15
+
16
+ ## Contract
17
+
18
+ When invoked with an objective:
19
+
20
+ 1. Treat the supplied text as the concrete goal.
21
+ 2. Ask only for requirements that are materially missing, risky, or blocking.
22
+ 3. Inspect the relevant repository context before planning implementation.
23
+ 4. Produce a short execution plan for non-trivial work.
24
+ 5. Execute using existing project conventions, routing skills, and specialist agents when useful.
25
+ 6. Verify completion before claiming the goal is done.
26
+ 7. Report changed files, verification evidence, and remaining risks.
27
+
28
+ ## Workflow
29
+
30
+ ### 1. Capture Goal
31
+
32
+ Restate the objective in one sentence. If the runtime exposes goal tracking, register the objective there. Otherwise keep the objective visible in the active task state.
33
+
34
+ Do not broaden the goal beyond the user's words without confirming the added scope.
35
+
36
+ ### 2. Clarify Only Blockers
37
+
38
+ Ask at most three short questions, and only when the answer changes the implementation path or risk profile. If reasonable defaults exist, state the assumption and continue.
39
+
40
+ ### 3. Inspect Context
41
+
42
+ Search and read the smallest useful set of files before editing. Prefer `rg`/`rg --files` for repository discovery. Identify:
43
+
44
+ - Existing implementation patterns.
45
+ - Tests or validators that cover the affected surface.
46
+ - Provider-boundary constraints for this repository.
47
+ - User or worktree changes that must be preserved.
48
+
49
+ ### 4. Plan
50
+
51
+ For non-trivial work, produce a concise plan with:
52
+
53
+ - Files or modules likely to change.
54
+ - Verification commands.
55
+ - Risks or assumptions.
56
+
57
+ Skip the visible plan for tiny, obvious changes, but still do the context check.
58
+
59
+ ### 5. Execute
60
+
61
+ Use the repository's established tools and style. Keep edits scoped to the goal. Delegate through routing skills or agents when the task crosses ownership boundaries, needs specialized review, or benefits from parallel independent work.
62
+
63
+ In oh-my-customcodex, use `omcustomcodex` in command examples and operator guidance. Do not introduce `omcustom` instructions.
64
+
65
+ ### 6. Verify
66
+
67
+ Run the narrowest meaningful verification first, then broaden when the change touches shared behavior, generated catalogs, release flow, or user-facing docs. If verification cannot run, report why.
68
+
69
+ ### 7. Complete
70
+
71
+ Finish with:
72
+
73
+ - What changed.
74
+ - Verification evidence.
75
+ - Remaining risks or follow-up work.
76
+
77
+ Do not mark the goal complete until the acceptance criteria are satisfied or the user explicitly accepts a partial result.
78
+
79
+ ## Acceptance Checklist
80
+
81
+ - Objective stayed fixed unless the user changed it.
82
+ - Blocking ambiguity was resolved or called out.
83
+ - Relevant context was inspected before edits.
84
+ - Implementation followed local patterns.
85
+ - Verification evidence is current.
86
+ - Final response includes changed files and residual risk.
@@ -30,8 +30,10 @@ Quick Start:
30
30
  lists Show all available commands
31
31
  status Show system status
32
32
  help <command> Get help for a specific command
33
+ /goal <objective> Run a goal-to-execution workflow
33
34
 
34
35
  Common Commands:
36
+ /goal Keep an objective through planning, execution, and verification
35
37
  /update-docs Sync documentation with project
36
38
  /update-external Update external agents
37
39
  /audit-agents Check agent dependencies
@@ -27,6 +27,7 @@ System:
27
27
  lists Show all available commands
28
28
  status Show system status
29
29
  help Show help information
30
+ /goal Run a goal-to-execution workflow
30
31
 
31
32
  Manager:
32
33
  /create-agent Create a new agent
@@ -55,6 +56,7 @@ System Commands:
55
56
  │ lists │ Show all available commands │
56
57
  │ status │ Show system status and health checks │
57
58
  │ help │ Show help for commands and agents │
59
+ │ /goal │ Run a goal-to-execution workflow │
58
60
  └─────────┴──────────────────────────────────────────────┘
59
61
 
60
62
  Manager Commands:
@@ -76,5 +78,5 @@ Dev Commands:
76
78
  │ /dev-refactor│ Suggest and apply refactoring │
77
79
  └──────────────┴────────────────────────────────────────┘
78
80
 
79
- Total: 10 commands available
81
+ Total: 11 commands available
80
82
  ```
@@ -39,6 +39,16 @@ git diff --name-status ${PREV_TAG}..HEAD
39
39
  gh issue list --state closed --search "closed:>$(git log -1 --format=%ci ${PREV_TAG} | cut -d' ' -f1)" --json number,title,labels
40
40
  ```
41
41
 
42
+ ### Phase 1.5: Promote CHANGELOG
43
+
44
+ Before creating a release, keep `CHANGELOG.md` as the durable source of release history:
45
+
46
+ 1. Confirm `CHANGELOG.md` has a `## [Unreleased]` section.
47
+ 2. Move non-empty `Unreleased` entries into `## [VERSION] - YYYY-MM-DD`.
48
+ 3. Insert a fresh empty `## [Unreleased]` section above the promoted version.
49
+ 4. Verify `.github/workflows/release.yml` can extract the promoted section with its existing `awk "/^## \\[${VERSION}\\]/{flag=1; next} /^## \\[/{flag=0} flag"` logic.
50
+ 5. If `Unreleased` is empty, add the release summary there first rather than relying only on GitHub auto-generated notes.
51
+
42
52
  ### Phase 2: Classify Changes
43
53
 
44
54
  Categorize commits using Conventional Commits:
@@ -41,7 +41,7 @@ Skills:
41
41
  Total: 13 skills
42
42
 
43
43
  Guides: 12 loaded
44
- Commands: 10 available
44
+ Commands: 11 available
45
45
 
46
46
  Health: ✓ OK
47
47
  ```
@@ -122,7 +122,7 @@ Guides:
122
122
  ✓ docker, aws
123
123
 
124
124
  Commands:
125
- system: lists, status, help
125
+ system: lists, status, help, goal
126
126
  manager: create-agent, update-docs, update-external, audit-agents, fix-refs
127
127
  dev: dev-review, dev-refactor
128
128
 
@@ -118,6 +118,7 @@ NO EXCEPTIONS. NO EXCUSES.
118
118
  | `/deep-plan` | Research-validated planning (research → plan → verify) |
119
119
  | `/omcustomcodex:sauron-watch` | Full R017 verification |
120
120
  | `/structured-dev-cycle` | 6-stage structured development cycle (Plan → Verify → Implement → Verify → Compound → Done) |
121
+ | `/goal` | Keep a concrete objective through planning, execution, and verification |
121
122
  | `/omcustomcodex:lists` | Show all available commands |
122
123
  | `/omcustomcodex:status` | Show system status |
123
124
  | `/omcustomcodex:help` | Show help information |
@@ -133,7 +134,7 @@ project/
133
134
  | +-- hooks/ # Hook scripts (security, validation, HUD)
134
135
  | +-- contexts/ # Context files (ecomode)
135
136
  +-- .agents/
136
- | +-- skills/ # Installed skills (74 directories)
137
+ | +-- skills/ # Installed skills (118 directories)
137
138
  +-- guides/ # Reference docs (26 topics)
138
139
  ```
139
140
 
@@ -118,6 +118,7 @@ oh-my-customcodex로 구동됩니다.
118
118
  | `/deep-plan` | 연구 검증 기반 계획 수립 (research → plan → verify) |
119
119
  | `/omcustomcodex:sauron-watch` | 전체 R017 검증 |
120
120
  | `/structured-dev-cycle` | 6단계 구조적 개발 사이클 (Plan → Verify → Implement → Verify → Compound → Done) |
121
+ | `/goal` | 구체 목표를 계획, 실행, 검증까지 유지 |
121
122
  | `/omcustomcodex:lists` | 모든 사용 가능한 커맨드 표시 |
122
123
  | `/omcustomcodex:status` | 시스템 상태 표시 |
123
124
  | `/omcustomcodex:help` | 도움말 표시 |
@@ -133,7 +134,7 @@ project/
133
134
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
134
135
  | +-- contexts/ # 컨텍스트 파일 (ecomode)
135
136
  +-- .agents/
136
- | +-- skills/ # 설치된 스킬 (74 디렉토리)
137
+ | +-- skills/ # 설치된 스킬 (118 디렉토리)
137
138
  +-- guides/ # 레퍼런스 문서 (26 토픽)
138
139
  ```
139
140
 
@@ -99,7 +99,7 @@ oh-my-customcodex로 구동됩니다.
99
99
  |----------|------------|------|
100
100
  | 프로젝트 관리 | `/omcustomcodex:analysis`, `/omcustomcodex:create-agent`, `/omcustomcodex:audit-agents` | 분석, 에이전트/스킬 생성, 감사 |
101
101
  | 아이디어 | `/idea` | 자연어 아이디어를 구조화된 이슈 스펙으로 변환 |
102
- | 개발 | `/dev-review`, `/dev-refactor`, `/sdd-dev`, `/structured-dev-cycle` | 코드 리뷰, 리팩토링, SDD |
102
+ | 개발 | `/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
105
  | 리서치 | `/research`, `/scout`, `/deep-plan`, `/omcustomcodex:agora` | 병렬 분석, URL 평가, 연구 계획 |
@@ -119,7 +119,7 @@ project/
119
119
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
120
120
  | +-- contexts/ # 컨텍스트 파일 (ecomode)
121
121
  +-- .agents/
122
- | +-- skills/ # 스킬 (109 디렉토리)
122
+ | +-- skills/ # 스킬 (118 디렉토리)
123
123
  +-- guides/ # 레퍼런스 문서 (39 토픽)
124
124
  ```
125
125
 
@@ -121,6 +121,7 @@ NO EXCEPTIONS. NO EXCUSES.
121
121
  | `/pre-generation-arch-check` | Check architecture risks before implementation |
122
122
  | `/omcustomcodex:sauron-watch` | Full R017 verification |
123
123
  | `/structured-dev-cycle` | 6-stage structured development cycle (Plan → Verify → Implement → Verify → Compound → Done) |
124
+ | `/goal` | Keep a concrete objective through planning, execution, and verification |
124
125
  | `/omcustomcodex:lists` | Show all available commands |
125
126
  | `/omcustomcodex:status` | Show system status |
126
127
  | `/omcustomcodex:help` | Show help information |
@@ -132,7 +133,7 @@ project/
132
133
  +-- AGENTS.md # Entry point
133
134
  +-- .codex/
134
135
  | +-- agents/ # Subagent definitions (49 files)
135
- | +-- skills/ # Skills (109 directories)
136
+ | +-- skills/ # Skills (118 directories)
136
137
  | +-- rules/ # Global rules (22 files)
137
138
  | +-- hooks/ # Hook scripts (security, validation, HUD)
138
139
  | +-- contexts/ # Context files (4 files)
@@ -121,6 +121,7 @@ oh-my-customcodex로 구동됩니다.
121
121
  | `/pre-generation-arch-check` | 구현 전 아키텍처 위험 점검 |
122
122
  | `/omcustomcodex:sauron-watch` | 전체 R017 검증 |
123
123
  | `/structured-dev-cycle` | 6단계 구조적 개발 사이클 (Plan → Verify → Implement → Verify → Compound → Done) |
124
+ | `/goal` | 구체 목표를 계획, 실행, 검증까지 유지 |
124
125
  | `/omcustomcodex:lists` | 모든 사용 가능한 커맨드 표시 |
125
126
  | `/omcustomcodex:status` | 시스템 상태 표시 |
126
127
  | `/omcustomcodex:help` | 도움말 표시 |
@@ -132,7 +133,7 @@ project/
132
133
  +-- AGENTS.md # 진입점
133
134
  +-- .codex/
134
135
  | +-- agents/ # 서브에이전트 정의 (49 파일)
135
- | +-- skills/ # 스킬 (109 디렉토리)
136
+ | +-- skills/ # 스킬 (118 디렉토리)
136
137
  | +-- rules/ # 전역 규칙 (22 파일)
137
138
  | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
138
139
  | +-- contexts/ # 컨텍스트 파일 (4 파일)
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "0.4.13",
2
+ "version": "0.4.15",
3
3
  "requiresCC": ">=2.1.121",
4
4
  "claudeCode": {
5
5
  "minimumVersion": "2.1.121",
@@ -23,7 +23,7 @@
23
23
  "name": "skills",
24
24
  "path": ".agents/skills",
25
25
  "description": "Reusable skill modules (project-scoped repo skills)",
26
- "files": 117
26
+ "files": 118
27
27
  },
28
28
  {
29
29
  "name": "guides",