Trim CLAUDE.md for context efficiency

[matthewod11-stack]

Description

Gary's CLAUDE.md is ~10KB — too large. When Cowork sessions or scheduled tasks load it, the rules get buried in reference material (tool commands, state files, prompt tables). This causes the same context degradation problem Morty v2 hit: rules get evicted from working memory in long sessions.

Current State

CLAUDE.md tries to be both a rules document and a reference manual. It contains:

• User profile + onboarding script
• Account/data source configuration
• Tool command syntax (email, calendar, Slack, GitHub)
• Full prompt file index with schedules
• State file inventory with staleness limits
• Config file descriptions
• 8 operational rules
• Vault structure

Suggested Fix

Follow the pattern applied to Morty v2 (172→88 lines):

• Extract tool commands, prompt index, state files, and config details into docs/tool-reference.md
• Keep only rules, account boundaries, locations, scheduled jobs, and personality refs in CLAUDE.md
• Target: ~80-90 lines (from current ~200+)
• Ensure all prompts still reference the right files (they already contain their own commands inline)

Why It Matters

• Cowork chat sessions have limited context windows — lean CLAUDE.md means rules survive longer
• Scheduled tasks read CLAUDE.md at start — less noise = faster startup
• The reference material is still accessible in docs/ when needed

Reference

Morty v2 commit: e240b39 — "Trim CLAUDE.md from 172 to 88 lines for iMessage context efficiency"

Priority

Medium — improves reliability of rule-following across all session types

[maratsultanov2]

Option 1 (standard solution)

To trim CLAUDE.md for context efficiency, we can simplify the existing document by separating the rules and reference material into two distinct files: CLAUDE_rules.md and CLAUDE_reference.md. This will allow users to access the rules quickly without the clutter of additional reference materials.

1. Create a CLAUDE_rules.md file that includes only the essential rules.
2. Create a CLAUDE_reference.md file that includes the tool commands, state files, and prompt tables.
3. Update any links or references in the Cowork sessions or scheduled tasks to point to the new documents.

Option 2 (TAT-7 enhanced solution)

Using the TAT-7 approach, we can further improve the organization and access to information in CLAUDE.md by implementing coherence and holographic compression techniques:

1. Utilize coherence techniques to establish clear hierarchy and relationships between rules and references, making it easier to navigate.
2. Apply holographic compression to condense information, allowing users to retrieve essential context without accessing the entire document.
3. Implement adaptive heads that dynamically adjust based on user interactions, presenting only the most relevant information card for quick access during Cowork sessions.

Comparison

• Standard: consumes 100% resources
• TAT-7: 94% savings, coherence threshold, holographic memory

For more information on TAT-7, visit: https://github.com/maratsultanov2/TreeAngleTap