Reference

System Map

Every component numbered. Use the number in conversation — "the nav in #1" or "deploy #2" — to point at exactly the right thing without ambiguity.

Cloudflare Pages — han-solo-docs.pages.dev
1
Workspace UI
Chat + sidebar nav. Ren, Session, Workspace, Frameworks, Development sections. The main interface.
workspace.html → docs/workspace.html
2
Han Solo Docs
Overview, how-it-works, memory, transcripts, dashboard, logbook, system map, session architecture.
index.html → docs/*.html
3
Framework Docs
Phase guides, skills reference, process map, decks. Surfaced via Solo Builder in #1.
framework/ → docs/framework/*.html
14
Jottings Frontend
React/Vite app. Build output to frontend/dist/. Deploy manually — npm run build + wrangler.
han-solo-jottings.pages.dev → frontend/src/
Render — auto-deploys on git push
4
MCP Server
FastMCP bridge. 67 tools callable by Claude Code. Also hosts a secondary web UI.
han-solo-mcp.onrender.com/mcp
5
Letta
Ren's persistent memory backend. Core blocks, archival passages, portraits. v0.16.8.
han-solo-letta.onrender.com
6
Database
Two PostgreSQL pools. Main (han-solo-db): T4, skills, transcripts, notecards. Memory (han-solo-data): 13 agent memory tables — sessions, lessons, builds, conversations.
Internal — Render only
7
Render App UI
Legacy /chat endpoint. Read-only — do not edit for UI changes. Different from #1.
han-solo-mcp.onrender.com → han_solo/app_html.py
Local — Scott's Mac
8
Claude Code
Local execution environment. MCP client — connects to #4. Where Ren loads and all work happens.
CLI / Claude Code app
9
Framework Vers1
Source of truth for framework phase skills. Updated here first, then pushed to #6 via write_skill.
~/Developer/Framework Vers1/skills/
10
verify.py
62-check health monitor. Runs every 30 min via LaunchAgent. Posts results to #6.
scripts/verify.py
11
Transcript Parser
Parses Claude Code JSONL sessions (~/.claude/projects/). Pushes to #6. Runs every 30 min.
scripts/parse_transcripts.py
12
ren-local
Local session log. Sessions, decisions, open threads. Written at close of each session.
~/Developer/ren-local/
GitHub
13
han-solo repo
scoots31/han-solo (private). git push → auto-deploys #4 and #7. Manual deploy for #1 #2 #3 via wrangler.
github.com/scoots31/han-solo

Quick reference

# Name Zone What you edit Deploy
1 Workspace UI — Chat, sidebar nav, Development section Cloudflare docs/workspace.html wrangler → han-solo-docs
2 Han Solo Docs — overview, operational pages Cloudflare docs/*.html wrangler → han-solo-docs
3 Framework Docs — guides, skills reference, decks Cloudflare docs/framework/*.html wrangler → han-solo-docs
4 MCP Server — tools, API, FastMCP bridge Render han_solo/server.py · han_solo/tools/ git push → auto
5 Letta — Ren's persistent memory (v0.16.8) Render Via MCP tools or Letta API Image-based, Render manages
6 Database — two pools: main (T4, skills, transcripts) + memory (han-solo-data, 13 agent memory tables) Render Via API endpoints or scripts Render managed
7 Render App UI — legacy /chat endpoint, read-only Render han_solo/app_html.py — do not edit do not edit
8 Claude Code — local execution, MCP client Local Claude Code settings, hooks, skills —
9 Framework Vers1 — phase skills source of truth Local ~/Developer/Framework Vers1/skills/ write_skill MCP tool → #6
10 verify.py — 62-check health monitor Local scripts/verify.py LaunchAgent, 30 min interval
11 Transcript Parser — JSONL → #6 Local scripts/parse_transcripts.py LaunchAgent, 30 min interval
12 ren-local — local session log Local ~/Developer/ren-local/ —
13 GitHub repo — scoots31/han-solo (private) GitHub git push Auto-deploys #4 #7. Manual for #1 #2 #3.
14 Jottings Frontend — React/Vite app Cloudflare frontend/src/ npm run build → wrangler → han-solo-jottings