speccrew 0.7.0 → 0.7.2

package/.speccrew/skills/speccrew-knowledge-bizs-identify-entries/workflow.agentflow.xml

@@ -117,8 +117,11 @@
           - Root object MUST contain "modules" field (array type)
           - Root object MUST NOT contain "businessModules", "subModules", or "components" fields
           - Each module in "modules" array MUST have exactly two fields: "name" (string) and "entryDirs" (array of strings)
-          - For platforms with hierarchical directory structure (e.g. frontend views/system/user/), flatten into individual modules
-          - Module names should use hyphen-separated composite names for sub-modules (e.g. "system-user", "system-role")
+          - Module granularity MUST follow the module_scan.depth configuration from tech-stack-mappings.json
+          - When depth=1: first-level subdirectories under module_scan.root are modules (e.g., src/views/system → module "system", src/views/bpm → module "bpm")
+          - When depth=2: second-level subdirectories are modules (e.g., src/main/java/com/example/controller → grouped by controller subdirectories)
+          - Each module's entryDirs should contain the module root directory path (e.g., ["src/views/system"] for module "system"), NOT individual sub-paths
+          - DO NOT flatten hierarchical directories into hyphen-separated sub-modules (e.g., DO NOT create "system-user", "system-role" — create one "system" module instead)
           - Multiple modules MUST NOT share the same entryDirs value. If multiple business areas share the same directory, they belong to ONE module.
           - If the generated JSON does not match this format, you MUST regenerate it before proceeding
         </field>

package/lib/commands/init.js

@@ -11,7 +11,9 @@ const {
   ensureDirectories,
   removeDirRecursive,
   DEPRECATED_SKILLS,
+  DEPRECATED_AGENTS,
   cleanDeprecatedSkills,
+  cleanDeprecatedAgents,
 } = require('../utils');
 const { resolveIDE, transformAgentForIDE, transformSkillForIDE } = require('../ide-adapters');
 
@@ -347,9 +349,15 @@ async function runInit(options = {}) {
       const skillsResult = copySkills(skillsSourceDir, skillsDestDir, ideConfig);
 
       // Clean up deprecated skills
-      const cleanedCount = cleanDeprecatedSkills(skillsDestDir, DEPRECATED_SKILLS);
-      if (cleanedCount > 0 && !silent) {
-        log(`  Cleaned up ${cleanedCount} deprecated skill(s) from ${ideConfig.name}`);
+      const cleanedSkillCount = cleanDeprecatedSkills(skillsDestDir, DEPRECATED_SKILLS);
+      if (cleanedSkillCount > 0 && !silent) {
+        log(`  Cleaned up ${cleanedSkillCount} deprecated skill(s) from ${ideConfig.name}`);
+      }
+
+      // Clean up deprecated agents
+      const cleanedAgentCount = cleanDeprecatedAgents(agentsDestDir, DEPRECATED_AGENTS);
+      if (cleanedAgentCount > 0 && !silent) {
+        log(`  Cleaned up ${cleanedAgentCount} deprecated agent(s) from ${ideConfig.name}`);
       }
 
       stats.ides.push({

package/lib/commands/update.js

@@ -10,7 +10,9 @@ const {
   copyDirRecursive,
   removeDirRecursive,
   DEPRECATED_SKILLS,
+  DEPRECATED_AGENTS,
   cleanDeprecatedSkills,
+  cleanDeprecatedAgents,
 } = require('../utils');
 const { resolveIDE, getIDEConfig, transformAgentForIDE, transformSkillForIDE } = require('../ide-adapters');
 
@@ -456,9 +458,15 @@ function run() {
       totalStats.extraDirs.push(...skillStats.extraDirs);
 
       // Clean up deprecated skills
-      const cleanedCount = cleanDeprecatedSkills(destSkillsDir, DEPRECATED_SKILLS);
-      if (cleanedCount > 0) {
-        console.log(`  Cleaned up ${cleanedCount} deprecated skill(s) from ${ide.name}`);
+      const cleanedSkillCount = cleanDeprecatedSkills(destSkillsDir, DEPRECATED_SKILLS);
+      if (cleanedSkillCount > 0) {
+        console.log(`  Cleaned up ${cleanedSkillCount} deprecated skill(s) from ${ide.name}`);
+      }
+
+      // Clean up deprecated agents
+      const cleanedAgentCount = cleanDeprecatedAgents(destAgentsDir, DEPRECATED_AGENTS);
+      if (cleanedAgentCount > 0) {
+        console.log(`  Cleaned up ${cleanedAgentCount} deprecated agent(s) from ${ide.name}`);
       }
     }
     

package/lib/utils.js

@@ -113,6 +113,29 @@ const DEPRECATED_SKILLS = [
   'speccrew-dev-review',    // replaced by speccrew-dev-review-backend/frontend/mobile/desktop
   'speccrew-test-execute',  // replaced by speccrew-test-runner + speccrew-test-reporter
   'speccrew-fd-feature-registry-init', // replaced by speccrew-fd-feature-registry
+  // Legacy -xml skills (replaced by non-xml versions)
+  'speccrew-knowledge-bizs-api-analyze-xml',
+  'speccrew-knowledge-bizs-api-graph-xml',
+  'speccrew-knowledge-bizs-dispatch-xml',
+  'speccrew-knowledge-bizs-identify-entries-xml',
+  'speccrew-knowledge-bizs-init-features-xml',
+  'speccrew-knowledge-bizs-ui-analyze-xml',
+  'speccrew-knowledge-bizs-ui-graph-xml',
+  'speccrew-knowledge-bizs-ui-style-extract-xml',
+  'speccrew-knowledge-module-summarize-xml',
+  'speccrew-knowledge-system-summarize-xml',
+  'speccrew-knowledge-techs-dispatch-xml',
+  'speccrew-knowledge-techs-generate-conventions-xml',
+  'speccrew-knowledge-techs-generate-quality-xml',
+  'speccrew-knowledge-techs-generate-ui-style-xml',
+  'speccrew-knowledge-techs-generate-xml',
+  'speccrew-knowledge-techs-index-xml',
+  'speccrew-knowledge-techs-init-xml',
+];
+
+// Deprecated agents that should be auto-cleaned on init/update
+const DEPRECATED_AGENTS = [
+  'speccrew-team-leader-xml.md', // replaced by speccrew-team-leader.md
 ];
 
 function cleanDeprecatedSkills(destDir, deprecatedList) {
@@ -133,6 +156,24 @@ function cleanDeprecatedSkills(destDir, deprecatedList) {
   return cleaned;
 }
 
+// Clean deprecated agent files from agents directory
+function cleanDeprecatedAgents(destDir, deprecatedList) {
+  if (!fs.existsSync(destDir)) return 0;
+  let cleaned = 0;
+  try {
+    for (const fileName of deprecatedList) {
+      const fullPath = path.join(destDir, fileName);
+      if (fs.existsSync(fullPath)) {
+        fs.unlinkSync(fullPath);
+        cleaned++;
+      }
+    }
+  } catch (error) {
+    // Silently ignore cleanup errors to not block main flow
+  }
+  return cleaned;
+}
+
 module.exports = {
   copyDirRecursive,
   isSpeccrewFile,
@@ -144,5 +185,7 @@ module.exports = {
   ensureDirectories,
   removeDirRecursive,
   DEPRECATED_SKILLS,
+  DEPRECATED_AGENTS,
   cleanDeprecatedSkills,
+  cleanDeprecatedAgents,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {