1. Home — what this wiki is and how to navigate it.
2. Avvyland zone home — the platform's mission and shape.
3. Glossary — the language used across the codebase.
4. Architecture Overview — service map, data flow, where each repo sits.
Backend engineer. Read state-server architecture, then the REST API and WebSocket protocol. Skim signed callbacks to understand worker integration.
Worker / pipeline engineer. Read avvy-worker architecture and signed callbacks. Then Projection model SOP for the manual-review gate.
Frontend engineer. Read avvy-app architecture, avvy-engine architecture, then the JS SDK.
SRE / DevOps. Read Infrastructure, then the Operations index and: Deployment, Persistence Layer, Redis queue, Observability, Load testing.
Product / partner. Read Product vision, Concepts, User journeys, Domains.
1. Clone the relevant repos from gitlab.avvyland.com/avvy — see the Repo Catalog for the index.
2. Follow each repo's README for local setup. The state-server's external/mongo/docker-compose is the canonical MongoDB-replica-set bootstrap.
3. Read Repo conventions and Coding standards.
4. Read Testing before opening a PR.
This wiki captures final-state design. The active backlog lives in Jira — see External Links for project keys (AL, AVARCH, DOM) and access notes.