{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "foundations-oracle-packx-field-guide",
  "slug": "oracle-packx-field-guide",
  "title": "Oracle + PackX Handoff Field Guide",
  "summary": "Spend Codex on implementation, not on reading 500K tokens of context.",
  "category": "Context",
  "tags": [
    "field guide",
    "oracle packx"
  ],
  "sources": [
    {
      "label": "Agent foundations: Route large codebase questions through Oracle (authorized access required)",
      "url": "https://codex-workshop-followup.pages.dev/lesson-01.html"
    },
    {
      "label": "Agent foundations: Combine intent, implementation, and output for autonomous work (authorized access required)",
      "url": "https://codex-workshop-followup.pages.dev/lesson-10.html"
    }
  ],
  "sourceUnits": [
    "field-guides/guides.mjs#oracle-packx/overview",
    "field-guides/guides.mjs#oracle-packx/quote",
    "field-guides/guides.mjs#oracle-packx/decision",
    "field-guides/guides.mjs#oracle-packx/agentPrompt",
    "field-guides/guides.mjs#oracle-packx/stories",
    "field-guides/guides.mjs#oracle-packx/tips",
    "field-guides/guides.mjs#oracle-packx/refs"
  ],
  "collection": "foundations",
  "categoryId": "context",
  "wordCount": 380,
  "url": "/topics/foundations-oracle-packx-field-guide/",
  "markdownUrl": "/markdown/foundations-oracle-packx-field-guide.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/foundations-oracle-packx-field-guide.json",
  "headings": [
    {
      "id": "choose-the-right-mechanism",
      "text": "Choose the right mechanism",
      "level": 2
    },
    {
      "id": "agent-ready-prompt",
      "text": "Agent-ready prompt",
      "level": 2
    },
    {
      "id": "applied-stories",
      "text": "Applied stories",
      "level": 2
    },
    {
      "id": "stale-test-suite-migration",
      "text": "Stale test-suite migration",
      "level": 3
    },
    {
      "id": "architecture-consistency-audit",
      "text": "Architecture consistency audit",
      "level": 3
    },
    {
      "id": "tips-and-gotchas",
      "text": "Tips and gotchas",
      "level": 2
    },
    {
      "id": "references",
      "text": "References",
      "level": 2
    },
    {
      "id": "related-principles",
      "text": "Related principles",
      "level": 2
    }
  ],
  "markdown": "# Oracle + PackX Handoff Field Guide\n\n> Original source pages and recordings require authorized access. The full article text here is public.\n\nSpend Codex on implementation, not on reading 500K tokens of context.\n\nUse this when the hard part is broad context synthesis and Codex should bring back an implementation-ready plan.\n\n> Use Oracle with a codebase.\n\n[Workshop transcript](https://askoracle.sh/)\n\n## Choose the right mechanism\n\n| Mechanism | Use when | Agent responsibility | Artifact |\n|---|---|---|---|\n| PackX preview | Before any large handoff | Verify files and token estimate | ~/.oracle/bundles/<slug>.txt |\n| Browser Oracle | Expensive broad reasoning | Upload bundle to ChatGPT browser mode | ~/.oracle/sessions/<slug>/output.log |\n| Codex implementation | After plan returns | Patch, test, verify, summarize | .notes/<task>/verification.md |\n\n## Agent-ready prompt\n\n```text\nUse Oracle + PackX for this broad codebase question.\nPreview the bundle first.\nBuild a markdown bundle under ~/.oracle/bundles/<slug>.txt.\nRun Oracle in browser mode with a 3-5 word slug.\nRead the full Oracle output, write a local plan, implement the first shippable slice, and verify locally before asking Oracle again.\n```\n\n## Applied stories\n\n### Stale test-suite migration\n\n**Role:** Senior engineer\n\nHundreds of tests need classification into keep, rewrite, browser QA, or delete.\n\n**Agent brief:** Pack tests, source owners, failures, and CI logs; ask Oracle for a migration plan; Codex implements one bucket at a time.\n\n**Done when:**\n\n- bundle path\n- Oracle plan\n- migration goal file\n- first verified slice\n\n### Architecture consistency audit\n\n**Role:** Tech lead\n\nA repo has several competing patterns and nobody knows the current owner path.\n\n**Agent brief:** Bundle current source and docs, ask Oracle for live owner paths and invariants, then patch docs and tests locally.\n\n**Done when:**\n\n- owner map\n- invariant list\n- docs patch\n- verification commands\n\n## Tips and gotchas\n\n- Preview before packing so the handoff is intentional.\n- Keep Oracle text-only; the local agent owns artifacts and commits.\n- Do not ask Oracle again on the same topic until you implemented, verified, hit a blocker, or narrowed scope.\n- Preserve the session slug and output path for auditability.\n\n## References\n\n- [Oracle](https://askoracle.sh/)\n- [Oracle GitHub](https://github.com/johnlindquist/oracle)\n- [PackX npm](https://www.npmjs.com/package/packx)\n\n## Related principles\n\n- [Route large codebase questions through Oracle](/topics/foundations-oracle-context-routing/)\n- [Combine intent, implementation, and output for autonomous work](/topics/foundations-context-triad-and-overnight-work/)"
}
