| name | secretary-routing |
| description | Routes agent management tasks to the correct manager agent. Use when user requests agent creation, updates, audits, git operations, or verification. |
| scope | core |
| user-invocable | false |
| context | fork |
Secretary Routing Skill
Purpose
Routes agent management tasks to the appropriate manager agent. This skill contains the coordination logic for orchestrating manager agents (mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron).
Manager Agents
| Agent | Purpose | Triggers |
|---|
| mgr-creator | Create new agents, skills, guides | "create agent", "new agent", "create skill", "new skill", "create guide", "new guide" |
| mgr-updater | Update external agents | "update agent", "sync" |
| mgr-supplier | Validate dependencies | "audit", "check deps" |
| mgr-gitnerd | Git operations | "commit", "push", "pr" |
| mgr-sauron | R017 auto-verification | "verify", "full check" |
| mgr-claude-code-bible | Claude Code spec compliance | "spec check", "verify compliance" |
| sys-memory-keeper | Memory operations | "save memory", "recall", "memory search" |
| sys-naggy | TODO management | "todo", "track tasks", "task list" |
| tracker-checkpoint | Pipeline checkpoint state | "pipeline resume", "checkpoint", "state restore" |
Routing Decision (Priority Order)
Before routing via Codex native subagents, evaluate Agent Teams eligibility first:
Self-check: Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over individual subagents. See R018 for the full decision matrix.
| Scenario | Preferred |
|---|
| Single manager task | Task Tool |
| Batch agent creation (3+) | Agent Teams |
| Multi-round verification (sauron) | Task Tool |
| Agent audit + fix cycle | Agent Teams |
Command Routing
User Input → Routing → Manager Agent
create → mgr-creator
create skill → mgr-creator
create guide → mgr-creator
update → mgr-updater
audit → mgr-supplier
git → mgr-gitnerd
verify → mgr-sauron
spec → mgr-claude-code-bible
memory → sys-memory-keeper
todo → sys-naggy
checkpoint → tracker-checkpoint
improve-report → omcodex:improve-report (skill invocation)
auto-improve → omcodex:auto-improve (skill invocation)
batch → multiple (parallel)
improve-report keywords: "improve-report", "improvement", "개선", "개선 리포트", "improve" → invoke omcodex:improve-report skill (read-only, no agent delegation needed)
auto-improve keywords: "auto-improve", "자동 개선", "개선 적용", "apply improvements", "improvement suggestions" → invoke omcodex:auto-improve skill (worktree isolation, sauron verification, PR creation)
Ontology-RAG Enrichment (R019)
If get_agent_for_task MCP tool is available, call it with the original query and inject suggested_skills into the agent prompt. Skip silently on failure.
Step 5: Soul Injection (R006)
If the selected agent has soul: true in frontmatter, read and prepend .codex/agents/souls/{agent-name}.soul.md content to the prompt. Skip silently if file doesn't exist.
Routing Rules
1. Single Task Routing
1. Parse user command and identify intent
2. Select appropriate manager agent
3. Spawn Task with selected agent role
4. Monitor execution
5. Report result to user
Claude compatibility Agent calls only (R010 “Delegated Permission Ownership”): Pass mode: "bypassPermissions" when the active Claude session uses bypass permissions. Native Codex spawn_agent has no mode parameter; use the installed agent_type and active Codex runtime permissions instead.
2. Batch/Parallel Task Routing
When command requires multiple independent operations:
1. Break down into sub-tasks
2. Identify parallelizable tasks (max 4)
3. Spawn parallel Task instances
4. Aggregate results
5. Report summary to user
Sub-agent Model Selection
| Agent | Recommended Lane / Effort | Reason |
|---|
| mgr-creator | frontier/medium | File generation, balanced |
| mgr-updater | frontier/medium | External sync, web fetch |
| mgr-supplier | spark/low | File scan, validation |
| mgr-gitnerd | frontier/medium | Commit message quality |
| mgr-sauron | frontier/medium | Multi-round verification |
| mgr-claude-code-bible | frontier/medium | Spec compliance checks |
| sys-memory-keeper | frontier/medium | Memory operations, search |
| sys-naggy | spark/low | Simple TODO tracking |
| tracker-checkpoint | frontier/medium | Pipeline state recovery |
No Match Fallback
When no manager agent matches the request but the task is clearly management-related:
User Input → No matching manager agent
↓
Evaluate: Is this a specialized management/tooling task?
YES → Delegate to mgr-creator with context:
domain: detected tool/technology
type: manager
skills: auto-discover from .codex/skills/
NO → Ask user for clarification
Examples of dynamic creation triggers:
- New CI/CD tool management (e.g., "ArgoCD 배포 관리해줘")
- New monitoring tool setup (e.g., "Grafana 대시보드 관리")
- Unfamiliar package manager operations
Sensitive-Path Delegation
Sensitive-path compatibility note: if this skill delegates work that touches .claude/**, .claude/outputs/**, templates/.claude/**, or read-only measurements of those paths, keep .codex/** edits on the normal Codex path. On Claude Code v2.1.121+ with bypassPermissions, direct writes to .claude/skills/, .claude/agents/, and .claude/commands/ are allowed; on v2.1.126+ that extends to broader protected paths. Only use /tmp/{skill}-{timestamp}.md as a legacy fallback when the target runtime is older or still prompts.
Usage
This skill is NOT user-invocable. It is automatically triggered when the main conversation detects agent management intent.
