Skip to content

feat: session intelligence roadmap + design doc - #727

Merged
garrytan merged 2 commits into
mainfrom
garrytan/claude-code-lessons
Mar 31, 2026
Merged

garrytan merged 2 commits into
mainfrom
garrytan/claude-code-lessons

Conversation

@garrytan

Copy link
Copy Markdown
Owner

Summary

  • Adds 9 new TODOS across 4 sections (Context Intelligence, Health, Swarm, Refactoring) based on Claude Code ecosystem research
  • Writes docs/designs/SESSION_INTELLIGENCE.md — the architectural vision for gstack as the persistent brain that survives Claude's ephemeral context
  • Key insight: gstack already writes plans/reviews/learnings to ~/.gstack/projects/$SLUG/. Claude's compaction doesn't know they exist. A ~10-line preamble addition makes every skill's artifacts survive compaction.

Test plan

  • Verify TODOS.md entries are well-structured and have correct priority/effort/depends-on
  • Verify SESSION_INTELLIGENCE.md renders correctly on GitHub
  • No code changes — roadmap and design doc only

🤖 Generated with Claude Code

garrytan and others added 2 commits March 31, 2026 15:34
Frames gstack as the persistent brain that survives Claude's ephemeral
context window. Architecture diagram, 5-layer feature breakdown, and
research sources from claude-mem, Anthropic engineering blog, CodeScene,
and Claude Code Agent Teams.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…dmap

9 new TODOS across 4 sections based on Claude Code ecosystem research:
- Context Intelligence (P1): preamble artifact recovery, session timeline,
  cross-session injection, /checkpoint skill, vision doc
- Health (P1): /health dashboard with CodeScene MCP integration option,
  /health as /ship quality gate
- Swarm (P2): extract Review Army into reusable multi-agent primitive
- Refactoring (P2): /refactor-prep for pre-refactor token hygiene

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

E2E Evals: ✅ PASS

0/0 tests passed | $0 total cost | 12 parallel runners

Suite Result Status Cost

12x ubicloud-standard-2 (Docker: pre-baked toolchain + deps) | wall clock ≈ slowest suite

@garrytan
garrytan merged commit db35b8e into main Mar 31, 2026
18 checks passed
24601 added a commit to 24601/gastack that referenced this pull request Apr 1, 2026
Syncs 5 upstream commits:
- feat: /design-html works from any starting point (v0.15.1.0) (garrytan#734)
- feat: Session Intelligence Layer — /checkpoint + /health + context recovery (v0.15.0.0) (garrytan#733)
- feat: recursive self-improvement — operational learning + full skill wiring (v0.13.8.0) (garrytan#647)
- feat: session intelligence roadmap + design doc (garrytan#727)
- fix: ship idempotency + skill prefix name patching (v0.14.3.0) (garrytan#693)

New skills: /checkpoint, /health (session intelligence layer)
New files: bin/gstack-patch-names, bin/gstack-timeline-log, bin/gstack-timeline-read
Design doc: SESSION_INTELLIGENCE.md

Conflict resolved: README.md (kept our gap diagram + upstream's full README rewrite)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
mathiasmora2232 pushed a commit to mathiasmora2232/gstack that referenced this pull request May 30, 2026
* docs: Session Intelligence Layer design doc

Frames gstack as the persistent brain that survives Claude's ephemeral
context window. Architecture diagram, 5-layer feature breakdown, and
research sources from claude-mem, Anthropic engineering blog, CodeScene,
and Claude Code Agent Teams.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: add context intelligence, health, swarm, and refactoring to roadmap

9 new TODOS across 4 sections based on Claude Code ecosystem research:
- Context Intelligence (P1): preamble artifact recovery, session timeline,
  cross-session injection, /checkpoint skill, vision doc
- Health (P1): /health dashboard with CodeScene MCP integration option,
  /health as /ship quality gate
- Swarm (P2): extract Review Army into reusable multi-agent primitive
- Refactoring (P2): /refactor-prep for pre-refactor token hygiene

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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.

1 participant