universal-dev-standards 3.2.0 → 3.2.2-beta.1

package/README.md

@@ -273,6 +273,7 @@ Git 鉤子透過 Git Bash 運作，它包含在 Git for Windows 中。不需要
 
 | Version | Date | Changes |
 |---------|------|---------|
+| 3.2.0 | 2026-01-02 | Added: Marketplace installation support; Fixed: wildcard paths, process hanging |
 | 3.0.0 | 2025-12-30 | Published to npm, enhanced init with AI tools selection |
 | 1.0.1 | 2025-12-24 | Added: Bilingual support (English + Chinese) |
 | 1.0.0 | 2025-12-23 | Initial CLI documentation |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "3.2.0",
+  "version": "3.2.2-beta.1",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",

package/src/commands/check.js

@@ -103,18 +103,24 @@ export function checkCommand() {
   // Skills status
   console.log(chalk.cyan('Skills Status:'));
   if (manifest.skills.installed) {
-    const skillsDir = join(process.env.HOME || '', '.claude', 'skills');
-    const hasGlobalSkills = existsSync(skillsDir);
-    const hasProjectSkills = existsSync(join(projectPath, '.claude', 'skills'));
-
-    if (hasGlobalSkills || hasProjectSkills) {
-      console.log(chalk.green('  ✓ Claude Code Skills installed'));
-      if (hasGlobalSkills) console.log(chalk.gray('    Global: ~/.claude/skills/'));
-      if (hasProjectSkills) console.log(chalk.gray('    Project: .claude/skills/'));
+    if (manifest.skills.location === 'marketplace') {
+      console.log(chalk.green('  ✓ Skills installed via Plugin Marketplace'));
+      console.log(chalk.gray('    Managed by Claude Code plugin system'));
+      console.log(chalk.gray('    To verify: /plugin list'));
     } else {
-      console.log(chalk.yellow('  ⚠ Skills marked as installed but not found'));
-      console.log(chalk.gray('    Run: git clone https://github.com/AsiaOstrich/universal-dev-skills.git'));
-      console.log(chalk.gray('          cd universal-dev-skills && ./install.sh'));
+      const skillsDir = join(process.env.HOME || '', '.claude', 'skills');
+      const hasGlobalSkills = existsSync(skillsDir);
+      const hasProjectSkills = existsSync(join(projectPath, '.claude', 'skills'));
+
+      if (hasGlobalSkills || hasProjectSkills) {
+        console.log(chalk.green('  ✓ Claude Code Skills installed'));
+        if (hasGlobalSkills) console.log(chalk.gray('    Global: ~/.claude/skills/'));
+        if (hasProjectSkills) console.log(chalk.gray('    Project: .claude/skills/'));
+      } else {
+        console.log(chalk.yellow('  ⚠ Skills marked as installed but not found'));
+        console.log(chalk.gray('    Run: git clone https://github.com/AsiaOstrich/universal-dev-skills.git'));
+        console.log(chalk.gray('          cd universal-dev-skills && ./install.sh'));
+      }
     }
   } else {
     console.log(chalk.gray('  Skills not installed (using reference documents only)'));

package/src/commands/configure.js

@@ -218,4 +218,7 @@ export async function configureCommand(options) {
   }
 
   console.log();
+
+  // Exit explicitly to prevent hanging due to inquirer's readline interface
+  process.exit(0);
 }

package/src/commands/init.js

@@ -154,9 +154,12 @@ export async function initCommand(options) {
     });
 
     const useClaudeCode = aiTools.includes('claude-code');
+    const onlyClaudeCode = aiTools.length === 1 && useClaudeCode;
 
-    // STEP 4: Skills handling (only if Claude Code is selected)
-    if (useClaudeCode) {
+    // STEP 4: Skills handling (only if Claude Code is the ONLY selected tool)
+    // When other AI tools are also selected, they need full standards,
+    // so we skip the Skills prompt to avoid minimal installation affecting them
+    if (onlyClaudeCode) {
       const projectSkillsInfo = getProjectInstalledSkillsInfo(projectPath);
       const userSkillsInfo = getInstalledSkillsInfo();
       const repoInfo = getRepositoryInfo();
@@ -218,8 +221,8 @@ export async function initCommand(options) {
           skillsConfig = {
             installed: true,
             location,
-            needsInstall: true,
-            updateTargets: [location]
+            needsInstall: location !== 'marketplace', // marketplace doesn't need install via CLI
+            updateTargets: location === 'marketplace' ? [] : [location]
           };
         }
       }
@@ -353,9 +356,14 @@ export async function initCommand(options) {
   console.log(chalk.gray(`  Integrations: ${integrations.length > 0 ? integrations.join(', ') : 'none'}`));
 
   if (skillsConfig.installed) {
-    const skillsStatus = skillsConfig.needsInstall
-      ? `install/update to ${skillsConfig.location}`
-      : `using existing (${skillsConfig.location})`;
+    let skillsStatus;
+    if (skillsConfig.location === 'marketplace') {
+      skillsStatus = 'Plugin Marketplace (managed by Claude Code)';
+    } else {
+      skillsStatus = skillsConfig.needsInstall
+        ? `install/update to ${skillsConfig.location}`
+        : `using existing (${skillsConfig.location})`;
+    }
     console.log(chalk.gray(`  Skills: ${skillsStatus}`));
   }
 
@@ -543,6 +551,41 @@ export async function initCommand(options) {
     intSpinner.succeed(`Generated ${results.integrations.length} integration files`);
   }
 
+  // Generate CLAUDE.md for Claude Code if selected
+  const claudeCodeSelected = aiTools.includes('claude-code');
+  if (claudeCodeSelected && !integrationFileExists('claude-code', projectPath)) {
+    const claudeSpinner = ora('Generating CLAUDE.md...').start();
+
+    // Determine language setting from locale or format
+    let claudeLanguage = 'en';
+    if (locale === 'zh-tw') {
+      claudeLanguage = 'zh-tw';
+    } else if (standardOptions?.commit_language === 'bilingual') {
+      claudeLanguage = 'bilingual';
+    } else if (standardOptions?.commit_language === 'traditional-chinese') {
+      claudeLanguage = 'zh-tw';
+    }
+
+    const claudeConfig = {
+      tool: 'claude-code',
+      categories: ['anti-hallucination', 'commit-standards', 'code-review'],
+      languages: [],
+      exclusions: [],
+      customRules: [],
+      detailLevel: 'standard',
+      language: claudeLanguage
+    };
+
+    const result = writeIntegrationFile('claude-code', claudeConfig, projectPath);
+    if (result.success) {
+      results.integrations.push(result.path);
+      claudeSpinner.succeed('Generated CLAUDE.md');
+    } else {
+      claudeSpinner.warn('Could not generate CLAUDE.md');
+      results.errors.push(`CLAUDE.md: ${result.error}`);
+    }
+  }
+
   // Install Skills if needed
   if (skillsConfig.needsInstall && skillsConfig.updateTargets.length > 0) {
     const skillSpinner = ora('Installing Claude Code Skills...').start();
@@ -616,7 +659,7 @@ export async function initCommand(options) {
     skills: {
       installed: skillsConfig.installed,
       location: skillsConfig.location,
-      names: results.skills,
+      names: skillsConfig.location === 'marketplace' ? ['all-via-plugin'] : results.skills,
       version: skillsConfig.installed ? repoInfo.skills.version : null
     }
   };
@@ -631,15 +674,19 @@ export async function initCommand(options) {
   const totalFiles = results.standards.length + results.extensions.length + results.integrations.length;
   console.log(chalk.gray(`  ${totalFiles} files copied to project`));
 
-  if (results.skills.length > 0) {
-    const skillLocations = [];
-    if (skillsConfig.updateTargets.includes('user')) {
-      skillLocations.push('~/.claude/skills/');
-    }
-    if (skillsConfig.updateTargets.includes('project')) {
-      skillLocations.push('.claude/skills/');
+  if (skillsConfig.installed) {
+    if (skillsConfig.location === 'marketplace') {
+      console.log(chalk.gray('  Skills: Using Plugin Marketplace installation'));
+    } else if (results.skills.length > 0) {
+      const skillLocations = [];
+      if (skillsConfig.updateTargets.includes('user')) {
+        skillLocations.push('~/.claude/skills/');
+      }
+      if (skillsConfig.updateTargets.includes('project')) {
+        skillLocations.push('.claude/skills/');
+      }
+      console.log(chalk.gray(`  ${results.skills.length} Skills installed to ${skillLocations.join(' and ')}`));
     }
-    console.log(chalk.gray(`  ${results.skills.length} Skills installed to ${skillLocations.join(' and ')}`));
   }
   console.log(chalk.gray('  Manifest created at .standards/manifest.json'));
 
@@ -662,4 +709,7 @@ export async function initCommand(options) {
     console.log(chalk.gray('  3. Run `uds check` to verify adoption status'));
   }
   console.log();
+
+  // Exit explicitly to prevent hanging due to inquirer's readline interface
+  process.exit(0);
 }

package/src/commands/update.js

@@ -183,4 +183,7 @@ export async function updateCommand(options) {
   }
 
   console.log();
+
+  // Exit explicitly to prevent hanging due to inquirer's readline interface
+  process.exit(0);
 }

package/src/prompts/init.js

@@ -81,7 +81,11 @@ export async function promptSkillsInstallLocation() {
       message: 'Where should Skills be installed?',
       choices: [
         {
-          name: `${chalk.green('User Level')} ${chalk.gray('(推薦)')} - ~/.claude/skills/ (shared across projects)`,
+          name: `${chalk.green('Plugin Marketplace')} ${chalk.gray('(推薦)')} - Already installed via /plugin install`,
+          value: 'marketplace'
+        },
+        {
+          name: `${chalk.blue('User Level')} - ~/.claude/skills/ (shared across projects)`,
           value: 'user'
         },
         {
@@ -93,13 +97,19 @@ export async function promptSkillsInstallLocation() {
           value: 'none'
         }
       ],
-      default: 'user'
+      default: 'marketplace'
     }
   ]);
 
   // Show explanation
   console.log();
-  if (location === 'user') {
+  if (location === 'marketplace') {
+    console.log(chalk.gray('  → Skills managed by Claude Code Plugin system'));
+    console.log(chalk.gray('  → Automatic updates when new versions are released'));
+    console.log(chalk.gray('  → If not installed yet, run:'));
+    console.log(chalk.gray('      /plugin marketplace add AsiaOstrich/universal-dev-standards'));
+    console.log(chalk.gray('      /plugin install universal-dev-standards@universal-dev-standards'));
+  } else if (location === 'user') {
     console.log(chalk.gray('  → Skills will be installed to ~/.claude/skills/'));
     console.log(chalk.gray('  → Available across all your projects'));
   } else if (location === 'project') {

package/src/utils/integration-generator.js

@@ -1431,76 +1431,116 @@ const TOOL_HEADERS = {
 # Generated by Universal Dev Standards CLI
 # https://github.com/AsiaOstrich/universal-dev-standards
 
-You are an expert software engineer assistant. Follow these project standards:`,
+You are an expert software engineer assistant. Follow these project standards.
+
+## Conversation Language
+All responses should be in **English**.`,
     'zh-tw': `# Cursor 規則
 # 由 Universal Dev Standards CLI 生成
 # https://github.com/AsiaOstrich/universal-dev-standards
 
-您是專業的軟體工程助手。請遵循以下專案標準:`,
+您是專業的軟體工程助手。請遵循以下專案標準。
+
+## 對話語言 / Conversation Language
+所有回覆必須使用**繁體中文 (Traditional Chinese)**。`,
     bilingual: `# Cursor Rules | Cursor 規則
 # Generated by Universal Dev Standards CLI
 # 由 Universal Dev Standards CLI 生成
 # https://github.com/AsiaOstrich/universal-dev-standards
 
 You are an expert software engineer assistant. Follow these project standards.
-您是專業的軟體工程助手。請遵循以下專案標準。`
+您是專業的軟體工程助手。請遵循以下專案標準。
+
+## Conversation Language / 對話語言
+All responses should be in **Traditional Chinese (繁體中文)**, with technical terms in English where appropriate.
+所有回覆必須使用**繁體中文**，技術術語可保留英文。`
   },
   windsurf: {
     en: `# Windsurf Rules
 # Generated by Universal Dev Standards CLI
 # https://github.com/AsiaOstrich/universal-dev-standards
 
-You are an expert software engineer assistant. Follow these project standards:`,
+You are an expert software engineer assistant. Follow these project standards.
+
+## Conversation Language
+All responses should be in **English**.`,
     'zh-tw': `# Windsurf 規則
 # 由 Universal Dev Standards CLI 生成
 # https://github.com/AsiaOstrich/universal-dev-standards
 
-您是專業的軟體工程助手。請遵循以下專案標準:`,
+您是專業的軟體工程助手。請遵循以下專案標準。
+
+## 對話語言 / Conversation Language
+所有回覆必須使用**繁體中文 (Traditional Chinese)**。`,
     bilingual: `# Windsurf Rules | Windsurf 規則
 # Generated by Universal Dev Standards CLI
 # 由 Universal Dev Standards CLI 生成
 # https://github.com/AsiaOstrich/universal-dev-standards
 
 You are an expert software engineer assistant. Follow these project standards.
-您是專業的軟體工程助手。請遵循以下專案標準。`
+您是專業的軟體工程助手。請遵循以下專案標準。
+
+## Conversation Language / 對話語言
+All responses should be in **Traditional Chinese (繁體中文)**, with technical terms in English where appropriate.
+所有回覆必須使用**繁體中文**，技術術語可保留英文。`
   },
   cline: {
     en: `# Cline Rules
 # Generated by Universal Dev Standards CLI
 # https://github.com/AsiaOstrich/universal-dev-standards
 
-You are an expert software engineer assistant. Follow these project standards:`,
+You are an expert software engineer assistant. Follow these project standards.
+
+## Conversation Language
+All responses should be in **English**.`,
     'zh-tw': `# Cline 規則
 # 由 Universal Dev Standards CLI 生成
 # https://github.com/AsiaOstrich/universal-dev-standards
 
-您是專業的軟體工程助手。請遵循以下專案標準:`,
+您是專業的軟體工程助手。請遵循以下專案標準。
+
+## 對話語言 / Conversation Language
+所有回覆必須使用**繁體中文 (Traditional Chinese)**。`,
     bilingual: `# Cline Rules | Cline 規則
 # Generated by Universal Dev Standards CLI
 # 由 Universal Dev Standards CLI 生成
 # https://github.com/AsiaOstrich/universal-dev-standards
 
 You are an expert software engineer assistant. Follow these project standards.
-您是專業的軟體工程助手。請遵循以下專案標準。`
+您是專業的軟體工程助手。請遵循以下專案標準。
+
+## Conversation Language / 對話語言
+All responses should be in **Traditional Chinese (繁體中文)**, with technical terms in English where appropriate.
+所有回覆必須使用**繁體中文**，技術術語可保留英文。`
   },
   copilot: {
     en: `# GitHub Copilot Instructions
 # Generated by Universal Dev Standards CLI
 # https://github.com/AsiaOstrich/universal-dev-standards
 
-You are an expert software engineer assistant. Follow these project standards:`,
+You are an expert software engineer assistant. Follow these project standards.
+
+## Conversation Language
+All responses should be in **English**.`,
     'zh-tw': `# GitHub Copilot 說明
 # 由 Universal Dev Standards CLI 生成
 # https://github.com/AsiaOstrich/universal-dev-standards
 
-您是專業的軟體工程助手。請遵循以下專案標準:`,
+您是專業的軟體工程助手。請遵循以下專案標準。
+
+## 對話語言 / Conversation Language
+所有回覆必須使用**繁體中文 (Traditional Chinese)**。`,
     bilingual: `# GitHub Copilot Instructions | GitHub Copilot 說明
 # Generated by Universal Dev Standards CLI
 # 由 Universal Dev Standards CLI 生成
 # https://github.com/AsiaOstrich/universal-dev-standards
 
 You are an expert software engineer assistant. Follow these project standards.
-您是專業的軟體工程助手。請遵循以下專案標準。`
+您是專業的軟體工程助手。請遵循以下專案標準。
+
+## Conversation Language / 對話語言
+All responses should be in **Traditional Chinese (繁體中文)**, with technical terms in English where appropriate.
+所有回覆必須使用**繁體中文**，技術術語可保留英文。`
   },
   antigravity: {
     en: `# Antigravity System Instructions
@@ -1508,20 +1548,54 @@ You are an expert software engineer assistant. Follow these project standards.
 # https://github.com/AsiaOstrich/universal-dev-standards
 
 Recommended system instructions for Google Antigravity (Gemini Advanced Agent).
-Follow these project standards:`,
+Follow these project standards.
+
+## Conversation Language
+All responses should be in **English**.`,
     'zh-tw': `# Antigravity 系統指令
 # 由 Universal Dev Standards CLI 生成
 # https://github.com/AsiaOstrich/universal-dev-standards
 
 Google Antigravity (Gemini Advanced Agent) 的推薦系統指令。
-請遵循以下專案標準:`,
+請遵循以下專案標準。
+
+## 對話語言 / Conversation Language
+所有回覆必須使用**繁體中文 (Traditional Chinese)**。`,
     bilingual: `# Antigravity System Instructions | Antigravity 系統指令
 # Generated by Universal Dev Standards CLI
 # 由 Universal Dev Standards CLI 生成
 # https://github.com/AsiaOstrich/universal-dev-standards
 
 Recommended system instructions for Google Antigravity (Gemini Advanced Agent).
-Google Antigravity (Gemini Advanced Agent) 的推薦系統指令。`
+Google Antigravity (Gemini Advanced Agent) 的推薦系統指令。
+
+## Conversation Language / 對話語言
+All responses should be in **Traditional Chinese (繁體中文)**, with technical terms in English where appropriate.
+所有回覆必須使用**繁體中文**，技術術語可保留英文。`
+  },
+  'claude-code': {
+    en: `# Project Guidelines for Claude Code
+# Generated by Universal Dev Standards CLI
+# https://github.com/AsiaOstrich/universal-dev-standards
+
+## Conversation Language
+All responses should be in **English**.`,
+    'zh-tw': `# Claude Code 專案指南
+# 由 Universal Dev Standards CLI 生成
+# https://github.com/AsiaOstrich/universal-dev-standards
+
+## 對話語言 / Conversation Language
+所有回覆必須使用**繁體中文 (Traditional Chinese)**。
+AI 助手應以繁體中文回覆使用者的問題與請求。`,
+    bilingual: `# Project Guidelines for Claude Code | Claude Code 專案指南
+# Generated by Universal Dev Standards CLI
+# 由 Universal Dev Standards CLI 生成
+# https://github.com/AsiaOstrich/universal-dev-standards
+
+## Conversation Language / 對話語言
+All responses should be in **Traditional Chinese (繁體中文)**, with technical terms in English where appropriate.
+所有回覆必須使用**繁體中文**，技術術語可保留英文。
+AI 助手應以繁體中文回覆使用者的問題與請求。`
   }
 };
 
@@ -1642,7 +1716,8 @@ export function writeIntegrationFile(tool, config, projectPath) {
     windsurf: '.windsurfrules',
     cline: '.clinerules',
     copilot: '.github/copilot-instructions.md',
-    antigravity: 'INSTRUCTIONS.md'
+    antigravity: 'INSTRUCTIONS.md',
+    'claude-code': 'CLAUDE.md'
   };
 
   const fileName = TOOL_FILES[tool];
@@ -1686,7 +1761,8 @@ export function integrationFileExists(tool, projectPath) {
     windsurf: '.windsurfrules',
     cline: '.clinerules',
     copilot: '.github/copilot-instructions.md',
-    antigravity: 'INSTRUCTIONS.md'
+    antigravity: 'INSTRUCTIONS.md',
+    'claude-code': 'CLAUDE.md'
   };
 
   const fileName = TOOL_FILES[tool];

package/standards-registry.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "3.0.0",
-  "lastUpdated": "2025-12-30",
+  "version": "3.2.0",
+  "lastUpdated": "2026-01-02",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
     "ai": {
@@ -48,14 +48,14 @@
     "standards": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
-      "version": "3.0.0"
+      "version": "3.2.0"
     },
     "skills": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
       "localPath": "skills/claude-code",
       "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/claude-code",
-      "version": "3.0.0",
+      "version": "3.2.0",
       "note": "Skills are now included in the main repository under skills/"
     }
   },
@@ -634,14 +634,34 @@
       "note": "SDD tool, not AI coding assistant. Manual integration only."
     },
     {
-      "id": "requirement-templates",
-      "name": "Requirement Document Templates",
+      "id": "requirement-checklist",
+      "name": "Requirement Checklist Template",
+      "nameZh": "需求檢核清單模板",
+      "source": "templates/requirement-checklist.md",
+      "category": "skill",
+      "skillName": "requirement-assistant",
+      "level": 2,
+      "description": "Checklist for reviewing requirement documents"
+    },
+    {
+      "id": "requirement-template",
+      "name": "Requirement Template",
+      "nameZh": "需求模板",
+      "source": "templates/requirement-template.md",
+      "category": "skill",
+      "skillName": "requirement-assistant",
+      "level": 2,
+      "description": "Template for writing user stories"
+    },
+    {
+      "id": "requirement-document-template",
+      "name": "Requirement Document Template",
       "nameZh": "需求文件模板",
-      "source": "templates/requirement-*.md",
+      "source": "templates/requirement-document-template.md",
       "category": "skill",
       "skillName": "requirement-assistant",
       "level": 2,
-      "description": "Templates for writing requirement documents and user stories"
+      "description": "Template for writing comprehensive requirement documents"
     },
     {
       "id": "migration-template",