speccrew 0.6.47 → 0.6.49

package/.speccrew/skills/speccrew-knowledge-module-summarize-xml/SKILL.md

@@ -51,8 +51,10 @@ flowchart TD
     Step6 --> End([End])
 ```
 
-> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `docs/rules/xml-workflow-spec.md`
+> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/xml-workflow-spec.md`
 
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
 <workflow id="module-summarize" version="1.0" status="pending" desc="Module summarization workflow">
 
   <!-- Input Block: Define workflow inputs -->
@@ -108,7 +110,7 @@ flowchart TD
     <block type="gateway" id="G1" mode="exclusive" desc="Check if features exist">
       <branch test="${feature_files.length} == 0" name="No features">
         <block type="event" id="E1a" action="log" level="warning" desc="No features warning">
-No feature documents found for module ${module_name}
+          <field name="message">No feature documents found for module ${module_name}</field>
         </block>
         <block type="task" id="B1e" action="write-file" desc="Generate minimal overview">
           <field name="path" value="${module_path}/${module_name}-overview.md"/>
@@ -116,12 +118,12 @@ No feature documents found for module ${module_name}
         </block>
         <field name="status" value="partial"/>
         <block type="event" id="E1b" action="signal" desc="Signal complete">
-workflow_complete
+          <field name="message">workflow_complete</field>
         </block>
       </branch>
       <branch test="${feature_files.length} > 0" name="Features found">
         <block type="event" id="E1c" action="log" level="info" desc="Features found">
-Found ${feature_files.length} feature documents
+          <field name="message">Found ${feature_files.length} feature documents</field>
         </block>
       </branch>
     </block>
@@ -308,13 +310,13 @@ Found ${feature_files.length} feature documents
       </try>
       <catch error-type="write_error">
         <block type="event" id="EH1-E1" action="log" level="error" desc="Write error">
-Failed to write overview document: ${write_error.message}
+          <field name="message">Failed to write overview document: ${write_error.message}</field>
         </block>
         <field name="status" value="failed"/>
       </catch>
       <finally>
         <block type="event" id="EH1-E2" action="log" level="info" desc="Write completed">
-Document write operation completed
+          <field name="message">Document write operation completed</field>
         </block>
       </finally>
     </block>
@@ -351,14 +353,14 @@ Document write operation completed
 
     <!-- Event: Log completion -->
     <block type="event" id="E6" action="log" level="info" desc="Log completion">
-Module summarization completed:
+      <field name="message">Module summarization completed:
 - Module: ${module_name}
 - Features Processed: ${feature_files.length}
 - Entities Extracted: ${unique_entities.length}
 - Dependencies Identified: ${dependencies.length}
 - Business Rules Summarized: ${business_rules.length}
 - Output: ${module_name}-overview.md (complete)
-- Status: success
+- Status: success</field>
     </block>
   </sequence>
 
@@ -371,6 +373,7 @@ Module summarization completed:
   </block>
 
 </workflow>
+```
 
 ## Constraints
 

package/.speccrew/skills/speccrew-knowledge-system-summarize-xml/SKILL.md

@@ -58,8 +58,10 @@ flowchart TD
     Step8 --> End([End])
 ```
 
-> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `docs/rules/xml-workflow-spec.md`
+> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/xml-workflow-spec.md`
 
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
 <workflow id="system-summarize-main" status="pending" version="1.0" desc="System summarization workflow">
   <!-- ============================================================
        Input Parameters Definition
@@ -97,7 +99,7 @@ flowchart TD
 
   <!-- Prerequisites Verification -->
   <block type="event" id="E1" action="log" level="info" desc="Log workflow start">
-Starting system summarization workflow
+    <field name="message">Starting system summarization workflow</field>
   </block>
 
   <!-- Step 0: Read System Overview Template -->
@@ -123,7 +125,7 @@ Starting system summarization workflow
   <block type="gateway" id="G1" mode="exclusive" desc="Check if modules discovered">
     <branch test="${module_files.length} == 0" name="No modules">
       <block type="event" id="E2" action="log" level="warning" desc="Log no modules found">
-No module overview files found in ${modules_path}
+        <field name="message">No module overview files found in ${modules_path}</field>
       </block>
       <block type="task" id="B2" action="run-script" desc="Generate skeleton document">
         <field name="script" value="generate-skeleton.js"/>
@@ -144,7 +146,7 @@ No module overview files found in ${modules_path}
     </branch>
     <branch test="${module_files.length} > 0" name="Modules found">
       <block type="event" id="E4" action="log" level="info" desc="Log modules discovered">
-Discovered ${module_files.length} module overview files
+        <field name="message">Discovered ${module_files.length} module overview files</field>
       </block>
     </branch>
   </block>
@@ -355,7 +357,7 @@ Discovered ${module_files.length} module overview files
         <field name="output" var="timestamp"/>
       </block>
       <block type="event" id="E5" action="log" level="warning" desc="Log fallback">
-Using system fallback timestamp
+        <field name="message">Using system fallback timestamp</field>
       </block>
     </branch>
   </block>
@@ -464,7 +466,7 @@ Using system fallback timestamp
     </try>
     <catch error-type="write_error">
       <block type="event" id="E6" action="log" level="error" desc="Log write error">
-Failed to write system overview: ${write_error.message}
+        <field name="message">Failed to write system overview: ${write_error.message}</field>
       </block>
       <block type="output" id="O-err" desc="Error output">
         <field name="status" value="failed"/>
@@ -472,7 +474,7 @@ Failed to write system overview: ${write_error.message}
     </catch>
     <finally>
       <block type="event" id="E7" action="log" level="info" desc="Log write complete">
-Document write operation completed
+        <field name="message">Document write operation completed</field>
       </block>
     </finally>
   </block>
@@ -513,14 +515,14 @@ Document write operation completed
 
   <!-- Event: Log completion -->
   <block type="event" id="E8" action="log" level="info" desc="Log completion summary">
-    System summarization completed:
+    <field name="message">System summarization completed:
     - Modules Processed: ${module_count}
     - Entities Aggregated: ${metrics.entity_count}
     - APIs Counted: ${metrics.api_count}
     - Dependencies Mapped: ${all_dependencies.length}
     - Business Flows Identified: ${flow_count}
     - Output: system-overview.md (complete)
-    - Status: success
+    - Status: success</field>
   </block>
 
   <!-- Output Block: Define workflow outputs -->
@@ -530,6 +532,7 @@ Document write operation completed
     <field name="message" value="System summarization completed with ${module_count} modules processed"/>
   </block>
 </workflow>
+```
 
 ## Constraints
 

package/.speccrew/skills/speccrew-knowledge-techs-dispatch-xml/SKILL.md

@@ -6,7 +6,7 @@ tools: Read, Write, Task, Bash
 
 > **⚠️ MANDATORY EXECUTION PROTOCOL — READ BEFORE EXECUTING ANY BLOCK**
 >
-> **Step 1**: Load XML workflow specification: `docs/rules/xml-workflow-spec.md` — this defines all block types and action-to-tool mappings
+> **Step 1**: Load XML workflow specification: `speccrew-workspace/docs/rules/xml-workflow-spec.md` — this defines all block types and action-to-tool mappings
 >
 > **Step 2**: Execute this SKILL.md's XML workflow **block by block in document order**:
 > - `action="run-script"` → Execute via **Terminal tool** (PowerShell/Bash)
@@ -118,8 +118,10 @@ Read `speccrew-workspace/docs/configs/platform-mapping.json` for standardized pl
 
 ## XML Workflow Definition
 
-> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `docs/rules/xml-workflow-spec.md`
+> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/xml-workflow-spec.md`
 
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
 <workflow id="techs-dispatch-main" status="pending" version="1.0" desc="techs knowledge base generation 3-stage pipeline">
 
   <!-- ============================================================
@@ -191,10 +193,10 @@ Read `speccrew-workspace/docs/configs/platform-mapping.json` for standardized pl
 
     <!-- Step 2: Prepare Task Plan for techs-init -->
     <block type="event" id="S1-E1" action="log" level="info" desc="Prepare techs-init task plan">
-Stage 1: Preparing task plan for speccrew-knowledge-techs-init-xml
+    <field name="message">Stage 1: Preparing task plan for speccrew-knowledge-techs-init-xml
 - Source path: ${source_path}
 - Output path: ${sync_state_techs_dir}
-- Language: ${language}
+- Language: ${language}</field>
     </block>
 
     <!-- Step 3: Prepare task specification -->
@@ -210,9 +212,9 @@ Stage 1: Preparing task plan for speccrew-knowledge-techs-init-xml
 
     <!-- Step 4: Monitor completion -->
     <block type="event" id="S1-E2" action="log" level="info" desc="Stage 1 task prepared">
-Stage 1 task plan prepared. Waiting for calling Agent to dispatch.
+    <field name="message">Stage 1 task plan prepared. Waiting for calling Agent to dispatch.
 Task: speccrew-knowledge-techs-init-xml
-Output: ${sync_state_techs_dir}/techs-manifest.json
+Output: ${sync_state_techs_dir}/techs-manifest.json</field>
     </block>
 
     <!-- Step 5: Read manifest after completion -->
@@ -233,7 +235,7 @@ Output: ${sync_state_techs_dir}/techs-manifest.json
     </block>
 
     <block type="event" id="S1-E3" action="log" level="info" desc="Report detected platforms">
-Stage 1 complete. Detected ${techs_manifest.platforms.length} platforms: ${techs_manifest.platforms.map(p => p.platform_id).join(', ')}
+    <field name="message">Stage 1 complete. Detected ${techs_manifest.platforms.length} platforms: ${techs_manifest.platforms.map(p => p.platform_id).join(', ')}</field>
     </block>
   </sequence>
 
@@ -284,7 +286,7 @@ if (platform) {
 
     <!-- Step 2: Prepare Conventions Worker Task Plans (ALL Platforms) -->
     <block type="event" id="S2-E1" action="log" level="info" desc="Prepare conventions worker tasks">
-Preparing conventions worker task plans for ${techs_manifest.platforms.length} platforms...
+    <field name="message">Preparing conventions worker task plans for ${techs_manifest.platforms.length} platforms...</field>
     </block>
 
     <block type="loop" id="S2-L2" over="${techs_manifest.platforms}" as="platform" desc="Prepare conventions worker task for each platform">
@@ -307,7 +309,7 @@ Preparing conventions worker task plans for ${techs_manifest.platforms.length} p
 
     <!-- Step 3: Prepare UI-Style Worker Task Plans (Frontend Platforms ONLY) -->
     <block type="event" id="S2-E2" action="log" level="info" desc="Prepare UI-style worker tasks">
-Preparing UI-style worker task plans for frontend platforms...
+    <field name="message">Preparing UI-style worker task plans for frontend platforms...</field>
     </block>
 
     <block type="loop" id="S2-L3" over="${techs_manifest.platforms}" as="platform" desc="Prepare UI-style worker task for frontend platforms">
@@ -331,7 +333,7 @@ Preparing UI-style worker task plans for frontend platforms...
 
     <!-- Step 4: Dispatch ALL Workers in PARALLEL -->
     <block type="event" id="S2-E3" action="log" level="info" desc="Dispatch all workers">
-Dispatching ALL workers in PARALLEL. The calling Agent should dispatch all prepared tasks simultaneously.
+    <field name="message">Dispatching ALL workers in PARALLEL. The calling Agent should dispatch all prepared tasks simultaneously.</field>
     </block>
 
     <!-- Step 5: Monitor Completion Markers -->
@@ -410,7 +412,7 @@ Dispatching ALL workers in PARALLEL. The calling Agent should dispatch all prepa
     </block>
 
     <block type="event" id="S2-E4" action="log" level="info" desc="Stage 2 complete">
-Stage 2 complete. All platform workers finished.
+    <field name="message">Stage 2 complete. All platform workers finished.</field>
     </block>
   </sequence>
 
@@ -427,7 +429,7 @@ Stage 2 complete. All platform workers finished.
 
     <!-- Step A: Scan Completion Markers -->
     <block type="event" id="S2_5-E1" action="log" level="info" desc="Step A: Scan completion markers">
-Stage 2.5 Step A: Scanning completion markers...
+    <field name="message">Stage 2.5 Step A: Scanning completion markers...</field>
     </block>
 
     <block type="loop" id="S2_5-L1" over="${techs_manifest.platforms}" as="platform" desc="Scan markers for each platform">
@@ -453,7 +455,7 @@ console.log(JSON.stringify(markers));
 
     <!-- Step B: Verify Output Integrity -->
     <block type="event" id="S2_5-E2" action="log" level="info" desc="Step B: Verify output integrity">
-Stage 2.5 Step B: Verifying output integrity...
+    <field name="message">Stage 2.5 Step B: Verifying output integrity...</field>
     </block>
 
     <block type="loop" id="S2_5-L2" over="${techs_manifest.platforms}" as="platform" desc="Verify documents for each platform">
@@ -497,7 +499,7 @@ console.log(JSON.stringify(results));
 
     <!-- Step C: Update Progress Status -->
     <block type="event" id="S2_5-E3" action="log" level="info" desc="Step C: Update progress status">
-Stage 2.5 Step C: Updating progress status...
+    <field name="message">Stage 2.5 Step C: Updating progress status...</field>
     </block>
 
     <block type="task" id="S2_5-B3" action="run-script" status="pending" desc="Generate stage2-status.json">
@@ -531,7 +533,7 @@ console.log('stage2-status.json written');
     </block>
 
     <block type="event" id="S2_5-E4" action="log" level="info" desc="Stage 2.5 complete">
-Stage 2.5 complete. Verification results written to stage2-status.json.
+    <field name="message">Stage 2.5 complete. Verification results written to stage2-status.json.</field>
     </block>
   </sequence>
 
@@ -554,10 +556,10 @@ Stage 2.5 complete. Verification results written to stage2-status.json.
 
     <!-- Step 2: Prepare Task Plan for techs-index -->
     <block type="event" id="S3-E1" action="log" level="info" desc="Prepare techs-index task plan">
-Stage 3: Preparing task plan for speccrew-knowledge-techs-index-xml
+    <field name="message">Stage 3: Preparing task plan for speccrew-knowledge-techs-index-xml
 - Manifest: ${sync_state_techs_dir}/techs-manifest.json
 - Output: ${workspace_path}/knowledges/techs/
-- Language: ${language}
+- Language: ${language}</field>
     </block>
 
     <!-- Step 3: Prepare task specification -->
@@ -574,9 +576,9 @@ Stage 3: Preparing task plan for speccrew-knowledge-techs-index-xml
 
     <!-- Step 4: Monitor completion -->
     <block type="event" id="S3-E2" action="log" level="info" desc="Stage 3 task prepared">
-Stage 3 task plan prepared. Waiting for calling Agent to dispatch.
+    <field name="message">Stage 3 task plan prepared. Waiting for calling Agent to dispatch.
 Task: speccrew-knowledge-techs-index-xml
-Output: ${workspace_path}/knowledges/techs/INDEX.md
+Output: ${workspace_path}/knowledges/techs/INDEX.md</field>
     </block>
 
     <!-- Step 5: Generate stage3-status.json -->
@@ -605,7 +607,7 @@ console.log('stage3-status.json written');
     </block>
 
     <block type="event" id="S3-E3" action="log" level="info" desc="Stage 3 complete">
-Stage 3 complete. Root INDEX.md generated.
+    <field name="message">Stage 3 complete. Root INDEX.md generated.</field>
     </block>
   </sequence>
 
@@ -621,6 +623,7 @@ Stage 3 complete. Root INDEX.md generated.
   </block>
 
 </workflow>
+```
 
 ---
 

package/.speccrew/skills/speccrew-knowledge-techs-generate-conventions-xml/SKILL.md

@@ -72,8 +72,10 @@ ${output_path}/
 
 ## Workflow
 
-> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `docs/rules/xml-workflow-spec.md`
+> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/xml-workflow-spec.md`
 
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
 <workflow id="platform-conventions-generation" status="pending" version="1.0" desc="Platform conventions generation workflow">
 
   <!-- ==================== INPUT PARAMETERS ==================== -->
@@ -866,6 +868,7 @@ ${output_path}/
   </block>
 
 </workflow>
+```
 
 ## Constraints