Title: Memory System Improvements — Feedback Welcome · Issue #63 · github/squad · GitHub
Open Graph Title: Memory System Improvements — Feedback Welcome · Issue #63 · github/squad
X Title: Memory System Improvements — Feedback Welcome · Issue #63 · github/squad
Description: Summary We're making improvements to Squad's memory system in upcoming releases. Some users have noticed issues with how memory scales as projects mature — this issue tracks the planned changes and invites community feedback. If you've n...
Open Graph Description: Summary We're making improvements to Squad's memory system in upcoming releases. Some users have noticed issues with how memory scales as projects mature — this issue tracks the planned changes and...
X Description: Summary We're making improvements to Squad's memory system in upcoming releases. Some users have noticed issues with how memory scales as projects mature — this issue tracks the planned cha...
Opengraph URL: https://github.com/github/squad/issues/63
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Memory System Improvements — Feedback Welcome","articleBody":"## Summary\n\nWe're making improvements to Squad's memory system in upcoming releases. Some users have noticed issues with how memory scales as projects mature — this issue tracks the planned changes and invites community feedback.\n\n**If you've noticed anything off with Squad's memory behavior** (decisions getting lost, context seeming stale, agents forgetting things they should know, or context windows feeling bloated), please comment here. Your observations will directly inform the implementation.\n\n---\n\n## What We've Heard\n\n- Memory files (`decisions.md`, `history.md`) can grow large as projects mature, consuming significant context window space\n- Stale decisions and one-time planning artifacts accumulate without cleanup\n- History summarization thresholds may need tuning\n- No visibility into how much context budget memory consumes at spawn time\n\n---\n\n## Planned Changes\n\n### Phase 1 — Scribe Memory Maintenance (v0.5.x)\n\n- **Decisions pruning:** Scribe actively identifies and archives stale decision blocks (completed sprints, one-time planning, superseded decisions) to `decisions-archive.md`\n- **History compression threshold:** Tune the 12KB/~3,000 token threshold for `history.md` summarization — may need adjustment based on real usage\n- **Context budget awareness:** Track and log how much of the context window memory files consume at spawn time\n- **Docs update:** `docs/features/memory.md` will be updated alongside every memory system change\n\n### Phase 2 — Schema & Self-Healing (v0.5.x)\n\n- **team.md schema validation:** Parsers that accept multiple header formats (already shipped in PR #60 for `## Members` / `## Team Roster`)\n- **Self-healing parsers:** Graceful degradation when memory files have unexpected formats rather than hard failures\n- **Spawn-time memory cap:** Target ~25KB max for memory loaded at agent spawn time\n\n### Phase 3 — Docs & Validation (v0.6.x)\n\n- **Memory health dashboard:** Quick way to see memory file sizes, decision count, staleness metrics\n- **Automated validation:** CI check that memory files stay within budget\n\n### Phase 4 — Future (v0.7.0+)\n\n- **Semantic search:** Vector embeddings for decisions and history, so agents find relevant context instead of loading everything\n- **Per-agent context budgets:** Different roles get different memory allocations based on their needs\n\n---\n\n## What We Want Feedback On\n\n1. **Have you noticed memory-related issues?** Agents forgetting things, decisions seeming stale, or context feeling bloated?\n2. **How large is your `.ai-team/` directory?** If you've been using Squad for a while, what does your `decisions.md` look like size-wise?\n3. **What matters most to you?** Agents remembering everything vs. agents staying fast and focused?\n4. **Any features you'd want?** Memory search, manual pruning tools, visibility into what agents \"know\"?\n\n---\n\n## Principles\n\nThese guide all memory system changes:\n\n- **Never lose information** — archiving, not deleting. Originals always preserved.\n- **Memory docs stay in sync** — every memory system change includes a `docs/features/memory.md` update\n- **Transparency** — users should be able to see and understand what their agents remember\n- **Backward compatible** — existing `.ai-team/` directories should work without migration\n\n---\n\nFiled by the Squad team. cc @bradygaster","author":{"url":"https://github.com/bradygaster","@type":"Person","name":"bradygaster"},"datePublished":"2026-02-15T04:03:36Z","url":"https://github.com/github/squad/issues/63"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:994baa4d-f783-46d1-b795-2f104c2a0e71 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C5B0:14ECB:1DA0DD7:259B671:6B015F17 |
| html-safe-nonce | b3915b5615b8b590d48d887b0d06e9bc989415382e5f7bb59bd37e159c220769 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDNUIwOjE0RUNCOjFEQTBERDc6MjU5QjY3MTo2QjAxNUYxNyIsInZpc2l0b3JfaWQiOiIyMTA3NTUwMzA2NTk3NDI5MDE1IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 415550d157422e5c4e540beec903c2b4d5197b8d415db7b72d4fa33d539e1ce1 |
| hovercard-subject-tag | issue:3943039750 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/github/squad/63/issue_layout |
| twitter:image | https://opengraph.githubassets.com/ea963c3a095cdcfeab44c591ab9e0ee7c8502fab8ba6c9abaf7396b784d52644/github/squad/issues/63 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/ea963c3a095cdcfeab44c591ab9e0ee7c8502fab8ba6c9abaf7396b784d52644/github/squad/issues/63 |
| og:image:alt | Summary We're making improvements to Squad's memory system in upcoming releases. Some users have noticed issues with how memory scales as projects mature — this issue tracks the planned changes and... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | bradygaster |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/github/squad git https://github.com/github/squad.git |
| octolytics-dimension-user_id | 9919 |
| octolytics-dimension-user_login | github |
| octolytics-dimension-repository_id | 1151205052 |
| octolytics-dimension-repository_nwo | github/squad |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1151205052 |
| octolytics-dimension-repository_network_root_nwo | github/squad |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width