Merge pull request #2043 from jimthompson5802/iss-2038-enable-claude-ai-suppor

feat(calm-cli, calm-ai): Add support for AI Assistant support for Claude Code

Author: markscott-ms

calm-ai/README.md

@@ -0,0 +1,21 @@
+{
+    "description": "Claude Code integrated with FINOS CALM",
+    "topLevelDirectory": ".claude/skills/calm",
+    "topLevelPromptFileName": "SKILL.md",
+    "skillPrefix": "`",
+    "skillSuffix": "`",
+    "frontmatter": "---\nname: calm\ndescription: An AI Assistant for FINOS CALM development.\nuser-invocable: true\n---",
+    "skillPrompts": [
+        "calm-prompts/architecture-creation.md",
+        "calm-prompts/calm-cli-instructions.md",
+        "calm-prompts/node-creation.md",
+        "calm-prompts/relationship-creation.md",
+        "calm-prompts/interface-creation.md",
+        "calm-prompts/metadata-creation.md",
+        "calm-prompts/control-creation.md",
+        "calm-prompts/flow-creation.md",
+        "calm-prompts/pattern-creation.md",
+        "calm-prompts/documentation-creation.md",
+        "calm-prompts/standards-creation.md"
+    ]
+}

calm-ai/ai-assistants/claude.json

@@ -1,11 +1,11 @@
 {
     "description": "Github Copilot integrated with FINOS CALM",
     "topLevelDirectory": ".github/chatmodes",
-    "topLevelPromptDirectory": "",
-    "skill-prefix": "`",
-    "skill-suffix": "`",
+    "topLevelPromptFileName": "CALM.chatmode.md",
+    "skillPrefix": "`",
+    "skillSuffix": "`",
     "frontmatter": "---\ndescription: An AI Assistant for FINOS CALM development.\ntools: ['codebase', 'editFiles', 'fetch', 'runInTerminal']\nmodel: Claude Sonnet 4.5\n---",
-    "skill-prompts": [
+    "skillPrompts": [
         "calm-prompts/architecture-creation.md",
         "calm-prompts/calm-cli-instructions.md",
         "calm-prompts/node-creation.md",

calm-ai/ai-assistants/copilot.json

@@ -2,10 +2,10 @@
     "description": "AWS Kiro/Q integrated with FINOS CALM",
     "frontmatter": "---\ninclusion: manual\n---",
     "topLevelDirectory": ".kiro",
-    "topLevelPromptDirectory": "steering",
-    "skill-prefix": "#[[",
-    "skill-suffix": "]]",
-    "skill-prompts": [
+    "topLevelPromptFileName": "steering/CALM.chatmode.md",
+    "skillPrefix": "#[[",
+    "skillSuffix": "]]",
+    "skillPrompts": [
         "calm-prompts/architecture-creation.md",
         "calm-prompts/calm-cli-instructions.md",
         "calm-prompts/node-creation.md",

calm-ai/ai-assistants/kiro.json

@@ -32,8 +32,8 @@ On your first prompt in each session, you MUST:
 
 1. Display: "Loading FINOS CALM instructions..."
 2. Read these tool prompt files to understand current CALM guidance:
-    {{#each skill-prompts}}
-    - {{{../skill-prefix}}}{{../topLevelDirectory}}/{{{this}}}{{{../skill-suffix}}}
+    {{#each skillPrompts}}
+    - {{{../skillPrefix}}}{{../topLevelDirectory}}/{{{this}}}{{{../skillSuffix}}}
     {{/each}}
 
 3. After reading the prompts, confirm you're ready to assist with CALM architectures.

calm-ai/templates/CALM.chatmode_template.md

@@ -130,7 +130,7 @@ Configure CALM-specific AI assistance inside a repo:
 calm init-ai -p <provider> [--directory <path>] [--verbose]
 ```
 
-At present Github Copilot (`copilot`) and AWS Kiro (`kiro`) are supported as providers.
+At present Github Copilot (`copilot`), AWS Kiro (`kiro`), and Claude Code (`claude`) are supported as providers.
 
 This generates custom prompts for the specified <provider> to use CALM-aware tools (nodes, relationships, interfaces, controls, flows, patterns, metadata).
 

calm-ai/tools/calm-cli-instructions.md

@@ -52,6 +52,23 @@ There are currently two types of tests;
 - `cli` tests - these are end-to-end and involve linking the package as part of the test so that we can assert on actual `calm X` invocations.
 - `shared` tests - these are where the core logic tests live, like how validation behaves etc.
 
+### Local verification of new CLI version
+
+```shell
+$ cd cli
+
+# create local distribution package in /tmp directory
+$ npm pack --pack-destination /tmp
+
+# install from the local distribution package.
+# Note: this will replace an existing calm cli install in the global area
+$ npm install -g /tmp/finos-calm-cli-<version-identifier>.tgz
+
+# run manual verfication of the new version, e.g,.
+#   calm --help
+#   calm init-ai --help
+```
+
 ## Releasing the CLI
 
 The CLI uses **semantic-release** for automated releases. Version management follows these principles:

cli/DEVELOPER_GUIDE.md

@@ -32,6 +32,11 @@ const TEMPLATE_DIR_OPTION = '-d, --template-dir <path>';
 const URL_MAPPING_OPTION = '-u, --url-to-local-file-mapping <path>';
 const CLEAR_OUTPUT_DIRECTORY_OPTION = '--clear-output-directory';
 
+// init-ai command options
+const AI_DIRECTORY_OPTION = '-d, --directory <path>';
+const AI_PROVIDER_OPTION = '-p, --provider <provider>';
+const AI_PROVIDER_CHOICES = ['copilot', 'kiro', 'claude'];
+
 export function setupCLI(program: Command) {
     program
         .name('calm')
@@ -228,18 +233,18 @@ export function setupCLI(program: Command) {
             await setupAiTools('copilot', options.directory, !!options.verbose);
         });
 
-    const providerOption = new Option('-p, --provider <provider>', 'AI provider to initialize')
-        .choices(['copilot', 'kiro']);
+    const providerOption = new Option(AI_PROVIDER_OPTION, 'AI provider to initialize')
+        .choices(AI_PROVIDER_CHOICES);
 
     program
         .command('init-ai')
         .description('Augment a git repository with AI assistance for CALM')
         .addOption(providerOption)
-        .option('-d, --directory <path>', 'Target directory (defaults to current directory)', '.')
+        .option(AI_DIRECTORY_OPTION, 'Target directory (defaults to current directory)', '.')
         .option(VERBOSE_OPTION, 'Enable verbose logging.', false)
         .action(async (options) => {
             const { setupAiTools } = await import('./command-helpers/ai-tools');
-            const providers = (providerOption as Option & { argChoices?: string[] }).argChoices ?? [];
+            const providers = AI_PROVIDER_CHOICES;
             let selectedProvider: string = options.provider;
             if (!selectedProvider) {
                 const answer = await inquirer.prompt({