Skip to content

docs(docs/ai-coder): replace Coder Tasks references with Coder Agents#24929

Merged
mattvollmer merged 4 commits into
mainfrom
matt/docs-ai-coder-index-agents
May 4, 2026
Merged

docs(docs/ai-coder): replace Coder Tasks references with Coder Agents#24929
mattvollmer merged 4 commits into
mainfrom
matt/docs-ai-coder-index-agents

Conversation

@mattvollmer

@mattvollmer mattvollmer commented May 4, 2026

Copy link
Copy Markdown
Contributor

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 docs: add Coder Agents to README and about page #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

PR generated with Coder Agents.

@github-actions

github-actions Bot commented May 4, 2026

Copy link
Copy Markdown

Docs preview

📖 View docs preview for docs/ai-coder/best-practices.md

@mattvollmer mattvollmer changed the title docs(docs/ai-coder): replace Coder Tasks references with Coder Agents docs: replace Coder Tasks references with Coder Agents May 4, 2026
@mattvollmer mattvollmer requested review from bpmct and david-fraley May 4, 2026 16:39
@mattvollmer mattvollmer changed the title docs: replace Coder Tasks references with Coder Agents docs(docs/ai-coder): replace Coder Tasks references with Coder Agents May 4, 2026
@mattvollmer mattvollmer marked this pull request as ready for review May 4, 2026 16:53
@mattvollmer mattvollmer merged commit 5612bb8 into main May 4, 2026
35 checks passed
@mattvollmer mattvollmer deleted the matt/docs-ai-coder-index-agents branch May 4, 2026 17:00
@github-actions github-actions Bot locked and limited conversation to collaborators May 4, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants