Merge pull request #2118 from markscott-ms/bye-bye-chatmode

Replace Copilot Chatmode with Copilot Agent

Author: markscott-ms

.gitignore

@@ -45,4 +45,5 @@ node_modules/
 coverage/
 /cli/test/template-bundles/
 .github/chatmodes
+.github/agents
 shared/test-output/

AGENTS.md

@@ -33,7 +33,7 @@ architecture-as-code/
 ├── calm-plugins/vscode/       # VSCode extension
 ├── calm-models/               # TypeScript data models
 ├── calm-widgets/              # React visualization components
-├── calm-ai/                   # AI chatmode tools & prompts
+├── calm-ai/                   # AI agent tools & prompts
 ├── shared/                    # Shared TypeScript utilities
 ├── docs/                      # Docusaurus documentation site
 ├── advent-of-calm/            # Educational content (24-day challenge)

advent-of-calm/AGENTS.md

@@ -43,7 +43,7 @@ advent-of-calm/
 
 **Week 2 (Days 8-14): Controls, Flows & AI-Assisted Operations**
 - Days 8-10: Controls (security), ADRs, Flows (business processes)
-- Days 11-14: AI integration (chatmode, analysis, documentation generation)
+- Days 11-14: AI integration (agent, analysis, documentation generation)
 - Outcome: Governed architecture with AI-assisted workflows
 
 **Week 3 (Days 15-18): Patterns & Automation**
@@ -102,7 +102,7 @@ Questions to consolidate learning
 
 ### AI-First Approach
 - GitHub Copilot integration starts Day 1
-- CALM chatmode introduced Day 11
+- CALM agent introduced Day 11
 - AI used for generation, validation, and documentation
 - Teaches both CALM and AI-assisted workflows
 

advent-of-calm/day-1.md

@@ -74,12 +74,12 @@ This directory will contain CALM patterns for architectural governance.
 Generated documentation from CALM models.
 ```
 
-### 5. Enable AI Assistance with Copilot Chatmode
+### 5. Enable AI Assistance with Copilot Agent
 ```bash
-calm copilot-chatmode -d .
+calm init-ai -p copilot -d .
 ```
 
-This creates `.github/chatmodes/CALM.chatmode.md` with specialized CALM knowledge for GitHub Copilot.
+This creates `.github/agents/CALM.agent.md` with specialized CALM knowledge for GitHub Copilot.
 
 ### 6. Add a .gitignore
 Create `.gitignore`:
@@ -118,7 +118,7 @@ Your Day 1 submission should include a commit tagged `day-1` containing:
 
 ✅ **Required Files:**
 - `README.md` - Project introduction with progress checklist
-- `.github/chatmodes/CALM.chatmode.md` - Copilot configuration
+- `.github/agents/CALM.agent.md` - Copilot configuration
 - `.gitignore` - Basic ignore patterns
 - `architectures/` - Empty directory (ready for Day 2)
 - `patterns/` - Empty directory
@@ -129,8 +129,8 @@ Your Day 1 submission should include a commit tagged `day-1` containing:
 # Test CALM CLI is installed
 calm --version
 
-# Verify chatmode file exists and contains CALM schema guidance
-test -f .github/chatmodes/CALM.chatmode.md && grep -q "CALM" .github/chatmodes/CALM.chatmode.md
+# Verify agent file exists and contains CALM schema guidance
+test -f .github/agents/CALM.agent.md && grep -q "CALM" .github/agents/CALM.agent.md
 
 # Check git tag exists
 git tag | grep -q "day-1"
@@ -142,7 +142,7 @@ git tag | grep -q "day-1"
 - [GitHub Copilot Chat](https://docs.github.com/en/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide)
 
 ## Tips
-- If you don't have GitHub Copilot access, the chatmode file is still useful as documentation for you to reference
+- If you don't have GitHub Copilot access, the agent file is still useful as documentation for you to reference
 - Use descriptive commit messages - they tell the story of your learning
 - Consider making your repository public to inspire others
 - Tag each day's work (`day-1`, `day-2`, etc.) to create clear milestones

advent-of-calm/day-15.md

@@ -301,4 +301,4 @@ git tag | grep -q "day-15"
 
 ## Next Steps
 
-Tomorrow (Day 16) you'll use docify to generate operations documentation - runbooks, on-call guides, and incident report templates from your architecture metadata! This shows how the CALM Chatmode and documentation capabilities of CALM all work from the same source of truth, your CALM architecture! 
+Tomorrow (Day 16) you'll use docify to generate operations documentation - runbooks, on-call guides, and incident report templates from your architecture metadata! This shows how the CALM Agent and documentation capabilities of CALM all work from the same source of truth, your CALM architecture! 

advent-of-calm/day-17.md

@@ -336,7 +336,7 @@ git tag | grep -q "day-17"
 - Test both generation AND validation to ensure the pattern works
 
 ## Trouble Shooting
-- Remember AI can make mistakes, if for some reason your pattern won't generate a valid architecture ask CALM Chatmode to figure out why not, this prompt may be helpful.
+- Remember AI can make mistakes, if for some reason your pattern won't generate a valid architecture ask CALM Agent to figure out why not, this prompt may be helpful.
 
 ```text
 My pattern doesn't generate a valid architecture when I run the generate command, look at this valid pattern - https://raw.githubusercontent.com/finos/architecture-as-code/refs/heads/main/conferences/osff-ln-2025/workshop/conference-signup.pattern.json - identify the problem. 

