v1.0.5
v1.0.5: AI-readable docs via llms.txt support.
External user feedback on v1.0.4 surfaced that the docs site is
hard for AI agents to parse — they hit mkdocs-rendered HTML with
navigation chrome and visual structure rather than clean markdown.
Most evaluators of Active Graph in 2026 use AI tooling (Claude
Code, Cursor, Replit agents) to test repos. The docs need to be
machine-readable as a first-class concern.
v1.0.5 adds two files to docs.activegraph.ai:
/llms.txt — structured markdown index. H1 + blockquote summary
- H2 sections linking the major doc pages. ~100 lines. Acts as
a navigation aid for AI tools that support llms.txt-aware
fetching.
/llms-full.txt — concatenated markdown of all doc pages. ~110K
tokens, well under the 200K context-window budget. Acts as the
"everything in one file" reference for AI tools that ingest
comprehensive docs.
Both files are generated at docs build time via mkdocs-llmstxt
(no hand-maintenance, no drift between source markdown and
generated files). A CI gate verifies both files exist and are
well-formed after every docs build.
CONTRACT v1.0.5 #1 documents the decision and deliberately does
not touch three adjacent concerns filed for v1.1: content
negotiation for Accept: text/markdown serving, editorial
doc-readability audit, and source-markdown improvements for AI
parseability.
This is the final patch release before the public launch.
See CHANGELOG.md for full notes.