The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
feat(skills): context-budget — account for reconnect scaffolding
robinryukc00eb809043a
diff --git a/skills/context-budget/SKILL.md b/skills/context-budget/SKILL.mdindex 1061041c6..d54140263 100644--- a/skills/context-budget/SKILL.md+++ b/skills/context-budget/SKILL.md@@ -43,6 +43,38 @@ Scan all component directories and estimate token consumption:- Estimate schema overhead at ~500 tokens per tool- Flag: servers with >20 tools, servers that wrap simple CLI commands (`gh`, `git`, `npm`, `supabase`, `vercel`)+**Session scaffolding** (the transcript itself)++Everything above is loaded once at startup. A *reconnect* re-injects a second copy of much of it into+the session transcript as `attachment` lines, and that cost is charged to the same context window.+Measure it directly rather than estimating:++```sh+# on the newest transcript for this project+f=$(ls -t ~/.claude/projects/"${PWD//\//-}"/*.jsonl | head -1)+python3 - "$f" <<'EOF'+import json,sys+tot=att=0+for line in open(sys.argv[1]):+ tot+=len(line)+ try:+ if json.loads(line).get('type')=='attachment': att+=len(line)+ except: pass+print(f"transcript {tot}B | scaffolding {att}B ({att*100//max(tot,1)}%) | conversation {tot-att}B")+EOF+```++Measured on a session that had reconnected once: **33,884 of 49,830 bytes — 68% scaffolding**, broken+down as `skill_listing` 14.6KB, `mcp_instructions_delta` 8.1KB, `deferred_tools_delta` 7.1KB,+`agent_listing_delta` 2.6KB. The conversation itself was 15.9KB.++- Flag: scaffolding >40% of the transcript — the session is paying more for its own inventory than for+ the work+- This is the strongest argument for the reductions elsewhere in this skill: trimming a skill or an+ MCP server saves tokens *once per reconnect*, not once per session+- It also means transcript file size is a poor proxy for how full a context window is. Count only+ non-`attachment` lines when reporting "how much room is left"+**CLAUDE.md** (project + user-level)- Count tokens per file in the CLAUDE.md chain- Flag: combined total >300 lines