chore(harness): make repository agent-ready

Add concise routed context, task-aware agent roles, focused skills, and structured learning promotion.\n\nUnify local development and workspace tooling, add layered test and E2E verification, harden MCP authentication, and gate deployment behind verification and explicit production promotion.

docs/index.md

@@ -0,0 +1,36 @@
+# 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)
+- [Local full-stack development](development/local-stack.md)
+- [Testing strategy](testing/strategy.md)
+- [Database migration safety](operations/database-migrations.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)
+- [Question selection](question-selection.md)
+- [Match notifications](match-notifications.md)
+- [Subscriptions](subscription-system.md)
+- [Redemption codes](product/redemption.md)
+- [Mobile release process](releasing.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`
+- `content-balance-implementation.md`
+- `dares-feature.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`