codex-thread-orchestration

codex-thread-orchestration is a skill for Claude Code, Codex from Arch1eSUN/Arcgentic. It costs 37 tokens per session (4,335 once invoked), scanned A, original, MIT.

A coordination guide for running a software project through fixed Planner, Developer, Test, and Auditor roles in Codex. It keeps the roles and project rounds organised.

In plain words
What is it for?
Use it when orchestrating Arcgentic V2 work in Codex, either within one session or across dedicated role threads.
Why use it?
It prevents role and round names from becoming inconsistent while separating planning, implementation, testing, and auditing work.

Skill for Claude CodeCodex

Part of the arcgentic plugin — 18 skills, 9 agents, 1 MCP server shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/arch1esun/arcgentic/codex-thread-orchestration
Any agent
npx skills add Arch1eSUN/Arcgentic --skill codex-thread-orchestration
Clone the repo
git clone --depth 1 https://github.com/Arch1eSUN/Arcgentic

Made for: Claude Code, Codex.

Or install arcgentic, the plugin that ships this one along with the rest of its 18 skills, 9 agents, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for codex-thread-orchestration

README.md
[![agentmods](https://agentmods.dev/badge/skills/arch1esun/arcgentic/codex-thread-orchestration.svg)](https://agentmods.dev/skills/arch1esun/arcgentic/codex-thread-orchestration)
Your own site
<a href="https://agentmods.dev/skills/arch1esun/arcgentic/codex-thread-orchestration"><img src="https://agentmods.dev/badge/skills/arch1esun/arcgentic/codex-thread-orchestration.svg" alt="Measured on agentmods" height="20"></a>
Per session 37 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,335 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00037 $0.04335
Opus 5 $0.00018 $0.02167
Sonnet 5 $0.00007 $0.00867
Haiku 4.5 $0.00004 $0.00434

Measured 5d ago against content hash 86ac3a5b5b96, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

codex-thread-orchestration scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/codex-thread-orchestration/SKILL.md · 448 lines

How it starts

The opening of the file, as written. The whole thing — 448 lines — stays where its author put it; the contents beside it link to each section on GitHub.

codex-thread-orchestration

Use this skill only in Codex host mode. The current thread is the Orchestrator.

Contract

V2 uses exactly five host-visible thread titles:

  • Orchestrator
  • Planner
  • Developer
  • Test
  • Auditor

Never create R1 Developer, R2 Test, R3 Auditor, or other round-numbered thread names. Round identity lives in .agentic-rounds/state.yaml and in the role prompt.

Phase/project close is Orchestrator-owned after Planner declares that a phase or the full project is complete. It is not a per-round role and it must not run after every Auditor PASS.

V2 has two project-level modes:

  • single-session-subagent: faster and usually completes sooner. The current Orchestrator session runs named Planner / Developer / Test / Auditor subagents without creating role threads. Role names must still be inherited exactly. The first use of a role creates that named role identity; later rounds reuse the same role identity.
  • multi-session-subthread: slower, with stronger role separation. The Orchestrator creates or reuses fixed project threads titled Planner, Developer, Test, and Auditor.

If no mode is stored, judge the user's idea and recommend a mode before dispatching Planner:

arcgentic session-mode recommend-v2 --idea '<current user request>'

Show the recommendation, confidence, reasons, and tradeoff, then ask the user to confirm or override it. Do not default silently.

Procedure

  1. Rename the current Codex thread to exactly Orchestrator, then ensure .agentic-rounds/state.yaml records the current thread as Orchestrator before dispatching any role:

    arcgentic v2-record-session \
      --state .agentic-rounds/state.yaml \
      --host codex \
      --role orchestrator \
      --thread-id <current-orchestrator-thread-id> \
      --title Orchestrator
    

    If the host cannot provide the current Orchestrator thread id, stop. Without this id, Planner / Developer / Auditor cannot actively send completion back. If the host cannot rename the current thread, stop because the fixed-role thread set is not visible to the user. If this thread was created from a Codex delegation payload, the source_thread_id is not the current Orchestrator id. It is the upstream supervising thread id and must not be recorded as the push-return target. When correcting only this mistake, use:

Read the full file on GitHub · 448 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 448 lines · 37 tokens per session scan A 86ac3a5b5b96

Subscribe to this mod's changes

codex-thread-orchestration is a skill published in the GitHub repository Arch1eSUN/Arcgentic (292 stars, last pushed 24d ago), licensed MIT. It adds 37 tokens to every session and 4,335 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

debt-ops-init

Write or refresh a "Tech debt operations" section in the project's AGENTS.md so the team shares one source of truth for debt-ops disciplines. Run ONLY when the user explicitly asks to set up, install, or initialize debt-ops disciplines — never auto-invoke. Idempotent; only the managed section changes, other sections…

bcanfield/agentic-tech-debt · 76 tokens

init

Write or refresh the ## Tech debt operations section in CLAUDE.md so a team shares one source of truth for debt-ops disciplines and cached quality commands. Idempotent. Only the managed section changes; other sections are untouched. Invoked explicitly via /debt-ops:init (solo users get the same content from the…

bcanfield/agentic-tech-debt · 74 tokens

add

Register a deferred decision in the debt registry. Trigger by judgment, not a marker scan, whenever a future reader would ask "why this way?": an unmade decision, stub, loosened type, bypassed check, swallowed error, a default picked "for now", or a TODO/FIXME/HACK/XXX marker. Trigger immediately whenever you defer…

bcanfield/agentic-tech-debt · 110 tokens

metrics

Print a debt-ops health summary from the metrics log, covering registration rate, hook feedback action rate, ADR creation, and AI-authored share. Use when the user asks for "debt-ops metrics", "debt health", "registry stats", or invokes /debt-ops:metrics. Read-only, never writes the log.

bcanfield/agentic-tech-debt · 72 tokens

review

Audit the debt registry, rank survivors by churn × Fowler quadrant, surface a top-N list, then walk paydown on user follow-up. Use when the user asks to review debt, see what to pay down, work through entries, or invokes /debt-ops:review. Stale entries drop with drop A,B,C.

bcanfield/agentic-tech-debt · 70 tokens

debt-ops-add

Register a deferred decision in the tech-debt registry. Trigger by judgment, not a marker scan, whenever a future reader would ask "why this way?": an unmade decision, stub, loosened type, bypassed check, swallowed error, a default picked "for now", or a TODO/FIXME/HACK/XXX marker. Trigger immediately whenever you…

bcanfield/agentic-tech-debt · 115 tokens