diff --git a/workbook/index.html b/workbook/index.html index 61fc691..d420c6f 100644 --- a/workbook/index.html +++ b/workbook/index.html @@ -821,9 +821,10 @@

Concrete examples to keep open

Token Savings Field Guide

Student goal: Use token efficiency as an engineering operating habit: search first, point precisely, delegate noisy work, compact at phase boundaries, and turn repeated work into reusable artifacts.
-

Token savings are not about making Claude think less. They are about keeping the context window focused on the material that changes the outcome. Read the nine moves below as a rough progression, not a checklist of rules: the early ones are reflexes you build in your first week, the later ones are habits you grow into as your sessions get more ambitious. You will not do all nine on every task, but the more advanced your work gets, the more of them you will reach for without thinking.

+

Token savings are not about making Claude think less. They are about keeping the context window focused on the material that changes the outcome. Read the ten moves below as a rough progression, not a checklist of rules: the early ones are reflexes you build in your first week, the later ones are habits you grow into as your sessions get more ambitious. You will not do all ten on every task, but the more advanced your work gets, the more of them you will reach for without thinking.

1. Enable RTK for noisy command output

RTK (Rust Token Killer) is a CLI proxy that compresses noisy command output before it reaches Claude's context, so a run that would have streamed hundreds of lines into the session lands as a compact, structured summary instead. It is useful when shell output is large, repetitive, or noisy. The impact compounds because command output does not just cost tokens once; it remains in the session and can be re-read on later turns.

+

The deep cut: RTK is content-aware, and that distinction is the whole point. It compresses the low-signal output (test runs, build logs, status noise) and leaves your source code untouched, because compressing the code Claude is reasoning over would degrade the reasoning itself. This is the same principle as the rest of this guide: cut the noise, never the signal. It is why you can leave RTK on by default instead of toggling it per command.

rtk gain              # cumulative token savings this session
 rtk gain --history    # per-command breakdown with savings
 rtk discover          # find missed compression opportunities
@@ -834,6 +835,7 @@ 

1. Enable RTK for noisy command output

- git status and diff noise - package manager output - long formatter or type-checker traces
+

You do not need to memorize which commands save the most, because one evergreen rule predicts it: the more predictable a command's output, the more of it is compressible noise. File reads and searches carry real signal, so the win is partial. Lint, type-check, and test runs that pass are almost pure boilerplate, so they compress nearly to nothing. When you meet a new noisy command, you can guess its payoff by asking how much of its output a human would actually read.

Practice habit: If a command regularly emits hundreds or thousands of lines, compress it, script it, or summarize it before it enters the main Claude context.

2. Move repeated tasks to executable scripts

The third time you type roughly the same instructions, treat it as a signal rather than a chore. Every repeat costs you twice: you re-describe the workflow, and Claude re-infers what you meant, sometimes differently than last time. Pinning that sequence into a stable script makes it cheaper, faster, and far more predictable, and it frees the conversation for the judgment only you can supply.

@@ -913,7 +915,10 @@

8. Prompt with a token budget

/compact focusing on decisions made, evidence pointers, files touched, unresolved questions, and residual risk. -

9. End-of-task token checklist

+

9. Keep the front of the conversation stable

+

The cheapest token is the one you never resend. Model APIs reward this directly: when the beginning of a request matches a previous one, the shared prefix is served from cache at a steep discount, so stability at the top of the context window is money. The evergreen principle underneath the pricing is simple and will outlast any specific discount rate: pin durable context (system prompt, project rules, the plan) at the top, and let churn happen at the bottom.

+

Reordering or rewriting early turns quietly invalidates that cache and you pay full freight again. This is also why a guided /compact at a phase boundary beats constant mid-task edits: it rewrites the context once, deliberately, instead of disturbing the stable prefix on every turn. Treat the top of your session as something you set carefully and then leave alone.

+

10. End-of-task token checklist

Before asking Claude to workBefore continuing the session
Have I named the artifact I want?Did I save decisions into an artifact?
Have I bounded files, paths, commands, and output length?Did I compress noisy evidence into pointers?