Skip to content

docs(coding-agent): document persistent subagent sessions - #116

Merged
Issacboy123 merged 1 commit into
feat/reconcile-persistent-subagentsfrom
docs/persistent-subagent-storage
Aug 28, 2026
Merged

Issacboy123 merged 1 commit into
feat/reconcile-persistent-subagentsfrom
docs/persistent-subagent-storage

Conversation

@Issacboy123

Copy link
Copy Markdown
Contributor

Summary

This PR explains what users can expect from subagents in saved sessions. It covers what returns after reopening a parent, why unfinished children become interrupted, how explicit wake works, and when subagents remain temporary. It also records persistent subagent sessions in the coding-agent changelog.

This PR is stacked on feat/reconcile-persistent-subagents, which completes the documented persistence, restoration, and context-reconciliation behavior.

Reasoning

The sessions guide is the existing user-facing source for resume, navigation, and deletion behavior, so it is the appropriate place to explain persistence without introducing a separate conceptual surface. The documentation focuses on observable guarantees and avoids presenting internal storage mechanics as public configuration.

Changes

  • Added the /subagents command to the saved-session command reference.
  • Documented terminal and interrupted restoration without automatic work, task replay, or result redelivery.
  • Documented explicit wake behavior for usable and isolated histories and complete captured-configuration fallback semantics.
  • Clarified branch reconciliation, ephemeral parent modes, and the non-destructive effect of disabling subagent tools.
  • Added an Unreleased coding-agent changelog entry for durable subagent sessions.

Testing

  • node ../../node_modules/vitest/dist/cli.js --run test/suite/subagent-persistence.test.ts test/suite/subagent-services.test.ts test/suite/subagent-registration.test.ts test/suite/agent-session-harness-version.test.ts test/session-manager/fork-branch.test.ts test/session-selector-path-delete.test.ts
  • npm run check

@Issacboy123 Issacboy123 added documentation Improvements or additions to documentation coding-agent labels Aug 25, 2026
@Issacboy123 Issacboy123 self-assigned this Aug 25, 2026
@Pepps233
Pepps233 force-pushed the docs/persistent-subagent-storage branch from 50eb285 to fbb4567 Compare August 25, 2026 14:36
@Pepps233

Copy link
Copy Markdown
Contributor

d56fc6f removes changes made to CHANGELOG.md.

Do not modify CHANGELOG.md, it will automatically be updated once we create a new github release

@Pepps233
Pepps233 self-requested a review August 25, 2026 16:41
@Issacboy123
Issacboy123 force-pushed the docs/persistent-subagent-storage branch from d56fc6f to faf62cf Compare August 27, 2026 10:54
@Issacboy123
Issacboy123 force-pushed the docs/persistent-subagent-storage branch from faf62cf to 2d17d6d Compare August 27, 2026 23:11
@Issacboy123
Issacboy123 merged commit 3b34efb into main Aug 28, 2026
2 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

coding-agent documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants