Skip to content

Comments

docs(design): context management design document #546

Open
dbschmigelski wants to merge 2 commits intostrands-agents:mainfrom
dbschmigelski:context-management
Open

docs(design): context management design document #546
dbschmigelski wants to merge 2 commits intostrands-agents:mainfrom
dbschmigelski:context-management

Conversation

@dbschmigelski
Copy link
Member

This PR introduces a design document that explores how we can improve context management in Strands Agents.

Today, when conversations grow long or tool results get large, our options are limited: sliding window drops messages permanently, summarization loses detail over time, and there's no way to retrieve content once it leaves the active window.

This document lays out a direction for doing better, organized around three tracks: making conversation context recoverable instead of permanently lost, reducing the overhead of tool definitions that get sent with every request regardless of relevance, and giving agents the ability to delegate work to keep their own context window clean.

The ideas draw from research like MemGPT and Recursive Language Models, and the document is meant to guide the work ahead, individual features will get their own design docs as we go. The goal is to agree on the problems that should be solved and the mechanism that can solve them, without focussing on exact syntax.

@dbschmigelski dbschmigelski changed the title Create 0003-context-management.md docs(design): context management design document Feb 13, 2026
@strands-agent
Copy link
Contributor

Documentation Deployment Complete

Your documentation preview has been successfully deployed!

Preview URL: https://d3ehv1nix5p99z.cloudfront.net/pr-546/

@dbschmigelski
Copy link
Member Author

/strands review

@github-actions
Copy link
Contributor

Assessment: Comment

This is a well-researched design document that provides a thoughtful strategic direction for context management in Strands Agents. The document effectively synthesizes academic research (MemGPT, Recursive Language Models) with practical industry examples and aligns well with SDK tenets.

Review Summary
  • Template Alignment: The document structure differs from the standard design template in designs/README.md (missing Status/Date/Issue metadata, Developer Experience, Alternatives Considered sections). Given this is explicitly a "high-level roadmap, not a detailed implementation spec" this may be intentional - but consider whether adding the metadata fields would help track the document's lifecycle.

  • Formatting: A few minor structural inconsistencies in Track 2 section where some headings are missing markers or inline with content.

The design principles, research foundations, and prioritized work plan are well-articulated. 👍

zastrowm
zastrowm previously approved these changes Feb 13, 2026
6. Proactive context compression M Medium — Most requested context feature (#555). Depends on: 2, 3
7. In-event-loop context management M Medium — Manage context within a cycle for tool-heavy agents (#298)
8. Semantic dynamic tool registry XL Medium — Needs design doc + vector store integration (#1677)
9. Large content aliasing M Low — Externalize oversized results so agents navigate on demand instead of inlining (#1678). Depends on: 5
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh I was thinking this was 5

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It definitely was inspired by it and of course they are highly related.

The way I view it is similar to how we are doing Retries. I want customers to be able to handle this themselves [hook]. But, the framework will also provide an opinionated solution [alias]

Make sense?


---

## Work Plan
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This would present better as a table FYI

@dbschmigelski
Copy link
Member Author

Noting that Skills over MCP seems like an interesting standardization opportunity https://github.com/modelcontextprotocol/experimental-ext-skills

- Fix missing period in overview paragraph
- Add heading markers for Dynamic Tool Loading and Autonomous Approach
- Separate Autonomous Approach heading from inline paragraph content
- Update "Hooks" to "Plugins" in Design Principle #1
- Convert work plan from numbered list to table format
- Move Autonomous delegation meta-tool up in priority (standalone, customer-requested)
- Update Context navigation meta-tools size from L to S
@strands-agent
Copy link
Contributor

Documentation Deployment Complete

Your documentation preview has been successfully deployed!

Preview URL: https://d3ehv1nix5p99z.cloudfront.net/pr-546/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants