speccrew 0.6.43 → 0.6.44

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

@@ -60,21 +60,19 @@ flowchart TD
 
 > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `docs/rules/xml-workflow-spec.md`
 
-<workflow>
-  <!-- Input Block: Define workflow inputs -->
-  <input name="modules_path" type="string" required="true" />
-  <input name="output_path" type="string" required="true" />
-  <input name="language" type="string" required="true" />
-
-  <!-- Prerequisites Verification -->
-  <event action="log" level="info">Starting system summarization workflow</event>
-
-  <!-- Edge Case Rules -->
-  <rule level="note">Empty modules directory: Generate skeleton with warning status if no *-overview.md files found</rule>
-  <rule level="note">Incomplete module overviews: Use available data and mark gaps with <!-- DATA INCOMPLETE --></rule>
-  <rule level="note">Same module name from different platforms: Treat as separate modules with platform annotation</rule>
+<workflow id="system-summarize-main" status="pending" version="1.0" desc="System summarization workflow">
+  <!-- ============================================================
+       Input Parameters Definition
+       ============================================================ -->
+  <block type="input" id="I1" desc="System summarization input parameters">
+    <field name="modules_path" required="true" type="string" desc="Path to modules directory"/>
+    <field name="output_path" required="true" type="string" desc="Output path for system-overview.md"/>
+    <field name="language" required="true" type="string" desc="Target language for generated content"/>
+  </block>
 
-  <!-- ==================== GLOBAL CONTINUOUS EXECUTION RULES ==================== -->
+  <!-- ============================================================
+       Global Continuous Execution Rules
+       ============================================================ -->
   <block type="rule" id="GLOBAL-R1" level="forbidden" desc="Continuous execution constraints — NEVER violate">
     <field name="text">DO NOT ask user "Should I continue?" or "How would you like to proceed?" during execution</field>
     <field name="text">DO NOT offer options like "Full execution / Partial / Stop" — always execute ALL tasks to completion</field>
@@ -84,377 +82,453 @@ flowchart TD
     <field name="text">Context window management: if approaching limit, save progress to checkpoint file and resume — do NOT ask user for guidance</field>
   </block>
 
+  <!-- ============================================================
+       Edge Case Rules
+       ============================================================ -->
+  <block type="rule" id="R-NOTE1" level="note" desc="Edge case handling">
+    <field name="text">Empty modules directory: Generate skeleton with warning status if no *-overview.md files found</field>
+  </block>
+  <block type="rule" id="R-NOTE2" level="note" desc="Incomplete data handling">
+    <field name="text">Incomplete module overviews: Use available data and mark gaps with <!-- DATA INCOMPLETE --></field>
+  </block>
+  <block type="rule" id="R-NOTE3" level="note" desc="Module name conflict handling">
+    <field name="text">Same module name from different platforms: Treat as separate modules with platform annotation</field>
+  </block>
+
+  <!-- Prerequisites Verification -->
+  <block type="event" id="E1" action="log" level="info" desc="Log workflow start">
+Starting system summarization workflow
+  </block>
+
   <!-- Step 0: Read System Overview Template -->
-  <task name="read_template" action="run-skill" skill="Read">
-    <param name="file_path">../speccrew-knowledge-system-summarize/templates/SYSTEM-OVERVIEW-TEMPLATE.md</param>
-    <output name="template_content" />
-  </task>
+  <block type="task" id="B0" action="run-skill" desc="Read system overview template">
+    <field name="skill">Read</field>
+    <field name="file_path" value="../speccrew-knowledge-system-summarize/templates/SYSTEM-OVERVIEW-TEMPLATE.md"/>
+    <field name="output" var="template_content"/>
+  </block>
 
   <!-- Checkpoint: Template loaded -->
-  <checkpoint name="template_loaded" verify="template_content != null" />
+  <block type="checkpoint" id="CP0" name="template_loaded" desc="Template loaded successfully">
+    <field name="verify" value="${template_content} != null"/>
+  </block>
 
   <!-- Step 1: Discover All Modules -->
-  <task name="discover_modules" action="run-skill" skill="Glob">
-    <param name="pattern">{{modules_path}}/**/*-overview.md</param>
-    <output name="module_files" />
-  </task>
+  <block type="task" id="B1" action="run-skill" desc="Discover all module overview files">
+    <field name="skill">Glob</field>
+    <field name="pattern" value="${modules_path}/**/*-overview.md"/>
+    <field name="output" var="module_files"/>
+  </block>
 
   <!-- Gateway: Handle empty modules directory -->
-  <gateway name="check_modules" mode="exclusive">
-    <branch condition="module_files.length == 0">
-      <event action="log" level="warning">No module overview files found in {{modules_path}}</event>
-      <task name="generate_skeleton" action="run-script">
-        <param name="script">generate-skeleton.js</param>
-        <param name="template">{{template_content}}</param>
-        <output name="skeleton_doc" />
-      </task>
-      <task name="write_skeleton" action="run-skill" skill="Write">
-        <param name="file_path">{{output_path}}/system-overview.md</param>
-        <param name="content">{{skeleton_doc}}</param>
-      </task>
-      <output name="status" from="warning" />
-      <event action="signal">workflow_complete_with_warning</event>
+  <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}
+      </block>
+      <block type="task" id="B2" action="run-script" desc="Generate skeleton document">
+        <field name="script" value="generate-skeleton.js"/>
+        <field name="template" value="${template_content}"/>
+        <field name="output" var="skeleton_doc"/>
+      </block>
+      <block type="task" id="B3" action="run-skill" desc="Write skeleton document">
+        <field name="skill">Write</field>
+        <field name="file_path" value="${output_path}/system-overview.md"/>
+        <field name="content" value="${skeleton_doc}"/>
+      </block>
+      <block type="output" id="O-early" desc="Early output for empty case">
+        <field name="status" value="warning"/>
+      </block>
+      <block type="event" id="E3" action="signal" desc="Signal workflow complete">
+        <field name="signal" value="workflow_complete_with_warning"/>
+      </block>
     </branch>
-    <branch condition="module_files.length > 0">
-      <event action="log" level="info">Discovered {{module_files.length}} module overview files</event>
+    <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
+      </block>
     </branch>
-  </gateway>
+  </block>
 
   <!-- Extract platform types from paths -->
-  <loop name="extract_platforms" over="module_files" as="module_file">
-    <task name="parse_platform" action="run-script">
-      <param name="script">extract-platform.js</param>
-      <param name="file_path">{{module_file}}</param>
-      <output name="platform_info" />
-    </task>
-  </loop>
+  <block type="loop" id="L1" over="${module_files}" as="module_file" desc="Extract platform types from paths">
+    <block type="task" id="B4" action="run-script" desc="Parse platform from file path">
+      <field name="script" value="extract-platform.js"/>
+      <field name="file_path" value="${module_file}"/>
+      <field name="output" var="platform_info"/>
+    </block>
+  </block>
 
   <!-- Checkpoint: Modules discovered -->
-  <checkpoint name="modules_discovered" verify="module_files.length > 0" />
+  <block type="checkpoint" id="CP1" name="modules_discovered" desc="Modules discovery complete">
+    <field name="verify" value="${module_files.length} > 0"/>
+  </block>
 
   <!-- Step 2: Read All Module Overviews -->
-  <loop name="read_modules" over="module_files" as="module_file">
-    <task name="read_module" action="run-skill" skill="Read">
-      <param name="file_path">{{module_file}}</param>
-      <output name="module_content" />
-    </task>
-    <task name="extract_module_info" action="run-script">
-      <param name="script">extract-module-info.js</param>
-      <param name="content">{{module_content}}</param>
-      <param name="file_path">{{module_file}}</param>
-      <output name="module_info" />
-    </task>
-  </loop>
+  <block type="loop" id="L2" over="${module_files}" as="module_file" desc="Read all module overview files">
+    <block type="task" id="B5" action="run-skill" desc="Read module overview">
+      <field name="skill">Read</field>
+      <field name="file_path" value="${module_file}"/>
+      <field name="output" var="module_content"/>
+    </block>
+    <block type="task" id="B6" action="run-script" desc="Extract module info">
+      <field name="script" value="extract-module-info.js"/>
+      <field name="content" value="${module_content}"/>
+      <field name="file_path" value="${module_file}"/>
+      <field name="output" var="module_info"/>
+    </block>
+  </block>
 
   <!-- Checkpoint: Module info extracted -->
-  <checkpoint name="modules_read" verify="module_infos.length == module_files.length" />
+  <block type="checkpoint" id="CP2" name="modules_read" desc="All modules read successfully">
+    <field name="verify" value="${module_infos.length} == ${module_files.length}"/>
+  </block>
 
   <!-- Step 3: Build Module Index -->
