Repository navigation
Research: Tiered memory implementation plan (#595 #600) #686
Description
Research for #595 and #600. Audited existing codebase patterns.
Existing patterns found:
- tiered-memory skill template at packages/squad-sdk/templates/skills/tiered-memory/SKILL.md (hot/cold/wiki tiers defined)
- history-shadow.ts: append-only markdown history with sections + timestamps
- nap.ts: 15KB compaction threshold, archives to history-archive.md, keeps last 5 entries
- agent-source.ts: reads history.md at agent load time
- history-split.ts: portable vs private history splitting
- squad_memory tool: write-only (no read tool exists)
Minimal implementation plan:
- Add readRecentHistory(teamRoot, agentName, limit=5) to history-shadow.ts
- Spawn prompts include only hot content (last 5 entries + core context)
- Cold tier = history-archive.md (already exists via nap.ts compaction)
- Add squad_history_read tool for on-demand cold/full access
- Wiki tier deferred (needs StorageProvider from feat(sdk): StorageProvider abstraction — complete migration + example providers #640)
Key finding: The tiered-memory SKILL.md already defines the 3-tier model. nap.ts already does hot/cold splitting. The gap is: spawn prompts load ALL history instead of just recent, and there is no read tool for agents to pull archive on demand.
Activity
github-actions commentedon Mar 29, 2026
📋 Assigned to Procedures (Prompt Engineer)
Issue: #686 — Research: Tiered memory implementation plan (#595 #600)
Procedures will pick this up in the next Copilot session.
github-actions commentedon Mar 29, 2026
🏗️ Squad Triage — Flight (Lead)
Issue: #686 — Research: Tiered memory implementation plan (#595 #600)
Assigned to: Flight (Lead)
Reason: No specific domain match — assigned to Lead for further analysis
@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:copilotdiberry commentedon Mar 31, 2026
🔄 Ralph status: Research complete — implementation plan documented for #595 and #600. Minimal plan: readRecentHistory + spawn prompt change + cold tier already exists. Wiki deferred. No implementation PR yet.
docs: design spec for fixed bottom input box (github#686)
fix(sdk,cli): bundle missing skills on init + strip fabricated proven…
fix(sdk,cli): bundle missing skills on init + strip fabricated tiered…
bradygaster commentedon Aug 3, 2026
Research spike complete. The investigation documented in this issue has been captured in the implementation plan for runtime integration. Ongoing runtime implementation work is tracked by #595 and #600. Closing this spike as completed — no runtime code shipped as part of this spike.