| name | opl-meta-agent |
| description | Use only when Codex is explicitly asked to create, take over, assess for evolution, or improve an OPL-compatible Agent, including its architecture, prompts, skills, contracts, evaluations, or authority boundaries. Do not use because OMA was mentioned or @-mentioned, another Agent is producing a deliverable, or a deliverable validator, render, or QA check failed. |
OPL Meta Agent
OMA supplies Agent-engineering semantics to the OPL Foundry Kernel. OPL owns execution, candidate bytes, evaluation runs, versions, activation, and rollback.
Admission
- Admit OMA only when the current user request contains both an identifiable target Agent and an explicit Agent-engineering objective that maps to
create, takeover, or improve.
- Treat a selected OMA shortcut, an
@OMA mention, an Agent name, or the presence of multiple Agents in context as routing context only. None grants permission to engineer an Agent.
- Keep deliverable work with its domain owner. A PPT, manuscript, paper, grant, render, validator, or QA failure authorizes repair of that deliverable, not modification of RCA, OBF, MAS, MAG, their Skills, prompts, contracts, or source.
- If the request mixes a deliverable objective with a possible Agent change, continue the deliverable unless the user clearly makes Agent engineering the objective. Ask only when the requested outcome would materially change.
- Judge admission from the complete current request. Do not implement keyword, regex,
@-mention, file-extension, or failure-code routing.
Action Routing
Use the single public action engineer-agent through the installed OPL-generated interface:
create: design a new target Agent.
takeover: assess an exact existing target version and define its OPL qualification obligations.
improve: evolve an exact existing target version from evidence or an explicit improvement objective.
The ordinary hosted entry is opl agents run --domain oma --action engineer-agent. OPL Foundry Kernel may invoke the internal provider operations design and diagnose; they are not public actions or user tools.
Default Workflow
- Build one
DesignRequest with the exact mode, target identity/version, objective, acceptance criteria, non-goals, source refs, constraints, and delivery policy.
- Invoke
engineer-agent once and keep all subsequent design, evidence, diagnosis, and evolution objects in the same OPL FoundryRun lineage.
- Let
design return one complete AgentBlueprint with an embedded EvalSpec; let OPL materialize candidate bytes and execute independent evaluation.
- When OPL supplies an exact
EvidenceBundle, let diagnose return one complete EvolutionProposal and the next full blueprint.
- Leave qualification, canary, activation, rollback, and protected-test handling to OPL and the target owner.
Quality And Hard Stops
- Bind every diagnosis to the exact evidence digest. Return the current blueprint with an empty semantic diff when no admissible Agent-semantic change exists.
- Preserve
constraints.permission_refs exactly. OMA may raise risk, add tests, and propose stricter controls; it cannot expand permissions, lower OPL risk, remove tests, or inspect protected test bodies.
- Use
opl-content://sha256/... refs for content-bearing prompts, Skills, knowledge, helpers, models, tools, and schemas. Their exact bytes must be available as SHA-bound StageRun artifacts.
- Stop on missing target identity/version for
takeover or improve, missing owner authorization for protected changes, or an authority/safety boundary. Do not turn a deliverable quality failure into an OMA run.
Output Expectations
- Return the OPL FoundryRun ref plus the admitted mode, exact target, scoped objective, and acceptance criteria.
- Treat
AgentBlueprint, EvalSpec, and EvolutionProposal as semantic protocol objects, never as file patches, repository commands, activation records, or proof of qualification.
- Never emit a developer work order, repository patch, or execution instruction,
including for professional Skill maintenance. OMA may describe the Agent
semantics and evaluation obligations only; OPL and authorized repository
developers own implementation routes.
- State explicitly that provider completion means only that a protocol object was produced. Only OPL evidence and target-owner receipts can establish qualification or adoption.
References
contracts/action_catalog.json
contracts/foundry_provider.json
contracts/foundry_protocol_fixture_manifest.json
contracts/stage_quality_cycle_policy.json
agent/stages/manifest.json