{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "codex-oracle-packx-runbook",
  "slug": "oracle-packx-runbook",
  "title": "Oracle and PackX execution runbook",
  "summary": "Published browser-only Packx→Oracle skill covering model settings, bundle preparation and validation, compact evidence and attachments, progress-gated follow-ups, blocking session recovery, full-response reading, implementation summaries, optional…",
  "category": "Tools",
  "tags": [
    "oracle",
    "packx",
    "runbook"
  ],
  "sources": [
    {
      "label": "Portable Codex workflow resources",
      "url": "https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle"
    }
  ],
  "sourceUnits": [
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Non-Negotiable Runtime Mode",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/ChatGPT Intelligence Setting",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Operating Principle",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Output Artifact Boundary",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Forward Progress Contract",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Long-Running Expectations",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline/Step 1: Choose a slug",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline/Step 2: Preview with packx",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline/Step 3: Build the bundle",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline/Step 4: Validate the bundle",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline/Step 4.5: Add compact evidence when raw context is too large or unsafe",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline/Step 5: Add screenshots or artifacts",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline/Step 6: Call Oracle",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline/Step 7: Read the full response",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline/Step 8: Summarize for execution",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Pipeline/Step 9: Commit phase, only when requested",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Prompt Contract",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Troubleshooting",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/Completion Checklist",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/skills/oracle-packx/SKILL.md#Packx + Oracle Pipeline/References",
    "downloads/codex-power-user-workshop-2026-06-27.bundle"
  ],
  "collection": "codex",
  "categoryId": "tools",
  "wordCount": 2865,
  "url": "/topics/codex-oracle-packx-runbook/",
  "markdownUrl": "/markdown/codex-oracle-packx-runbook.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/codex-oracle-packx-runbook.json",
  "headings": [
    {
      "id": "non-negotiable-runtime-mode",
      "text": "Non-Negotiable Runtime Mode",
      "level": 2
    },
    {
      "id": "chatgpt-intelligence-setting",
      "text": "ChatGPT Intelligence Setting",
      "level": 2
    },
    {
      "id": "operating-principle",
      "text": "Operating Principle",
      "level": 2
    },
    {
      "id": "output-artifact-boundary",
      "text": "Output Artifact Boundary",
      "level": 2
    },
    {
      "id": "forward-progress-contract",
      "text": "Forward Progress Contract",
      "level": 2
    },
    {
      "id": "long-running-expectations",
      "text": "Long-Running Expectations",
      "level": 2
    },
    {
      "id": "pipeline",
      "text": "Pipeline",
      "level": 2
    },
    {
      "id": "step-1-choose-a-slug",
      "text": "Step 1: Choose a slug",
      "level": 3
    },
    {
      "id": "step-2-preview-with-packx",
      "text": "Step 2: Preview with packx",
      "level": 3
    },
    {
      "id": "step-3-build-the-bundle",
      "text": "Step 3: Build the bundle",
      "level": 3
    },
    {
      "id": "step-4-validate-the-bundle",
      "text": "Step 4: Validate the bundle",
      "level": 3
    },
    {
      "id": "step-4-5-add-compact-evidence-when-raw-context-is-too-large-or-unsafe",
      "text": "Step 4.5: Add compact evidence when raw context is too large or unsafe",
      "level": 3
    },
    {
      "id": "step-5-add-screenshots-or-artifacts",
      "text": "Step 5: Add screenshots or artifacts",
      "level": 3
    },
    {
      "id": "step-6-call-oracle",
      "text": "Step 6: Call Oracle",
      "level": 3
    },
    {
      "id": "step-7-read-the-full-response",
      "text": "Step 7: Read the full response",
      "level": 3
    },
    {
      "id": "step-8-summarize-for-execution",
      "text": "Step 8: Summarize for execution",
      "level": 3
    },
    {
      "id": "step-9-commit-phase-only-when-requested",
      "text": "Step 9: Commit phase, only when requested",
      "level": 3
    },
    {
      "id": "prompt-contract",
      "text": "Prompt Contract",
      "level": 2
    },
    {
      "id": "troubleshooting",
      "text": "Troubleshooting",
      "level": 2
    },
    {
      "id": "completion-checklist",
      "text": "Completion Checklist",
      "level": 2
    },
    {
      "id": "references",
      "text": "References",
      "level": 2
    },
    {
      "id": "operational-boundaries",
      "text": "Operational boundaries",
      "level": 2
    },
    {
      "id": "related-resources",
      "text": "Related resources",
      "level": 2
    }
  ],
  "markdown": "# Oracle and PackX execution runbook\n\nYou are a PIPELINE EXECUTOR. Your job is: packx bundle -> `mcp__oracle__consult` -> read output.log -> summarize Oracle's answer -> optionally commit Oracle-driven implementation changes when the user explicitly asks.\n\nDo not answer the user's question from your own code research. Use local inspection only to build an excellent bundle and prompt. The point of this skill is to spend Oracle's expensive intelligence on high-leverage design, implementation, and review output.\n\n## Non-Negotiable Runtime Mode\n\nOracle MUST always run through the browser engine using the remote browser configuration in `~/.oracle/config.json`. Treat this as a hard stop before every consult call, including follow-up calls.\n\n- Every `mcp__oracle__consult` call MUST set `engine: \"browser\"`.\n- Never use `engine: \"api\"` and never omit `engine`; the API engine's `OPENAI_API_KEY` failure is a caller bug, not a credential blocker.\n- Never switch to API mode because it seems faster, because browser mode timed out, because a smaller/follow-up prompt is being sent, or because a specific model label looks API-only.\n- If a planned Oracle call object contains `engine: \"api\"` or lacks `engine: \"browser\"`, discard that call object before invoking the tool and rebuild it in browser mode.\n- Model choice must be expressed through browser-compatible fields such as `browserModelLabel` and `browserThinkingTime`; do not use API credentials, API model IDs, or API-engine shortcuts.\n- Do not pass ad hoc remote host, token, profile, or browser-routing overrides. Let Oracle read `~/.oracle/config.json`, which owns the remote browser endpoint.\n- If the MCP surface is unavailable, the CLI Oracle recovery path MUST use `oracle --engine browser ...` and the same `~/.oracle` config. Do not add API flags or environment-key workarounds.\n- If any Oracle attempt reports `Missing OPENAI_API_KEY`, immediately retry in browser mode using the `~/.oracle` config instead of asking the user for a key.\n\n## ChatGPT Intelligence Setting\n\noracle-packx is a text/code reasoning workflow, not image generation. Use\nChatGPT **Pro Extended** for every `oracle-packx` consult.\n\nCritical rules:\n\n- Every `mcp__oracle__consult` call in this skill must include\n  `browserThinkingTime: \"extended\"`.\n- Keep `browserModelLabel: \"Latest\"` and `model: \"gpt-5.5-pro\"` unless the user\n  explicitly asks for a different browser model.\n- Never use `browserThinkingTime: \"instant\"` for packx, planning, review,\n  architecture, debugging, or code-analysis consults.\n- Instant is reserved for ChatGPT **Create image** / `imagine` runs only.\n- If the visible ChatGPT Intelligence pill says `Instant` before a packx run,\n  change it back through Oracle by sending `browserThinkingTime: \"extended\"`;\n  do not rely on the current UI state.\n\nGood call shape:\n\n```text\nmcp__oracle__consult({\n  prompt: \"[{slug}]\\n\\n{question}\",\n  files: [\"~/.oracle/bundles/{slug}.txt\"],\n  engine: \"browser\",\n  model: \"gpt-5.5-pro\",\n  browserModelLabel: \"Latest\",\n  browserThinkingTime: \"extended\",\n  slug: \"{slug}\"\n})\n```\n\nBad call shape:\n\n```text\nbrowserThinkingTime: \"instant\"  # image generation only; wrong for oracle-packx\n```\n\n## Operating Principle\n\nOracle is expensive and powerful. Push it for maximum useful output.\n\n- Current validated browser-mode bundle target: up to ~900k tokens. The old ~49k guidance is obsolete.\n- Large bundles may exceed 1 MB on disk; rely on `~/.oracle/config.json` `maxFileSizeBytes` (10 MiB or higher) instead of splitting solely because of the old guard.\n- Ask for comprehensive solutions, not cautious fragments.\n- Ask Oracle to identify the highest-leverage work, sequencing, risks, invariants, tests, logs, and verification receipts.\n- Ask for critical code snippets, exact file/function targets, and implementation notes local agents can execute.\n- Ask Oracle to separate \"must implement now\" from \"later polish\", while still pushing for a meaningful implementation wave.\n- Expect local verification with `$agentic-testing`, logs, targeted tests, and `lat check` to teach us more after Oracle gives the plan.\n\n## Output Artifact Boundary\n\nFor planning, review, debugging, goal-writing, or implementation guidance, Oracle must return text in the chat/session response only. Do not ask Oracle to create, attach, export, or offer a downloadable file as the deliverable.\n\nThe local agent owns every local artifact:\n\n- `~/.oracle/bundles/{slug}.txt` is created locally by `packx`.\n- `~/.oracle/sessions/{slug}/output.log` is Oracle session output captured locally.\n- Repo files, `.goals/*.md`, `.loop/oracle-loop/**`, prompts, plans, review notes, commits, and verification logs are written locally by the agent with local file-editing or shell tools.\n\nIf Oracle creates a downloadable file anyway, do not treat the download as the artifact. Read the response content and write the local artifact yourself. If the only useful content exists inside an unreadable download, rerun Oracle with the no-download constraint emphasized.\n\n## Forward Progress Contract\n\nOracle is not a substitute for doing the work. Before any second or later Oracle call on the same topic, the local agent MUST build a Prior-State Ledger and pass the Forward Progress Gate.\n\nFor a first Oracle call on a new topic, write `prior_oracle_session: none` and continue. For every follow-up Oracle call on the same topic, include this ledger in the Oracle prompt:\n\n```text\nPrior-State Ledger:\n- prior_oracle_session: <slug/path, or none for first call>\n- last_oracle_recommendation: <one-paragraph summary>\n- implemented_since_prior_oracle: <files/functions/tests/receipts changed, or none>\n- verified_since_prior_oracle: <exact command/receipt/result, or none>\n- failed_proof_or_blocker: <exact failed command/output/log/screenshot path, or none>\n- narrowing_decision: <what scope was removed and what one slice remains>\n- files_functions_now_in_scope: <exact paths#symbols>\n- files_functions_out_of_scope: <explicit exclusions>\n- next_falsifiable_verification: <command, receipt, screenshot, or runtime proof>\n- forward_progress_index: <score and arithmetic>\n```\n\nForward Progress Gate: before another Oracle call on the same topic, at least one of these MUST be true:\n\n- `implemented`: files, tests, goal artifacts, or receipts changed since the prior Oracle session.\n- `verified`: a new proof result exists, even if it is red.\n- `blocked`: an exact failed command/output/log/screenshot path exists.\n- `narrowed`: the new prompt removes scope and targets exactly one next shippable slice.\n\nIf none are true, do not call Oracle again. Implement the previous recommendation, run proof, capture a blocker, or narrow the prompt first.\n\nForward Progress Index:\n\n- +3 consumed a prior receipt, failed proof, or blocker\n- +3 selected exactly one new next slice\n- +2 named exact files/functions/tests/commands\n- +2 added falsifiable verification\n- +2 resulted in a checked-in or written goal/test/receipt afterward\n- -3 repeats the same topic without new evidence\n- -4 produces a broad roadmap instead of the next action\n\nTarget score before a follow-up Oracle call: `>= 7`. A score below 7 is allowed only when `blocked` is true and the prompt includes the exact blocker receipt. Record the score in the local goal, loop state, or final summary.\n\n## Long-Running Expectations\n\nOracle browser runs are blocking research sessions. After Codex starts an Oracle call, all local planning, implementation, verification, and independent problem solving MUST pause until Oracle has fully completed and the local Oracle response has been read. There are no elapsed-time exceptions.\n\n- Never assume Oracle timed out or failed based on elapsed time alone.\n- Never proceed independently while Oracle is still processing, even if a wrapper returns after 120s or any other local wait limit.\n- Treat Oracle's response as the required next input. No fallback, workaround, self-directed implementation, or \"I'll continue while it runs\" path is allowed.\n- Reattach with `mcp__oracle__sessions({ id: \"{slug}\", detail: true })` or read `~/.oracle/sessions/{slug}/output.log` when it lands.\n- Health checks are allowed only to reattach, inspect session state, or confirm whether Oracle has produced the final local response. They are not permission to start work.\n- Keep waiting as long as Oracle requires while the session is still processing. There is no Codex-side timeout threshold that permits independent action.\n- Only treat the run as failed when Oracle reports an explicit error, the session exits non-zero, browser automation is blocked, or logs show a terminal failure.\n\nFor packx flags and filter details, see [references/packx-quick-reference.md](/topics/codex-packx-command-reference/).\n\n## Pipeline\n\n### Step 1: Choose a slug\n\nSlug must be 3-5 words separated by hyphens. Oracle rejects slugs outside this range.\n\n```bash\nmkdir -p ~/.oracle/bundles\n```\n\n### Step 2: Preview with packx\n\nRun a dry-run to check file count and estimated size.\n\n```bash\npackx --preview [your-filters] -x \"**/CLAUDE.md\"\n```\n\nStop if 0 files match. Fix filters and preview again. If the target directory is not your cwd, wrap in a subshell: `(cd /path/to/project && packx ...)`.\n\nNever include `CLAUDE.md` in an Oracle PackX bundle. Always exclude it explicitly with `-x \"**/CLAUDE.md\"` and prefer `AGENTS.md` for repository guidance when both files exist.\n\n### Step 3: Build the bundle\n\nTarget a rich bundle close to 900k. If the bundle is under 250k for a broad planning/review task, attempt another pass with more relevant context, process docs, `lat.md` pages, tests, logs, or adjacent owners before consulting Oracle. Smaller focused bundles are still fine for narrow questions.\n\n```bash\npackx --limit 900k [filters] -x \"**/CLAUDE.md\" -f markdown --no-interactive --stdout > ~/.oracle/bundles/{slug}.txt\n```\n\nRequired flags: `--limit 900k`, `-x \"**/CLAUDE.md\"`, `-f markdown`, `--no-interactive`, `--stdout`.\n\nIf preview showed more than 200 files, add `--strip-comments --minify` so the final bundle still carries broad context.\n\n### Step 4: Validate the bundle\n\n```bash\ntest -s ~/.oracle/bundles/{slug}.txt && echo \"OK\" || echo \"EMPTY\"\n```\n\nStop if empty. Go back to Step 2.\n\n### Step 4.5: Add compact evidence when raw context is too large or unsafe\n\n`packx` remains the primary bundle. Do not skip the bundle. However, if raw session logs, hidden-path scans, screenshots, traces, or generated receipts are too large, unsafe, unavailable, or filtered out, add compact evidence.\n\nWrite `~/.oracle/bundles/{slug}-evidence.md` when useful:\n\n```markdown\n# Compact Evidence Supplement\n\n## Prior-State Ledger\n<ledger, or prior_oracle: none>\n\n## Receipts and failures\n- <exact command / receipt / failure summary>\n- <paths to screenshots, logs, traces, or receipts not included in packx>\n\n## Raw context intentionally omitted\n- <large log/session path> -- omitted because <too large / hidden path / unsafe / unavailable>\n- <summary of the relevant lines or facts>\n\n## Current narrowing\n- one_next_slice: <exact next slice>\n- out_of_scope: <what is intentionally excluded>\n- verification: <falsifiable proof>\n```\n\nPass the supplement as an extra file when it is small and safe. If the supplement itself would be too large, include the compact evidence directly in the prompt. This is allowed only as evidence compaction, not as a replacement for the primary packx bundle.\n\n### Step 5: Add screenshots or artifacts\n\nIf the user provided image, PDF, log, trace, or screenshot paths, verify they exist and pass them in `files` with the bundle. Use `browserAttachments: \"always\"` for visual files.\n\n### Step 6: Call Oracle\n\nYou must execute this MCP tool call.\n\n```\nmcp__oracle__consult({\n  prompt: \"[{slug}]\\n\\n{your detailed question here}\",\n  files: [\"~/.oracle/bundles/{slug}.txt\"],\n  engine: \"browser\",\n  model: \"gpt-5.5-pro\",\n  browserModelLabel: \"Latest\",\n  browserThinkingTime: \"extended\",\n  slug: \"{slug}\"\n})\n```\n\nForbidden call shapes:\n\n```text\nengine: \"api\"              # never valid for oracle-packx\nmodel: \"<api-model-id>\"    # never use this as a reason to switch engines\nengine omitted             # never rely on Oracle defaults\n```\n\nIf you notice one of these shapes in a drafted call, stop before tool invocation and rewrite the call with `engine: \"browser\"` plus browser fields. Do not try it once \"to see if it works.\"\n\nWith screenshots or PDFs:\n\n```\nmcp__oracle__consult({\n  prompt: \"[{slug}]\\n\\n{your detailed question here}\",\n  files: [\"~/.oracle/bundles/{slug}.txt\", \"/path/to/screenshot.png\"],\n  engine: \"browser\",\n  model: \"gpt-5.5-pro\",\n  browserModelLabel: \"Latest\",\n  browserThinkingTime: \"extended\",\n  browserAttachments: \"always\",\n  slug: \"{slug}\"\n})\n```\n\n### Step 7: Read the full response\n\nThe MCP return can be truncated. Read the authoritative answer from:\n\n```text\n~/.oracle/sessions/{slug}/output.log\n```\n\nIf the file does not exist yet, check session status and keep waiting unless there is a real terminal failure. A long browser run is expected; keep waiting while the session is still alive and logs show no terminal failure.\nDo not summarize, plan, edit, verify, or answer from your own analysis until this full Oracle output is available and read.\n\n### Step 8: Summarize for execution\n\nLead with Oracle's highest-leverage recommendations, then convert the answer into implementation-ready work packages. Preserve Oracle's reasoning, file targets, critical snippets, logging asks, verification plan, and unresolved risks.\n\nIf follow-up code changes are likely, mention the optional commit path: after implementation, the user can say `commit` and you should inspect the diff, map actual changes back to Oracle's advice, and create a traceable commit tied to `{slug}`.\n\n### Step 9: Commit phase, only when requested\n\nOnly run this step if the user explicitly asks after implementation.\n\n```bash\ngit diff --staged\ngit diff\n```\n\nPrefer `git diff --staged` as the commit boundary. Stage only relevant Oracle-driven changes. Do not sweep unrelated edits into the commit.\n\nCommit message format:\n\n```text\n<imperative subject line, <=72 chars>\n\n- <what changed> because Oracle recommended <fix/improvement>\n- <what changed> to address Oracle's finding about <risk/problem>\n\nOracle-Session: {slug}\n```\n\n## Prompt Contract\n\nEvery Oracle prompt must be self-contained, ambitious, and progress-gated.\n\nInclude:\n\n1. Slug header: `[{slug}]`.\n2. Project briefing: stack, framework, runtime, and repo rules.\n3. Goal: the broad outcome the user wants, plus the first shippable slice when the goal is broad.\n4. Prior-State Ledger: use `prior_oracle_session: none` for the first consult; for follow-ups include the last Oracle recommendation, what was implemented, verification result, failed proof or blocker, and what is being narrowed now.\n5. Forward Progress Gate result: `implemented`, `verified`, `blocked`, or `narrowed`, including Forward Progress Index arithmetic.\n6. Current evidence: attempts, logs, screenshots, failing receipts, blocker outputs, or known constraints.\n7. Bundle map: why these files were included, what may be missing, and what compact evidence was summarized because raw logs/hidden paths were too large or unavailable.\n8. Deliverable: ask for architecture, implementation plan, critical code snippets, file/function targets, tests, logs, verification strategy, and task breakdown for local agents.\n9. Next action shape: Oracle must identify the one highest-leverage next shippable slice, separate immediate implementation from later roadmap, and name exact files/functions/tests when possible.\n10. Repo-specific rules: for Script Kit GPUI, include `AGENTS.md`, owning skills, relevant `lat.md` pages, and `lat.md/verification.md` when implementation or review checks are part of the question. Never include `CLAUDE.md`; prefer `AGENTS.md` for repo instructions.\n11. Output boundary: ask Oracle to return text in the response only, with no downloadable files, attachments, exports, or generated local artifacts.\n\nInclude this constraint verbatim or equivalently in every planning/review prompt:\n\n```text\nReturn your answer as text in this response only. Do not create, attach, export,\nor offer any downloadable file. Do not create local project artifacts yourself.\nThe local agent will write any needed files, plans, notes, goals, commits, or\nverification logs using local tools.\n```\n\nAvoid prompts that ask only \"what is the next change?\" Also avoid repeated broad replanning. A follow-up prompt on the same topic must either consume new evidence or deliberately narrow to one next slice.\n\n## Troubleshooting\n\n| Problem | Fix |\n|---------|-----|\n| Empty bundle | Check `--preview`; ensure `-i` uses `**/` prefix; expand relevant filters |\n| `-i \"*.ts\"` matches nothing | Use `-i \"**/*.ts\"` |\n| `-i` + external path = 0 files | Wrap in `(cd TARGET && packx ...)` |\n| Token budget exceeded | Use `--strip-comments --minify`, then sharpen filters around owners, tests, docs, and logs |\n| `mcp__oracle__consult` unavailable | Use the CLI Oracle recovery path: `oracle --engine browser --model gpt-5.5-pro --browser-thinking-time extended -p \"...\" --file ~/.oracle/bundles/{slug}.txt --slug \"{slug}\"` |\n| `Missing OPENAI_API_KEY` | The call accidentally used API mode or defaulted incorrectly. Retry with `engine: \"browser\"` and let Oracle read `~/.oracle/config.json`. |\n| 120s timeout / no final answer yet | Reattach/check `mcp__oracle__sessions` or `output.log`; do not proceed independently; keep waiting until Oracle completes or reports a terminal failure |\n| Truncated response | Read `~/.oracle/sessions/{slug}/output.log` |\n| Oracle created a downloadable file | Do not use it as the artifact; write the needed local file yourself from response text, or rerun with the no-download constraint emphasized |\n| Thinking time error | Use `browserThinkingTime: \"extended\"` |\n\n## Completion Checklist\n\n- [ ] `packx` preview ran and produced matching files.\n- [ ] `~/.oracle/bundles/{slug}.txt` exists and is non-empty.\n- [ ] If under 250k for broad planning/review, you attempted to add useful context before consulting Oracle.\n- [ ] You called `mcp__oracle__consult` with `engine: \"browser\"` so Oracle uses `~/.oracle/config.json`.\n- [ ] You read `~/.oracle/sessions/{slug}/output.log`.\n- [ ] Your summary is based on Oracle's answer, not your own analysis.\n- [ ] No planning, implementation, verification, or final answer happened while Oracle was still processing.\n- [ ] Oracle was asked to return text only and not create downloadable files or project artifacts.\n- [ ] For follow-up Oracle calls, the prompt included a Prior-State Ledger.\n- [ ] For follow-up Oracle calls, the Forward Progress Gate passed as `implemented`, `verified`, `blocked`, or `narrowed`.\n- [ ] The Forward Progress Index arithmetic was recorded.\n- [ ] If raw logs/session output/hidden paths were too large or unavailable, compact evidence was summarized in the prompt or a `~/.oracle/bundles/{slug}-evidence.md` supplement.\n- [ ] Oracle was asked for one next shippable slice, not only a broad roadmap.\n- [ ] If committing, you inspected staged and unstaged diffs and mapped the commit to Oracle's recommendations.\n\n## References\n\n- [Packx quick reference](/topics/codex-packx-command-reference/) - flags, filters, workflows, size management\n- [Packx deep technical reference](/topics/codex-packx-technical-reference/) - internals, caching, AST details\n\n## Operational boundaries\n\n- The browser-only mode, extended-thinking setting, exclusion policy, and progress score are this runbook’s operating choices. They are not universal tool limitations.\n- Numeric token targets and model labels describe a configured workflow, not a guaranteed current capacity. An accepted attachment does not prove the model consumed every token. Verify the installed tools and provider limits.\n- Repo-specific verification helpers such as `$agentic-testing`, `lat check`, and `lat.md` require that project’s tooling; use the corresponding real verification surface for another repository.\n\n## Related resources\n\n- [Companion reference](https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle)\n- [Resource directory and portable download](/topics/codex-resources/)"
}
