Six-step ritual for distilling long conversations and sessions into potent wisdom artifacts. Use when compressing a transcript, ending a long session, performing context hygiene, handing off a project, or when the context feels heavy and noisy. Also use when someone asks how to compress, distill, or summarize a session into lasting artifacts.
Compression is not destruction -- it is transformation. We transform the raw material of conversation into refined artifacts of wisdom. The goal is to lose volume while preserving meaning. Every token in a context window has a cost; compression ensures that cost buys wisdom, not noise.
The ritual framing matters. This is not "cleanup" or "archiving" -- it's a conscious, creative act of choosing what deserves to grow and what can be respectfully composted. The Art of Letting Go is the recognition that not everything deserves permanent cultivation, and that releasing context is an act of respect for future clarity.
Distillation follows a principle: compress the experience, not just the text. A good compression captures the meaning of a 3-hour session in 200 words, not just the first paragraph of each exchange.
When NOT to use: For short conversations with 1-2 key points, a simple daily note via /tend is sufficient. Don't ritualize what doesn't need it.
Announce the ritual to frame it as deliberate practice:
"We're entering a compression ritual. The goal is to distill this session into its essential wisdom."
Why this matters: Signaling shifts the mindset from "working" to "reflecting." It creates a boundary between the session and its compression.
Read through the material looking for five types of significant moments:
Key Insight: Read for significance, not completeness. Most of the transcript is machinery -- the process of getting to insights. The insights themselves are what deserve preservation.
Each significant moment needs an appropriate container:
| Vessel | Purpose | When to Use |
|---|---|---|
| Philosophical Reflection | Capture the "why" behind work | Deep insights about thinking or approach |
| Conversation Summary | Document decisions and outcomes | Significant discussions with multiple decisions |
| Seed | Preserve a reusable pattern | Generalizable insight with a trigger |
| Documentation Update | Integrate into existing docs | Key decision that changes how something works |
| Decision Record | Formalize a choice with rationale | Consequential decisions with alternatives considered |
Decision point: If a moment fits multiple vessels, choose the most specific one. A reusable pattern is a seed, not a reflection. A specific decision is a record, not a summary.
Write each artifact with distillation as the goal:
For every potential artifact, explicitly categorize:
| Category | Action | What Belongs Here |
|---|---|---|
| Cultivate | Preserve as Tier B | Decisions, insights, seeds, failures, breakthroughs |
| Summarize | Condense to 1-2 sentences | Activities, discussions, exploration, intermediate steps |
| Compost | Release entirely | Pleasantries, dead-ends, repetitive iterations, duplicate context |
Present the triage visibly. The user should see what was cultivated, summarized, and composted. This transparency builds trust in the compression process.
Every compression produces a meta-record:
# Compression Log: YYYY-MM-DD
**Source:** [What was compressed]
**Original volume:** ~[X] tokens
**Compressed volume:** ~[Y] tokens
**Compression ratio:** [Z]% reduction
## Artifacts Cultivated
| Type | Path | Description |
|---|---|---|
## Insights Preserved
- [Insight 1]
- [Insight 2]
## Context Composted
- [What was released]
## Seeds Planted
- [Seed]: [Pattern]
Key Insight: The compression log is itself a Tier B artifact. It documents your curation decisions, which is institutional knowledge about what your team considers important.
The goal is to reduce noise while preserving signal. Challenge every potential artifact: "Would someone need this in 3 months?" If the answer is "probably not," compost it. But do so with acknowledgment -- even composted material contributed to the session's thinking.
Prioritize the "why" and the "how" over the raw "what." A compression that preserves "we chose X because of Y" is more valuable than one that lists every file changed.
If a concept is already captured in an existing seed or decision record, link to it rather than rewriting it. Duplication is the enemy of a clean garden.
A 3-hour debugging session might compress to: "Root cause was X. We misdiagnosed as Y because of Z. Seed: check-assumptions-before-code." That's the wisdom. The debugging transcript is machinery.
The more frequently you compress, the less daunting it becomes. Daily compression (via /tend) handles routine days. Weekly or per-session compression (via /compress) handles significant sessions.
/plant)Problem: Waiting weeks to compress means the context is cold. You've forgotten why decisions were made, and the compression becomes surface-level.
Solution: Compress within 24-48 hours of a significant session. The wisdom is freshest when the experience is recent.
Problem: The compression reads like a summary of every exchange rather than a distillation of insights. "First we discussed X, then we explored Y, then we decided Z" is machinery.
Solution: Ask: "What would I tell someone who wasn't in this session?" The answer is the wisdom. The step-by-step narrative is the machinery.
Problem: No meta-record of what was compressed. Future you can't tell what was in the original session or why certain things were composted.
Solution: Always write the compression log. It takes 5 minutes and provides invaluable context for future harvests.
Scenario: Compressing a 2-hour architecture session about migrating from monolith to microservices.
Step 1 (Signal): "Let's compress this architecture session into its essential wisdom."
Step 2 (Review): Key moments identified:
Step 3 (Vessel):
Step 5 (3-month rule):
Step 6 (Log): ~12,000 tokens > ~800 tokens (93% reduction)