# Sauci documentation

This index separates maintained operational truth from implementation plans and
historical notes. Agents should load only the section relevant to their task.

## Maintained system documentation

- [System architecture](architecture/system.md)
- [Client data freshness](architecture/client-data-freshness.md)
- [Local full-stack development](development/local-stack.md)
- [Dependency and lockfile discipline](development/dependencies.md)
- [Testing strategy](testing/strategy.md)
- [Database migration safety](operations/database-migrations.md)
- [Backend deployment and branching](operations/backend-deployments.md)
- [Website deployment](operations/web-deployments.md)
- [Agent routing and effort](agents/routing.md)
- [Learning promotion](agents/learnings.md)
- [Authentication](authentication.md)
- [Database schema](schema.md)
- [Couple pairing](couple-pairing.md)
- [Couple streaks](couple-streaks.md)
- [Question selection](question-selection.md)
- [Question interaction types](question-types.md)
- [Match notifications](match-notifications.md)
- [Subscriptions](subscription-system.md)
- [Redemption codes](product/redemption.md)
- [Mobile release process](releasing.md)
- [Mobile over-the-air updates](mobile-ota.md)
- [Dares loop](dares-loop.md)
- [Couples quiz](quiz.md)

## Feature and implementation references

These contain useful history and acceptance details, but may describe planned or
partially implemented states. Confirm claims against current code.

- `admin-question-types-plan.md`
- [Universal catalogue safety plan](product/catalog-content-safety-plan.md)
- `content-balance-implementation.md`
- `dares-feature.md` (superseded by [Dares loop](dares-loop.md))
- `live-draw-feature-plan.md`
- `NEW_QUESTION_TYPES.md`
- `oversized-file-inventory.md`
- `pack-icons-admin-first.md`
- `data-retrieval-tasks.md`
- `release-notes.md`