{"slug": "subagent-guidance-for-codex-copy-the-raw-contents-into-your-codex-agents-md", "title": "Subagent guidance for Codex (copy the raw contents into your ~/.codex/AGENTS.md)", "summary": "A developer published guidance for configuring Codex subagents, instructing that both the model and reasoning effort be set explicitly at spawn time rather than inherited from the parent. The flow maps task characteristics to model/effort pairs — Luna (gpt-6-luna) for mechanical, synthesis, and ordinary bounded work, and Sol (gpt-6.1-sol) for complex tasks requiring conflicting-evidence decisions or deep correctness reasoning — with Luna/high as the configured default and forks disabled via fork_turns=\"none\".", "body_md": "Use this guidance whenever launching any subagent, regardless of role.\n\nBefore every launch, follow the flow below to choose the model and reasoning effort together. Set both explicitly in the spawn call. Apply the flow again for each new assignment; do not automatically reuse a previous selection.\n\nKeep the user-selected lead model unchanged. Luna means `gpt-6-luna`;\nSol means `gpt-6.1-sol`. The configured default is Luna/high.\n\nFollow this flow before spawning. Choose the resulting pair directly; these are classification questions, not a sequence of trial runs.\n\n``` php\nflowchart TD\n    Task[Assess the assigned subtask] --> Complex{\"Complex or ambiguous task?<br/>Architecture, interacting modules,<br/>difficult debugging, broad or risky review\"}\n    Complex -->|No| Mechanical{\"Purely mechanical?<br/>Exact checks, simple extraction,<br/>fine-grained edits with no judgment\"}\n    Mechanical -->|Yes| LunaLow[Luna / low]\n    Mechanical -->|No| Synthesis{\"Substantial synthesis with clear constraints?<br/>Several sources or apps\"}\n    Synthesis -->|Yes| LunaXhigh[Luna / xhigh]\n    Synthesis -->|No| LunaHigh[\"Luna / high<br/>Ordinary bounded work\"]\n    Complex -->|Yes| Demanding{\"Decisions from conflicting evidence,<br/>or demanding deliverables needing<br/>polish and consistency across components?\"}\n    Demanding -->|Yes| SolXhigh[Sol / xhigh]\n    Demanding -->|No| Deep{\"Deep correctness reasoning?<br/>Competing hypotheses, state, concurrency,<br/>lifecycle, subtle security or data integrity\"}\n    Deep -->|Yes| SolHigh[Sol / high]\n    Deep -->|No| SolMedium[\"Sol / medium<br/>Normal starting point for complex work\"]\n```\n\nBefore spawning, give the subagent a self-contained brief and use\n`fork_turns=\"none\"`. Set both `model` and `reasoning_effort` explicitly to\nthe selected pair. Full-history forks inherit the parent model and effort\nand cannot accept spawn-time overrides. Check custom agent files first:\ntheir model and reasoning settings take precedence. State the task-specific\nreason for choosing a pair other than Luna/high.\n\nIf work stalls, identify the cause before changing the pair. Missing requirements, evidence, or access, tool failures, waiting for CI, and routine test repairs call for better information or execution. For a demonstrated reasoning limitation, return the unresolved problem and evidence to the lead; the lead reassesses this flow and explains why the new pair should help.\n\nMax and ultra are exceptional choices for a bounded problem. Reassess the model and problem framing first, and explain why xhigh is insufficient. Repository size, elapsed time, or the lead's setting alone do not justify an increase. Long or repetitive work with a settled contract can stay on Luna. Reassess each new assignment rather than carrying an elevated setting forward.\n\nUse the [OpenAI model-selection guidance](https://developers.openai.com/api/docs/guides/model-selection)\nas task-specific starting points alongside this local flow.", "url": "https://wpnews.pro/news/subagent-guidance-for-codex-copy-the-raw-contents-into-your-codex-agents-md", "canonical_source": "https://gist.github.com/chrisbanes/dc1407ddd22d6e8d6c4d374b564eac9a", "published_at": "2026-10-01 13:13:48+00:00", "updated_at": "2026-10-02 01:45:03.436475+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "large-language-models"], "entities": ["Codex", "OpenAI", "gpt-6-luna", "gpt-6.1-sol"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/subagent-guidance-for-codex-copy-the-raw-contents-into-your-codex-agents-md", "markdown": "https://wpnews.pro/news/subagent-guidance-for-codex-copy-the-raw-contents-into-your-codex-agents-md.md", "text": "https://wpnews.pro/news/subagent-guidance-for-codex-copy-the-raw-contents-into-your-codex-agents-md.txt", "jsonld": "https://wpnews.pro/news/subagent-guidance-for-codex-copy-the-raw-contents-into-your-codex-agents-md.jsonld"}}