-  <task name="build_index" action="run-script">
-    <param name="script">build-module-index.js</param>
-    <param name="modules">{{module_infos}}</param>
-    <output name="module_index" />
-  </task>
+  <block type="task" id="B7" action="run-script" desc="Build module index">
+    <field name="script" value="build-module-index.js"/>
+    <field name="modules" value="${module_infos}"/>
+    <field name="output" var="module_index"/>
+  </block>
 
   <!-- Create index table rows -->
-  <loop name="create_index_rows" over="module_infos" as="module_info">
-    <task name="create_index_row" action="run-script">
-      <param name="script">create-index-row.js</param>
-      <param name="module">{{module_info}}</param>
-      <param name="language">{{language}}</param>
-      <output name="index_row" />
-    </task>
-  </loop>
+  <block type="loop" id="L3" over="${module_infos}" as="module_info" desc="Create index table rows">
+    <block type="task" id="B8" action="run-script" desc="Create index row">
+      <field name="script" value="create-index-row.js"/>
+      <field name="module" value="${module_info}"/>
+      <field name="language" value="${language}"/>
+      <field name="output" var="index_row"/>
+    </block>
+  </block>
 
   <!-- Checkpoint: Index built -->
-  <checkpoint name="index_built" verify="module_index != null" />
+  <block type="checkpoint" id="CP3" name="index_built" desc="Module index built">
+    <field name="verify" value="${module_index} != null"/>
+  </block>
 
   <!-- Step 4: Build Dependency Graph -->
-  <task name="extract_dependencies" action="run-script">
-    <param name="script">extract-all-dependencies.js</param>
-    <param name="modules">{{module_infos}}</param>
-    <output name="all_dependencies" />
-  </task>
+  <block type="task" id="B9" action="run-script" desc="Extract all dependencies">
+    <field name="script" value="extract-all-dependencies.js"/>
+    <field name="modules" value="${module_infos}"/>
+    <field name="output" var="all_dependencies"/>
+  </block>
 
   <!-- Classify dependencies -->
-  <loop name="classify_dependencies" over="all_dependencies" as="dependency">
-    <gateway name="dep_type" mode="exclusive">
-      <branch condition="dependency.type == 'internal'">
-        <output name="internal_deps" append="{{dependency}}" />
+  <block type="loop" id="L4" over="${all_dependencies}" as="dependency" desc="Classify dependencies by type">
+    <block type="gateway" id="G2" mode="exclusive" desc="Classify dependency type">
+      <branch test="${dependency.type} == 'internal'" name="Internal dependency">
+        <block type="output" id="O-int" desc="Add to internal deps">
+          <field name="internal_deps" append="${dependency}"/>
+        </block>
       </branch>
-      <branch condition="dependency.type == 'external'">
-        <output name="external_deps" append="{{dependency}}" />
+      <branch test="${dependency.type} == 'external'" name="External dependency">
+        <block type="output" id="O-ext" desc="Add to external deps">
+          <field name="external_deps" append="${dependency}"/>
+        </block>
       </branch>
-      <branch condition="dependency.type == 'cross_platform'">
-        <output name="cross_platform_deps" append="{{dependency}}" />
+      <branch test="${dependency.type} == 'cross_platform'" name="Cross-platform dependency">
+        <block type="output" id="O-cross" desc="Add to cross-platform deps">
+          <field name="cross_platform_deps" append="${dependency}"/>
+        </block>
       </branch>
-    </gateway>
-  </loop>
+    </block>
+  </block>
 
   <!-- Build directed graph -->
-  <task name="build_dependency_graph" action="run-script">
-    <param name="script">build-dep-graph.js</param>
-    <param name="internal_deps">{{internal_deps}}</param>
-    <param name="cross_platform_deps">{{cross_platform_deps}}</param>
-    <output name="dependency_graph" />
-  </task>
+  <block type="task" id="B10" action="run-script" desc="Build dependency graph">
+    <field name="script" value="build-dep-graph.js"/>
+    <field name="internal_deps" value="${internal_deps}"/>
+    <field name="cross_platform_deps" value="${cross_platform_deps}"/>
+    <field name="output" var="dependency_graph"/>
+  </block>
 
   <!-- Generate Mermaid diagram -->
