anthropics / anthropics/claude-code

[DOCS] agent-teams Limitations: /rewind does preserve in-process teammates, contradicting the documented claim

Aperta Adatta ai principianti
#90,453 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
area:agents area:docs bug documentation
Lingua principale
Python
Stelle
145k
Fork
23.1k
Metriche di merge delle PR
Metriche PR in attesa

Descrizione

### Documentation Type

Incorrect/outdated documentation

### Documentation Location

https://code.claude.com/docs/en/agent-teams (§ Limitations)

### Section/Topic

Limitations → "No session resumption with in-process teammates"

### Current Documentation

The Limitations section states:

> * **No session resumption with in-process teammates**: `/resume` and `/rewind` do not restore in-process teammates. After resuming a session, the lead may attempt to message teammates that no longer exist. If this happens, tell the lead to spawn new teammates.

Verified still present as written on 2026-08-28.

### What's Wrong or Missing?

**The `/rewind` half of this claim does not match observed behavior.** On 2026-08-20, on Claude Code 2.1.238, a `/rewind` in a session with live in-process teammates left every teammate intact — busy, idle, and waiting alike. They remained addressable by name afterward and responded with their full prior context.

Two scoping notes, so the report is not read as broader than the evidence:

1. **This report covers `/rewind` only.** I have not run a controlled test of `/resume` against in-process teammates and make no claim about it here. If the two share an implementation, the same correction likely applies; if they do not, the bullet should probably be split rather than deleted.
2. **The advice that follows the claim is also affected.** "After resuming a session, the lead may attempt to message teammates that no longer exist... tell the lead to spawn new teammates" leads to the opposite of the right action after a rewind: re-spawning discards a teammate that is alive and holding context, and can collide with the original's worktree if it is mid-task.

I could find no CHANGELOG entry at any version pairing "teammate" with resume, rewind, or restore, so there is no public record of this being fixed after the page was written — which is why I am reporting it as an inaccuracy rather than as staleness relative to a known change.

The practical cost: teams built on this documentation treat a rewind as destructive to teammates and either avoid rewinding or discard live agents afterward. Both are expensive — a teammate carries accumulated exploration and review context that is costly to rebuild.

### Suggested Improvement

If `/rewind` does preserve in-process teammates, split the bullet so each command carries its own accurate statement. Suggested text:

> * **No session resumption with in-process teammates**: `/resume` does not restore in-process teammates. After resuming a session, the lead may attempt to message teammates that no longer exist. If this happens, tell the lead to spawn new teammates. `/rewind` is different: it preserves in-process teammates, which remain addressable by name with their context intact — do not spawn replacements after a rewind.

If instead the current text is correct and the observed behavior is the bug, the page is fine and the correction belongs in the implementation — in which case it would help to say explicitly that surviving teammates after a rewind are unsupported, since today the page reads as though they cannot survive at all.

Either way, stating what `/rewind` does independently of `/resume` would resolve the ambiguity.

### Impact

Medium - Makes feature difficult to understand

### Additional Context

- Observed on Claude Code 2.1.238 (2026-08-20); the documentation text re-verified unchanged on 2.1.247 (2026-08-28).
- Searched open issues before filing — nothing open reports this. #49978 quotes the same sentence but is a feature request about which agent Esc-to-rewind should target, not about the accuracy of the claim.
- Related closed docs issues on the same page for context: #70139, #72941, #69621, #70135.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Direzione di ricerca

Open the Claude Code documentation at the reported URL and read the Limitations section, especially “No session resumption with in-process teammates.” Check the documented behavior of /resume and /rewind against the report, then update the bullet and its follow-up advice so each command is described accurately and the completed page does not imply that live teammates should be replaced after a rewind.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Attiva
Chiarezza
Specificata chiaramente
Idoneità per principianti
78/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.