docs: Add Claude Code settings audit report

Generated settings optimization analysis with token budget breakdown
and MCP server recommendations.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

settings-audit-report.md

@@ -0,0 +1,112 @@
+# Claude Code Settings Audit Report
+
+**Generated:** 2026-01-20 17:49:51
+
+---
+
+## Token Budget Summary
+
+| Component | Tokens | % of 200K | Status |
+|-----------|--------|-----------|--------|
+| CLAUDE.md | 1,738 | 0.9% | 🟢 |
+| MCP Servers | 61,500 | 30.8% | 🟡 |
+| **Baseline Total** | **63,238** | **31.6%** | 🔴 |
+| **Available for Work** | **136,762** | **68.4%** | — |
+
+**Target:** Baseline under 30% (60,000 tokens), Available over 70%
+
+---
+
+## Overall Health: 🔴 Critical
+
+- Critical Issues: 1
+- Warnings: 13
+- Passing Checks: 56
+
+---
+
+## MCP Server Analysis
+
+**Servers:** 10 configured
+
+
+**Active:** 10 | **Disabled:** 0
+
+| Server | Tokens | Instructions | Status |
+|--------|--------|--------------|--------|
+| filesystem | ~4,000 | ✅ | always |
+| sqlite | ~5,000 | ✅ | lazy |
+| playwright | ~13,500 | ✅ | always |
+| figma | ~5,000 | ✅ | lazy |
+| osascript | ~5,000 | ✅ | lazy |
+| firecrawl | ~6,000 | ✅ | lazy |
+| google-analytics | ~5,000 | ✅ | lazy |
+| chrome-devtools | ~8,000 | ✅ | always |
+| exa | ~5,000 | ✅ | lazy |
+| dtm-agent | ~5,000 | ✅ | lazy |
+
+---
+
+## CLAUDE.md Analysis
+
+- **/Users/ourdigital/.claude/CLAUDE.md**: 110 lines, ~800 tokens 🟢
+- **/Users/ourdigital/Project/claude-skills-factory/CLAUDE.md**: 150 lines, ~938 tokens 🟢
+
+---
+
+## Extensions Analysis
+
+- Commands: 18
+- Skills: 28
+- Agents: 5
+
+---
+
+## ❌ Critical Issues
+
+- Baseline uses 31.6% of context - target is under 30%
+
+---
+
+## ⚠️ Warnings
+
+- Command 'settings-audit': Missing YAML frontmatter
+- Command 'settings-audit': Too long: 120 lines (max 100)
+- Skill 'jamie-youtube-manager': Too long: 526 lines (max 500)
+- Agent 'data-analyst': Missing frontmatter
+- Agent 'data-analyst': Tools not restricted (consider limiting)
+- Agent 'seo-advisor': Missing frontmatter
+- Agent 'seo-advisor': Tools not restricted (consider limiting)
+- Agent 'python-coach': Missing frontmatter
+- Agent 'python-coach': Tools not restricted (consider limiting)
+- Agent 'gtm-manager': Missing frontmatter
+- *...and 3 more*
+
+---
+
+## ✅ Passing
+
+- MCP 'filesystem': Has serverInstructions
+- MCP 'sqlite': Has serverInstructions
+- MCP 'playwright': Has serverInstructions
+- MCP 'figma': Has serverInstructions
+- MCP 'osascript': Has serverInstructions
+- *...and 51 more*
+
+---
+
+## Recommendations
+
+1. **Fix:** Baseline uses 31.6% of context - target is under 30%
+
+---
+
+## Next Steps
+
+1. Run `python3 scripts/auto_fix.py` to preview fixes
+2. Run `python3 scripts/auto_fix.py --apply` to apply fixes
+3. Re-run audit to verify improvements
+
+---
+
+*Generated by Claude Code Settings Optimizer*