{
 "schema": "aiblocks-page/1",
 "id": "deploy-worker-to-render-builder-prompt",
 "type": "prompt",
 "name": "Render worker deployment planner",
 "summary": "Get a coding brief to deploy an always-on agent worker to Render, with a config file, secret names, startup checks and a rollback step.",
 "headline": "Render worker deployment planner",
 "subhead": "Give your coding assistant your project and the services your worker uses. It plans the Render config file, checks that the worker starts and stops cleanly and writes a go-live checklist with a rollback step. It never deploys and never sees your secrets.",
 "job": {
  "id": "build-software",
  "name": "Build and ship software"
 },
 "level": "intermediate",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "codebase",
   "required": true,
   "label": "Codebase",
   "what": "a project's code, in a folder or repo the AI can open"
  }
 ],
 "outputs": [
  {
   "type": "code_change",
   "required": true,
   "label": "Code change",
   "what": "a change to the code, with what it fixes and how it was checked"
  }
 ],
 "you_give": [
  "Your code project, or its package file and main folders",
  "The file that starts your worker and how you run it today",
  "The services it connects to, such as Redis, Supabase and Slack, and the environment variable names your code reads (never the values)",
  "Where your code is hosted, such as GitHub",
  "The Render plan you plan to use (optional)"
 ],
 "you_get": [
  "A list of setup gaps before anything is written",
  "A draft Render config file with secret names and no values",
  "A table of environment variable names, with which ones are secret",
  "A check that the worker stops cleanly, and a fix if it doesn't",
  "A go-live checklist with a rollback step"
 ],
 "use_when": [
  "Your agent worker runs on your laptop and you want it running all day without it.",
  "A first deploy failed and you can't tell if the cause is a secret, a build step or the start command.",
  "You want a rollback step and a checklist written before you go live, not after.",
  "You aren't sure whether your project needs a Background Worker or a Web Service."
 ],
 "skip_when": [
  "Your app answers web requests or serves pages. A worker is the wrong service type. Ask the assistant to plan a Render Web Service instead.",
  "You only need a task that runs once an hour or once a day. A scheduled job may fit better than an always-on worker. Check Render's current options.",
  "You haven't built the worker yet. Use the TypeScript agent worker builder first.",
  "You want it to create the Render service and press deploy. It only plans and drafts. You do those steps in Render yourself."
 ],
 "output_sample": {
  "input": [
   "Your code project, or its package file and main folders",
   "The file that starts your worker, and the names of the variables it reads",
   "The services it uses and where your code is hosted"
  ],
  "prerequisites": [
   "A coding assistant that can open your project, such as Claude Code or Codex",
   "A Render account, and a plan chosen from Render's pricing page",
   "Accounts for the services the worker uses, such as Redis, Supabase and Slack"
  ],
  "output": [
   {
    "name": "Setup gaps",
    "contains": "What is missing before any file is written, such as a start file or a variable name."
   },
   {
    "name": "Render config",
    "contains": "A draft config file with one worker service, named variables and no secret values."
   },
   {
    "name": "Variables",
    "contains": "Each variable name, the service it connects to and whether it is a secret."
   },
   {
    "name": "Shutdown check",
    "contains": "What your worker does when Render stops it, and the change needed so running jobs finish."
   },
   {
    "name": "Alive check",
    "contains": "The option recommended for knowing the worker still runs, and why."
   },
   {
    "name": "Deploy checklist",
    "contains": "Steps to tick before and after going live, including a five-minute test and a rollback step."
   }
  ]
 },
 "output_shape": "SETUP GAPS\n<what is missing or unclear>\n\nRENDER CONFIG (draft)\n<render.yaml with named variables and no values>\n\nVARIABLES\n<name> | <connects to> | <secret: yes or no>\n\nSHUTDOWN CHECK\n<what the worker does on the stop signal> | <change needed or not>\n\nHOW YOU WILL KNOW IT IS ALIVE\n<recommended option and why>\n\nDEPLOY CHECKLIST\n<steps to tick, ending with the rollback step>\n\nNEXT STEP\n<the smallest useful step>",
 "how_to_use": [
  "Open your coding assistant, such as Claude Code or Codex, in your project folder. A plain chat AI can only write a plan.",
  "Paste the skill, then add the items under \"What you need\". Never paste a secret value.",
  "Read the setup gaps and the start-command check first. Choose between the two fixes if it asks.",
  "Read the Render config file before you save it. Look up the plan on Render's pricing page and choose one yourself.",
  "Push your code, create the service in Render and enter each secret in the dashboard by hand.",
  "Work down the checklist. Watch the logs for the start lines your own code prints, then run the five-minute test with the laptop closed."
 ],
 "checks": [],
 "next": [
  {
   "name": "Developer tools engineer",
   "url": "https://useaiblocks.com/skills/agency-engineering-developer-tooling-engineer",
   "why": "Build it"
  }
 ],
 "source": null,
 "credits": [],
 "files": [
  "references/worked-example.md"
 ],
 "links": {
  "page": "https://useaiblocks.com/prompts/deploy-worker-to-render-builder-prompt",
  "markdown": "https://useaiblocks.com/prompts/deploy-worker-to-render-builder-prompt.md",
  "json": "https://useaiblocks.com/prompts/deploy-worker-to-render-builder-prompt.json",
  "instructions": "https://useaiblocks.com/skills/deploy-worker-to-render-builder-prompt/SKILL.md",
  "download": "https://useaiblocks.com/skills/deploy-worker-to-render-builder-prompt.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/deploy-worker-to-render-builder-prompt",
  "api_document": "https://useaiblocks.com/api/v1/documents/prompt/deploy-worker-to-render-builder-prompt",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