advent-of-calm/day-18.md

@@ -1,12 +1,5 @@
 # Day 18: Using Standards for Your Organization
 
-## ATTENTION
-
-Please ensure you are using the latest version of the CALM CLI and reran `calm copilot-chatmode` to update your repositories chatmode files.
-A bug exists in Chatmode instructions for CLI <= 1.24.0 where the CALM Schema
-URL in the $ref attribute is incorrect. It should refer to
-`https://calm.finos.org/release/1.1/meta/core.json`.
-
 ## Overview
 Learn how CALM Standards extend the flexible core schema with your organization's specific requirements, enabling consistent governance across all architectures.
 
@@ -62,7 +55,7 @@ Standards extend core CALM definitions using `allOf` composition:
 
 This says: "A node using this Standard must satisfy BOTH the core CALM node requirements AND our additional properties."
 
-Please ensure the URL in the `$ref` property is correct. If not, you may need to update your CLI and Copilot Chatmode instructions.
+Please ensure the URL in the `$ref` property is correct. If not, you may need to update your CLI and Copilot Agent instructions.
 
 ### 4. Explore Common Use Cases
 

advent-of-calm/day-2.md

@@ -1,11 +1,11 @@
 # Day 2: Create Your First Node
 
 ## Overview
-Use the CALM chatmode you configured on Day 1 to create your first architecture file with AI assistance.
+Use the CALM agent you configured on Day 1 to create your first architecture file with AI assistance.
 
 ## Objective and Rationale
-- **Objective:** Create a valid CALM architecture JSON file containing a single node using GitHub Copilot and the CALM chatmode
-- **Rationale:** Learn to leverage AI for architecture authoring. The chatmode you installed provides Copilot with deep CALM schema knowledge, making it an expert assistant. This teaches both CALM concepts AND effective AI-powered workflows.
+- **Objective:** Create a valid CALM architecture JSON file containing a single node using GitHub Copilot and the CALM agent
+- **Rationale:** Learn to leverage AI for architecture authoring. The agent you installed provides Copilot with deep CALM schema knowledge, making it an expert assistant. This teaches both CALM concepts AND effective AI-powered workflows.
 
 ## Requirements
 
@@ -24,15 +24,15 @@ A **node** in CALM represents a distinct architectural component. CALM provides
 
 **Custom node types:** You can define your own node types (e.g., "message-queue", "cache", "api-gateway") to better represent components specific to your architecture.
 
-### 2. Open the CALM Chatmode in VSCode
+### 2. Open the CALM Agent in VSCode
 
 1. Open your `advent-of-calm-2025` repository in VSCode
 2. Open the Copilot Chat panel:
    - **Windows/Linux**: `Ctrl+Alt+I` or click the chat icon in the sidebar
    - **Mac**: `Cmd+Shift+I` or click the chat icon in the sidebar
-3. **Select the CALM chatmode** to maintain context across multiple prompts:
-   - Click the chatmode selector dropdown in the chat panel (it shows "General Purpose" by default)
-   - Select **"CALM"** from the list of available chatmodes
+3. **Select the CALM agent** to maintain context across multiple prompts:
+   - Click the agent selector dropdown in the chat panel (it shows "Agent" by default)
+   - Select **"CALM"** from the list of available agents
    - The chat panel will now show "CALM" as the active mode
    - This keeps you in CALM mode for all subsequent prompts in this conversation
 