-  <task name="generate_mermaid_deps" action="run-script">
-    <param name="script">generate-mermaid-diagram.js</param>
-    <param name="graph">{{dependency_graph}}</param>
-    <param name="diagram_type">graph LR</param>
-    <output name="mermaid_deps" />
-  </task>
+  <block type="task" id="B11" action="run-script" desc="Generate Mermaid dependency diagram">
+    <field name="script" value="generate-mermaid-diagram.js"/>
+    <field name="graph" value="${dependency_graph}"/>
+    <field name="diagram_type" value="graph LR"/>
+    <field name="output" var="mermaid_deps"/>
+  </block>
 
   <!-- Checkpoint: Dependency graph built -->
-  <checkpoint name="deps_built" verify="dependency_graph.nodes.length > 0" />
+  <block type="checkpoint" id="CP4" name="deps_built" desc="Dependency graph built">
+    <field name="verify" value="${dependency_graph.nodes.length} > 0"/>
+  </block>
 
   <!-- Step 5: Identify Business Domains -->
-  <task name="extract_domains" action="run-script">
-    <param name="script">extract-domains.js</param>
-    <param name="modules">{{module_infos}}</param>
-    <output name="business_domains" />
-  </task>
+  <block type="task" id="B12" action="run-script" desc="Extract business domains">
+    <field name="script" value="extract-domains.js"/>
+    <field name="modules" value="${module_infos}"/>
+    <field name="output" var="business_domains"/>
+  </block>
 
   <!-- Group modules by domain -->
-  <loop name="group_by_domain" over="business_domains" as="domain">
-    <task name="find_domain_modules" action="run-script">
-      <param name="script">find-domain-modules.js</param>
-      <param name="domain">{{domain}}</param>
-      <param name="modules">{{module_infos}}</param>
-      <output name="domain_modules" />
-    </task>
-  </loop>
+  <block type="loop" id="L5" over="${business_domains}" as="domain" desc="Group modules by domain">
+    <block type="task" id="B13" action="run-script" desc="Find domain modules">
+      <field name="script" value="find-domain-modules.js"/>
+      <field name="domain" value="${domain}"/>
+      <field name="modules" value="${module_infos}"/>
+      <field name="output" var="domain_modules"/>
+    </block>
+  </block>
 
   <!-- Generate domain diagram -->
-  <task name="generate_domain_diagram" action="run-script">
-    <param name="script">generate-domain-diagram.js</param>
-    <param name="domains">{{business_domains}}</param>
-    <param name="module_groups">{{domain_module_groups}}</param>
-    <output name="domain_diagram" />
-  </task>
+  <block type="task" id="B14" action="run-script" desc="Generate domain diagram">
+    <field name="script" value="generate-domain-diagram.js"/>
+    <field name="domains" value="${business_domains}"/>
+    <field name="module_groups" value="${domain_module_groups}"/>
+    <field name="output" var="domain_diagram"/>
+  </block>
 
   <!-- Checkpoint: Domains identified -->
-  <checkpoint name="domains_identified" verify="business_domains.length > 0" />
+  <block type="checkpoint" id="CP5" name="domains_identified" desc="Business domains identified">
+    <field name="verify" value="${business_domains.length} > 0"/>
+  </block>
 
   <!-- Step 6: Identify End-to-End Flows -->
-  <task name="analyze_flows" action="run-script">
-    <param name="script">analyze-cross-module-flows.js</param>
-    <param name="dependencies">{{all_dependencies}}</param>
-    <param name="modules">{{module_infos}}</param>
-    <output name="end_to_end_flows" />
-  </task>
+  <block type="task" id="B15" action="run-script" desc="Analyze cross-module flows">
+    <field name="script" value="analyze-cross-module-flows.js"/>
+    <field name="dependencies" value="${all_dependencies}"/>
+    <field name="modules" value="${module_infos}"/>
+    <field name="output" var="end_to_end_flows"/>
+  </block>
 
   <!-- Create flow-module mapping matrix -->
