Start Core Hub FastAPI replacement foundation

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

@@ -1,12 +1,12 @@
 ## Stack
 
-Current repo state: Markdown/specification-first planning repo. Implementation workplans target the following stack once source code is added:
+Core Hub now has a runnable FastAPI foundation.
 
 - Python 3.12
 - FastAPI, Pydantic v2
 - SQLAlchemy async, Alembic, asyncpg, Postgres
-- httpx for service clients
-- pytest for unit, API, contract, and migration tests
+- httpx and uvicorn for HTTP/runtime support
+- pytest and ruff for verification
 - OpenAPI and JSON Schema for public contracts
 - whynot-design aligned UI components/adapters where operator UI is needed
 
@@ -19,6 +19,19 @@ cat INTENT.md
 cat SCOPE.md
 ls workplans/
 
+# Install/sync dependencies
+make install
+
+# Verify implementation
+make test
+make lint
+
+# Run locally
+make run
+
+# Regenerate OpenAPI snapshot
+make openapi
+
 # Review core docs
 cat docs/specs/README.md
 cat docs/research/2026-06-27-core-hub-lineage-and-platform-reset.md
@@ -26,11 +39,9 @@ cat docs/research/2026-06-27-core-hub-lineage-and-platform-reset.md
 # After workplan edits, from ~/state-hub
 make fix-consistency REPO=core-hub
 
-# Sanity-check markdown/registry edits
+# Sanity-check markdown/registry/code 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.