* Add Vercel-style compressed documentation index to AGENTS.md
This replaces the previous summary-based approach with a retrieval-based
index following Vercel's agents.md pattern:
- Create .tg-docs/INDEX.md as detailed documentation index
- Add compressed pipe-delimited index directly in AGENTS.md
- Index points to source documentation files for on-demand retrieval
- Organize by category: Core Architecture, Layout, Commands, Input, etc.
- Include API namespace specs and source code directory structure
- Enable retrieval-led reasoning instead of embedding full content
The compressed format reduces token usage while preserving full
documentation access through file retrieval.
https://claude.ai/code/session_01PA5YNxogagLmiQrvvJNisX
* Add plan for comprehensive API docs compression
This plan outlines steps to:
1. Build docs with docfx to generate full API reference
2. Extract all types from generated metadata
3. Create Vercel-style compressed index with full API coverage
4. Include all ~270 classes, ~55 interfaces, ~55 enums
The plan enables continuation of this work in a CLI environment
where dotnet and docfx are available.
https://claude.ai/code/session_01PA5YNxogagLmiQrvvJNisX
* docs: add comprehensive API type index for AI agents
Add complete API reference with ~530 types across 12 namespaces:
- INDEX.md: Full detailed tables for all types by namespace
- AGENTS.md: Compressed pipe-delimited format for quick AI lookup
- Remove work-in-progress plan file
This completes the Vercel-style documentation compression effort,
providing AI agents with immediate access to API type information.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: add Vercel-style auto-generated file path index
Add Generate-SourceIndex.ps1 script that creates retrieval-led reasoning
indices for AI agents. Instead of embedding stale descriptions, the index
points to actual source files that agents read when needed.
- Create docfx/scripts/Generate-SourceIndex.ps1 to scan source and docs
- Update Build.ps1 to call generator before docfx build
- Rewrite .tg-docs/INDEX.md as auto-generated Vercel-style index
- Add injection markers to AGENTS.md for auto-updated source index
- Document the feature in docfx/README.md with link to Vercel blog post
Based on: https://vercel.com/blog/how-we-compressed-our-js-sdk-docs-by-80-percent-for-llms
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* regen
---------
Co-authored-by: Claude <noreply@anthropic.com>