-  <loop name="build_flow_matrix" over="end_to_end_flows" as="flow">
-    <task name="map_flow_modules" action="run-script">
-      <param name="script">map-flow-modules.js</param>
-      <param name="flow">{{flow}}</param>
-      <param name="modules">{{module_infos}}</param>
-      <output name="flow_mapping" />
-    </task>
-  </loop>
+  <block type="loop" id="L6" over="${end_to_end_flows}" as="flow" desc="Build flow-module matrix">
+    <block type="task" id="B16" action="run-script" desc="Map flow to modules">
+      <field name="script" value="map-flow-modules.js"/>
+      <field name="flow" value="${flow}"/>
+      <field name="modules" value="${module_infos}"/>
+      <field name="output" var="flow_mapping"/>
+    </block>
+  </block>
 
   <!-- Checkpoint: Flows identified -->
-  <checkpoint name="flows_identified" verify="end_to_end_flows.length >= 0" />
+  <block type="checkpoint" id="CP6" name="flows_identified" desc="End-to-end flows identified">
+    <field name="verify" value="${end_to_end_flows.length} >= 0"/>
+  </block>
 
   <!-- Step 7: Generate system-overview.md -->
   <!-- Phase A: Skeleton Construction -->
-  <task name="count_modules" action="run-script">
-    <param name="script">count-items.js</param>
-    <param name="items">{{module_infos}}</param>
-    <output name="module_count" />
-  </task>
-
-  <task name="count_flows" action="run-script">
-    <param name="script">count-items.js</param>
-    <param name="items">{{end_to_end_flows}}</param>
-    <output name="flow_count" />
-  </task>
-
-  <task name="count_integrations" action="run-script">
-    <param name="script">count-items.js</param>
-    <param name="items">{{external_deps}}</param>
-    <output name="integration_count" />
-  </task>
+  <block type="task" id="B17" action="run-script" desc="Count modules">
+    <field name="script" value="count-items.js"/>
+    <field name="items" value="${module_infos}"/>
+    <field name="output" var="module_count"/>
+  </block>
+
+  <block type="task" id="B18" action="run-script" desc="Count flows">
+    <field name="script" value="count-items.js"/>
+    <field name="items" value="${end_to_end_flows}"/>
+    <field name="output" var="flow_count"/>
+  </block>
+
+  <block type="task" id="B19" action="run-script" desc="Count integrations">
+    <field name="script" value="count-items.js"/>
+    <field name="items" value="${external_deps}"/>
+    <field name="output" var="integration_count"/>
+  </block>
 
   <!-- Read tech stack mappings -->
-  <task name="read_tech_mappings" action="run-skill" skill="Read">
-    <param name="file_path">speccrew-workspace/docs/configs/tech-stack-mappings.json</param>
-    <output name="tech_mappings" />
-  </task>
+  <block type="task" id="B20" action="run-skill" desc="Read tech stack mappings">
+    <field name="skill">Read</field>
+    <field name="file_path" value="speccrew-workspace/docs/configs/tech-stack-mappings.json"/>
+    <field name="output" var="tech_mappings"/>
+  </block>
 
   <!-- Read Mermaid rules -->
-  <task name="read_mermaid_rules" action="run-skill" skill="Read">
-    <param name="file_path">speccrew-workspace/docs/rules/mermaid-rule.md</param>
-    <output name="mermaid_rules" />
-  </task>
+  <block type="task" id="B21" action="run-skill" desc="Read Mermaid rules">
+    <field name="skill">Read</field>
+    <field name="file_path" value="speccrew-workspace/docs/rules/mermaid-rule.md"/>
+    <field name="output" var="mermaid_rules"/>
+  </block>
 
   <!-- Get timestamp via script -->
-  <task name="get_timestamp" action="run-script" description="Get current timestamp">
-    <run-script script="scripts/get-timestamp.js" output="timestamp" />
-  </task>
+  <block type="task" id="B22" action="run-script" desc="Get current timestamp">
+    <field name="script" value="scripts/get-timestamp.js"/>
+    <field name="output" var="timestamp"/>
+  </block>
 
   <!-- Gateway: Fallback for timestamp -->
-  <gateway name="check_timestamp" mode="exclusive">
-    <branch condition="timestamp == null">
-      <task name="fallback_timestamp" action="run-script">
-        <param name="script">get-system-time.js</param>
-        <output name="timestamp" />
-      </task>
-      <event action="log" level="warning">Using system fallback timestamp</event>
+  <block type="gateway" id="G3" mode="exclusive" desc="Check timestamp">
+    <branch test="${timestamp} == null" name="No timestamp">
+      <block type="task" id="B23" action="run-script" desc="Get system fallback timestamp">
+        <field name="script" value="get-system-time.js"/>
+        <field name="output" var="timestamp"/>
+      </block>
+      <block type="event" id="E5" action="log" level="warning" desc="Log fallback">
+Using system fallback timestamp
+      </block>
     </branch>
