docs: add QUICK_REF + workflow OS + 2026Q1 roadmap

docs/WORKFLOWS/ANALYZE.md

@@ -0,0 +1,11 @@
+# Workflow: ANALYZE
+
+_Last updated: 2026-01-29 (Mario)_
+
+## Goal
+Explore results + generate insights.
+
+## UI
+- Results overview
+- Insights bank (generate HTML artifacts)
+- Claude-assisted interpretation

docs/WORKFLOWS/CREATE.md

@@ -0,0 +1,26 @@
+# Workflow: CREATE (Study Creation)
+
+_Last updated: 2026-01-29 (Mario)_
+
+## Goal
+Create a new study via the **Create Wizard**:
+
+Files → Introspection → Context → Draft → Interview → Validate → Publish
+
+## Source of truth
+- Draft spec (local): browser storage
+- Published spec: `atomizer_spec.json`
+
+## Outputs required (DoD)
+- `atomizer_spec.json` (published)
+- `README.md` (auto-generated)
+- Study folder structure created
+
+## Key rules
+- Don’t ask user for info we can introspect.
+- Ask only gap questions.
+- Canvas is validation (gimmick), not the authoring source.
+
+## See also
+- PKM: TECH-SPEC-Create-Wizard-Blueprint
+- PKM: TECH-SPEC-Canvas-Study-Sync

docs/WORKFLOWS/DELIVER.md

@@ -0,0 +1,13 @@
+# Workflow: DELIVER
+
+_Last updated: 2026-01-29 (Mario)_
+
+## Goal
+Package everything for client delivery:
+- report
+- optimized model files
+- optional insights html bundle
+- optional DB/logs
+
+## Also
+Archive study + capture learnings in LAC.

docs/WORKFLOWS/REPORT.md

@@ -0,0 +1,12 @@
+# Workflow: REPORT
+
+_Last updated: 2026-01-29 (Mario)_
+
+## Goal
+Generate client-ready artifacts:
+- Markdown
+- HTML
+- PDF (Atomizer branded template)
+
+## Notes
+Report generation should be deterministic, with Claude optional for narrative additions.

docs/WORKFLOWS/RUN.md

@@ -0,0 +1,16 @@
+# Workflow: RUN
+
+_Last updated: 2026-01-29 (Mario)_
+
+## Goal
+Start and reliably track long-running optimizations.
+
+## Requirements
+- Published `atomizer_spec.json`
+- Backend can start/stop processes safely
+
+## UI
+- Live status + progress
+- Convergence
+- Best trial summary
+- Safe stop

docs/WORKFLOWS/VALIDATE.md

@@ -0,0 +1,20 @@
+# Workflow: VALIDATE
+
+_Last updated: 2026-01-29 (Mario)_
+
+## Goal
+Give the user confidence that the study will run correctly:
+- correct model chain
+- DV bounds sane
+- objectives/constraints correctly sourced
+- spec is runnable
+
+## Primary UI
+- Checklist + Parameters table
+
+## Secondary UI
+- Canvas visualization
+
+## Outputs
+- Validation report (errors/warnings)
+- "Ready to Run" state