From 9d731d5a7f337c4bb78e066f3aa860dbe68da5e7 Mon Sep 17 00:00:00 2001
From: tegwick <bernd.worsch@gmail.com>
Date: Wed, 8 Jul 2026 15:07:23 +0200
Subject: [PATCH] Complete State Hub bootstrap (DVD-WP-0001); add DVD-WP-0002

---
 .claude/rules/stack-and-commands.md           | 20 +++++++-------
 SCOPE.md                                      |  3 +--
 workplans/DVD-WP-0001-statehub-bootstrap.md   | 14 +++++++---
 .../DVD-WP-0002-main-codebase-tdd-kickoff.md  | 26 +++++++++++++++++++
 4 files changed, 47 insertions(+), 16 deletions(-)
 create mode 100644 workplans/DVD-WP-0002-main-codebase-tdd-kickoff.md

diff --git a/.claude/rules/stack-and-commands.md b/.claude/rules/stack-and-commands.md
index dc53ac6..fc1a228 100644
--- a/.claude/rules/stack-and-commands.md
+++ b/.claude/rules/stack-and-commands.md
@@ -1,19 +1,19 @@
 ## Stack
 
-<!-- TODO: Fill in language, frameworks, and key dependencies -->
-- **Language:**
-- **Key deps:**
+- **Language:** Python (FastAPI target under `/src`; prototypes in `/prototype-*`)
+- **Key deps:** See `prototype-chatgpt5/pyproject.toml` and `docs/openapi.yaml`
 
 ## Dev Commands
 
 ```bash
-# TODO: Fill in the standard commands for this repo
+# Orient on architecture and migration plan
+cat INTENT.md
+cat docs/WORKPLAN_MainCodebase_Integration.md
+ls docs/architecture/adr/
 
-# Install dependencies
+# Prototype smoke (chatgpt5 — most complete)
+cd prototype-chatgpt5 && pip install -e . && pytest -q
 
-# Run tests
-
-# Lint / type check
-
-# Build / package (if applicable)
+# After workplan edits
+statehub fix-consistency
 ```
diff --git a/SCOPE.md b/SCOPE.md
index 0939046..356d7ee 100644
--- a/SCOPE.md
+++ b/SCOPE.md
@@ -1,7 +1,6 @@
 # SCOPE
 
-> This file was generated by `statehub register`. Refine it as the repository
-> boundaries become clearer.
+> Lightweight boundary for agents and contributors.
 
 ## One-liner
 
diff --git a/workplans/DVD-WP-0001-statehub-bootstrap.md b/workplans/DVD-WP-0001-statehub-bootstrap.md
index 20133e4..9032630 100644
--- a/workplans/DVD-WP-0001-statehub-bootstrap.md
+++ b/workplans/DVD-WP-0001-statehub-bootstrap.md
@@ -4,7 +4,7 @@ type: workplan
 title: "Bootstrap State Hub integration"
 domain: government
 repo: direkt-vermittlung-de
-status: ready
+status: finished
 owner: codex
 topic_slug: personhood
 created: "2026-07-08"
@@ -20,11 +20,13 @@ DirektVermittlungDe is a document-centric platform that routes citizens' documen
 
 ```task
 id: DVD-WP-0001-T01
-status: todo
+status: done
 priority: high
 state_hub_task_id: "72635778-8c9f-4d75-839a-24c0daddeb4e"
 ```
 
+Result 2026-07-08: INTENT.md and SCOPE.md reviewed; AGENTS.md and brief confirmed.
+
 Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
 Replace generated placeholders with repo-specific facts where needed.
 
@@ -32,11 +34,13 @@ Replace generated placeholders with repo-specific facts where needed.
 
 ```task
 id: DVD-WP-0001-T02
-status: todo
+status: done
 priority: high
 state_hub_task_id: "8280145c-478b-4e61-a190-01e75ccd747d"
 ```
 
+Result 2026-07-08: Documented prototype/TDD workflow in stack-and-commands.md.
+
 Identify the repo's install, test, lint, build, and run commands. Add or refine
 those commands in the agent instructions so future coding sessions can verify
 changes confidently.
@@ -45,11 +49,13 @@ changes confidently.
 
 ```task
 id: DVD-WP-0001-T03
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "c57deaf3-8faa-4043-84f3-0ad3b057c525"
 ```
 
+Result 2026-07-08: Created DVD-WP-0002.
+
 Create the first implementation workplan for the repository's most important
 next change. After workplan file updates, run the sync locally from this repo
 checkout:
diff --git a/workplans/DVD-WP-0002-main-codebase-tdd-kickoff.md b/workplans/DVD-WP-0002-main-codebase-tdd-kickoff.md
new file mode 100644
index 0000000..d459cb9
--- /dev/null
+++ b/workplans/DVD-WP-0002-main-codebase-tdd-kickoff.md
@@ -0,0 +1,26 @@
+---
+id: DVD-WP-0002
+type: workplan
+title: "Main codebase TDD integration kickoff"
+domain: government
+repo: direkt-vermittlung-de
+status: ready
+owner: codex
+topic_slug: personhood
+created: "2026-07-08"
+updated: "2026-07-08"
+---
+
+# Main codebase TDD integration kickoff
+
+Start unified `/src` production codebase with ADR-governed TDD interfaces, consolidating chatgpt5 prototype learnings.
+
+## TDD kickoff
+
+```task
+id: DVD-WP-0002-T01
+status: todo
+priority: high
+```
+
+Create `/src` skeleton, port split-payload routing interfaces from chatgpt5 prototype, and add first failing acceptance tests per docs/WORKPLAN_MainCodebase_Integration.md.