{{ message }}
docs: point to Coder Agents and drop Tasks walkthrough in quickstart#24833
Merged
Conversation
…sks walkthrough Removes the optional 'Get Coder Tasks Running' section that walked users through pulling the tasks-docker template from the Registry and creating a Coder Task. The main flow already uses the original Docker Containers starter template, so removing the Tasks epilogue restores the original non-task quickstart and avoids steering new users at a feature that is about to be deprecated (PR #24831 adds the deprecation notice). In its place, the 'What's Next?' section now links to Coder Agents getting started, the chat interface and API for delegating development work to coding agents in the Coder deployment. Also drops the orphaned 'Tasks' row from the cooking-analogy table, the optional task line in the 'What You'll Build' checklist, and the 'Claude Code in the background' aside in the lead paragraph. Deletes the now-unreferenced quickstart-tasks-background-change.png screenshot. Linear: CODAGT-157
e38c8b2 to
216a8a0
Compare
mattvollmer
approved these changes
May 1, 2026
mattvollmer
added a commit
that referenced
this pull request
May 4, 2026
…#24929) Updates `docs/ai-coder/index.md`, `docs/ai-coder/best-practices.md`, and `docs/ai-coder/ai-governance.md` to point readers at Coder Agents and the AI Governance Add-On instead of Coder Tasks and Agent Firewall (CODAGT-157). ## Changes - `docs/ai-coder/index.md`: - Rename `## Agents with Coder Tasks` to `## Coder Agents`. Drop the Devin / ChatGPT Codex name-drops and the Tasks pitch. New copy points at `./agents/index.md`, names the agent loop in the control plane, and notes that workspaces can be completely network isolated. Image swapped from `tasks-ui.png` to `agents-hero-image.png` (the hero shot added in #24915). - Replace the `## Secure Your Workflows with Agent Firewall` section with `## Govern AI activity with the AI Governance Add-On`. The new section opens with adoption-first framing (visibility, guardrails, cost) and links to `./ai-governance.md`, with bulleted callouts for AI Gateway, Agent Firewall, and the expanded Agent Workspace Build allowance the add-on bundles. - `docs/ai-coder/best-practices.md`: - In the use-case table, swap `[Tasks](./tasks.md)` to `[Coder Agents](./agents/index.md)` for the developer-led-investigation and prototyping rows, and swap the "Tasks API *(in development)*" cell to `[Coder Agents API](./agents/chats-api.md)` for the background-jobs row. Retitle the Security section link from "securing agents with Coder Tasks" to "securing AI agents" since `security.md` does not actually mention Tasks. Re-ran `markdown-table-formatter` to repad column widths. - In `## Provide Agents with Proper Context`, add a paragraph describing how context is provided in Coder Agents (admin-configured system prompts, centrally registered MCP servers, and skills shipped from repos or templates under `.agents/skills/`), with a transition line clarifying that the existing Memory and Tools subsections cover BYO-agent patterns. - `docs/ai-coder/ai-governance.md`: drop the "Additional Tasks Use (via Agent Workspace Builds)" bullet from the intro feature list and the "Expanding the use of Coder Tasks for AI-driven background work" bullet from the audience list. The `## How Coder Tasks usage is measured` section and the rest of the Tasks-related prose on this page are intentionally left for a follow-up PR. ## Notes for the reviewer - The `[Coder Agents API](./agents/chats-api.md)` link in `best-practices.md` will need to be retargeted if #24830 (which replaces `agents/chats-api.md` with auto-generated `reference/api/chats.md`) lands first. - This is the first slice of the Tasks-references audit. Remaining files (`tasks-core-principles.md`, `tasks-lifecycle.md`, `tasks-migration.md`, `cli.md`, `github-to-tasks.md`, `agent-compatibility.md`, the rest of `ai-governance.md`, `custom-agents.md`, `ai-gateway/clients/claude-code.md`, `manifest.json`, `reference/api/tasks.md`, the `task*` CLI references, the ESR upgrade guide, `feature-stages.md`, `workspace-scheduling.md`, `shared-workspaces.md`) will land in follow-up PRs against the same Linear ticket. Open PRs #24831, #24833, and #24841 cover separate slices and do not touch any file in this PR. - Validation: `markdownlint-cli2`, `markdown-table-formatter`, `scripts/check_emdash.sh`, and `make pre-commit-light` all pass. PR generated with Coder Agents.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.

Closes CODAGT-157 (in part).
The
docs/tutorials/quickstart.mdpage currently steers new users into Coder Tasks at the end of the quickstart, including a full walkthrough of pulling thetasks-dockertemplate from the registry and creating a Task. With Coder Tasks slated for deprecation (see #24831, also under CODAGT-157) and Coder Agents now the recommended way to interact with coding agents on a Coder deployment, this PR rewinds the quickstart back to its pre-Tasks shape and points readers at the Coder Agents docs as the next step.Changes
Drop the trailing
### Get Coder Tasks Runningsection in full (thetasks-dockerregistry walkthrough plus the “See Tasks in action” steps).Drop the
Tasksrow from the cooking-analogy table inUnderstanding Coder: 30-Second Overviewand the matchingInside those Workspaces, developers can also run Tasks…clause inPutting it Together.Drop the optional
Optionally setup a **task** running Claude Codecheckbox fromWhat You'll Build, plus theYou can also get Claude Code up and running in the background!aside in the lead paragraph.Replace the first “What’s Next?” link (“Learn more about running Coder Tasks and our recommended Best Practices”) with a link to the Coder Agents getting-started doc:
Switch the other two
coder.com/docs/...links in the same list to in-tree relative paths so they render correctly in the docs preview.Delete the now-unreferenced
docs/images/screenshots/quickstart-tasks-background-change.png(only used by the removed Tasks section, confirmed viagrep -rln).The Docker Containers starter-template flow that the rest of the page already follows is unchanged; the user instruction in this Linear thread was specifically to keep the original template flow and drop the Tasks epilogue.
Out of scope
docs/start/local-deploy.md,docs/start/first-template.md, ordocs/start/first-workspace.md. Those pages already use the original Docker Containers starter and never mention Coder Tasks.docs/ai-coder/index.md's## Agents with Coder Taskssection. Renaming or removing that page belongs with the broader Coder Tasks deprecation tracked in docs(docs/ai-coder): add deprecation notice to Coder Tasks pages #24831.docs/ai-coder/agents/audit (auto-archive default, missing endpoints, missing tools, etc.) is tracked separately under CODAGT-157 and will land in follow-up PRs.Validation
pnpm exec markdownlint-cli2 docs/tutorials/quickstart.md→ 0 errors.bash scripts/check_emdash.sh→ OK, no new emdash/endash characters.make pre-commit-light) passed in 6s.grep -in 'task\|claude' docs/tutorials/quickstart.md→ no matches after the change.grep -rln quickstart-tasks-background-change docs/→ no matches after deletion.docs/ai-coder/agents/getting-started.md,docs/user-guides/workspace-management.md,docs/admin/monitoring/index.md.Proof
This is a docs-only change. The visible diff for the rendered page is the
textual diff in the PR. Local markdown previews of the two regions that
changed (the lead paragraph + 30-second overview at the top, and the
What's Next?list at the bottom) are attached to the originating chatthread.
This PR was opened by Coder Agents on @david-fraley's behalf.