-  </gateway>
+  </block>
 
   <!-- Determine technology stack -->
-  <task name="determine_tech_stack" action="run-script">
-    <param name="script">determine-tech-stack.js</param>
-    <param name="platforms">{{extracted_platforms}}</param>
-    <param name="mappings">{{tech_mappings}}</param>
-    <output name="tech_stack" />
-  </task>
+  <block type="task" id="B24" action="run-script" desc="Determine tech stack">
+    <field name="script" value="determine-tech-stack.js"/>
+    <field name="platforms" value="${extracted_platforms}"/>
+    <field name="mappings" value="${tech_mappings}"/>
+    <field name="output" var="tech_stack"/>
+  </block>
 
   <!-- Create skeleton structure -->
-  <task name="create_skeleton" action="run-script">
-    <param name="script">create-system-skeleton.js</param>
-    <param name="template">{{template_content}}</param>
-    <param name="module_count">{{module_count}}</param>
-    <param name="flow_count">{{flow_count}}</param>
-    <param name="integration_count">{{integration_count}}</param>
-    <param name="timestamp">{{timestamp}}</param>
-    <param name="tech_stack">{{tech_stack}}</param>
-    <param name="language">{{language}}</param>
-    <output name="document_skeleton" />
-  </task>
+  <block type="task" id="B25" action="run-script" desc="Create document skeleton">
+    <field name="script" value="create-system-skeleton.js"/>
+    <field name="template" value="${template_content}"/>
+    <field name="module_count" value="${module_count}"/>
+    <field name="flow_count" value="${flow_count}"/>
+    <field name="integration_count" value="${integration_count}"/>
+    <field name="timestamp" value="${timestamp}"/>
+    <field name="tech_stack" value="${tech_stack}"/>
+    <field name="language" value="${language}"/>
+    <field name="output" var="document_skeleton"/>
+  </block>
 
   <!-- Rule: Skeleton must be complete before filling -->
-  <rule level="mandatory">DO NOT start filling content until the complete skeleton is verified</rule>
+  <block type="rule" id="R-MAND1" level="mandatory" desc="Skeleton completion rule">
+    <field name="text">DO NOT start filling content until the complete skeleton is verified</field>
+  </block>
 
   <!-- Checkpoint: Skeleton ready -->
-  <checkpoint name="skeleton_ready" verify="document_skeleton != null AND document_skeleton.contains('[TO BE FILLED]')" />
+  <block type="checkpoint" id="CP7" name="skeleton_ready" desc="Document skeleton ready">
+    <field name="verify" value="${document_skeleton} != null AND ${document_skeleton}.contains('[TO BE FILLED]')"/>
+  </block>
 
   <!-- Phase B: Content Filling -->
   <!-- Fill Index and Overview section -->
-  <task name="fill_index_section" action="run-script">
-    <param name="script">fill-index-section.js</param>
-    <param name="skeleton">{{document_skeleton}}</param>
-    <param name="timestamp">{{timestamp}}</param>
-    <param name="tech_stack">{{tech_stack}}</param>
-    <param name="statistics">{{aggregated_stats}}</param>
-    <param name="module_index">{{module_index}}</param>
-    <output name="filled_index" />
-  </task>
+  <block type="task" id="B26" action="run-script" desc="Fill index section">
+    <field name="script" value="fill-index-section.js"/>
+    <field name="skeleton" value="${document_skeleton}"/>
+    <field name="timestamp" value="${timestamp}"/>
+    <field name="tech_stack" value="${tech_stack}"/>
+    <field name="statistics" value="${aggregated_stats}"/>
+    <field name="module_index" value="${module_index}"/>
+    <field name="output" var="filled_index"/>
+  </block>
 
   <!-- Fill Section 1: System Overview -->
-  <task name="fill_system_overview" action="run-script">
-    <param name="script">fill-system-overview.js</param>
-    <param name="skeleton">{{filled_index}}</param>
-    <param name="modules">{{module_infos}}</param>
-    <param name="language">{{language}}</param>
-    <output name="filled_section1" />
-  </task>
+  <block type="task" id="B27" action="run-script" desc="Fill system overview section">
+    <field name="script" value="fill-system-overview.js"/>
+    <field name="skeleton" value="${filled_index}"/>
+    <field name="modules" value="${module_infos}"/>
+    <field name="language" value="${language}"/>
+    <field name="output" var="filled_section1"/>
+  </block>
 
   <!-- Fill Section 2: Module Topology -->
