Skip to content

docs(ai): AI Cost Tracking & Savings page#279

Merged
maximelb merged 3 commits into
masterfrom
solve/ai-cost-docs
Jun 21, 2026
Merged

docs(ai): AI Cost Tracking & Savings page#279
maximelb merged 3 commits into
masterfrom
solve/ai-cost-docs

Conversation

@maximelb

Copy link
Copy Markdown
Contributor

What was asked

Review the AI documentation against the recent changes to the AI cost-tracking feature and fix what's stale/missing. The LimaCharlie web app now links the cost UI to https://docs.limacharlie.io/9-ai-sessions/cost-tracking/, which had no page behind it.

What was done

The AI section had no dedicated cost pagemax_budget_usd was mentioned across several pages, but cost tracking, cost profiles, resolution-anchored savings, analyst-equivalent value, per-severity valuation, ROI, CSV exports, and the fleet rollup were undocumented.

  • New page docs/9-ai-sessions/cost-tracking.md documenting the feature as it now works:
    • Where to find it (per-org Cost Analytics + AI Resolution & Savings; Fleet Billing → AI Spend).
    • The two halves of cost (BYOK AI spend vs analyst-equivalent value) and the net-savings formula.
    • Cost profiles (label, loaded hourly rate, minutes/investigation, rate basis) and the cost-to-handle formula.
    • The resolution-anchored model (AI-only / AI+Human / Human-only) with per-severity rate-tiering.
    • Headline metrics (net savings, ROI, automation rate, analyst-hours freed, FTE-equivalent, cost/investigation), the per-profile P&L, and the cumulative savings trend (labelled as accrual, not a per-day measurement).
    • CSV exports (savings breakdown, raw resolution data, spend by model & rule).
    • The fleet/MSSP rollup and its "tenants need a cost profile" caveat.
    • Its relationship to per-session max_budget_usd (measurement vs hard cap).
  • Linked it from the AI Sessions overview (index.md): a pointer in the Billing section and an entry in the Documentation list.
  • Registered it in mkdocs.yml nav under AI Sessions, after API Reference.

No customer names, org IDs, or internal repo references are included (public repo).

Testing

  • mkdocs build --strict could not run locally — the Material theme/plugins aren't installed in this environment (infra-only). The nav YAML edit matches the surrounding structure, and all relative links in the new/edited pages were verified to resolve to existing files.

🤖 Generated with Claude Code

https://claude.ai/code/session_012ie78qt9UBuvCBEEfLRKT3

Document the AI cost-tracking and savings feature, which had no dedicated
page (the web app now links to /9-ai-sessions/cost-tracking/). Covers:
cost profiles (loaded rate + minutes/investigation), the resolution-
anchored savings model (AI-only / AI+Human / Human-only) with per-severity
valuation, the headline metrics (net savings, ROI, automation rate,
analyst-hours, FTE-equivalent), CSV exports, the fleet/MSSP rollup, and
the relationship to per-session max_budget_usd.

Also link it from the AI Sessions overview (Billing + Documentation
sections) and register it in the nav.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012ie78qt9UBuvCBEEfLRKT3
@github-actions

Copy link
Copy Markdown

Broken Links Detected

The link checker found some issues:

* [ERROR] <file:///home/runner/work/documentation/documentation/site/9-ai-sessions/7-administration/billing/options> | Cannot find file: File not found. Check if file exists and path is correct

Please fix these broken links before merging.

Full results

See the uploaded artifact for complete link check results.

lcbill
lcbill previously approved these changes Jun 21, 2026
Add the `text` language to the three formula fenced blocks (MD040), and
clarify that the savings calc nets token spend while per-minute session
runtime is billed separately.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012ie78qt9UBuvCBEEfLRKT3
@github-actions

Copy link
Copy Markdown

Broken Links Detected

The link checker found some issues:

* [ERROR] <file:///home/runner/work/documentation/documentation/site/9-ai-sessions/7-administration/billing/options> | Cannot find file: File not found. Check if file exists and path is correct

Please fix these broken links before merging.

Full results

See the uploaded artifact for complete link check results.

lcbill
lcbill previously approved these changes Jun 21, 2026
The link checker resolves bare directory links relative to the page URL,
turning ../7-administration/billing/options/ into a path under
9-ai-sessions/. Use the relative .md file path like the rest of the docs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012ie78qt9UBuvCBEEfLRKT3
@maximelb maximelb merged commit 23a39ad into master Jun 21, 2026
2 checks passed
@maximelb maximelb deleted the solve/ai-cost-docs branch June 21, 2026 03:34
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