Trovella Internal Wiki

Internal documentation for the Trovella product team — architecture, implementation, operations, and product knowledge.

Internal documentation organized by system capability. Each domain is self-contained with cross-references to related domains.

Domains

Schema design, migrations, query patterns, caching, and background jobs.

Compute, cloud resources, provisioning, secrets, observability, and deployment.

Authentication, authorization, tenant isolation, and organization management.

CI/CD pipeline, testing, quality gates, architecture enforcement, and dependency management.

Routing, API layer, UI components, state management, and admin dashboard.

Indexing, query pipeline, and relevance tuning.

Plan orchestration, AI reasoning, skills, and the tool protocol.

Product vision, design language, conventions, and planning.

Organize by capability, not by role or team — domains mirror what the system does
Link, don't duplicate — cross-reference related pages instead of repeating content
Content-type discipline — each page is an overview, decision, guide, reference, or runbook
Folders for browsing, metadata for finding — frontmatter tags enable cross-cutting discovery
Docs-as-code — wiki lives in the repo, built by Fumadocs, linted in CI
Start with what exists, grow intentionally — migrate existing docs, add new content as needed