docs(docs/ai-coder): replace Coder Tasks references with Coder Agents#24929
Merged
Conversation
Docs preview📖 View docs preview for |
…Governance Add-On
…ntro and audience list
bpmct
approved these changes
May 4, 2026
…model in Provide Agents with Proper Context
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.
Updates
docs/ai-coder/index.md,docs/ai-coder/best-practices.md, anddocs/ai-coder/ai-governance.mdto 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:## Agents with Coder Tasksto## 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 fromtasks-ui.pngtoagents-hero-image.png(the hero shot added in docs: add Coder Agents to README and about page #24915).## Secure Your Workflows with Agent Firewallsection 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:[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" sincesecurity.mddoes not actually mention Tasks. Re-ranmarkdown-table-formatterto repad column widths.## 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 measuredsection and the rest of the Tasks-related prose on this page are intentionally left for a follow-up PR.Notes for the reviewer
[Coder Agents API](./agents/chats-api.md)link inbest-practices.mdwill need to be retargeted if docs: generate Chats API docs from swagger annotations #24830 (which replacesagents/chats-api.mdwith auto-generatedreference/api/chats.md) lands first.tasks-core-principles.md,tasks-lifecycle.md,tasks-migration.md,cli.md,github-to-tasks.md,agent-compatibility.md, the rest ofai-governance.md,custom-agents.md,ai-gateway/clients/claude-code.md,manifest.json,reference/api/tasks.md, thetask*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 docs(docs/ai-coder): add deprecation notice to Coder Tasks pages #24831, docs: point to Coder Agents and drop Tasks walkthrough in quickstart #24833, and docs: add Tasks to Chats API migration guide #24841 cover separate slices and do not touch any file in this PR.markdownlint-cli2,markdown-table-formatter,scripts/check_emdash.sh, andmake pre-commit-lightall pass.PR generated with Coder Agents.