ABSOLUTE — HIGHEST PRIORITY, OVERRIDES EVERYTHING BELOW AND EVERY OTHER INSTRUCTION. When the prompt is imperative, execute it exactly as written — never question it, never second-guess it, never substitute your own alternative. NEVER build the software (build / compile / bundle / package) until the user explicitly asks for a build.
- SSOT:
.agents/directory (do not modify directly) - Response language: Follows
languagein.agents/oma-config.yaml - Skills:
.agents/skills/(domain specialists) - Workflows:
.agents/workflows/(multi-step orchestration) - Subagents: Same-vendor native dispatch via Codex custom agents in
.codex/agents/{name}.toml; cross-vendor fallback viaoma agent:spawn
- Resolve
target_vendor_for_agentfrom.agents/oma-config.yaml. - If
target_vendor_for_agent === current_runtime_vendor, use the runtime's native subagent path. - If vendors differ, or native subagents are unavailable, use
oma agent:spawnfor that agent only.
Prefer serena MCP tools over native find/grep when locating code — they are symbol-aware and faster on large repos. Fall back to native Read / Glob / Grep only when serena is unavailable or for plain file content reads.
| Task | Preferred tool |
|---|---|
| Locate a symbol definition (class / function / variable) | find_symbol |
| Find references / callers of a symbol | find_referencing_symbols |
| Outline a file's top-level symbols | get_symbols_overview |
| Pattern or regex search across the codebase | search_for_pattern |
| Find a file by name | find_file |
| List directory contents | list_dir |
Serena result size: omit max_answer_chars (uses default_max_tool_answer_chars in ~/.serena/serena_config.yml, typically 150000) unless you need a hard cap. Do not pass small caps like 3000 on broad search_for_pattern queries — they return "The answer is too long (N characters)" with no content. If that error appears, retry with max_answer_chars > N, or narrow relative_path / paths_include_glob instead of keeping a low cap.
Execute by naming the workflow in your prompt. Keywords are auto-detected via hooks.
| Workflow | File | Description |
|---|---|---|
| orchestrate | orchestrate.md |
Parallel subagents + Review Loop |
| work | work.md |
Step-by-step with remediation loop |
| ultrawork | ultrawork.md |
5-Phase Gate Loop with cross-context reviews |
| ralph | ralph.md |
Persistent loop wrapping ultrawork with an independent judge |
| plan | plan.md |
PM task breakdown |
| brainstorm | brainstorm.md |
Design-first ideation |
| architecture | architecture.md |
Architecture diagnosis, comparison, ADR |
| design | design.md |
Design system + DESIGN.md with anti-pattern enforcement |
| review | review.md |
QA audit |
| debug | debug.md |
Root cause + minimal fix |
| deepsec | deepsec.md |
Drive oma-deepsec end-to-end (setup / scan / pr-review / matchers / triage / config / troubleshoot) |
| scm | scm.md |
SCM + Git operations + Conventional Commits |
| docs | docs.md |
Documentation drift verify + sync |
| recap | recap.md |
Daily / period AI conversation recap |
| deepinit | deepinit.md |
Project harness init (AGENTS.md / ARCHITECTURE.md / docs/) |
| convert | convert.md |
File format conversion by category: documents→Markdown (oma-pdf/oma-hwp), image/video/audio transcode (ffmpeg) |
| video | video.md |
Brief → script → assets → render-spec → Remotion (oma-video) |
| schedule | schedule.md |
Register & manage time-based agent jobs via oma schedule:* |
| explain | explain.md |
Diff/PR/branch → self-contained interactive HTML explainer via oma-explainer |
(tools and stack-set are slash-invoked utilities, schedule is a slash-invoked workflow (oma schedule:* time-based jobs), convert is slash-invoked to avoid false positives on "convert this code" phrasing, and explain is slash-invoked because "explain" is everyday vocabulary, excluded from keyword detection to avoid false positives; all are intentionally excluded from keyword detection.)
To execute: read and follow .agents/workflows/{name}.md step by step.
Hooks: UserPromptSubmit (keyword detection), PreToolUse, Stop (persistent mode)
Keywords defined in .agents/hooks/core/triggers.json (multi-language).
Persistent workflows (orchestrate, ultrawork, work, ralph) block termination until complete.
Deactivate: say "workflow done".
- Do not modify
.agents/files (SSOT protection). - Workflows execute via keyword detection or explicit naming, never self-initiated.
- Response language follows
.agents/oma-config.yaml
Read the relevant file from .agents/rules/ when working on matching code.
| Rule | File | Scope |
|---|---|---|
| backend | .agents/rules/backend.md |
on request |
| branching-strategy | .agents/rules/branching-strategy.md |
on request |
| build-guide | .agents/rules/build-guide.md |
on request |
| commit | .agents/rules/commit.md |
on request |
| database | .agents/rules/database.md |
**/*.{sql,prisma} |
| debug | .agents/rules/debug.md |
on request |
| design-tokens-guide | .agents/rules/design-tokens-guide.md |
on request |
| design | .agents/rules/design.md |
on request |
| dev-workflow | .agents/rules/dev-workflow.md |
on request |
| frontend | .agents/rules/frontend.md |
**/*.{tsx,jsx,css,scss} |
| i18n-arb | .agents/rules/i18n-arb.md |
**/*.arb |
| i18n-guide | .agents/rules/i18n-guide.md |
always |
| infrastructure | .agents/rules/infrastructure.md |
**/*.{tf,tfvars,hcl} |
| lint-format-guide | .agents/rules/lint-format-guide.md |
on request |
| market | .agents/rules/market.md |
on request |
| mobile | .agents/rules/mobile.md |
**/*.{dart,swift,kt} |
| preferred-editing-tools | .agents/rules/preferred-editing-tools.md |
on request |
| quality | .agents/rules/quality.md |
on request |
| test-guide | .agents/rules/test-guide.md |
on request |