trinity

name	trinity
description	Codex adapter for Trinity multi-model orchestration. Use when the user says /trinity or $trinity in Codex, asks to import Trinity into Codex, or wants to delegate work through Trinity while preserving Claude Code compatibility.

Trinity for Codex

Use this skill when working with Trinity from Codex. Trinity is a multi-model orchestration package that also supports Claude Code through the root SKILL.md; this file is the Codex-specific adapter. The repo-local copy lives at .agents/skills/trinity, and the plugin-bundled copy lives at plugins/trinity/skills/trinity.

Commands

Support the same user-facing command family as the Claude Code adapter:

/trinity status
/trinity help
/trinity clear [<instance> | all]
/trinity <provider>[:<instance>] "<task>"
/trinity <provider>*N "<task>"
/trinity plan ...

Also treat $trinity as an explicit Codex skill invocation.

For Codex-native code review from the terminal, use the installed wrapper:

trinity doctor --providers glm,gemini,deepseek
trinity doctor --preset fast-review
trinity review --providers glm,gemini,deepseek --scope <path-or-label>
trinity review --preset fast-review --scope <path-or-label>
trinity review --preset dr --scope <path-or-label>
trinity review --base main --head HEAD --providers glm,deepseek
trinity review --pr 21 --preset deep-review
trinity review --sop COR-1602 --rubric COR-1609 --scope <path-or-label>
trinity review --sop COR-1602 --rubric COR-1609 --base main --head HEAD --preset fast-review
trinity review --sop COR-1602 --rubric COR-1609 --pr 21 --preset deep-review

The wrapper loads ~/.codex/trinity.json, whose repo default lives at .agents/trinity.codex.json. It calls provider CLIs directly, saves raw outputs, and writes a deterministic synthesis markdown under .trinity/reviews/. Review providers run concurrently up to review.max_parallel_providers (default: selected provider count). Progress is written to stderr; stdout remains the review directory path. Interrupted reviews that cannot write final metadata and synthesis are marked with incomplete.json in the review directory. The review preset resolver selects providers from explicit --providers, explicit --preset, review.default_preset, then legacy review.default_providers. review expands to glm, gemini, and deepseek; fast-review expands to glm and deepseek; deep-review expands to glm, gemini, and deepseek. Aliases r, fr, and dr resolve to those preset names. Optional providers are skipped with stderr warnings when they lack config or a CLI, and skipped providers are recorded in metadata.json. trinity doctor and trinity review --check-providers validate provider config, command lookup, executable permissions, and timeout values without making network calls. Use the default review mode for dirty working-tree changes, --base / --head for committed branch reviews, and --pr for GitHub PR reviews. Pair --sop and --rubric for strict COR review mode. The first supported strict template is COR-1602 with COR-1609; it asks reviewers for findings, a decision matrix, weighted average, and PASS/FIX, then records the selected SOP/rubric metadata in metadata.json.

Host Boundary

• The root SKILL.md remains the Claude Code adapter and continues to use ~/.claude/ files.
• This Codex adapter must load successfully without requiring Claude Code worker-agent files.
• Do not depend on Claude-specific background worker instructions when checking skill/plugin importability or when running trinity review.
• Preserve existing Trinity provider files and installers unless the user explicitly asks to change Claude behavior.

Codex Workflow

1. Read the user's /trinity or $trinity request.
2. Inspect the repo first: README.md, root SKILL.md, scripts/, providers/, and tests as needed.
3. For status/help/import questions, answer directly from repo files and the Codex package files.
4. For implementation work, follow the repo's af routing docs and use TDD.
5. For code-review requests from Codex, prefer trinity review when the local adapter is installed; it does not require Claude-specific background worker files.
6. For delegation requests, use Codex-native delegation only when the user explicitly requests background or parallel agent work and the current Codex environment exposes that capability.

Verification

For Codex load verification, use these smoke checks after changes are installed or committed:

• Repo-local skill: restart/start Codex in this repository, open /skills or invoke $trinity, and confirm trinity is visible/loadable.
• Plugin package: restart Codex, open /plugins, select the repo marketplace, and confirm the trinity plugin appears and exposes its bundled skill.
• Local wrapper: run make install-codex, then trinity --version, trinity doctor --providers glm,gemini,deepseek, and a mocked or low-risk trinity review --providers glm,gemini,deepseek --scope <path>.

For Claude Code regression verification, keep using the existing Claude checks: install Trinity, restart Claude Code, and run /trinity status.