Merge pull request #2018 from rocketstack-matt/feat/docs-learning-navigation

Integrate Advent of CALM into core docs

Author: rocketstack-matt

.gitignore

@@ -1,5 +1,8 @@
 .DS_Store
 
+# Sandbox folder for AI agent working files (not for check-in)
+/sandbox/
+
 # Docusaurus generated folders
 website/translated_docs/
 website/build/

AGENTS.md

@@ -1,5 +1,22 @@
 # FINOS CALM Monorepo - AI Assistant Guide
 
+## Sandbox Folder for Working Files
+
+**IMPORTANT:** Use the `/sandbox/` folder for all temporary working files, test outputs, notes, and drafts.
+
+- The `sandbox/` folder is in `.gitignore` and will not be committed
+- Store test plans, results, TODO lists, and exploration notes here
+- Do NOT create working files in other directories (they may accidentally be committed)
+- Clean up the sandbox when work is complete if appropriate
+
+```bash
+# Example: Create working files in sandbox
+mkdir -p sandbox
+echo "My notes" > sandbox/my-notes.md
+```
+
+---
+
 ## Project Overview
 
 This is the **FINOS Architecture as Code** monorepo containing the Common Architecture Language Model (CALM) specification and associated tools.

calm-ai/README.md

@@ -40,7 +40,7 @@ Tool prompts should:
 
 - Include critical validation requirements
 - Provide working examples
-- Reference CALM schema v1.0
+- Reference CALM schema v1.1
 - Emphasize common pitfalls and solutions
 - Follow consistent markdown formatting
 

calm-ai/templates/CALM.chatmode_template.md

@@ -21,7 +21,7 @@ CALM enables modeling of:
 
 You specialize in helping users create, modify, and understand CALM architecture models. You have deep knowledge of:
 
-- CALM schema validation requirements (release/1.0)
+- CALM schema validation requirements (release/1.1)
 - Best practices for architecture modeling
 - JSON schema constraints and validation rules
 - VSCode integration and tooling
@@ -40,7 +40,7 @@ On your first prompt in each session, you MUST:
 
 ## Guidelines
 
-- Always validate CALM models against the 1.0 schema
+- Always validate CALM models against the 1.1 schema
 - Provide specific, actionable guidance for schema compliance
 - Reference the tool prompts for detailed creation instructions
 - Use examples that follow CALM best practices

calm-ai/tools/architecture-creation.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-This guide provides instructions for creating complete CALM architecture documents that comply with the FINOS CALM v1.0 schema.
+This guide provides instructions for creating complete CALM architecture documents that comply with the FINOS CALM v1.1 schema.
 
 ## Required Schema Structure
 
@@ -31,7 +31,7 @@ Every CALM architecture MUST include:
 
 ## Architecture Creation Checklist
 
-- [ ] Include required $schema reference to CALM v1.0
+- [ ] Include required $schema reference to CALM v1.1
 - [ ] Provide unique-id (kebab-case recommended)
 - [ ] Add descriptive name and description
 - [ ] Name file with `.architecture.json` suffix

calm-ai/tools/control-creation.md

@@ -6,7 +6,7 @@
 
 ## Official JSON Schema Definition
 
-The complete control schema from the FINOS CALM v1.0 specification:
+The complete control schema from the FINOS CALM v1.1 specification:
 
 ```json
 {

calm-ai/tools/flow-creation.md

@@ -6,7 +6,7 @@
 
 ## Official JSON Schema Definition
 
-The complete flow schema from the FINOS CALM v1.0 specification:
+The complete flow schema from the FINOS CALM v1.1 specification:
 
 ```json
 {

calm-ai/tools/interface-creation.md

@@ -6,7 +6,7 @@
 
 ## Official JSON Schema Definition
 
-The complete interface schema from the FINOS CALM v1.0 specification:
+The complete interface schema from the FINOS CALM v1.1 specification:
 
 ```json
 {
@@ -199,4 +199,5 @@ Use **interface-type** when:
 2. Include all required properties for chosen type
 3. Port values must be integers, not strings
 4. URLs must be valid format
-5. No additional properties beyond those defined
+5. For `interface-definition`: no additional properties beyond `unique-id`, `definition-url`, and `config`
+6. For `interface-type`: any additional properties are allowed beyond `unique-id`

calm-ai/tools/metadata-creation.md

@@ -6,7 +6,7 @@
 
 ## Official JSON Schema Definition
 
-The complete metadata schema from the FINOS CALM v1.0 specification:
+The complete metadata schema from the FINOS CALM v1.1 specification:
 
 ```json
 {

calm-ai/tools/node-creation.md

@@ -19,7 +19,7 @@ Nodes represent the "boxes" in a typical architecture diagram and are the fundam
 
 ## Official JSON Schema Definition
 
-The complete node schema from the FINOS CALM v1.0 specification:
+The complete node schema from the FINOS CALM v1.1 specification:
 
 ```json
 {