Initial commit: SWOOSH bootstrap with statechart spec, OpenAPI, ADRs, and ops harnesses

README.DEV.md

@@ -0,0 +1,12 @@
+# Developer Guide
+
+## Running Locally (skeleton)
+- Validate specs: `npm i -g @stoplight/spectral` then `spectral lint api/openapi.yaml`
+- Lint YAML: `yamllint .`
+- Inspect statechart: open `docs/statechart.yaml` in your visualizer of choice.
+
+## Next Steps
+- Implement reducer skeleton in Go/Rust.
+- Add WAL adapter (Badger/RocksDB) and snapshotting.
+- Implement HLC lib + HMMM signer verification.
+- Build transition guard providers (BACKBEAT, policy engine, health probes).