You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
feat: Tiered history retrieval (hot/cold layer pattern) #595
Agent history.md files grow unbounded. Currently Scribe summarizes at 12KB, but agents read everything — no distinction between recent context and archived knowledge. This wastes context window tokens and slows agent startup.
Proposed Solution
Formalize a two-tier retrieval pattern inspired by ClawMongo's tiered projection model:
Hot layer (history.md): Last ~20 entries. Always read at spawn time. Fresh, actionable context. Cold layer (history-archive.md): Summarized older entries. Read only when agent explicitly needs historical context.
Implementation
Spawn prompt change: agents read history.md (hot) by default. Only read history-archive.md when the task references past decisions or old patterns.
Scribe summarization: when history.md exceeds threshold, move old entries to archive with summaries (already partially implemented).
Search cold: add a 'search archive' pattern agents can invoke when they need historical context.
Benefits
Reduced context window usage (~60% less tokens for history)
Faster agent startup
No external DB required — pure file-based
Prior Art
Inspired by ClawMongo's tiered retrieval model (https://clawmongo.site) which uses ID-only projections for 10x context reduction. Adapted for Squad's file-based architecture.
Issue:#595 — feat: Tiered history retrieval (hot/cold layer pattern)
Procedures will pick this up in the next Copilot session.
For Copilot coding agent: If enabled, this issue will be worked automatically.
Otherwise, start a Copilot session and say: Procedures, work on issue #595
Closing as a duplicate of #600 — issue comments on this thread explicitly state #595 is a subset of #600 and #600 is the superset covering this work. The shipped tiered-memory docs/skill track the combined scope under #600 (and #1264).
Activity
feat(skills): add tiered-history skill — hot/cold history split for c…
fix: REPL UX fixes — 10 issues resolved with 52 new tests (github#608)
github-actions commentedon Mar 26, 2026
📋 Assigned to Procedures (Prompt Engineer)
Issue: #595 — feat: Tiered history retrieval (hot/cold layer pattern)
Procedures will pick this up in the next Copilot session.
github-actions commentedon Mar 26, 2026
🏗️ Squad Triage — Flight (Lead)
Issue: #595 — feat: Tiered history retrieval (hot/cold layer pattern)
Assigned to: DSKY (TUI Engineer)
Reason: Issue relates to frontend/UI work
@copilot evaluation: 🔴 Not suitable — issue involves work outside the coding agent's capability profile.
Team roster:
squad:flightsquad:proceduressquad:eecomsquad:fidosquad:paosquad:capcomsquad:controlsquad:surgeonsquad:boostersquad:gncsquad:networksquad:retrosquad:incosquad:guidosquad:telemetrysquad:voxsquad:dskysquad:simssquad:handbooksquad:ralphsquad:copilotbradygaster commentedon Mar 26, 2026
Triage: Contributor-submitted tiered history retrieval feature. Hot/cold layer pattern for context management. Assigned to Procedures (agent memory architecture).
diberry commentedon Mar 31, 2026
🔄 Ralph status: Feature — 2-tier history retrieval. Research done in #686. Subset of #600 (which adds wiki tier). No implementation PR yet.
1 remaining item
github-actions commentedon Sep 10, 2026
🔄 Ralph — Auto-Triage
Assigned to: Flight
Reason: No module, routing, or role keyword match — routed to Lead/Architect
Source: lead-fallback
github-actions commentedon Sep 10, 2026
🔄 Ralph — Auto-Triage
Assigned to: Flight
Reason: No module, routing, or role keyword match — routed to Lead/Architect
Source: lead-fallback
github-actions commentedon Sep 11, 2026
🔄 Ralph — Auto-Triage
Assigned to: Flight
Reason: No module, routing, or role keyword match — routed to Lead/Architect
Source: lead-fallback
github-actions commentedon Sep 11, 2026
🔄 Ralph — Auto-Triage
Assigned to: Flight
Reason: No module, routing, or role keyword match — routed to Lead/Architect
Source: lead-fallback
github-actions commentedon Sep 11, 2026
🔄 Ralph — Auto-Triage
Assigned to: Flight
Reason: No module, routing, or role keyword match — routed to Lead/Architect
Source: lead-fallback
github-actions commentedon Sep 11, 2026
🔄 Ralph — Auto-Triage
Assigned to: Flight
Reason: No module, routing, or role keyword match — routed to Lead/Architect
Source: lead-fallback
github-actions commentedon Sep 13, 2026
🔄 Ralph — Auto-Triage
Assigned to: architect
Reason: No module, routing, or role keyword match — routed to Lead/Architect
Source: lead-fallback
bradygaster commentedon Sep 23, 2026
Closing as a duplicate of #600 — issue comments on this thread explicitly state #595 is a subset of #600 and #600 is the superset covering this work. The shipped tiered-memory docs/skill track the combined scope under #600 (and #1264).