Skip to content

Comparison landing page, extended troubleshooting#120

Merged
amavashev merged 2 commits intomainfrom
claude/audit-docs-blogs-L2gsm
Mar 20, 2026
Merged

Comparison landing page, extended troubleshooting#120
amavashev merged 2 commits intomainfrom
claude/audit-docs-blogs-L2gsm

Conversation

@amavashev
Copy link
Contributor

Comparison landing page (/concepts/comparisons.md):

  • Quick-scan capability matrix (8 approaches × 5 dimensions)
  • 6 deep-dive links organized by category: infrastructure you already run, AI stack tools, build vs use
  • Links to the full comparison article and related reading

Expanded troubleshooting (4 new sections in troubleshooting-and-faq.md):

  • MCP server issues — missing env vars, config path problems, mock mode confusion
  • Admin API issues — wrong port (7878 vs 7979), wrong header, fund operation gotchas
  • Common first-integration mistakes — TTL too short for commits, USD_MICROCENTS math (with conversion table), scope hierarchy mismatches
  • Incident pattern cross-links — connects to all 4 incident pages that were previously undiscoverable from troubleshooting

Sidebar — "Comparisons" added as first item in Concepts section.

claude added 2 commits March 20, 2026 21:11
New: /concepts/comparisons.md — hub page linking to all 6 comparison
articles (vs rate limiters, provider caps, token counters, Guardrails AI,
LLM proxies, DIY wrappers) with a quick-scan capability matrix.

Expanded: /how-to/troubleshooting-and-faq.md — added 4 new sections:
- MCP server issues (config, mock mode, tool visibility)
- Admin API issues (wrong port/header, fund operations, tenant 409)
- Common first-integration mistakes (TTL, USD_MICROCENTS math, scope mismatch)
- Cross-links to all 4 incident pattern pages

Updated sidebar to add Comparisons as first Concepts entry.

https://claude.ai/code/session_01NEcAqmfZHsZV9WEZXNofWY
- Fix scope/budget claim: scopes without budgets are skipped during
  enforcement (not "every level needs its own budget"). Updated both
  the pre-existing note (line 31) and the new first-integration section.
- Fix pre-existing bug: admin API curl examples used X-Cycles-API-Key
  instead of X-Admin-API-Key for port 7979 calls (3 instances).
- Rewrite scope mismatch troubleshooting entry with accurate scenarios.

https://claude.ai/code/session_01NEcAqmfZHsZV9WEZXNofWY
@amavashev amavashev merged commit 0676c55 into main Mar 20, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants