Tune

Phase 2: Principles (if selected)

1. Check if .gabbro/principles.yaml exists
2. Read .claude/skills/tune/principles-guide.md

If existing principles found:

Show: "You have N principles configured: [list them]"

AskUserQuestion: "What would you like to do?"

• "Add more" → proceed to catalog, show only unconfigured principles
• "Remove some" → show existing principles as options, let user pick which to remove, then offer to add more
• "Start fresh" → clear all, show full catalog

If no existing principles:

Proceed directly to catalog.

Catalog flow:

3. Follow the guide's "Presenting to the user" instructions
4. Follow the guide's "Probe Instructions" for codebase exploration
5. Write .gabbro/principles.yaml with final set (kept + newly added)

Phase 3: tokf Filters (if selected)

Step 1: Discover real usage

Run tokf discover --json via Bash to find commands that ran without filters in past sessions.

• If discover finds unfiltered commands with significant token waste: propose filters for the top results, one at a time via AskUserQuestion
• If discover finds nothing (new project, no session history): fall back to codebase exploration (Step 2)

Step 2: Codebase exploration (fallback)

Only if discover found nothing. Read .claude/skills/tune/tokf-guide.md and follow its probe instructions to discover commands from package.json, Makefile, justfile, etc.

Step 3: Write filters

For each accepted filter, read .claude/skills/tokf-filter/SKILL.md for the full TOML reference (processing order, fields, templates). Use that knowledge to write proper filters, not just Level 1.

• Check .tokf/filters/ for existing filters and skip duplicates
• Write each accepted filter to .tokf/filters/[tool]/[command].toml
• Write .tokf/rewrites.toml if any rewrites were accepted
• Verify each filter with tokf verify after writing

Phase 4: Summary

Report what was written:

• Number of principles added to .gabbro/principles.yaml
• Number of filters written to .tokf/filters/
• Number of rewrites added to .tokf/rewrites.toml