-  <task name="fill_module_topology" action="run-script">
-    <param name="script">fill-module-topology.js</param>
-    <param name="skeleton">{{filled_section1}}</param>
-    <param name="domain_diagram">{{domain_diagram}}</param>
-    <param name="dependency_graph">{{dependency_graph}}</param>
-    <param name="mermaid_deps">{{mermaid_deps}}</param>
-    <param name="module_index">{{module_index}}</param>
-    <param name="language">{{language}}</param>
-    <output name="filled_section2" />
-  </task>
+  <block type="task" id="B28" action="run-script" desc="Fill module topology section">
+    <field name="script" value="fill-module-topology.js"/>
+    <field name="skeleton" value="${filled_section1}"/>
+    <field name="domain_diagram" value="${domain_diagram}"/>
+    <field name="dependency_graph" value="${dependency_graph}"/>
+    <field name="mermaid_deps" value="${mermaid_deps}"/>
+    <field name="module_index" value="${module_index}"/>
+    <field name="language" value="${language}"/>
+    <field name="output" var="filled_section2"/>
+  </block>
 
   <!-- Fill Section 3: End-to-End Business Flows -->
-  <task name="fill_business_flows" action="run-script">
-    <param name="script">fill-business-flows.js</param>
-    <param name="skeleton">{{filled_section2}}</param>
-    <param name="flows">{{end_to_end_flows}}</param>
-    <param name="flow_mappings">{{flow_mappings}}</param>
-    <param name="modules">{{module_infos}}</param>
-    <param name="language">{{language}}</param>
-    <output name="filled_section3" />
-  </task>
+  <block type="task" id="B29" action="run-script" desc="Fill business flows section">
+    <field name="script" value="fill-business-flows.js"/>
+    <field name="skeleton" value="${filled_section2}"/>
+    <field name="flows" value="${end_to_end_flows}"/>
+    <field name="flow_mappings" value="${flow_mappings}"/>
+    <field name="modules" value="${module_infos}"/>
+    <field name="language" value="${language}"/>
+    <field name="output" var="filled_section3"/>
+  </block>
 
   <!-- Fill Section 4: System Boundaries and Integration -->
-  <task name="fill_system_boundaries" action="run-script">
-    <param name="script">fill-system-boundaries.js</param>
-    <param name="skeleton">{{filled_section3}}</param>
-    <param name="external_deps">{{external_deps}}</param>
-    <param name="language">{{language}}</param>
-    <output name="filled_section4" />
-  </task>
+  <block type="task" id="B30" action="run-script" desc="Fill system boundaries section">
+    <field name="script" value="fill-system-boundaries.js"/>
+    <field name="skeleton" value="${filled_section3}"/>
+    <field name="external_deps" value="${external_deps}"/>
+    <field name="language" value="${language}"/>
+    <field name="output" var="filled_section4"/>
+  </block>
 
   <!-- Fill Section 5: Requirement Assessment Guide -->
-  <task name="fill_assessment_guide" action="run-script">
-    <param name="script">fill-assessment-guide.js</param>
-    <param name="skeleton">{{filled_section4}}</param>
-    <param name="language">{{language}}</param>
-    <output name="filled_section5" />
-  </task>
+  <block type="task" id="B31" action="run-script" desc="Fill assessment guide section">
+    <field name="script" value="fill-assessment-guide.js"/>
+    <field name="skeleton" value="${filled_section4}"/>
+    <field name="language" value="${language}"/>
+    <field name="output" var="filled_section5"/>
+  </block>
 
   <!-- Error Handler for document writing -->
-  <error-handler>
+  <block type="error-handler" id="EH1" desc="Document write error handling">
     <try>
       <!-- Step 7a: Prepare Document -->
-      <task name="write_document" action="run-skill" skill="Write">
-        <param name="file_path">{{output_path}}/system-overview.md</param>
-        <param name="content">{{filled_section5}}</param>
-      </task>
+      <block type="task" id="B32" action="run-skill" desc="Write document to file">
+        <field name="skill">Write</field>
+        <field name="file_path" value="${output_path}/system-overview.md"/>
+        <field name="content" value="${filled_section5}"/>
+      </block>
     </try>