@@ -133,8 +133,8 @@ git tag | grep -q "day-2"
 - [GitHub Copilot Chat Documentation](https://docs.github.com/en/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide)
 
 ## Tips
-- The chatmode makes Copilot a CALM expert - use it liberally!
-- **Remember to select the CALM chatmode** from the dropdown to maintain conversation context across multiple prompts
+- The agent makes Copilot a CALM expert - use it liberally!
+- **Remember to select the CALM agent** from the dropdown to maintain conversation context across multiple prompts
 - If you don't have Copilot access, you can manually create the file following this structure:
   ```json
   {
@@ -151,13 +151,13 @@ git tag | grep -q "day-2"
   }
   ```
 - Ask Copilot follow-up questions if you don't understand something
-- Use the CALM chatmode selector to stay in CALM mode across all your prompts
+- Use the CALM agent selector to stay in CALM mode across all your prompts
 
 ## Troubleshooting
 
-**"I don't see CALM in the chatmode list"**
-- Make sure you ran `calm copilot-chatmode -d .` on Day 1
-- Check that `.github/chatmodes/CALM.chatmode.md` exists
+**"I don't see CALM in the agent list"**
+- Make sure you ran `calm init-ai -p copilot -d .` on Day 1
+- Check that `.github/agents/CALM.agent.md` exists
 - Restart VSCode and try again
 
 **"Copilot generated an invalid file"**
@@ -167,7 +167,7 @@ git tag | grep -q "day-2"
 
 **"I don't have GitHub Copilot"**
 - You can manually create the file using the example structure above
-- The chatmode file itself is good documentation you can reference
+- The agent file itself is good documentation you can reference
 - Consider this a prompt for what you need to create
 
 ## Next Steps

advent-of-calm/setup.md

@@ -63,39 +63,39 @@ If auto-update is disabled, you can manually update:
 3. Click the gear icon and select "Check for Updates"
 4. Click "Update" if available
 
-## CALM Copilot Chatmode
+## CALM Copilot Agent
 
-The CALM Copilot Chatmode enhances GitHub Copilot with deep knowledge of the CALM specification, making it an expert assistant for architecture authoring.
+The CALM Copilot Agent enhances GitHub Copilot with deep knowledge of the CALM specification, making it an expert assistant for architecture authoring.
 
-### What is a Chatmode?
+### What is an Agent?
 
-Chatmodes are specialized configurations for GitHub Copilot Chat that provide domain-specific expertise. The CALM chatmode includes:
+Agents are specialized configurations for GitHub Copilot Chat that provide domain-specific expertise. The CALM agent includes:
 - Complete CALM schema knowledge
 - Best practices for architecture modeling
 - Examples and patterns
 
-### Install or Update the Chatmode
+### Install or Update the Agent
 
-Use the CALM CLI to install or update the chatmode:
+Use the CALM CLI to install or update the agent:
 
 ```bash
-calm copilot-chatmode
+calm init-ai -p copilot
 ```
 
 This command will:
 - Create or update `.github/copilot-instructions.md` in your repository
-- Download the latest chatmode configuration from the CALM project
+- Download the latest agent configuration from the CALM project
 - Ensure you have the most up-to-date CALM expertise for Copilot
 
 ### Apply the Update
 
-After installing or updating the chatmode:
+After installing or updating the agent:
 
 1. **Start a new Copilot Chat session** in VS Code
    - Close any existing chat panels
    - Open a fresh chat session (click the Copilot chat icon or use `Cmd+Shift+I` / `Ctrl+Shift+I`)
 
-2. The updated chatmode will be active in your new chat session
+2. The updated agent will be active in your new chat session
 
 **Note:** You don't need to restart VS Code - just start a new chat session!
 
@@ -128,12 +128,12 @@ If the extension isn't working properly:
 3. Uninstall and reinstall the extension
 4. Check the Output panel (View → Output → select "CALM" from dropdown)
 
-### Chatmode Issues
+### Agent Issues
 
-If Copilot doesn't seem to be using the chatmode:
+If Copilot doesn't seem to be using the agent:
 
-1. Verify `.github/copilot-instructions.md` exists in your repository root
-2. Run `calm copilot-chatmode` to ensure it's up to date
+1. Verify `.github/agents/CALM.agent.md` exists in your repository root
+2. Run `calm init-ai` to ensure it's up to date
 3. Start a completely new chat session (close and reopen)
 4. Ensure GitHub Copilot is active (check status bar)
 5. Make sure you're chatting from within your repository directory

advent-of-calm/website/src/pages/setup.astro

@@ -9,7 +9,7 @@ if (!entry) {
 const { Content } = await entry.render();
 ---
 
-<Layout title="Setup - Keeping Your CALM Tools Up to Date" description="Learn how to keep your CALM CLI, VS Code Extension, and Copilot Chatmode up to date">
+<Layout title="Setup - Keeping Your CALM Tools Up to Date" description="Learn how to keep your CALM CLI, VS Code Extension, and Copilot Agent up to date">
   <nav class="day-nav">
     <div class="nav-center">
       <a href={import.meta.env.BASE_URL} class="nav-button home">Back to Calendar</a>