{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "codex-workspace-agents",
  "slug": "workspace-agents",
  "title": "Build hyper-specific workspace agents",
  "summary": "The fastest useful agent is usually not the biggest one. Wrap the tools you already trust, preload only the context the job needs, and keep broad agents out of small repeated tasks.",
  "category": "Execution",
  "tags": [
    "imps",
    "specialists",
    "context"
  ],
  "sources": [
    {
      "label": "Codex workflows companion",
      "url": "https://lapis-fossil-vsbc.here.now/#workspace-agents"
    },
    {
      "label": "Published workshop recording",
      "url": "https://www.dropbox.com/scl/fi/3m5p2dwkx0imuyu0dq5os/GMT20260626-155513_Recording_gallery_1920x1080.mp4?rlkey=60j5649let6pt4fdxpggozv1q&st=qhbuo513&dl=0"
    }
  ],
  "sourceUnits": [
    "src/content/final/chunk-03-hyper-specific-workspace-agents.md",
    "src/content/final/chunk-03-hyper-specific-workspace-agents.md#Create Hyper-Specific Workspace Agents",
    "src/content/final/chunk-03-hyper-specific-workspace-agents.md#Create Hyper-Specific Workspace Agents/Start With The Tool",
    "src/content/final/chunk-03-hyper-specific-workspace-agents.md#Create Hyper-Specific Workspace Agents/Preload The Right Context",
    "src/content/final/chunk-03-hyper-specific-workspace-agents.md#Create Hyper-Specific Workspace Agents/Keep The Agent Narrow",
    "src/content/final/chunk-03-hyper-specific-workspace-agents.md#Create Hyper-Specific Workspace Agents/Prefer Tools With CLIs Or APIs",
    "src/content/final/chunk-03-hyper-specific-workspace-agents.md#Create Hyper-Specific Workspace Agents/Treat Account Permissions As Setup",
    "src/content/final/chunk-03-hyper-specific-workspace-agents.md#Create Hyper-Specific Workspace Agents/Make Self-Improvement Reviewable",
    "src/content/final/chunk-03-hyper-specific-workspace-agents.md#Create Hyper-Specific Workspace Agents/Prove Generated Helpers",
    "src/lib/content/sections.ts",
    "src/lib/content/sections.ts#workspace-agents",
    "src/lib/content/sections.ts#recordingSpans"
  ],
  "collection": "codex",
  "categoryId": "execution",
  "wordCount": 364,
  "url": "/topics/codex-workspace-agents/",
  "markdownUrl": "/markdown/codex-workspace-agents.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/codex-workspace-agents.json",
  "headings": [
    {
      "id": "start-with-the-tool",
      "text": "Start With The Tool",
      "level": 2
    },
    {
      "id": "preload-the-right-context",
      "text": "Preload The Right Context",
      "level": 2
    },
    {
      "id": "keep-the-agent-narrow",
      "text": "Keep The Agent Narrow",
      "level": 2
    },
    {
      "id": "prefer-tools-with-clis-or-apis",
      "text": "Prefer Tools With CLIs Or APIs",
      "level": 2
    },
    {
      "id": "treat-account-permissions-as-setup",
      "text": "Treat Account Permissions As Setup",
      "level": 2
    },
    {
      "id": "make-self-improvement-reviewable",
      "text": "Make Self-Improvement Reviewable",
      "level": 2
    },
    {
      "id": "prove-generated-helpers",
      "text": "Prove Generated Helpers",
      "level": 2
    },
    {
      "id": "related-resources",
      "text": "Related resources",
      "level": 2
    }
  ],
  "markdown": "# Build hyper-specific workspace agents\n\nThe fastest useful agent is usually not the biggest one. Wrap the tools you already trust, **preload only the context the job needs**, and keep broad agents out of small repeated tasks.\n\n## Start With The Tool\n\nBuild the agent around **one CLI, API, repo, or repeatable workflow**. A narrow helper should have a clear job before it gets a clever personality.\n\n## Preload The Right Context\n\n**Static prompt context** works for stable jobs. **Dynamic context** works when the helper needs to load files, docs, API data, or a project-specific bundle before answering.\n\n> This is about as instant as I've ever seen an AI respond to anything, because it just has that context preloaded in.\n>\n> — John Lindquist\n\n## Keep The Agent Narrow\n\nIf the task needs web research, product judgment, or multi-system reasoning, send it back to a general agent or a heavier planning workflow. The narrow agent should stay **boring, quick, and predictable**.\n\n> I don't want them to reason or think about things. I want them to know exact file paths, exact examples, and then maybe some basic file editing, but not too much more than that.\n>\n> — John Lindquist\n\n## Prefer Tools With CLIs Or APIs\n\nCommand-line and API surfaces give the agent something concrete to **inspect, execute, and verify**. They also make it easier to turn a vague repeat task into a small wrapper with reliable inputs and outputs.\n\n## Treat Account Permissions As Setup\n\nOAuth screens, account state, credential storage, scopes, and admin permissions are setup concerns. They should be checked deliberately and kept out of shared examples unless they are sanitized and current.\n\n## Make Self-Improvement Reviewable\n\nStore suggested changes, inspect them, and apply them deliberately. A self-improving helper is only useful if its changes are **reviewable and reversible**.\n\n## Prove Generated Helpers\n\nA newly generated **[imp](https://github.com/johnlindquist/codex-imps)** is draft tooling until the source, link/install behavior, and smoke tests check out. Do not share the generated helper as a setup path until it can **answer one harmless query and show the command evidence**.\n\n## Related resources\n\n- [Companion reference](https://lapis-fossil-vsbc.here.now/#workspace-agents)\n- [Resource directory and portable download](/topics/codex-resources/)\n- [Published recording](https://www.dropbox.com/scl/fi/3m5p2dwkx0imuyu0dq5os/GMT20260626-155513_Recording_gallery_1920x1080.mp4?rlkey=60j5649let6pt4fdxpggozv1q&st=qhbuo513&dl=0)"
}
