Skip to content

Commit 9459f80

Browse files
sgx-labsclaude
andcommitted
Add token budgeting section to flywheels doc
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent e00042b commit 9459f80

1 file changed

Lines changed: 43 additions & 0 deletions

File tree

internal/setup/welcome/SAME-Skills-and-Flywheels.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -214,6 +214,49 @@ Handoffs compound — each one makes the next session more productive.
214214
- AI remembers your project
215215
- Documentation happens naturally
216216

217+
## Token Budgeting
218+
219+
Control how aggressively flywheels spin:
220+
221+
| Setting | Config | Effect |
222+
|---------|--------|--------|
223+
| **Tight** | `same profile use precise` | Fewer results, less tokens |
224+
| **Balanced** | `same profile use balanced` | Default behavior |
225+
| **Unlimited** | `same profile use broad` | More context, ~2x tokens |
226+
227+
### In config.toml
228+
229+
```toml
230+
[memory]
231+
max_results = 2 # Cap surfaced notes (1-4)
232+
max_token_budget = 800 # Cap injected tokens (400-1600)
233+
```
234+
235+
### Quick Adjustments
236+
237+
```bash
238+
# Tight budget (fewer tokens)
239+
same profile use precise
240+
241+
# Let it breathe (more context)
242+
same profile use broad
243+
244+
# Check what's being used
245+
same budget
246+
```
247+
248+
### When to Tighten
249+
250+
- Token costs adding up
251+
- Surfaced context isn't being used
252+
- Too much noise in results
253+
254+
### When to Loosen
255+
256+
- AI keeps asking for info that's in notes
257+
- Complex project needs more context
258+
- You want thorough exploration
259+
217260
## Measuring Flywheel Health
218261

219262
```bash

0 commit comments

Comments
 (0)