[DOCS] Session recap docs missing auto-trigger and draft-input behavior

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/common-workflows

Section/Topic

The "Resume previous conversations" section, plus the undocumented session recap feature and /recap command behavior when returning to a session.

Current Documentation

The current resume workflow documentation says:

"When starting Claude Code, you can resume a previous session:" " claude --continue continues the most recent conversation in the current directory" " claude --resume opens a conversation picker or resumes by name"

Later on the same page it says:

"4. Context Restoration: The conversation resumes with all previous context intact"

But there is no documentation here for session recap behavior, no /recap command reference, and no explanation of when an automatic recap should or should not appear while the user is typing an unsent prompt.

What's Wrong or Missing?

The v2.1.113 changelog entry says: "Fixed session recap auto-firing while composing unsent text in the prompt".

That bug fix exposes user-visible behavior that is still undocumented:

A. Session recap itself is undocumented

Users returning to a session are not told that Claude Code can generate a recap, when it appears, or how it relates to resuming prior conversations.

B. /recap is undocumented in the command reference

The docs do not explain that users can manually invoke a recap.

C. Trigger and suppression behavior is undocumented

The v2.1.113 fix makes clear that recap auto-triggering interacts with draft prompt text. Users need documentation that automatic recap behavior should not interrupt them while they are composing an unsent prompt.

Suggested Improvement

Add a short "Session recap" subsection to https://code.claude.com/docs/en/common-workflows near "Resume previous conversations" that explains:

• what session recap is
• when it can appear automatically after returning to a session
• that users can invoke it manually with /recap
• that automatic recap should not fire while the prompt composer already contains unsent text

Also update these references:

• https://code.claude.com/docs/en/commands — add a /recap entry
• https://code.claude.com/docs/en/env-vars — document CLAUDE_CODE_ENABLE_AWAY_SUMMARY
• https://code.claude.com/docs/en/settings — document the related /config setting if that setting is intended to be user-configurable

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/common-workflows | Resume-session guidance is the closest user-facing place to explain automatic session recap behavior |
| https://code.claude.com/docs/en/commands | /recap is not documented in the built-in commands reference |
| https://code.claude.com/docs/en/env-vars | CLAUDE_CODE_ENABLE_AWAY_SUMMARY is not documented in the environment variable reference |
| https://code.claude.com/docs/en/settings | The docs say recap is configurable in /config, but no corresponding settings documentation is available |

Total scope: 4 pages affected

Source: Changelog v2.1.113

Exact changelog entry:

Fixed session recap auto-firing while composing unsent text in the prompt