mirror of
https://github.com/tiennm99/ai-coding-workflow-labs.git
synced 2026-08-13 01:20:32 +00:00
chore: add oh-my-claudecode project configuration
Enable the oh-my-claudecode plugin and vendor the OMC project instructions plus the omc-reference skill so session-start guidance and agent catalog are available without plugin re-install. Confidence: high Scope-risk: narrow
This commit is contained in:
@@ -0,0 +1,65 @@
|
||||
<!-- OMC:START -->
|
||||
<!-- OMC:VERSION:4.12.1 -->
|
||||
|
||||
# oh-my-claudecode - Intelligent Multi-Agent Orchestration
|
||||
|
||||
You are running with oh-my-claudecode (OMC), a multi-agent orchestration layer for Claude Code.
|
||||
Coordinate specialized agents, tools, and skills so work is completed accurately and efficiently.
|
||||
|
||||
<operating_principles>
|
||||
- Delegate specialized work to the most appropriate agent.
|
||||
- Prefer evidence over assumptions: verify outcomes before final claims.
|
||||
- Choose the lightest-weight path that preserves quality.
|
||||
- Consult official docs before implementing with SDKs/frameworks/APIs.
|
||||
</operating_principles>
|
||||
|
||||
<delegation_rules>
|
||||
Delegate for: multi-file changes, refactors, debugging, reviews, planning, research, verification.
|
||||
Work directly for: trivial ops, small clarifications, single commands.
|
||||
Route code to `executor` (use `model=opus` for complex work). Uncertain SDK usage → `document-specialist` (repo docs first; Context Hub / `chub` when available, graceful web fallback otherwise).
|
||||
</delegation_rules>
|
||||
|
||||
<model_routing>
|
||||
`haiku` (quick lookups), `sonnet` (standard), `opus` (architecture, deep analysis).
|
||||
Direct writes OK for: `~/.claude/**`, `.omc/**`, `.claude/**`, `CLAUDE.md`, `AGENTS.md`.
|
||||
</model_routing>
|
||||
|
||||
<skills>
|
||||
Invoke via `/oh-my-claudecode:<name>`. Trigger patterns auto-detect keywords.
|
||||
Tier-0 workflows include `autopilot`, `ultrawork`, `ralph`, `team`, and `ralplan`.
|
||||
Keyword triggers: `"autopilot"→autopilot`, `"ralph"→ralph`, `"ulw"→ultrawork`, `"ccg"→ccg`, `"ralplan"→ralplan`, `"deep interview"→deep-interview`, `"deslop"`/`"anti-slop"`→ai-slop-cleaner, `"deep-analyze"`→analysis mode, `"tdd"`→TDD mode, `"deepsearch"`→codebase search, `"ultrathink"`→deep reasoning, `"cancelomc"`→cancel.
|
||||
Team orchestration is explicit via `/team`.
|
||||
Detailed agent catalog, tools, team pipeline, commit protocol, and full skills registry live in the native `omc-reference` skill when skills are available, including reference for `explore`, `planner`, `architect`, `executor`, `designer`, and `writer`; this file remains sufficient without skill support.
|
||||
</skills>
|
||||
|
||||
<verification>
|
||||
Verify before claiming completion. Size appropriately: small→haiku, standard→sonnet, large/security→opus.
|
||||
If verification fails, keep iterating.
|
||||
</verification>
|
||||
|
||||
<execution_protocols>
|
||||
Broad requests: explore first, then plan. 2+ independent tasks in parallel. `run_in_background` for builds/tests.
|
||||
Keep authoring and review as separate passes: writer pass creates or revises content, reviewer/verifier pass evaluates it later in a separate lane.
|
||||
Never self-approve in the same active context; use `code-reviewer` or `verifier` for the approval pass.
|
||||
Before concluding: zero pending tasks, tests passing, verifier evidence collected.
|
||||
</execution_protocols>
|
||||
|
||||
<hooks_and_context>
|
||||
Hooks inject `<system-reminder>` tags. Key patterns: `hook success: Success` (proceed), `[MAGIC KEYWORD: ...]` (invoke skill), `The boulder never stops` (ralph/ultrawork active).
|
||||
Persistence: `<remember>` (7 days), `<remember priority>` (permanent).
|
||||
Kill switches: `DISABLE_OMC`, `OMC_SKIP_HOOKS` (comma-separated).
|
||||
</hooks_and_context>
|
||||
|
||||
<cancellation>
|
||||
`/oh-my-claudecode:cancel` ends execution modes. Cancel when done+verified or blocked. Don't cancel if work incomplete.
|
||||
</cancellation>
|
||||
|
||||
<worktree_paths>
|
||||
State: `.omc/state/`, `.omc/state/sessions/{sessionId}/`, `.omc/notepad.md`, `.omc/project-memory.json`, `.omc/plans/`, `.omc/research/`, `.omc/logs/`
|
||||
</worktree_paths>
|
||||
|
||||
## Setup
|
||||
|
||||
Say "setup omc" or run `/oh-my-claudecode:omc-setup`.
|
||||
|
||||
<!-- OMC:END -->
|
||||
@@ -0,0 +1,5 @@
|
||||
{
|
||||
"enabledPlugins": {
|
||||
"oh-my-claudecode@omc": true
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,141 @@
|
||||
---
|
||||
name: omc-reference
|
||||
description: OMC agent catalog, available tools, team pipeline routing, commit protocol, and skills registry. Auto-loads when delegating to agents, using OMC tools, orchestrating teams, making commits, or invoking skills.
|
||||
user-invocable: false
|
||||
---
|
||||
|
||||
# OMC Reference
|
||||
|
||||
Use this built-in reference when you need detailed OMC catalog information that does not need to live in every `CLAUDE.md` session.
|
||||
|
||||
## Agent Catalog
|
||||
|
||||
Prefix: `oh-my-claudecode:`. See `agents/*.md` for full prompts.
|
||||
|
||||
- `explore` (haiku) — fast codebase search and mapping
|
||||
- `analyst` (opus) — requirements clarity and hidden constraints
|
||||
- `planner` (opus) — sequencing and execution plans
|
||||
- `architect` (opus) — system design, boundaries, and long-horizon tradeoffs
|
||||
- `debugger` (sonnet) — root-cause analysis and failure diagnosis
|
||||
- `executor` (sonnet) — implementation and refactoring
|
||||
- `verifier` (sonnet) — completion evidence and validation
|
||||
- `tracer` (sonnet) — trace gathering and evidence capture
|
||||
- `security-reviewer` (sonnet) — trust boundaries and vulnerabilities
|
||||
- `code-reviewer` (opus) — comprehensive code review
|
||||
- `test-engineer` (sonnet) — testing strategy and regression coverage
|
||||
- `designer` (sonnet) — UX and interaction design
|
||||
- `writer` (haiku) — documentation and concise content work
|
||||
- `qa-tester` (sonnet) — runtime/manual validation
|
||||
- `scientist` (sonnet) — data analysis and statistical reasoning
|
||||
- `document-specialist` (sonnet) — SDK/API/framework documentation lookup
|
||||
- `git-master` (sonnet) — commit strategy and history hygiene
|
||||
- `code-simplifier` (opus) — behavior-preserving simplification
|
||||
- `critic` (opus) — plan/design challenge and review
|
||||
|
||||
## Model Routing
|
||||
|
||||
- `haiku` — quick lookups, lightweight inspection, narrow docs work
|
||||
- `sonnet` — standard implementation, debugging, and review
|
||||
- `opus` — architecture, deep analysis, consensus planning, and high-risk review
|
||||
|
||||
## Tools Reference
|
||||
|
||||
### External AI / orchestration
|
||||
- `/team N:executor "task"`
|
||||
- `omc team N:codex|gemini "..."`
|
||||
- `omc ask <claude|codex|gemini>`
|
||||
- `/ccg`
|
||||
|
||||
### OMC state
|
||||
- `state_read`, `state_write`, `state_clear`, `state_list_active`, `state_get_status`
|
||||
|
||||
### Team runtime
|
||||
- `TeamCreate`, `TeamDelete`, `SendMessage`, `TaskCreate`, `TaskList`, `TaskGet`, `TaskUpdate`
|
||||
|
||||
### Notepad
|
||||
- `notepad_read`, `notepad_write_priority`, `notepad_write_working`, `notepad_write_manual`
|
||||
|
||||
### Project memory
|
||||
- `project_memory_read`, `project_memory_write`, `project_memory_add_note`, `project_memory_add_directive`
|
||||
|
||||
### Code intelligence
|
||||
- LSP: `lsp_hover`, `lsp_goto_definition`, `lsp_find_references`, `lsp_diagnostics`, and related helpers
|
||||
- AST: `ast_grep_search`, `ast_grep_replace`
|
||||
- Utility: `python_repl`
|
||||
|
||||
## Skills Registry
|
||||
|
||||
Invoke built-in workflows via `/oh-my-claudecode:<name>`.
|
||||
|
||||
### Workflow skills
|
||||
- `autopilot` — full autonomous execution from idea to working code
|
||||
- `ralph` — persistence loop until completion with verification
|
||||
- `ultrawork` — high-throughput parallel execution
|
||||
- `visual-verdict` — structured visual QA verdicts
|
||||
- `team` — coordinated team orchestration
|
||||
- `ccg` — Codex + Gemini + Claude synthesis lane
|
||||
- `ultraqa` — QA cycle: test, verify, fix, repeat
|
||||
- `omc-plan` — planning workflow and `/plan`-safe alias
|
||||
- `ralplan` — consensus planning workflow
|
||||
- `sciomc` — science/research workflow
|
||||
- `external-context` — external docs/research workflow
|
||||
- `deepinit` — hierarchical AGENTS.md generation
|
||||
- `deep-interview` — Socratic ambiguity-gated requirements workflow
|
||||
- `ai-slop-cleaner` — regression-safe cleanup workflow
|
||||
|
||||
### Utility skills
|
||||
- `ask`, `cancel`, `note`, `learner`, `omc-setup`, `mcp-setup`, `hud`, `omc-doctor`, `trace`, `release`, `project-session-manager`, `skill`, `writer-memory`, `configure-notifications`
|
||||
|
||||
### Keyword triggers kept compact in CLAUDE.md
|
||||
- `"autopilot"→autopilot`
|
||||
- `"ralph"→ralph`
|
||||
- `"ulw"→ultrawork`
|
||||
- `"ccg"→ccg`
|
||||
- `"ralplan"→ralplan`
|
||||
- `"deep interview"→deep-interview`
|
||||
- `"deslop" / "anti-slop"→ai-slop-cleaner`
|
||||
- `"deep-analyze"→analysis mode`
|
||||
- `"tdd"→TDD mode`
|
||||
- `"deepsearch"→codebase search`
|
||||
- `"ultrathink"→deep reasoning`
|
||||
- `"cancelomc"→cancel`
|
||||
- Team orchestration is explicit via `/team`.
|
||||
|
||||
## Team Pipeline
|
||||
|
||||
Stages: `team-plan` → `team-prd` → `team-exec` → `team-verify` → `team-fix` (loop).
|
||||
|
||||
- Use `team-fix` for bounded remediation loops.
|
||||
- `team ralph` links the team pipeline with Ralph-style sequential verification.
|
||||
- Prefer team mode when independent parallel lanes justify the coordination overhead.
|
||||
|
||||
## Commit Protocol
|
||||
|
||||
Use git trailers to preserve decision context in every commit message.
|
||||
|
||||
### Format
|
||||
- Intent line first: why the change was made
|
||||
- Optional body with context and rationale
|
||||
- Structured trailers when applicable
|
||||
|
||||
### Common trailers
|
||||
- `Constraint:` active constraint shaping the decision
|
||||
- `Rejected:` alternative considered | reason for rejection
|
||||
- `Directive:` forward-looking warning or instruction
|
||||
- `Confidence:` `high` | `medium` | `low`
|
||||
- `Scope-risk:` `narrow` | `moderate` | `broad`
|
||||
- `Not-tested:` known verification gap
|
||||
|
||||
### Example
|
||||
```text
|
||||
feat(docs): reduce always-loaded OMC instruction footprint
|
||||
|
||||
Move reference-only orchestration content into a native Claude skill so
|
||||
session-start guidance stays small while detailed OMC reference remains available.
|
||||
|
||||
Constraint: Preserve CLAUDE.md marker-based installation flow
|
||||
Rejected: Sync all built-in skills in legacy install | broader behavior change than issue requires
|
||||
Confidence: high
|
||||
Scope-risk: narrow
|
||||
Not-tested: End-to-end plugin marketplace install in a fresh Claude profile
|
||||
```
|
||||
Reference in New Issue
Block a user