Set up Core Hub framework planning

.claude/rules/stack-and-commands.md

@@ -1,27 +1,36 @@
 ## Stack
 
-- **Language:** Markdown-first registry and planning repo (no application runtime yet)
-- **Key deps:** State Hub ADR-001 workplans, `registry/indexes/capabilities.yaml`
+Current repo state: Markdown/specification-first planning repo. Implementation workplans target the following stack once source code is added:
+
+- Python 3.12
+- FastAPI, Pydantic v2
+- SQLAlchemy async, Alembic, asyncpg, Postgres
+- httpx for service clients
+- pytest for unit, API, contract, and migration tests
+- OpenAPI and JSON Schema for public contracts
+- whynot-design aligned UI components/adapters where operator UI is needed
 
 ## Dev Commands
 
 ```bash
-# Orient (offline-safe)
+# Orient
 cat .custodian-brief.md
-cat README.md
+cat INTENT.md
 cat SCOPE.md
 ls workplans/
 
-# Consumer bootstrap docs
-cat docs/statehub-register.md
-cat docs/template-validation-checklist.md
+# Review core docs
+cat docs/specs/README.md
+cat docs/research/2026-06-27-core-hub-lineage-and-platform-reset.md
 
-# After workplan or registry edits — from ~/state-hub
-make fix-consistency REPO=repo-seed
+# After workplan edits, from ~/state-hub
+make fix-consistency REPO=core-hub
 
-# Validate registry entries (from reuse-surface checkout)
-reuse-surface validate --root .
-
-# Sanity-check markdown / registry edits
+# Sanity-check markdown/registry edits
 git diff --check
+
+# Registry validation, from a checkout with reuse-surface CLI available
+reuse-surface validate --root .
 ```
+
+Add concrete `install`, `test`, `lint`, `build`, and `run` commands in this file when the FastAPI implementation lands.