Skip to content

AGENTS.md

Latest commit

 

History

History
84 lines (64 loc) · 3.66 KB

AGENTS.md

File metadata and controls

84 lines (64 loc) · 3.66 KB

oh-my-agent

Architecture

  • SSOT: .agents/ directory (do not modify directly)
  • Response language: Follows language in .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 via oma agent:spawn

Per-Agent Dispatch

  1. Resolve target_vendor_for_agent from .agents/oma-config.yaml.
  2. If target_vendor_for_agent === current_runtime_vendor, use the runtime's native subagent path.
  3. If vendors differ, or native subagents are unavailable, use oma agent:spawn for that agent only.

Code Search

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

Workflows

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 (11 reviews)
plan plan.md PM task breakdown
brainstorm brainstorm.md Design-first ideation
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)
scm scm.md SCM + Git operations + Conventional Commits
docs docs.md Documentation drift verify + sync
recap recap.md Daily / period AI conversation recap

To execute: read and follow .agents/workflows/{name}.md step by step.

Auto-Detection

Hooks: UserPromptSubmit (keyword detection), PreToolUse, Stop (persistent mode) Keywords defined in .agents/hooks/core/triggers.json (multi-language). Persistent workflows (orchestrate, ultrawork, work) block termination until complete. Deactivate: say "workflow done".

Rules

  1. Do not modify .agents/ files (SSOT protection).
  2. Workflows execute via keyword detection or explicit naming, never self-initiated.
  3. Response language follows .agents/oma-config.yaml

Project Rules

Read the relevant file from .agents/rules/ when working on matching code.

Rule File Scope
backend .agents/rules/backend.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 .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-guide .agents/rules/i18n-guide.md always
infrastructure .agents/rules/infrastructure.md **/*.{tf,tfvars,hcl}
market .agents/rules/market.md on request
mobile .agents/rules/mobile.md **/*.{dart,swift,kt}
quality .agents/rules/quality.md on request