claudecode-omc 5.4.0 → 5.5.1

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 (91) hide show
  1. package/.local/guidelines/CLAUDE.md +31 -0
  2. package/README.md +57 -1
  3. package/bundled/manifest.json +2 -2
  4. package/bundled/upstream/oh-my-claudecode/agents/analyst.md +1 -1
  5. package/bundled/upstream/oh-my-claudecode/agents/architect.md +1 -1
  6. package/bundled/upstream/oh-my-claudecode/agents/code-reviewer.md +1 -1
  7. package/bundled/upstream/oh-my-claudecode/agents/code-simplifier.md +1 -1
  8. package/bundled/upstream/oh-my-claudecode/agents/critic.md +1 -1
  9. package/bundled/upstream/oh-my-claudecode/agents/debugger.md +1 -1
  10. package/bundled/upstream/oh-my-claudecode/agents/designer.md +1 -1
  11. package/bundled/upstream/oh-my-claudecode/agents/document-specialist.md +1 -1
  12. package/bundled/upstream/oh-my-claudecode/agents/executor.md +1 -1
  13. package/bundled/upstream/oh-my-claudecode/agents/explore.md +1 -1
  14. package/bundled/upstream/oh-my-claudecode/agents/git-master.md +3 -3
  15. package/bundled/upstream/oh-my-claudecode/agents/planner.md +1 -1
  16. package/bundled/upstream/oh-my-claudecode/agents/qa-tester.md +1 -1
  17. package/bundled/upstream/oh-my-claudecode/agents/scientist.md +1 -1
  18. package/bundled/upstream/oh-my-claudecode/agents/security-reviewer.md +1 -1
  19. package/bundled/upstream/oh-my-claudecode/agents/test-engineer.md +1 -75
  20. package/bundled/upstream/oh-my-claudecode/agents/tracer.md +1 -1
  21. package/bundled/upstream/oh-my-claudecode/agents/verifier.md +1 -1
  22. package/bundled/upstream/oh-my-claudecode/agents/writer.md +1 -1
  23. package/bundled/upstream/oh-my-claudecode/hooks/hooks.json +21 -1
  24. package/bundled/upstream/oh-my-claudecode/skills/AGENTS.md +200 -0
  25. package/bundled/upstream/oh-my-claudecode/skills/autopilot/SKILL.md +17 -10
  26. package/bundled/upstream/oh-my-claudecode/skills/autoresearch/SKILL.md +90 -0
  27. package/bundled/upstream/oh-my-claudecode/skills/cancel/SKILL.md +15 -6
  28. package/bundled/upstream/oh-my-claudecode/skills/configure-notifications/SKILL.md +12 -12
  29. package/bundled/upstream/oh-my-claudecode/skills/debug/SKILL.md +35 -0
  30. package/bundled/upstream/oh-my-claudecode/skills/deep-dive/SKILL.md +4 -0
  31. package/bundled/upstream/oh-my-claudecode/skills/deep-interview/SKILL.md +23 -18
  32. package/bundled/upstream/oh-my-claudecode/skills/hud/SKILL.md +23 -101
  33. package/bundled/upstream/oh-my-claudecode/skills/learner/SKILL.md +27 -2
  34. package/bundled/upstream/oh-my-claudecode/skills/mcp-setup/SKILL.md +67 -8
  35. package/bundled/upstream/oh-my-claudecode/skills/omc-doctor/SKILL.md +32 -47
  36. package/bundled/upstream/oh-my-claudecode/skills/omc-setup/SKILL.md +4 -2
  37. package/bundled/upstream/oh-my-claudecode/skills/omc-setup/phases/01-install-claude-md.md +15 -4
  38. package/bundled/upstream/oh-my-claudecode/skills/omc-setup/phases/02-configure.md +9 -9
  39. package/bundled/upstream/oh-my-claudecode/skills/omc-setup/phases/03-integrations.md +13 -13
  40. package/bundled/upstream/oh-my-claudecode/skills/omc-setup/phases/04-welcome.md +3 -3
  41. package/bundled/upstream/oh-my-claudecode/skills/omc-teams/SKILL.md +28 -0
  42. package/bundled/upstream/oh-my-claudecode/skills/plan/SKILL.md +1 -0
  43. package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/SKILL.md +25 -5
  44. package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/lib/config.sh +2 -15
  45. package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/lib/providers/github.sh +1 -1
  46. package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/lib/session.sh +2 -2
  47. package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/lib/tmux.sh +109 -4
  48. package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/lib/worktree.sh +26 -0
  49. package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/psm.sh +46 -5
  50. package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/templates/pr-review.md +5 -2
  51. package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/templates/projects.json +1 -1
  52. package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/tests/test-psm-prompt-injection.sh +336 -0
  53. package/bundled/upstream/oh-my-claudecode/skills/ralph/SKILL.md +18 -9
  54. package/bundled/upstream/oh-my-claudecode/skills/ralplan/SKILL.md +2 -0
  55. package/bundled/upstream/oh-my-claudecode/skills/release/SKILL.md +167 -57
  56. package/bundled/upstream/oh-my-claudecode/skills/remember/SKILL.md +41 -0
  57. package/bundled/upstream/oh-my-claudecode/skills/self-improve/SKILL.md +391 -0
  58. package/bundled/upstream/oh-my-claudecode/skills/self-improve/data_contracts.md +274 -0
  59. package/bundled/upstream/oh-my-claudecode/skills/self-improve/scripts/plot_progress.py +128 -0
  60. package/bundled/upstream/oh-my-claudecode/skills/self-improve/scripts/resolve-paths.mjs +192 -0
  61. package/bundled/upstream/oh-my-claudecode/skills/self-improve/scripts/validate.sh +404 -0
  62. package/bundled/upstream/oh-my-claudecode/skills/self-improve/si-benchmark-builder.md +79 -0
  63. package/bundled/upstream/oh-my-claudecode/skills/self-improve/si-goal-clarifier.md +94 -0
  64. package/bundled/upstream/oh-my-claudecode/skills/self-improve/si-researcher.md +73 -0
  65. package/bundled/upstream/oh-my-claudecode/skills/self-improve/templates/agent-settings.json +14 -0
  66. package/bundled/upstream/oh-my-claudecode/skills/self-improve/templates/goal.md +22 -0
  67. package/bundled/upstream/oh-my-claudecode/skills/self-improve/templates/harness.md +18 -0
  68. package/bundled/upstream/oh-my-claudecode/skills/self-improve/templates/idea.md +5 -0
  69. package/bundled/upstream/oh-my-claudecode/skills/self-improve/templates/settings.json +23 -0
  70. package/bundled/upstream/oh-my-claudecode/skills/skill/SKILL.md +46 -77
  71. package/bundled/upstream/oh-my-claudecode/skills/skillify/SKILL.md +53 -0
  72. package/bundled/upstream/oh-my-claudecode/skills/team/SKILL.md +83 -11
  73. package/bundled/upstream/oh-my-claudecode/skills/trace/SKILL.md +1 -0
  74. package/bundled/upstream/oh-my-claudecode/skills/ultraqa/SKILL.md +1 -0
  75. package/bundled/upstream/oh-my-claudecode/skills/ultrawork/SKILL.md +1 -0
  76. package/bundled/upstream/oh-my-claudecode/skills/verify/SKILL.md +37 -0
  77. package/bundled/upstream/oh-my-claudecode/skills/wiki/SKILL.md +67 -0
  78. package/package.json +3 -1
  79. package/src/cli/artifact.js +47 -0
  80. package/src/cli/doctor.js +6 -1
  81. package/src/cli/guidelines.js +83 -0
  82. package/src/cli/index.js +13 -1
  83. package/src/cli/setup.js +68 -19
  84. package/src/cli/source.js +35 -1
  85. package/src/config/artifact-types.js +12 -2
  86. package/src/config/paths.js +95 -4
  87. package/src/config/sources.js +29 -5
  88. package/src/guidelines/apply.js +152 -0
  89. package/src/guidelines/optimizer.js +325 -0
  90. package/src/merge/claude-md-merger.js +35 -12
  91. package/bundled/upstream/oh-my-claudecode/skills/omc-doctor/skill-debugger.md +0 -101
