{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "foundations-daemon-profiles-field-guide",
  "slug": "daemon-profiles-field-guide",
  "title": "Codex Daemon Profile Field Guide",
  "summary": "Turn repeated web-dev chores into narrow, cheap, low-context Codex workers.",
  "category": "Execution",
  "tags": [
    "field guide",
    "daemon profiles"
  ],
  "sources": [
    {
      "label": "Agent foundations: Build narrow daemons and inspectable agent graphs (authorized access required)",
      "url": "https://codex-workshop-followup.pages.dev/lesson-09.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#daemon-profiles/overview",
    "field-guides/guides.mjs#daemon-profiles/decision",
    "field-guides/guides.mjs#daemon-profiles/agentPrompt",
    "field-guides/guides.mjs#daemon-profiles/stories",
    "field-guides/guides.mjs#daemon-profiles/tips",
    "field-guides/guides.mjs#daemon-profiles/refs"
  ],
  "collection": "foundations",
  "categoryId": "execution",
  "wordCount": 371,
  "url": "/topics/foundations-daemon-profiles-field-guide/",
  "markdownUrl": "/markdown/foundations-daemon-profiles-field-guide.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/foundations-daemon-profiles-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": "preview-deploy-checker",
      "text": "Preview deploy checker",
      "level": 3
    },
    {
      "id": "log-triage-worker",
      "text": "Log triage worker",
      "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": "# Codex Daemon Profile Field Guide\n\n> Original source pages and recordings require authorized access. The full article text here is public.\n\nTurn repeated web-dev chores into narrow, cheap, low-context Codex workers.\n\nUse this when a repeated CLI or browser-adjacent task deserves its own focused Codex profile instead of a full general agent.\n\n## Choose the right mechanism\n\n| Mechanism | Use when | Agent responsibility | Artifact |\n|---|---|---|---|\n| Daemon profile | Repeated narrow task | Preview deploy checks, log triage, changelog drafting | profiles/pro-<tool>.ts |\n| Fake CODEX_HOME | Hard isolation | Disable memories/MCP/plugins unless needed | .codex-daemon-home/ |\n| Command map | Small tool vocabulary | Literal tasks with predictable outputs | README plus examples |\n\n## Agent-ready prompt\n\n```text\nDesign a narrow Codex daemon profile for this repeated task.\nUse one command map, one output shape, low reasoning by default, and no broad memory/MCP/plugin access unless required.\nKeep it read-only first.\nWrite docs, examples, and a smoke test before using it on a real repo.\n```\n\n## Applied stories\n\n### Preview deploy checker\n\n**Role:** Frontend lead\n\nEvery PR needs preview status, changed-route browser proof, and a short verdict.\n\n**Agent brief:** Create a read-only deploy-check profile that discovers preview URL, opens changed routes, and writes a browser receipt.\n\n**Done when:**\n\n- profile file\n- command map\n- read-only proof\n- smoke test\n\n### Log triage worker\n\n**Role:** On-call engineer\n\nA local dev server spews logs and general Codex wastes context reading everything.\n\n**Agent brief:** Create a profile that tails, filters, summarizes, and writes exact blocker text for the main Codex session.\n\n**Done when:**\n\n- filtered log\n- blocker summary\n- no source edits\n- handoff path\n\n## Tips and gotchas\n\n- A daemon profile should be boring: one job, one command map, one output format.\n- Disable unrelated memories, MCPs, apps, and skills to keep context small.\n- Start read-only; add mutation only after a smoke test proves the profile is scoped.\n- Use low reasoning for literal CLI wrappers and reserve smarter models for ambiguous planning.\n\n## References\n\n- [codex-daemons](https://github.com/johnlindquist/codex-daemons)\n- [Codex SDK](https://developers.openai.com/codex/sdk)\n- [Codex MCP](https://developers.openai.com/codex/mcp)\n\n## Related principles\n\n- [Build narrow daemons and inspectable agent graphs](/topics/foundations-narrow-daemons-and-agent-graphs/)\n- [Combine intent, implementation, and output for autonomous work](/topics/foundations-context-triad-and-overnight-work/)"
}
