big-agi/kb/KB.md

Knowledge Base

Architecture and system documentation is available in the /kb/ knowledge base, for use by AI agents and developers.

Structure:

• /kb/KB.md - Already in context: this text
• /kb/vision-inlined.md - Already in context (next section): long-term vision and north stars
• /kb/modules/ - Core business logic (e.g. AIX)
• /kb/systems/ - Infrastructure (routing, startup)

Modules Documentation

AIX - AI Communication Framework

• AIX.md - AIX streaming architecture documentation
• AIX-callers-analysis.md - Analysis of AIX entry points, call chains, common and different rendering, error handling, etc.

CSF - Client-Side Fetch

• CSF.md - Direct browser-to-API communication for LLM requests

LLM - Language Model Metadata

• LLM-editorial-control.md - Where we have editorial control over per-model metadata vs dynamic discovery; pubDate field semantics, propagation chain, resolution rules, per-vendor matrix
• LLM-models-catalog-pipeline.md - Forward-looking pipeline: extraction script, snapshot artifact, website consumption, future schema extensions

LLM - Vendor APIs

• LLM-gemini-interactions.md - Gemini Interactions API (Deep Research): endpoints, status taxonomy, two retrieval paths (SSE replay vs JSON GET), known failure modes (10-min cuts, zombies), UI surface

Systems Documentation

Core Platform Systems

• app-routing.md - Next.js routing, provider stack, and display state hierarchy
• LLM-parameters-system.md - Language model parameter flow across the system
• LLM-vendor-integration.md - Adding new LLM providers

KB Guidelines

Writing Style

• Direct and factual - No marketing language
• Present tense - "AIX handles streaming" not "AIX will handle"
• Active voice - "The system processes" not "Processing is done by"
• Concrete examples - Show actual code/config when helpful, briefly

Maintenance

• Remove outdated knowledge base information when detected
• Keep cross-references current when files move