@@ -0,0 +1,31 @@
1
+ # Coding Discipline
2
+
3
+ These are always-on guardrails for non-trivial coding work.
4
+
5
+ ## Think Before Coding
6
+
7
+ - State assumptions that materially affect design, scope, or behavior.
8
+ - Surface ambiguity instead of silently choosing an interpretation.
9
+ - Ask for clarification when missing detail can change the implementation.
10
+ - Prefer the simpler path when it still satisfies the real goal.
11
+
12
+ ## Simplicity First
13
+
14
+ - Make the smallest correct change that solves the task.
15
+ - Do not add speculative features, configuration, or extension points.
16
+ - Avoid new abstractions for one-off logic.
17
+ - If the solution expands quickly, step back and simplify it.
18
+
19
+ ## Surgical Changes
20
+
21
+ - Change only the files and lines required for the task.
22
+ - Match existing patterns unless the task explicitly requires a new one.
23
+ - Do not refactor adjacent code, comments, or formatting as a drive-by edit.
24
+ - Clean up only unused code introduced by your own change unless asked.
25
+
26
+ ## Goal-Driven Execution
27
+
28
+ - Turn vague requests into concrete success criteria.
29
+ - Verify behavior with tests or explicit checks whenever practical.
30
+ - Tie multi-step work to validation at each step.
31
+ - Do not claim completion without fresh evidence from the workspace.
package/README.md CHANGED
@@ -19,9 +19,16 @@ omc-manage setup
19
19
  | Agents | ~19 | oh-my-claudecode + superpowers |
20
20
  | Hooks | ~8 | oh-my-claudecode (standalone) |
21
21
  | Commands | ~3 | superpowers |
22
+ | Guidelines | 1 | local coding discipline prompt guidelines |
22
23
 
23
24
  All artifacts are installed to `~/.claude/` where Claude Code discovers them automatically.
24
25
 
26
+ The bundled guidelines install into `~/.claude/CLAUDE.md` and add lightweight
27
+ coding discipline rules
28
+ adapted from [andrej-karpathy-skills](https://github.com/forrestchang/andrej-karpathy-skills):
29
+ think before coding, prefer simple solutions, make surgical changes, and verify
30
+ completion with concrete evidence.
31
+
25
32
  ## Commands
26
33
 
27
34
  | Command | Description |
@@ -30,9 +37,11 @@ All artifacts are installed to `~/.claude/` where Claude Code discovers them aut
30
37
  | `omc-manage doctor` | Health checks |
31
38
  | `omc-manage source list` | Show configured sources |
32
39
  | `omc-manage source sync` | Update upstream sources to latest |
33
- | `omc-manage source add <name> <url>` | Add a new source |
40
+ | `omc-manage source add <name> <url>` | Add a new source, including `guidelines` sources |
34
41
  | `omc-manage artifact list [--type <type>]` | List merged artifacts |
35
42
  | `omc-manage artifact conflicts [--type <type>]` | Show conflict report |
43
+ | `omc-manage guidelines optimize [source...]` | Build maintainer-only guideline optimization artifacts |
44
+ | `omc-manage guidelines apply --result-file <path>` | Apply a maintainer-generated optimization result |
36
45
 
37
46
  ## Sources & Priority
38
47
 
@@ -50,6 +59,53 @@ mkdir -p ~/.omc-manage/local/skills/my-skill
50
59
  omc-manage setup --force
51
60
  ```
52
61
 
62
+ Add a remote guidelines source:
63
+
64
+ ```bash
65
+ omc-manage source add karpathy https://github.com/forrestchang/andrej-karpathy-skills.git \
66
+ --artifacts guidelines \
67
+ --mapping guidelines=CLAUDE.md \
68
+ --role guidelines
69
+ omc-manage source sync karpathy
70
+ omc-manage setup --type guidelines
71
+ ```
72
+
73
+ ## Maintainer Guideline Optimization
74
+
75
+ OMC now treats runtime prompt guidance as a first-class `guidelines` artifact,
76
+ but the semantic optimization workflow is maintainer-only. The optimizer does
77
+ not get installed into user Claude Code configs.
78
+
79
+ Build an optimization pack for model-assisted synthesis:
80
+
81
+ ```bash
82
+ omc-manage guidelines optimize
83
+ ```
84
+
85
+ This writes maintainer artifacts under `.omc/guidelines/`, including:
86
+
87
+ - `latest/next-steps.md`
88
+ - `latest/optimizer-input.md`
89
+ - `latest/sections.json`
90
+ - `latest/sources.json`
91
+ - `latest/current-local-guidelines.md`
92
+
93
+ If you are driving the repo with Claude Code CLI or Codex, read
94
+ `latest/next-steps.md` first. That file points the agent at the relevant
95
+ maintainer workflow and the runtime file to edit.
96
+
97
+ The repository-only maintainer prompt lives at
98
+ `.maintainer/skills/guideline-optimizer/SKILL.md`. It is intentionally not
99
+ installed into user runtime configs.
100
+
101
+ After the optimization pass updates `.local/guidelines/CLAUDE.md`, reinstall
102
+ with:
103
+
104
+ ```bash
105
+ omc-manage guidelines apply --result-file /absolute/path/to/result.json
106
+ omc-manage setup --type guidelines
107
+ ```
108
+
53
109
  ## Update Upstream
54
110
 
55
111
  ```bash
@@ -1,8 +1,8 @@
1
1
  {
2
- "bundledAt": "2026-04-01T09:46:53Z",
2
+ "bundledAt": "2026-04-23T09:40:23Z",
3
3
  "sources": {
4
4
  "anthropic-skills": { "artifacts": 2 },
5
- "oh-my-claudecode": { "artifacts": 20 },
5
+ "oh-my-claudecode": { "artifacts": 21 },
6
6
  "superpowers": { "artifacts": 8 }
7
7
  }
8
8
  }
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: analyst
3
3
  description: Pre-planning consultant for requirements analysis (Opus)
4
- model: claude-opus-4-6
4
+ model: opus
5
5
  level: 3
6
6
  disallowedTools: Write, Edit
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: architect
3
3
  description: Strategic Architecture & Debugging Advisor (Opus, READ-ONLY)
4
- model: claude-opus-4-6
4
+ model: opus
5
5
  level: 3
6
6
  disallowedTools: Write, Edit
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: code-reviewer
3
3
  description: Expert code review specialist with severity-rated feedback, logic defect detection, SOLID principle checks, style, performance, and quality strategy
4
- model: claude-opus-4-6
4
+ model: opus
5
5
  level: 3
6
6
  disallowedTools: Write, Edit
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: code-simplifier
3
3
  description: Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses on recently modified code unless instructed otherwise.
4
- model: claude-opus-4-6
4
+ model: opus
5
5
  level: 3
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: critic
3
3
  description: Work plan and code review expert — thorough, structured, multi-perspective (Opus)
4
- model: claude-opus-4-6
4
+ model: opus
5
5
  level: 3
6
6
  disallowedTools: Write, Edit
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: debugger
3
3
  description: Root-cause analysis, regression isolation, stack trace analysis, build/compilation error resolution
4
- model: claude-sonnet-4-6
4
+ model: sonnet
5
5
  level: 3
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: designer
3
3
  description: UI/UX Designer-Developer for stunning interfaces (Sonnet)
4
- model: claude-sonnet-4-6
4
+ model: sonnet
5
5
  level: 2
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: document-specialist
3
3
  description: External Documentation & Reference Specialist
4
- model: claude-sonnet-4-6
4
+ model: sonnet
5
5
  level: 2
6
6
  disallowedTools: Write, Edit
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: executor
3
3
  description: Focused task executor for implementation work (Sonnet)
4
- model: claude-sonnet-4-6
4
+ model: sonnet
5
5
  level: 2
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: explore
3
3
  description: Codebase search specialist for finding files and code patterns
4
- model: claude-haiku-4-5
4
+ model: haiku
5
5
  level: 3
6
6
  disallowedTools: Write, Edit
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: git-master
3
3
  description: Git expert for atomic commits, rebasing, and history management with style detection
4
- model: claude-sonnet-4-6
4
+ model: sonnet
5
5
  level: 3
6
6
  ---
7
7
 
@@ -62,8 +62,8 @@ level: 3
62
62
  - Format: [semantic (feat:, fix:) / plain / short]
63
63
 
64
64
  ### Commits Created
65
- 1. `abc1234` - [commit message] - [N files]
66
- 2. `def5678` - [commit message] - [N files]
65
+ 1. `<commit-sha-1>` - [commit message] - [N files]
66
+ 2. `<commit-sha-2>` - [commit message] - [N files]
67
67
 
68
68
  ### Verification
69
69
  ```
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: planner
3
3
  description: Strategic planning consultant with interview workflow (Opus)
4
- model: claude-opus-4-6
4
+ model: opus
5
5
  level: 4
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: qa-tester
3
3
  description: Interactive CLI testing specialist using tmux for session management
4
- model: claude-sonnet-4-6
4
+ model: sonnet
5
5
  level: 3
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: scientist
3
3
  description: Data analysis and research execution specialist
4
- model: claude-sonnet-4-6
4
+ model: sonnet
5
5
  level: 3
6
6
  disallowedTools: Write, Edit
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: security-reviewer
3
3
  description: Security vulnerability detection specialist (OWASP Top 10, secrets, unsafe patterns)
4
- model: claude-opus-4-6
4
+ model: opus
5
5
  level: 3
6
6
  disallowedTools: Write, Edit
7
7
  ---
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: test-engineer
3
3
  description: Test strategy, integration/e2e coverage, flaky test hardening, TDD workflows
4
- model: claude-sonnet-4-6
4
+ model: sonnet
5
5
  level: 3
6
6
  ---
7
7
 
@@ -12,23 +12,6 @@ level: 3
12
12
  You are not responsible for feature implementation (executor), code quality review (quality-reviewer), or security testing (security-reviewer).
13
13
  </Role>
14
14
 
15
- <Integration_With_Test_Gen_Skill>
16
- When user asks to "generate tests" or "add tests", prefer using the `/test-gen` skill:
17
-
18
- - `/test-gen` handles tech stack detection and complexity analysis automatically
19
- - For simple code, `/test-gen` generates tests directly using CLI commands
20
- - For complex code, `/test-gen` will delegate to test-engineer with enriched context (detected stack, complexity metrics)
21
- - For test strategy and planning, use test-engineer directly
22
- - For test debugging and flaky test fixes, use test-engineer directly
23
-
24
- When invoked by `/test-gen` for complex code, you will receive:
25
- - Detected tech stack (frontend/backend frameworks, test frameworks, databases, APIs)
26
- - Complexity analysis (function size, cyclomatic complexity, dependencies)
27
- - Generated test framework (basic structure to build upon)
28
-
29
- Use this context to generate comprehensive test cases that cover edge cases, error scenarios, and business logic validation.
30
- </Integration_With_Test_Gen_Skill>
31
-
32
15
  <Why_This_Matters>
33
16
  Tests are executable documentation of expected behavior. These rules exist because untested code is a liability, flaky tests erode team trust in the test suite, and writing tests after implementation misses the design benefits of TDD. Good tests catch regressions before users do.
34
17
  </Why_This_Matters>
@@ -140,60 +123,3 @@ level: 3
140
123
  - For TDD: did I write the failing test first?
141
124
  </Final_Checklist>
142
125
  </Agent_Prompt>
143
-
144
- ## Enhanced Integration with Test Generation System
145
-
146
- ### Automatic Context Enrichment
147
-
148
- When invoked for test generation, test-engineer receives enriched context:
149
-
150
- - **Tech Stack**: Detected frameworks, languages, and test tools
151
- - **Complexity Analysis**: Metrics including cyclomatic complexity, nesting levels, external dependencies
152
- - **Suggested Approach**:
153
- - `auto-generate`: Simple code, generate tests automatically
154
- - `guided`: Complex code, ask user for clarification
155
- - `manual`: Very complex, provide framework and guidance only
156
-
157
- ### Workflow for Complex Code
158
-
159
- When complexity is `complex`:
160
-
161
- 1. **Review Context**: Examine complexity metrics and reasons
162
- 2. **Ask Questions**: Use pre-generated questions based on complexity reasons
163
- 3. **Generate Test Framework**: Create test structure with placeholders
164
- 4. **Fill in Details**: Based on user answers, complete test cases
165
- 5. **Verify Coverage**: Ensure all identified complexity factors are tested
166
-
167
- ### Example Invocation
168
-
169
- ```typescript
170
- const context = await prepareTestEngineerContext({
171
- filePath: 'src/services/payment.ts',
172
- code: paymentServiceCode,
173
- projectRoot: '/project/root',
174
- });
175
-
176
- // Context includes:
177
- // - techStack: { backend: { language: 'nodejs', testFramework: 'vitest' } }
178
- // - complexity: 'complex'
179
- // - complexityMetrics: { lines: 75, cyclomaticComplexity: 15, ... }
180
- // - suggestedApproach: 'guided'
181
- // - questionsForUser: ['What payment flows...', 'Should I mock...']
182
- ```
183
-
184
- ### Integration with /test-gen Skill
185
-
186
- The `/test-gen` skill automatically prepares this context before delegating to test-engineer:
187
-
188
- 1. User runs `/test-gen src/services/payment.ts`
189
- 2. System detects tech stack and analyzes complexity
190
- 3. If complex, prepares questions and delegates to test-engineer
191
- 4. Test-engineer asks questions and generates comprehensive tests
192
- 5. System verifies tests and commits
193
-
194
- ### Success Criteria
195
-
196
- - [ ] Context preparation includes all necessary information
197
- - [ ] Questions are relevant to complexity reasons
198
- - [ ] Test-engineer can generate appropriate tests for both simple and complex code
199
- - [ ] Integration with /test-gen skill is seamless
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: tracer
3
3
  description: Evidence-driven causal tracing with competing hypotheses, evidence for/against, uncertainty tracking, and next-probe recommendations
4
- model: claude-sonnet-4-6
4
+ model: sonnet
5
5
  level: 3
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: verifier
3
3
  description: Verification strategy, evidence-based completion checks, test adequacy
4
- model: claude-sonnet-4-6
4
+ model: sonnet
5
5
  level: 3
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: writer
3
3
  description: Technical documentation writer for README, API docs, and comments (Haiku)
4
- model: claude-haiku-4-5
4
+ model: haiku
5
5
  level: 2
6
6
  ---
7
7
 
@@ -31,6 +31,11 @@
31
31
  "type": "command",
32
32
  "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/project-memory-session.mjs",
33
33
  "timeout": 5
34
+ },
35
+ {
36
+ "type": "command",
37
+ "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/wiki-session-start.mjs",
38
+ "timeout": 5
34
39
  }
35
40
  ]
36
41
  },
@@ -92,6 +97,11 @@
92
97
  "type": "command",
93
98
  "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/project-memory-posttool.mjs",
94
99
  "timeout": 3
100
+ },
101
+ {
102
+ "type": "command",
103
+ "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/post-tool-rules-injector.mjs",
104
+ "timeout": 3
95
105
  }
96
106
  ]
97
107
  }
@@ -150,6 +160,11 @@
150
160
  "type": "command",
151
161
  "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/project-memory-precompact.mjs",
152
162
  "timeout": 5
163
+ },
164
+ {
165
+ "type": "command",
166
+ "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/wiki-pre-compact.mjs",
167
+ "timeout": 3
153
168
  }
154
169
  ]
155
170
  }
@@ -165,7 +180,7 @@
165
180
  },
166
181
  {
167
182
  "type": "command",
168
- "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/persistent-mode.cjs",
183
+ "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/persistent-mode.mjs",
169
184
  "timeout": 10
170
185
  },
171
186
  {
@@ -184,6 +199,11 @@
184
199
  "type": "command",
185
200
  "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/session-end.mjs",
186
201
  "timeout": 30
202
+ },
203
+ {
204
+ "type": "command",
205
+ "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/wiki-session-end.mjs",
206
+ "timeout": 30
187
207
  }
188
208
  ]
189
209
  }
@@ -0,0 +1,200 @@
1
+ <!-- Parent: ../AGENTS.md -->
2
+ <!-- Generated: 2026-01-28 | Updated: 2026-03-02 -->
3
+
4
+ # skills
5
+
6
+ 30 skill directories for workflow automation and specialized behaviors.
7
+
8
+ ## Purpose
9
+
10
+ Skills are reusable workflow templates that can be invoked via `/oh-my-claudecode:skill-name`. Each skill provides:
11
+ - Structured prompts for specific workflows
12
+ - Activation triggers (manual or automatic)
13
+ - Integration with execution modes
14
+
15
+ ## Key Files
16
+
17
+ ### Execution Mode Skills
18
+
19
+ | File | Skill | Purpose |
20
+ |-----------|-------|---------|
21
+ | `autopilot/SKILL.md` | autopilot | Full autonomous execution from idea to working code |
22
+ | `ultrawork/SKILL.md` | ultrawork | Maximum parallel agent execution |
23
+ | `ralph/SKILL.md` | ralph | Persistence until verified complete |
24
+ | `team/SKILL.md` | team | N coordinated agents with task claiming |
25
+ | `ultraqa/SKILL.md` | ultraqa | QA cycling until goal met |
26
+
27
+ ### Planning Skills
28
+
29
+ | File | Skill | Purpose |
30
+ |-----------|-------|---------|
31
+ | `plan/SKILL.md` | omc-plan | Strategic planning with interview workflow |
32
+ | `ralplan/SKILL.md` | ralplan | Iterative planning (Planner+Architect+Critic) with RALPLAN-DR structured deliberation (`--deliberate` for high-risk) |
33
+ | `deep-interview/SKILL.md` | deep-interview | Socratic deep interview with mathematical ambiguity gating (Ouroboros-inspired) |
34
+ | `ralph-init/SKILL.md` | ralph-init | Initialize PRD for structured ralph |
35
+
36
+ ### Exploration Skills
37
+
38
+ | File | Skill | Purpose |
39
+ |-----------|-------|---------|
40
+ | `deepinit/SKILL.md` | deepinit | Generate hierarchical AGENTS.md |
41
+ | `sciomc/SKILL.md` | sciomc | Parallel scientist orchestration |
42
+
43
+ ### Visual Skills
44
+
45
+ | File | Skill | Purpose |
46
+ |-----------|-------|---------|
47
+ | `visual-verdict/SKILL.md` | visual-verdict | Structured visual QA verdict for screenshot/reference comparisons |
48
+
49
+ ### Utility Skills
50
+
51
+ | File | Skill | Purpose |
52
+ |-----------|-------|---------|
53
+ | `ai-slop-cleaner/SKILL.md` | ai-slop-cleaner | Regression-safe cleanup workflow for AI-generated code slop |
54
+ | `learner/SKILL.md` | learner | Extract reusable skill from session |
55
+ | `ask/SKILL.md` | ask | Ask Claude, Codex, or Gemini via `omc ask` and capture an artifact |
56
+ | `note/SKILL.md` | note | Save notes for compaction resilience |
57
+ | `cancel/SKILL.md` | cancel | Cancel any active OMC mode |
58
+ | `hud/SKILL.md` | hud | Configure HUD display |
59
+ | `omc-doctor/SKILL.md` | omc-doctor | Diagnose installation issues |
60
+ | `setup/SKILL.md` | setup | Unified setup entrypoint for install, diagnostics, and MCP configuration |
61
+ | `omc-setup/SKILL.md` | omc-setup | One-time setup wizard |
62
+ | `omc-help/SKILL.md` | omc-help | Usage guide |
63
+ | `mcp-setup/SKILL.md` | mcp-setup | Configure MCP servers |
64
+ | `skill/SKILL.md` | skill | Manage local skills |
65
+
66
+ ### Domain Skills
67
+
68
+ | File | Skill | Purpose |
69
+ |-----------|-------|---------|
70
+ | `project-session-manager/SKILL.md` | project-session-manager (+ `psm` alias) | Isolated dev environments |
71
+ | `writer-memory/SKILL.md` | writer-memory | Agentic memory for writers |
72
+ | `release/SKILL.md` | release | Generic release assistant — analyzes repo CI/rules, caches in `.omc/RELEASE_RULE.md`, guides the release |
73
+
74
+ ## For AI Agents
75
+
76
+ ### Working In This Directory
77
+
78
+ #### Skill Template Format
79
+
80
+ ```markdown
81
+ ---
82
+ name: skill-name
83
+ description: Brief description
84
+ triggers:
85
+ - "keyword1"
86
+ - "keyword2"
87
+ agent: executor # Optional: which agent to use
88
+ model: sonnet # Optional: model override
89
+ pipeline: [skill-name, follow-up-skill] # Optional: standardized multi-skill flow
90
+ next-skill: follow-up-skill # Optional: explicit handoff target
91
+ next-skill-args: --direct # Optional: arguments for the next skill
92
+ handoff: .omc/plans/example.md # Optional: artifact/context handed to next skill
93
+ ---
94
+
95
+ # Skill Name
96
+
97
+ ## Purpose
98
+ What this skill accomplishes.
99
+
100
+ ## Workflow
101
+ 1. Step one
102
+ 2. Step two
103
+ 3. Step three
104
+
105
+ ## Usage
106
+ How to invoke this skill.
107
+
108
+ ## Configuration
109
+ Any configurable options.
110
+ ```
111
+
112
+ #### Skill Invocation
113
+
114
+ ```bash
115
+ # Manual invocation
116
+ /oh-my-claudecode:skill-name
117
+
118
+ # With arguments
119
+ /oh-my-claudecode:skill-name arg1 arg2
120
+
121
+ # Auto-detected from keywords
122
+ "autopilot build me a REST API" # Triggers autopilot skill
123
+ ```
124
+
125
+ #### Creating a New Skill
126
+
127
+ 1. Create `new-skill/SKILL.md` directory and file with YAML frontmatter
128
+ 2. Define purpose, workflow, and usage
129
+ 3. Add to skill registry (auto-detected from frontmatter)
130
+ 4. Optionally add activation triggers
131
+ 5. Create corresponding `commands/new-skill.md` file (mirror)
132
+ 6. Update `docs/REFERENCE.md` (Skills section, count)
133
+ 7. If execution mode skill, also create `src/hooks/new-skill/` hook
134
+
135
+ ### Common Patterns
136
+
137
+ **Skill chaining:**
138
+ ```markdown
139
+ ## Workflow
140
+ 1. Invoke `explore` agent for context
141
+ 2. Invoke `architect` for analysis
142
+ 3. Invoke `executor` for implementation
143
+ 4. Invoke `qa-tester` for verification
144
+ ```
145
+
146
+ If `pipeline` / `next-skill` metadata is present, OMC appends a standardized **Skill Pipeline** handoff block to the rendered skill prompt so downstream steps are explicit.
147
+
148
+ **Conditional behavior:**
149
+ ```markdown
150
+ ## Workflow
151
+ 1. Check if tests exist
152
+ - If yes: Run tests first
153
+ - If no: Create test plan
154
+ 2. Proceed with implementation
155
+ ```
156
+
157
+ ### Testing Requirements
158
+
159
+ - Skills are verified via integration tests
160
+ - Test skill invocation with `/oh-my-claudecode:skill-name`
161
+ - Verify trigger keywords activate correct skill
162
+ - For git-related skills, follow `templates/rules/git-workflow.md`
163
+
164
+ ## Dependencies
165
+
166
+ ### Internal
167
+ - Loaded by skill bridge (`scripts/build-skill-bridge.mjs`)
168
+ - References agents from `agents/`
169
+ - Uses hooks from `src/hooks/`
170
+
171
+ ### External
172
+ None - pure markdown files.
173
+
174
+ ## Skill Categories
175
+
176
+ | Category | Skills | Trigger Keywords |
177
+ |----------|--------|------------------|
178
+ | Execution | autopilot, ultrawork, ralph, team, ultraqa | "autopilot", "ulw", "ralph", "team" |
179
+ | Cleanup | ai-slop-cleaner | "deslop", "anti-slop", cleanup/refactor + slop smells |
180
+ | Planning | omc-plan, ralplan, deep-interview, ralph-init | "plan this", "interview me", "ouroboros" |
181
+ | Exploration | deepinit, sciomc, external-context | "deepinit", "research" |
182
+ | Utility | learner, note, cancel, hud, setup, omc-doctor, omc-setup, omc-help, mcp-setup | "stop", "cancel" |
183
+ | Domain | psm, writer-memory, release | psm context |
184
+
185
+ ## Auto-Activation
186
+
187
+ Some skills activate automatically based on context:
188
+
189
+ | Skill | Auto-Trigger Condition |
190
+ |-------|----------------------|
191
+ | autopilot | "autopilot", "build me", "I want a" |
192
+ | ultrawork | "ulw", "ultrawork" |
193
+ | ralph | "ralph", "don't stop until" |
194
+ | deep-interview | "deep interview", "interview me", "ouroboros", "don't assume" |
195
+ | cancel | "stop", "cancel", "abort" |
196
+
197
+ <!-- MANUAL:
198
+ - Team runtime wait semantics: `omc_run_team_wait.timeout_ms` only limits the wait call and does not stop workers.
199
+ - `timeoutSeconds` is removed from `omc_run_team_start`; use explicit `omc_run_team_cleanup` for intentional worker pane termination.
200
+ -->