docs: point to Coder Agents and drop Tasks walkthrough in quickstart by david-fraley · Pull Request #24833 · coder/coder · GitHub
Skip to content

docs: point to Coder Agents and drop Tasks walkthrough in quickstart#24833

Merged
david-fraley merged 1 commit into
mainfrom
dfraley/codagt-157-quickstart-agents
May 5, 2026
Merged

docs: point to Coder Agents and drop Tasks walkthrough in quickstart#24833
david-fraley merged 1 commit into
mainfrom
dfraley/codagt-157-quickstart-agents

Conversation

@david-fraley

@david-fraley david-fraley commented Apr 29, 2026

Copy link
Copy Markdown
Collaborator

Closes CODAGT-157 (in part).

The docs/tutorials/quickstart.md page currently steers new users into Coder Tasks at the end of the quickstart, including a full walkthrough of pulling the tasks-docker template 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 Running section in full (the tasks-docker registry walkthrough plus the “See Tasks in action” steps).

  • Drop the Tasks row from the cooking-analogy table in Understanding Coder: 30-Second Overview and the matching Inside those Workspaces, developers can also run Tasks… clause in Putting it Together.

  • Drop the optional Optionally setup a **task** running Claude Code checkbox from What You'll Build, plus the You 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:

    - - [Learn more about running Coder Tasks and our recommended Best Practices](https://coder.com/docs/ai-coder/best-practices)
    + - [Try Coder Agents](../ai-coder/agents/getting-started.md), the chat
    +   interface and API for delegating development work to coding agents in your
    +   Coder deployment.
  • 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 via grep -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

  • This does not touch docs/start/local-deploy.md, docs/start/first-template.md, or docs/start/first-workspace.md. Those pages already use the original Docker Containers starter and never mention Coder Tasks.
  • This does not touch docs/ai-coder/index.md's ## Agents with Coder Tasks section. 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.
  • The deeper 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.
  • Pre-commit hook (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.
  • All three relative links in the new “What’s Next?” list resolve to existing files: 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 chat
thread.


This PR was opened by Coder Agents on @david-fraley's behalf.

@github-actions

Copy link
Copy Markdown

@david-fraley david-fraley changed the title docs(docs/tutorials/quickstart.md): point to Coder Agents and drop Tasks walkthrough docs(docs): point to Coder Agents and drop Tasks walkthrough Apr 29, 2026
@david-fraley david-fraley changed the title docs(docs): point to Coder Agents and drop Tasks walkthrough docs: point to Coder Agents and drop Tasks walkthrough in quickstart Apr 29, 2026
…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
@david-fraley david-fraley force-pushed the dfraley/codagt-157-quickstart-agents branch from e38c8b2 to 216a8a0 Compare April 30, 2026 20:09
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.
@david-fraley david-fraley merged commit 98ea526 into main May 5, 2026
26 checks passed
@david-fraley david-fraley deleted the dfraley/codagt-157-quickstart-agents branch May 5, 2026 13:02
@github-actions github-actions Bot locked and limited conversation to collaborators May 5, 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