Tokenfesto — Token FinOps Manifesto

Your Token Hygiene Checklist

Check off what you've done. Your score updates in real-time.

Context

Listed all steering/rules files with sizes Deleted dead files (.bak, unused, stale) Moved <30% frequency files to on-demand Measured total tokens loaded per call

Memory

Ran archive_old(60) for observations >60d Using compact_graph instead of read_graph Checked memory size (entities × obs count)

Model

Identified expensive model on simple tasks Configured fallback chain (free → mid → premium) Tested quality with cheaper model on common tasks

Budget

Set daily/monthly token budget Configured warn/degrade/block thresholds

KBs

Reviewed which knowledge bases are indexed Removed stale/unused KBs from index

Template Script

Works with: Kiro CLI, Claude Code, Cursor, Windsurf, any MCP agent.

monthly-audit.sh

# 1. Count context files + total size
find .kiro/steering -type f | xargs wc -c | sort -rn
du -sh .kiro/steering

# 2. Check memory size
sqlite3 .kiro/memory.db \
  "SELECT count(*) as active FROM observations WHERE archived = 0"

# 3. Archive old (via MCP or direct SQL)
sqlite3 .kiro/memory.db \
  "UPDATE observations SET archived = 1
   WHERE created_at < datetime('now', '-60 days')
   AND archived = 0"

# 4. Report
echo "Steering: $(du -sh .kiro/steering | cut -f1)"
echo "Active obs: $(sqlite3 .kiro/memory.db 'SELECT count(*) FROM observations WHERE archived=0')"
echo "Archived: $(sqlite3 .kiro/memory.db 'SELECT count(*) FROM observations WHERE archived=1')"

Audit Monthly