Documentation Index

Canonical documentation lives in docs/. The published site in docs-site/ is synced from these files via docs-site/scripts/sync-docs.js.

New to Aragora? Start with DOCUMENTATION_HUB.md for guided navigation.

Use this index for fast navigation. For a fuller map, see docs/DOCUMENTATION_MAP.md. Deprecated and historical documents live in docs/deprecated/.

Quick Links

Need	Document
Extended reference	EXTENDED_README.md
Feature discovery	FEATURE_DISCOVERY.md
Project status	STATUS.md
First-time setup	GETTING_STARTED.md
Control plane overview	CONTROL_PLANE.md
Control plane operations	CONTROL_PLANE_GUIDE.md
Capability matrix	CAPABILITY_MATRIX.md
API reference	API_REFERENCE.md
Admin API reference	ADMIN_API_REFERENCE.md
API examples	API_EXAMPLES.md
Production deployment	DEPLOYMENT.md
Troubleshooting	TROUBLESHOOTING.md
Email prioritization	EMAIL_PRIORITIZATION.md
Unified inbox guide	INBOX_GUIDE.md
Shared inbox	SHARED_INBOX.md
Document ingestion	DOCUMENTS.md
Codebase analysis	CODEBASE_ANALYSIS.md
GitHub PR review API	GITHUB_PR_REVIEW.md
Coding assistance	CODING_ASSISTANCE.md
Cost visibility	COST_VISIBILITY.md
Accounting automation	ACCOUNTING.md

Core Concepts

• Architecture: ARCHITECTURE.md
• Debate engine: DEBATE_INTERNALS.md
• Declarative hooks: HOOKS.md
• Workflow engine: WORKFLOW_ENGINE.md
• Templates: TEMPLATES.md
• Knowledge Mound: KNOWLEDGE_MOUND.md
• Memory tiers: MEMORY_TIERS.md
• Memory overview: MEMORY.md
• Document ingestion: DOCUMENTS.md
• Agent catalog: AGENTS.md
• Skills system: SKILLS.md

Control Plane & Operations

• Control plane overview: CONTROL_PLANE.md
• Control plane guide: CONTROL_PLANE_GUIDE.md
• Operations runbook: OPERATIONS.md
• Production readiness: PRODUCTION_READINESS.md
• Observability: OBSERVABILITY.md
• Async gateway setup: deployment/ASYNC_GATEWAY.md
• Container volume guidance: deployment/CONTAINER_VOLUMES.md

Channels & Inbox

• Channels overview: CHANNELS.md
• Bot integrations: BOT_INTEGRATIONS.md
• Email prioritization: EMAIL_PRIORITIZATION.md
• Unified inbox guide: INBOX_GUIDE.md
• Shared inbox: SHARED_INBOX.md

Analysis & Code Health

• Codebase analysis: CODEBASE_ANALYSIS.md
• Document analysis: ANALYSIS.md

API & SDK

• API reference: API_REFERENCE.md
• Admin API reference: ADMIN_API_REFERENCE.md
• Endpoint catalog (auto-generated): API_ENDPOINTS.md
• API usage guide: API_USAGE.md
• WebSocket events: WEBSOCKET_EVENTS.md
• SDK guide (Python): SDK_GUIDE.md
• SDK guide (TypeScript): SDK_TYPESCRIPT.md

Enterprise & Security

• Governance: GOVERNANCE.md
• Compliance: COMPLIANCE.md
• Compliance presets: COMPLIANCE_PRESETS.md
• Security overview: SECURITY.md
• Authentication guide: AUTH_GUIDE.md
• SSO setup: SSO_SETUP.md
• RBAC/ABAC strategy: security/rbac-abac-strategy.md

Costs & Billing

• Billing overview: BILLING.md
• Cost visibility: COST_VISIBILITY.md
• Accounting automation: ACCOUNTING.md

Development

• Contributing: CONTRIBUTING.md
• Frontend development: FRONTEND_DEVELOPMENT.md
• Frontend routes: FRONTEND_ROUTES.md
• Handler reference: HANDLERS.md
• Handler development: HANDLER_DEVELOPMENT.md
• Testing: TESTING.md
• Breaking changes: BREAKING_CHANGES.md
• Deprecation policy: DEPRECATION_POLICY.md
• Parity backlog: PARITY_BACKLOG.md

Coding & Review

• Coding assistance: CODING_ASSISTANCE.md
• GitHub PR review API: GITHUB_PR_REVIEW.md

Deprecated & Historical

Deprecated docs are archived in docs/deprecated/. See docs/deprecated/README.md for the index.

Inventory

• Markdown files under docs/: 435 (includes deprecated)
• Last updated: 2026-02-03