Skip to content

docs: add task lifecycle and agent compatibility pages - #22222

Merged
mafredri merged 3 commits into
mainfrom
mafredri/docs-tasks-pause-resume-compat-matrix
Mar 4, 2026
Merged

docs: add task lifecycle and agent compatibility pages#22222
mafredri merged 3 commits into
mainfrom
mafredri/docs-tasks-pause-resume-compat-matrix

Conversation

@mafredri

@mafredri mafredri commented Feb 20, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

Beta docs for task pause/resume. Covers the lifecycle (how pause and
resume work, what gets preserved, template requirements) and which
agents support session resume.

Intentionally infrastructure-focused for Beta: what template authors
need to configure, not UI walkthroughs or screenshots. Those come with
GA (coder/internal#1271).

The compatibility matrix version numbers will be filled in as the
registry module PRs (registry#739-748) land.

Closes coder/internal#1359
Closes coder/internal#1329

@mafredri mafredri mentioned this pull request Feb 20, 2026
Closed
6 tasks done
@github-actions github-actions Bot added the stale This issue is like stale bread. label Feb 28, 2026
@mafredri
mafredri force-pushed the mafredri/docs-tasks-pause-resume-compat-matrix branch from 4dcdbf5 to 5b891ff Compare March 2, 2026 10:58
@mafredri mafredri removed the stale This issue is like stale bread. label Mar 2, 2026
@mafredri
mafredri force-pushed the mafredri/docs-tasks-pause-resume-compat-matrix branch 9 times, most recently from f571cdf to bcc61c2 Compare March 2, 2026 13:17
@mafredri
mafredri force-pushed the mafredri/docs-tasks-pause-resume-compat-matrix branch from bcc61c2 to db5fbec Compare March 2, 2026 13:21
@mafredri mafredri changed the title docs: add agent compatibility reference for task pause/resume docs: add task lifecycle and agent compatibility pages Mar 2, 2026
@mafredri
mafredri marked this pull request as ready for review March 2, 2026 13:28
@mafredri

mafredri commented Mar 2, 2026

Copy link
Copy Markdown
Member Author

Also for @DanielleMaywood and @SasSwart, feel free to review if there's anything we need to improve here based on your work.

@coderagents

coderagents Bot commented Mar 2, 2026 •
edited by mafredri
Loading

Copy link
Copy Markdown
Contributor

Documentation Check

Updates Needed

  • docs/ai-coder/cli.md — task pause and task resume are not listed in the CLI reference index. The new tasks-lifecycle.md page references coder task pause and the auto-generated docs (task_pause.md, task_resume.md) already exist, but they are missing from the hand-maintained index in cli.md.

New Documentation Needed

  • docs/ai-coder/custom-agents.md — No mention of session persistence or pause/resume support for custom agents. tasks-lifecycle.md already covers enable_state_persistence for custom agents (under the agentapi module section) and links to custom-agents.md in its Next Steps. Adding a brief note or a backlink from custom-agents.md to the lifecycle page would help template authors building custom agents discover how to enable pause/resume support.

Automated review via Coder Tasks

This was referenced Mar 3, 2026
Merged
Closed
@mafredri
mafredri merged commit 13411c8 into main Mar 4, 2026
25 checks passed
@mafredri
mafredri deleted the mafredri/docs-tasks-pause-resume-compat-matrix branch March 4, 2026 00:39
@github-actions github-actions Bot locked and limited conversation to collaborators Mar 4, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

@johnstcn johnstcn johnstcn approved these changes
@david-fraley david-fraley Awaiting requested review from david-fraley

Assignees

@mafredri mafredri

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Tasks: Beta documentation for pause/resume lifecycle Research: AI agent state persistence compatibility

2 participants

@mafredri @johnstcn