Merge pull request #1795 from gkaria/docupdates

docs: add explicit CALM validation instructions to chat mode

Author: markscott-ms

calm-ai/tools/architecture-creation.md

@@ -38,7 +38,13 @@ Every CALM architecture MUST include:
 - [ ] Add nodes array (even if empty initially)
 - [ ] Add relationships array to connect nodes
 - [ ] Include metadata array for operational info
-- [ ] Validate against CALM schema before saving
+**🚨 MANDATORY VALIDATION (Do not skip):**
+- [ ] **Verify calm-cli is installed:** `which calm`
+- [ ] **Run CALM validation:** `calm validate -a <filename>.architecture.json`
+- [ ] **Review output for errors:** `jsonSchemaValidationOutputs`, `spectralSchemaValidationOutputs`
+- [ ] **Fix ALL errors before proceeding** - Do not assume JSON validity equals CALM validity
+- [ ] **Confirm output shows:** `"hasErrors": false, "hasWarnings": false`
+- [ ] **Document any warnings addressed**
 
 ## Best Practices