Seeded INTENT.md and stuff

SCOPE.md

@@ -0,0 +1,38 @@
+# SCOPE
+
+> This file was generated by `statehub register`. Refine it as the repository
+> boundaries become clearer.
+
+## One-liner
+
+DirektVermittlungDe is a document-centric platform that routes citizens' documents or reference numbers (Aktenzeichen) directly to the responsible German authority caseworker and opens a communication thread, replacing manual phone-routing hunts.
+
+## Core Idea
+
+direkt-vermittlung-de exists to provide the capability described in INTENT.md.
+
+## In Scope
+
+- Document/reference-number intake and metadata-based routing to the responsible authority unit
+- Citizen-official communication threads (text chat, callback requests, appointment scheduling)
+- Stateless OAuth2/JWT authentication with citizen/official scopes
+- Async data export workflow for authority systems
+- GDPR-compliant document/thread retention and TTL cleanup
+- Migration from prototype implementations to a unified, TDD-driven /src production codebase
+
+## Out of Scope
+
+- Decrypting or otherwise processing encrypted document payload contents in the main backend service
+- General-purpose CRM/ticketing functionality unrelated to authority-citizen routing
+- Non-government (private sector) support-routing use cases
+- Maintaining the prototype-* directories as live code (archived reference only)
+
+## Current State
+
+- Pre-production: three parallel prototypes (chatgpt5, geminiNbt3pro, grok4.1) exist under /prototype-*; no unified /src codebase yet. Architecture is documented via 8 ADRs and a migration workplan, but the target production codebase has not been started.
+
+## Getting Oriented
+
+- Start with: INTENT.md
+- Agent instructions: AGENTS.md
+- Workplans: workplans/