From d8666b87d3969a9974a8fb729a54e08efedcac3d Mon Sep 17 00:00:00 2001 From: tiennm99 Date: Sun, 19 Apr 2026 08:36:49 +0700 Subject: [PATCH] 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 --- oh-my-claudecode/.claude/CLAUDE.md | 65 ++++++++ oh-my-claudecode/.claude/settings.json | 5 + .../.claude/skills/omc-reference/SKILL.md | 141 ++++++++++++++++++ 3 files changed, 211 insertions(+) create mode 100644 oh-my-claudecode/.claude/CLAUDE.md create mode 100644 oh-my-claudecode/.claude/settings.json create mode 100644 oh-my-claudecode/.claude/skills/omc-reference/SKILL.md diff --git a/oh-my-claudecode/.claude/CLAUDE.md b/oh-my-claudecode/.claude/CLAUDE.md new file mode 100644 index 0000000..16eecaf --- /dev/null +++ b/oh-my-claudecode/.claude/CLAUDE.md @@ -0,0 +1,65 @@ + + + +# 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. + + +- 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. + + + +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). + + + +`haiku` (quick lookups), `sonnet` (standard), `opus` (architecture, deep analysis). +Direct writes OK for: `~/.claude/**`, `.omc/**`, `.claude/**`, `CLAUDE.md`, `AGENTS.md`. + + + +Invoke via `/oh-my-claudecode:`. 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. + + + +Verify before claiming completion. Size appropriately: small→haiku, standard→sonnet, large/security→opus. +If verification fails, keep iterating. + + + +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. + + + +Hooks inject `` tags. Key patterns: `hook success: Success` (proceed), `[MAGIC KEYWORD: ...]` (invoke skill), `The boulder never stops` (ralph/ultrawork active). +Persistence: `` (7 days), `` (permanent). +Kill switches: `DISABLE_OMC`, `OMC_SKIP_HOOKS` (comma-separated). + + + +`/oh-my-claudecode:cancel` ends execution modes. Cancel when done+verified or blocked. Don't cancel if work incomplete. + + + +State: `.omc/state/`, `.omc/state/sessions/{sessionId}/`, `.omc/notepad.md`, `.omc/project-memory.json`, `.omc/plans/`, `.omc/research/`, `.omc/logs/` + + +## Setup + +Say "setup omc" or run `/oh-my-claudecode:omc-setup`. + + diff --git a/oh-my-claudecode/.claude/settings.json b/oh-my-claudecode/.claude/settings.json new file mode 100644 index 0000000..c6802dc --- /dev/null +++ b/oh-my-claudecode/.claude/settings.json @@ -0,0 +1,5 @@ +{ + "enabledPlugins": { + "oh-my-claudecode@omc": true + } +} diff --git a/oh-my-claudecode/.claude/skills/omc-reference/SKILL.md b/oh-my-claudecode/.claude/skills/omc-reference/SKILL.md new file mode 100644 index 0000000..cc02915 --- /dev/null +++ b/oh-my-claudecode/.claude/skills/omc-reference/SKILL.md @@ -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 ` +- `/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:`. + +### 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 +```