-    <catch error="write_error">
-      <event action="log" level="error">Failed to write system overview: {{write_error.message}}</event>
-      <output name="status" from="failed" />
+    <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}
+      </block>
+      <block type="output" id="O-err" desc="Error output">
+        <field name="status" value="failed"/>
+      </block>
     </catch>
     <finally>
-      <event action="log" level="info">Document write operation completed</event>
+      <block type="event" id="E7" action="log" level="info" desc="Log write complete">
+Document write operation completed
+      </block>
     </finally>
-  </error-handler>
+  </block>
 
   <!-- Rule: Critical constraints -->
-  <rule level="forbidden">FORBIDDEN: create_file for documents - Document MUST be created by copying template then filling with search_replace</rule>
-  <rule level="forbidden">FORBIDDEN: Full-file rewrite - Always use targeted search_replace on specific sections</rule>
-  <rule level="mandatory">MANDATORY: Template-first workflow - Step 7a MUST execute before Step 7b</rule>
+  <block type="rule" id="R-FORB1" level="forbidden" desc="Document creation constraint">
+    <field name="text">FORBIDDEN: create_file for documents - Document MUST be created by copying template then filling with search_replace</field>
+  </block>
+  <block type="rule" id="R-FORB2" level="forbidden" desc="Full rewrite constraint">
+    <field name="text">FORBIDDEN: Full-file rewrite - Always use targeted search_replace on specific sections</field>
+  </block>
+  <block type="rule" id="R-MAND2" level="mandatory" desc="Template-first constraint">
+    <field name="text">MANDATORY: Template-first workflow - Step 7a MUST execute before Step 7b</field>
+  </block>
 
   <!-- Checkpoint: Document generated -->
-  <checkpoint name="document_generated" verify="output_file_exists == true" />
+  <block type="checkpoint" id="CP8" name="document_generated" desc="Document generated successfully">
+    <field name="verify" value="${output_file_exists} == true"/>
+  </block>
 
   <!-- Step 8: Report Results -->
-  <task name="calculate_metrics" action="run-script">
-    <param name="script">calculate-metrics.js</param>
-    <param name="modules">{{module_infos}}</param>
-    <param name="platforms">{{extracted_platforms}}</param>
-    <output name="metrics" />
-  </task>
-
-  <task name="generate_report" action="run-script">
-    <param name="script">generate-system-report.js</param>
-    <param name="module_count">{{module_count}}</param>
-    <param name="entity_count">{{metrics.entity_count}}</param>
-    <param name="api_count">{{metrics.api_count}}</param>
-    <param name="dependency_count">{{all_dependencies.length}}</param>
-    <param name="flow_count">{{flow_count}}</param>
-    <output name="completion_report" />
-  </task>
+  <block type="task" id="B33" action="run-script" desc="Calculate metrics">
+    <field name="script" value="calculate-metrics.js"/>
+    <field name="modules" value="${module_infos}"/>
+    <field name="platforms" value="${extracted_platforms}"/>
+    <field name="output" var="metrics"/>
+  </block>
+
+  <block type="task" id="B34" action="run-script" desc="Generate system report">
+    <field name="script" value="generate-system-report.js"/>
+    <field name="module_count" value="${module_count}"/>
+    <field name="entity_count" value="${metrics.entity_count}"/>
+    <field name="api_count" value="${metrics.api_count}"/>
+    <field name="dependency_count" value="${all_dependencies.length}"/>
+    <field name="flow_count" value="${flow_count}"/>
+    <field name="output" var="completion_report"/>
+  </block>
 
   <!-- Event: Log completion -->
-  <event action="log" level="info">
+  <block type="event" id="E8" action="log" level="info" desc="Log completion summary">
     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}}
+    - 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
-  </event>
+  </block>
 
   <!-- Output Block: Define workflow outputs -->
-  <output name="status" from="success" />
-  <output name="output_file" from="system-overview.md" />
-  <output name="message" from="System summarization completed with {{module_count}} modules processed" />
+  <block type="output" id="O1" desc="System summarization results">
+    <field name="status" value="success"/>
+    <field name="output_file" value="system-overview.md"/>
+    <field name="message" value="System summarization completed with ${module_count} modules processed"/>
+  </block>
 </workflow>
 
 ## Constraints