docs: add llms.txt and llms-full.txt for AI agent discoverability

Adds mkdocs-llmstxt plugin generating:
- /llms.txt  — structured index (title, description, all page links)
  readable by Perplexity, ChatGPT, Claude, Cursor, and AI crawlers
- /llms-full.txt — full concatenated docs content (9k+ lines) for
  AI tools that ingest the entire knowledge base in one shot

Sections cover all 38 pages across Getting Started, Usage Guide,
Integrations, Reference, and Architecture.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: arieradle

.github/workflows/docs.yml

@@ -29,6 +29,7 @@ jobs:
             mkdocs-mermaid2-plugin \
             mkdocs-minify-plugin \
             mkdocs-rss-plugin \
+            mkdocs-llmstxt \
             mike
 
       - name: Build docs

mkdocs.yml

@@ -100,6 +100,53 @@ plugins:
         as_creation: date
       categories:
         - tags
+  - llmstxt:
+      full_output: "llms-full.txt"
+      markdown_description: |
+        Shekel enforces hard LLM spend limits in Python with one line of code.
+        Supports OpenAI, Anthropic, LiteLLM, Gemini, LangGraph, CrewAI, OpenAI Agents SDK, MCP, and more.
+        Key features: hard USD caps, loop detection, velocity limits, per-node/agent/task circuit breakers, Redis distributed budgets.
+      sections:
+        Getting Started:
+          - index.md
+          - installation.md
+          - quickstart.md
+        Usage Guide:
+          - usage/basic-usage.md
+          - usage/nested-budgets.md
+          - usage/budget-enforcement.md
+          - usage/fallback-models.md
+          - usage/loop-guard.md
+          - usage/spend-velocity.md
+          - usage/tool-budgets.md
+          - usage/temporal-budgets.md
+          - usage/distributed-budgets.md
+          - usage/accumulating-budgets.md
+          - usage/streaming.md
+          - usage/decorators.md
+        Integrations:
+          - integrations/litellm.md
+          - integrations/langgraph.md
+          - integrations/crewai.md
+          - integrations/openai-agents.md
+          - integrations/openai.md
+          - integrations/anthropic.md
+          - integrations/gemini.md
+          - integrations/huggingface.md
+          - integrations/langfuse.md
+          - integrations/otel.md
+        Reference:
+          - cli.md
+          - docker.md
+          - api-reference.md
+          - models.md
+        Architecture:
+          - how-it-works.md
+          - architecture/overview.md
+          - architecture/components.md
+          - architecture/data-flow.md
+          - architecture/extensibility.md
+          - architecture/concurrency.md
   - mermaid2
 
 markdown_extensions:

pyproject.toml

@@ -99,6 +99,7 @@ dev = [
     "mkdocs-mermaid2-plugin>=1.0.0",
     "mkdocs-minify-plugin>=0.8.0",
     "mkdocs-rss-plugin>=1.17.0",
+    "mkdocs-llmstxt>=0.5.0",
     "google-genai>=1.0.0",
     "huggingface-hub>=0.20.0",
     "opentelemetry-api>=1.0.0",