Repo layout

backend/
  src/Aide.Api/             endpoints, auth, ProblemDetails, OpenAPI, hosted workers
  src/Aide.Domain/          pure business rules: state machine, gates, versioning, guardian, review scoring
  src/Aide.Infrastructure/  EF Core (Persistence, Migrations), LLM, Git hosts (GitHub, GitLab, Bitbucket), deployment
                            platforms, databases, notifications, Agents/Prompts and Agents/Stack (embedded catalog)
  src/Aide.Cli/             the `tevrin` .NET global tool (package Tevrin.Cli)
  src/Aide.Cli.Alias/       the deprecated `aide` command (package Aide.Cli), same sources
  tests/                    Aide.UnitTests, Aide.IntegrationTests (Testcontainers)
  openapi/api.json          GENERATED contract (committed)
frontend/
  src/api/generated/        GENERATED client
  src/features/             pages, components, hooks per feature
  src/app/                  Next.js App Router routes (thin; render feature pages)
  server.ts                 custom Node server: serves the app, proxies /api
  e2e/                      Playwright
deploy/
  k8s/base, k8s/overlays/local, k8s/overlays/local-e2e   Kustomize manifests
  scripts/                  deploy-local.sh, teardown-local.sh, smoke.sh, validate-manifests.sh, seed-e2e-repo.sh,
                            smoke-remote.sh
  railway/                  Railway ops docs (README.md) and variable inventory (variables.md)
.railway/                   Railway infrastructure as code (railway.ts)
.github/workflows/          ci.yml, deploy.yml, docs.yml (GitHub Pages)
docs/                       this site: index, getting-started, guides, operations, reference, history, brand;
                            plus the frozen docs/v1 ... docs/v5 specs and build logs
scripts/ci, scripts/perf    generated-file check, E2E seed for CI, perf scripts
docker-compose.yml          dev-loop database only
SPEC.md, PROGRESS.md        the current version's spec and build log
STACK.md, CLAUDE.md         stack packs and conventions

Generated files

Path	Generated by
backend/openapi/api.json	dotnet build src/Aide.Api
frontend/src/api/generated/	npm run gen:api

Commit both. Never hand-edit them. CI fails if they differ from what is committed.