speccrew 0.6.42 → 0.6.44

package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze-xml/SKILL.md

@@ -78,401 +78,350 @@ Analyze one specific UI feature from source code, extract business functionality
 
 > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `docs/rules/xml-workflow-spec.md`
 
-```xml
-<workflow name="ui-feature-analysis" version="1.0">
-  
-  <!-- ==================== INPUT PARAMETERS ==================== -->
-  <input name="feature" type="object" required="true" description="Complete feature object from features.json"/>
-  <input name="fileName" type="string" required="true" description="Feature file name"/>
-  <input name="sourcePath" type="string" required="true" description="Relative path to source file"/>
-  <input name="documentPath" type="string" required="true" description="Target path for generated document"/>
-  <input name="module" type="string" required="true" description="Business module name"/>
-  <input name="analyzed" type="boolean" required="true" description="Analysis status flag"/>
-  <input name="platform_type" type="string" required="true" description="Platform type: web, mobile, etc."/>
-  <input name="platform_subtype" type="string" required="true" description="Platform subtype: vue, react, etc."/>
-  <input name="tech_stack" type="array" required="true" description="Platform tech stack"/>
-  <input name="language" type="string" required="true" description="Target language for generated content"/>
-  
-  <!-- ==================== CONSTRAINT RULES ==================== -->
-  <rule level="forbidden" id="no-create-file-for-docs">
-    NEVER use create_file to rewrite entire document. Documents MUST be created by copying template then filling with search_replace.
-  </rule>
-  <rule level="forbidden" id="no-file-deletion">
-    NEVER delete generated files. If a file is malformed, fix it with search_replace.
-  </rule>
-  <rule level="forbidden" id="no-full-rewrite">
-    NEVER rewrite entire document. Always use targeted search_replace on specific sections.
-  </rule>
-  <rule level="mandatory" id="template-first">
-    Template copying (Step 5a) MUST execute before section filling (Step 5b).
-  </rule>
-  <rule level="mandatory" id="all-sections-filled">
-    ALL sections in the template must be filled. Use "N/A" for unavailable data, never skip a section.
-  </rule>
-  <rule level="mandatory" id="language-compliance">
-    ALL content MUST be generated in the language specified by {{language}} parameter.
-  </rule>
-  
-  <!-- ==================== STEP 0: CHECK ANALYSIS STATUS ==================== -->
-  <gateway name="check-analyzed-status" mode="exclusive">
-    <branch condition="{{analyzed}} == true">
-      <event action="log" level="info" message="Step 0 Status: SKIPPED (already analyzed)"/>
-      <output name="status" value="skipped"/>
-      <output name="message" value="Feature already analyzed, skipping"/>
-      <checkpoint name="skip-complete" verify="true"/>
-    </branch>
-    <branch condition="{{analyzed}} == false">
-      <event action="log" level="info" message="Step 0 Status: PROCEEDING (analysis required)"/>
-    </branch>
-  </gateway>
-  
-  <!-- ==================== STEP 1: READ ANALYSIS TEMPLATE ==================== -->
-  <task name="step1-read-template" action="run-skill">
-    <description>Read the appropriate template based on platform type</description>
-    <parameter name="platform_type">{{platform_type}}</parameter>
-    <parameter name="platform_subtype">{{platform_subtype}}</parameter>
-    <script>
-      <!-- Template Selection Logic -->
-      <gateway name="template-selection" mode="exclusive">
-        <branch condition="{{platform_type}} == 'mobile'">
-          <output name="templateFile" value="../speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-MOBILE.md"/>
-        </branch>
-        <branch condition="{{platform_type}} == 'miniapp'">
-          <output name="templateFile" value="../speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-MINIAPP.md"/>
-        </branch>
-        <branch condition="{{platform_type}} == 'desktop' AND {{platform_subtype}} == 'electron'">
-          <output name="templateFile" value="../speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-ELECTRON.md"/>
-        </branch>
-        <branch condition="{{platform_type}} == 'desktop'">
-          <output name="templateFile" value="../speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-DESKTOP.md"/>
-        </branch>
-        <branch condition="default">
-          <output name="templateFile" value="../speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI.md"/>
-        </branch>
-      </gateway>
-      
-      <!-- Read Template Content -->
-      <task action="read-file" target="{{templateFile}}">
-        <output name="templateContent" from="file.content"/>
-      </task>
-      
-      <!-- Validate Template Structure -->
-      <checkpoint name="template-loaded" verify="{{templateContent}} != null AND {{templateContent}} != ''"/>
-      <event action="log" level="info" message="Step 1 Status: COMPLETED - Read template for {{platform_type}}/{{platform_subtype}}"/>
-    </script>
-  </task>
-  
-  <!-- ==================== STEP 2: READ FEATURE FILE AND ANALYZE UI STRUCTURE ==================== -->
-  <task name="step2-read-source" action="run-skill">
-    <description>Read feature file and analyze UI structure, components, props, state management</description>
-    <parameter name="sourcePath">{{sourcePath}}</parameter>
-    <script>
-      <!-- Read Source File -->
-      <task action="read-file" target="{{sourcePath}}">
-        <output name="sourceContent" from="file.content"/>
-        <output name="lineCount" from="file.lineCount"/>
-      </task>
-      
-      <!-- Analyze UI Structure -->
-      <task action="analyze-ui">
-        <input name="content">{{sourceContent}}</input>
-        <input name="tech_stack">{{tech_stack}}</input>
-        <output name="componentCount" from="analysis.components"/>
-        <output name="eventCount" from="analysis.events"/>
-        <output name="apiCalls" from="analysis.apis"/>
-        <output name="stateFields" from="analysis.state"/>
-        <output name="formFields" from="analysis.forms"/>
-      </task>
-      
-      <checkpoint name="source-analyzed" verify="{{sourceContent}} != null"/>
-      <event action="log" level="info" message="Step 2 Status: COMPLETED - Read {{sourcePath}} ({{lineCount}} lines), Analyzed {{componentCount}} components, {{eventCount}} events"/>
-    </script>
-  </task>
-  
-  <!-- ==================== STEP 3: EXTRACT BUSINESS FEATURES ==================== -->
-  <task name="step3-extract-features" action="run-skill">
-    <description>Extract business features, wireframes, and business flows from source analysis</description>
-    <parameter name="sourceContent">{{sourceContent}}</parameter>
-    <parameter name="language">{{language}}</parameter>
-    <script>
-      <!-- Read Mermaid Rules -->
-      <task action="read-file" target="speccrew-workspace/docs/rules/mermaid-rule.md">
-        <output name="mermaidRules" from="file.content"/>
-      </task>
-      
-      <!-- Extract Wireframes -->
-      <task action="extract-wireframes">
-        <input name="content">{{sourceContent}}</input>
-        <input name="platform">{{platform_type}}</input>
-        <output name="wireframes" from="extraction.wireframes"/>
-        <output name="wireframeCount" from="extraction.count"/>
-      </task>
-      
-      <!-- Extract Business Flows -->
-      <task action="extract-flows">
-        <input name="content">{{sourceContent}}</input>
-        <input name="events">{{eventCount}}</input>
-        <output name="flows" from="extraction.flows"/>
-        <output name="flowCount" from="extraction.count"/>
-        <output name="sequenceAnalysis" from="extraction.sequences"/>
-        <output name="boundaryScenarios" from="extraction.boundaries"/>
-      </task>
-      
-      <!-- Extract Data Bindings -->
-      <task action="extract-data-bindings">
-        <input name="stateFields">{{stateFields}}</input>
-        <input name="formFields">{{formFields}}</input>
-        <output name="dataBindingMap" from="extraction.bindings"/>
-        <output name="reactiveDependencies" from="extraction.dependencies"/>
-      </task>
-      
-      <checkpoint name="features-extracted" verify="{{flowCount}} &gt; 0 OR {{wireframeCount}} &gt; 0"/>
-      <event action="log" level="info" message="Step 3 Status: COMPLETED - Extracted {{wireframeCount}} wireframes, {{flowCount}} business flows"/>
-    </script>
-  </task>
-  
-  <!-- ==================== STEP 4: FIND REFERENCING PAGES ==================== -->
-  <task name="step4-find-references" action="run-skill">
-    <description>Search other page files to find which pages reference/navigate to this page</description>
-    <parameter name="fileName">{{fileName}}</parameter>
-    <parameter name="sourcePath">{{sourcePath}}</parameter>
-    <script>
-      <!-- Search for Router Navigation -->
-      <task action="grep-search">
-        <input name="pattern">{{fileName}}</input>
-        <input name="glob">*.{vue,tsx,jsx}</input>
-        <output name="routerMatches" from="search.results"/>
-      </task>
-      
-      <!-- Search for Component Imports -->
-      <task action="grep-search">
-        <input name="pattern">import.*{{fileName}}</input>
-        <input name="glob">*.{vue,tsx,jsx,ts,js}</input>
-        <output name="importMatches" from="search.results"/>
-      </task>
-      
-      <!-- Compile Referencing Pages -->
-      <task action="compile-references">
-        <input name="routerMatches">{{routerMatches}}</input>
-        <input name="importMatches">{{importMatches}}</input>
-        <output name="referencingPages" from="compilation.pages"/>
-        <output name="referenceCount" from="compilation.count"/>
-      </task>
-      
-      <event action="log" level="info" message="Step 4 Status: COMPLETED - Found {{referenceCount}} referencing pages"/>
-    </script>
-  </task>
-  
-  <!-- ==================== STEP 5A: COPY TEMPLATE TO DOCUMENT PATH ==================== -->
-  <task name="step5a-copy-template" action="run-skill">
-    <description>Copy the appropriate template file to the target document path, replacing top-level placeholders</description>
-    <parameter name="templateContent">{{templateContent}}</parameter>
-    <parameter name="documentPath">{{documentPath}}</parameter>
-    <parameter name="fileName">{{fileName}}</parameter>
-    <parameter name="sourcePath">{{sourcePath}}</parameter>
-    <parameter name="language">{{language}}</parameter>
-    <script>
-      <!-- Prepare Placeholder Replacements -->
-      <task action="prepare-replacements">
-        <output name="featureName" from="i18n.featureName"/>
-        <output name="currentDate" from="date.now"/>
-      </task>
-      
-      <!-- Replace Top-Level Placeholders -->
-      <task action="replace-placeholders">
-        <input name="template">{{templateContent}}</input>
-        <replacements>
-          <replacement from="{Feature Name}" to="{{featureName}}"/>
-          <replacement from="{documentPath}" to="{{documentPath}}"/>
-          <replacement from="{sourcePath}" to="{{sourcePath}}"/>
-          <replacement from="{Date}" to="{{currentDate}}"/>
-          <replacement from="{FeatureFile}.vue" to="{{fileName}}.vue"/>
-        </replacements>
-        <output name="documentSkeleton" from="result.content"/>
-      </task>
-      
-      <!-- Write Document Skeleton -->
-      <task action="create-file" target="{{documentPath}}">
-        <content>{{documentSkeleton}}</content>
-      </task>
-      
-      <checkpoint name="template-copied" verify="file.exists({{documentPath}})"/>
-      <event action="log" level="info" message="Step 5a Status: COMPLETED - Template copied to {{documentPath}}"/>
-    </script>
-  </task>
-  
-  <!-- ==================== STEP 5B: FILL EACH SECTION USING SEARCH_REPLACE ==================== -->
-  <task name="step5b-fill-sections" action="run-skill">
-    <description>Fill each section of the copied template document using search_replace</description>
-    <parameter name="documentPath">{{documentPath}}</parameter>
-    <parameter name="analysisData">{{analysisData}}</parameter>
-    <parameter name="language">{{language}}</parameter>
-    <script>
-      <!-- Section 1: Content Overview -->
-      <task action="search_replace" target="{{documentPath}}">
-        <search>## 1. Content Overview.*?(?=## 2.|$)</search>
-        <replace>## 1. Content Overview
-
-{{section1Content}}</replace>
-      </task>
-      
-      <!-- Section 2: Interface Prototype -->
-      <task action="search_replace" target="{{documentPath}}">
-        <search>## 2. Interface Prototype.*?(?=## 3.|$)</search>
-        <replace>## 2. Interface Prototype
-
-{{wireframes}}
-
-### Interface Element Description
-
-{{elementDescriptions}}</replace>
-      </task>
-      
-      <!-- Section 3: Business Flow -->
-      <task action="search_replace" target="{{documentPath}}">
-        <search>## 3. Business Flow.*?(?=## 4.|$)</search>
-        <replace>## 3. Business Flow
-
-{{businessFlows}}
-
-### API Call Sequence Analysis
-
-{{sequenceAnalysis}}
-
-### Boundary Scenarios
-
-{{boundaryScenarios}}</replace>
-      </task>
-      
-      <!-- Section 4: Data Field Definition -->
-      <task action="search_replace" target="{{documentPath}}">
-        <search>## 4. Data Field Definition.*?(?=## 5.|$)</search>
-        <replace>## 4. Data Field Definition
-
-### Page State Fields
-
-{{stateFieldsTable}}
-
-### Form Fields
-
-{{formFieldsTable}}
-
-### Data Binding Mapping
-
-{{dataBindingMap}}
+<workflow id="ui-feature-analysis" version="1.0" status="pending" desc="UI feature analysis workflow">
 
-### Reactive Dependency Chain
-
-{{reactiveDependencies}}</replace>
-      </task>
-      
-      <!-- Section 5: References -->
-      <task action="search_replace" target="{{documentPath}}">
-        <search>## 5. References.*?(?=## 6.|$)</search>
-        <replace>## 5. References
-
-### APIs
-
-{{apiReferences}}
-
-### Shared Methods
-
-{{sharedMethods}}
-
-### Shared Components
-
-{{sharedComponents}}
-
-### Other Pages
-
-{{otherPages}}
-
-### Referenced By
-
-{{referencedBy}}</replace>
-      </task>
-      
-      <!-- Section 6: Business Rule Constraints -->
-      <task action="search_replace" target="{{documentPath}}">
-        <search>## 6. Business Rule Constraints.*?(?=## 7.|$)</search>
-        <replace>## 6. Business Rule Constraints
+  <!-- ==================== INPUT PARAMETERS ==================== -->
+  <block type="input" id="I1" desc="UI feature analysis input parameters">
+    <field name="feature" required="true" type="object" desc="Complete feature object from features.json"/>
+    <field name="fileName" required="true" type="string" desc="Feature file name"/>
+    <field name="sourcePath" required="true" type="string" desc="Relative path to source file"/>
+    <field name="documentPath" required="true" type="string" desc="Target path for generated document"/>
+    <field name="module" required="true" type="string" desc="Business module name"/>
+    <field name="analyzed" required="true" type="boolean" desc="Analysis status flag"/>
+    <field name="platform_type" required="true" type="string" desc="Platform type: web, mobile, etc."/>
+    <field name="platform_subtype" required="true" type="string" desc="Platform subtype: vue, react, etc."/>
+    <field name="tech_stack" required="true" type="array" desc="Platform tech stack"/>
+    <field name="language" required="true" type="string" desc="Target language for generated content"/>
+    <field name="completed_dir" required="true" type="string" desc="Marker file output directory"/>
+    <field name="workspace_path" required="true" type="string" desc="Workspace root path"/>
+    <field name="sync_state_bizs_dir" required="true" type="string" desc="Sync state directory path"/>
+    <field name="sourceFile" required="true" type="string" desc="Source features JSON filename"/>
+  </block>
 
-### Permission Rules
+  <!-- ==================== CONSTRAINT RULES ==================== -->
+  <block type="rule" id="R1" level="forbidden" desc="Document generation constraints">
+    <field name="text">NEVER use create_file to rewrite entire document. Documents MUST be created by copying template then filling with search_replace.</field>
+  </block>
+  <block type="rule" id="R2" level="forbidden" desc="File deletion constraint">
+    <field name="text">NEVER delete generated files. If a file is malformed, fix it with search_replace.</field>
+  </block>
+  <block type="rule" id="R3" level="forbidden" desc="Full rewrite constraint">
+    <field name="text">NEVER rewrite entire document. Always use targeted search_replace on specific sections.</field>
+  </block>
+  <block type="rule" id="R4" level="mandatory" desc="Template-first workflow">
+    <field name="text">Template copying (Step 5a) MUST execute before section filling (Step 5b).</field>
+  </block>
+  <block type="rule" id="R5" level="mandatory" desc="All sections filled">
+    <field name="text">ALL sections in the template must be filled. Use "N/A" for unavailable data, never skip a section.</field>
+  </block>
+  <block type="rule" id="R6" level="mandatory" desc="Language compliance">
+    <field name="text">ALL content MUST be generated in the language specified by {{language}} parameter.</field>
+  </block>
+
+  <!-- ==================== 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>
+    <field name="text">DO NOT suggest "Due to context window limits, let me pause" — complete current task, use checkpoint for resumption</field>
+    <field name="text">DO NOT estimate workload and suggest breaking it into phases — execute ALL items in sequence</field>
+    <field name="text">DO NOT warn about "large number of files" or "this may take a while" — proceed with generation</field>
+    <field name="text">Context window management: if approaching limit, save progress to checkpoint file and resume — do NOT ask user for guidance</field>
+  </block>
 
-{{permissionRules}}
+  <!-- ==================== STEP 0: CHECK ANALYSIS STATUS ==================== -->
+  <sequence id="S0" name="Step 0: Check Analysis Status" status="pending" desc="Check if feature has already been analyzed">
+    <block type="gateway" id="G0" mode="exclusive" desc="Check analyzed status">
+      <branch test="${analyzed} == true" name="Already analyzed">
+        <block type="event" id="E0a" action="log" level="info" desc="Skip already analyzed feature">
+Step 0 Status: SKIPPED (already analyzed)
+        </block>
+        <block type="output" id="O0a" desc="Skip output">
+          <field name="status" value="skipped"/>
+          <field name="message" value="Feature already analyzed, skipping"/>
+        </block>
+        <block type="checkpoint" id="CP0" name="skip-complete" desc="Skip checkpoint">
+          <field name="verify" value="true"/>
+        </block>
+      </branch>
+      <branch test="${analyzed} == false" name="Proceed with analysis">
+        <block type="event" id="E0b" action="log" level="info" desc="Proceed with analysis">
+Step 0 Status: PROCEEDING (analysis required)
+        </block>
+      </branch>
+    </block>
+  </sequence>
 
-### Business Logic Rules
+  <!-- ==================== STEP 1: READ ANALYSIS TEMPLATE ==================== -->
+  <sequence id="S1" name="Step 1: Read Template" status="pending" desc="Read the appropriate template based on platform type">
+    <!-- Template Selection Logic -->
+    <block type="gateway" id="G1" mode="exclusive" desc="Select template based on platform type">
+      <branch test="${platform_type} == 'mobile'" name="Mobile template">
+        <field name="templateFile" value="../speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-MOBILE.md"/>
+      </branch>
+      <branch test="${platform_type} == 'miniapp'" name="Miniapp template">
+        <field name="templateFile" value="../speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-MINIAPP.md"/>
+      </branch>
+      <branch test="${platform_type} == 'desktop' AND ${platform_subtype} == 'electron'" name="Electron template">
+        <field name="templateFile" value="../speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-ELECTRON.md"/>
+      </branch>
+      <branch test="${platform_type} == 'desktop'" name="Desktop template">
+        <field name="templateFile" value="../speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-DESKTOP.md"/>
+      </branch>
+      <branch default="true" name="Default Web template">
+        <field name="templateFile" value="../speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI.md"/>
+      </branch>
+    </block>
+
+    <!-- Read Template Content -->
+    <block type="task" id="B1" action="read-file" desc="Read template content">
+      <field name="path" value="${templateFile}"/>
+      <field name="output" var="templateContent"/>
+    </block>
+
+    <!-- Validate Template Structure -->
+    <block type="checkpoint" id="CP1" name="template-loaded" desc="Template loaded checkpoint">
+      <field name="verify" value="${templateContent} != null AND ${templateContent} != ''"/>
+    </block>
+    <block type="event" id="E1" action="log" level="info" desc="Log template read">
+Step 1 Status: COMPLETED - Read template for ${platform_type}/${platform_subtype}
+    </block>
+  </sequence>
 
-{{businessRules}}
+  <!-- ==================== STEP 2: READ FEATURE FILE AND ANALYZE UI STRUCTURE ==================== -->
+  <sequence id="S2" name="Step 2: Read Source" status="pending" desc="Read feature file and analyze UI structure">
+    <!-- Read Source File -->
+    <block type="task" id="B2" action="read-file" desc="Read source file">
+      <field name="path" value="${sourcePath}"/>
+      <field name="output" var="sourceContent"/>
+    </block>
+
+    <!-- Analyze UI Structure -->
+    <block type="task" id="B2b" action="analyze" desc="Analyze UI structure">
+      <field name="content" value="${sourceContent}"/>
+      <field name="tech_stack" value="${tech_stack}"/>
+      <field name="output" var="analysisResult"/>
+      <field name="componentCount" from="${analysisResult.components.length}"/>
+      <field name="eventCount" from="${analysisResult.events.length}"/>
+      <field name="apiCalls" from="${analysisResult.apis}"/>
+      <field name="stateFields" from="${analysisResult.state}"/>
+      <field name="formFields" from="${analysisResult.forms}"/>
+    </block>
+
+    <block type="checkpoint" id="CP2" name="source-analyzed" desc="Source analyzed checkpoint">
+      <field name="verify" value="${sourceContent} != null"/>
+    </block>
+    <block type="event" id="E2" action="log" level="info" desc="Log source analysis">
+Step 2 Status: COMPLETED - Read ${sourcePath}, Analyzed ${componentCount} components, ${eventCount} events
+    </block>
+  </sequence>
 
-### Validation Rules
+  <!-- ==================== STEP 3: EXTRACT BUSINESS FEATURES ==================== -->
+  <sequence id="S3" name="Step 3: Extract Features" status="pending" desc="Extract business features and flows">
+    <!-- Read Mermaid Rules -->
+    <block type="task" id="B3a" action="read-file" desc="Read Mermaid rules">
+      <field name="path" value="speccrew-workspace/docs/rules/mermaid-rule.md"/>
+      <field name="output" var="mermaidRules"/>
+    </block>
+
+    <!-- Extract Wireframes -->
+    <block type="task" id="B3b" action="analyze" desc="Extract wireframes">
+      <field name="content" value="${sourceContent}"/>
+      <field name="platform" value="${platform_type}"/>
+      <field name="output" var="wireframes"/>
+    </block>
+
+    <!-- Extract Business Flows -->
+    <block type="task" id="B3c" action="analyze" desc="Extract business flows">
+      <field name="content" value="${sourceContent}"/>
+      <field name="events" value="${eventCount}"/>
+      <field name="output" var="flows"/>
+      <field name="sequenceAnalysis" from="${flows.sequences}"/>
+      <field name="boundaryScenarios" from="${flows.boundaries}"/>
+    </block>
+
+    <!-- Extract Data Bindings -->
+    <block type="task" id="B3d" action="analyze" desc="Extract data bindings">
+      <field name="stateFields" value="${stateFields}"/>
+      <field name="formFields" value="${formFields}"/>
+      <field name="output" var="dataBindingMap"/>
+      <field name="reactiveDependencies" from="${dataBindingMap.dependencies}"/>
+    </block>
+
+    <block type="checkpoint" id="CP3" name="features-extracted" desc="Features extracted checkpoint">
+      <field name="verify" value="${flows.length} > 0 OR ${wireframes.length} > 0"/>
+    </block>
+    <block type="event" id="E3" action="log" level="info" desc="Log feature extraction">
+Step 3 Status: COMPLETED - Extracted ${wireframes.length} wireframes, ${flows.length} business flows
+    </block>
+  </sequence>
 
-{{validationRules}}</replace>
-      </task>
-      
-      <!-- Section 7: Notes and Additional Information -->
-      <task action="search_replace" target="{{documentPath}}">
-        <search>## 7. Notes and Additional Information.*?(?=$)</search>
-        <replace>## 7. Notes and Additional Information
+  <!-- ==================== STEP 4: FIND REFERENCING PAGES ==================== -->
+  <sequence id="S4" name="Step 4: Find References" status="pending" desc="Find referencing pages">
+    <!-- Search for Router Navigation -->
+    <block type="task" id="B4a" action="run-script" desc="Search router references">
+      <field name="command">grep -r "${fileName}" --include="*.{vue,tsx,jsx}" "${sourcePath}/.."</field>
+      <field name="output" var="routerMatches"/>
+    </block>
+
+    <!-- Search for Component Imports -->
+    <block type="task" id="B4b" action="run-script" desc="Search import references">
+      <field name="command">grep -r "import.*${fileName}" --include="*.{vue,tsx,jsx,ts,js}" "${sourcePath}/.."</field>
+      <field name="output" var="importMatches"/>
+    </block>
+
+    <!-- Compile Referencing Pages -->
+    <block type="task" id="B4c" action="analyze" desc="Compile references">
+      <field name="routerMatches" value="${routerMatches}"/>
+      <field name="importMatches" value="${importMatches}"/>
+      <field name="output" var="referencingPages"/>
+    </block>
+
+    <block type="event" id="E4" action="log" level="info" desc="Log reference search">
+Step 4 Status: COMPLETED - Found ${referencingPages.length} referencing pages
+    </block>
+  </sequence>
 
-{{notes}}
+  <!-- ==================== STEP 5A: COPY TEMPLATE TO DOCUMENT PATH ==================== -->
+  <sequence id="S5a" name="Step 5a: Copy Template" status="pending" desc="Copy template to document path">
+    <!-- Prepare Placeholder Replacements -->
+    <block type="task" id="B5a1" action="analyze" desc="Prepare replacements">
+      <field name="language" value="${language}"/>
+      <field name="fileName" value="${fileName}"/>
+      <field name="output" var="replacements"/>
+    </block>
+
+    <!-- Replace Top-Level Placeholders and Write Document Skeleton -->
+    <block type="task" id="B5a2" action="write-file" desc="Write document skeleton">
+      <field name="path" value="${documentPath}"/>
+      <field name="content" value="${templateContent}"/>
+      <field name="note">Replace placeholders {Feature Name}, {documentPath}, {sourcePath}, {Date}, {FeatureFile}.vue with actual values</field>
+    </block>
+
+    <block type="checkpoint" id="CP5a" name="template-copied" desc="Template copied checkpoint">
+      <field name="verify" value="file.exists(${documentPath})"/>
+    </block>
+    <block type="event" id="E5a" action="log" level="info" desc="Log template copy">
+Step 5a Status: COMPLETED - Template copied to ${documentPath}
+    </block>
+  </sequence>
 
-### Performance and Scalability Analysis
+  <!-- ==================== STEP 5B: FILL EACH SECTION USING SEARCH_REPLACE ==================== -->
+  <sequence id="S5b" name="Step 5b: Fill Sections" status="pending" desc="Fill document sections">
+    <!-- Section 1: Content Overview -->
+    <block type="task" id="B5b1" action="run-skill" desc="Fill Section 1">
+      <field name="skill">search_replace</field>
+      <field name="file_path" value="${documentPath}"/>
+      <field name="search" value="## 1. Content Overview.*?(?=## 2.|$)"/>
+      <field name="replace" value="## 1. Content Overview\n\n${section1Content}"/>
+    </block>
+
+    <!-- Section 2: Interface Prototype -->
+    <block type="task" id="B5b2" action="run-skill" desc="Fill Section 2">
+      <field name="skill">search_replace</field>
+      <field name="file_path" value="${documentPath}"/>
+      <field name="search" value="## 2. Interface Prototype.*?(?=## 3.|$)"/>
+      <field name="replace" value="## 2. Interface Prototype\n\n${wireframes}\n\n### Interface Element Description\n\n${elementDescriptions}"/>
+    </block>
+
+    <!-- Section 3: Business Flow -->
+    <block type="task" id="B5b3" action="run-skill" desc="Fill Section 3">
+      <field name="skill">search_replace</field>
+      <field name="file_path" value="${documentPath}"/>
+      <field name="search" value="## 3. Business Flow.*?(?=## 4.|$)"/>
+      <field name="replace" value="## 3. Business Flow\n\n${businessFlows}\n\n### API Call Sequence Analysis\n\n${sequenceAnalysis}\n\n### Boundary Scenarios\n\n${boundaryScenarios}"/>
+    </block>
+
+    <!-- Section 4: Data Field Definition -->
+    <block type="task" id="B5b4" action="run-skill" desc="Fill Section 4">
+      <field name="skill">search_replace</field>
+      <field name="file_path" value="${documentPath}"/>
+      <field name="search" value="## 4. Data Field Definition.*?(?=## 5.|$)"/>
+      <field name="replace" value="## 4. Data Field Definition\n\n### Page State Fields\n\n${stateFieldsTable}\n\n### Form Fields\n\n${formFieldsTable}\n\n### Data Binding Mapping\n\n${dataBindingMap}\n\n### Reactive Dependency Chain\n\n${reactiveDependencies}"/>
+    </block>
+
+    <!-- Section 5: References -->
+    <block type="task" id="B5b5" action="run-skill" desc="Fill Section 5">
+      <field name="skill">search_replace</field>
+      <field name="file_path" value="${documentPath}"/>
+      <field name="search" value="## 5. References.*?(?=## 6.|$)"/>
+      <field name="replace" value="## 5. References\n\n### APIs\n\n${apiReferences}\n\n### Shared Methods\n\n${sharedMethods}\n\n### Shared Components\n\n${sharedComponents}\n\n### Other Pages\n\n${otherPages}\n\n### Referenced By\n\n${referencedBy}"/>
+    </block>
+
+    <!-- Section 6: Business Rule Constraints -->
+    <block type="task" id="B5b6" action="run-skill" desc="Fill Section 6">
+      <field name="skill">search_replace</field>
+      <field name="file_path" value="${documentPath}"/>
+      <field name="search" value="## 6. Business Rule Constraints.*?(?=## 7.|$)"/>
+      <field name="replace" value="## 6. Business Rule Constraints\n\n### Permission Rules\n\n${permissionRules}\n\n### Business Logic Rules\n\n${businessRules}\n\n### Validation Rules\n\n${validationRules}"/>
+    </block>
+
+    <!-- Section 7: Notes and Additional Information -->
+    <block type="task" id="B5b7" action="run-skill" desc="Fill Section 7">
+      <field name="skill">search_replace</field>
+      <field name="file_path" value="${documentPath}"/>
+      <field name="search" value="## 7. Notes and Additional Information.*?(?=$)"/>
+      <field name="replace" value="## 7. Notes and Additional Information\n\n${notes}\n\n### Performance and Scalability Analysis\n\n${performanceAnalysis}"/>
+    </block>
+
+    <block type="checkpoint" id="CP5b" name="all-sections-filled" desc="All sections filled checkpoint">
+      <field name="verify" value="all.sections.filled"/>
+    </block>
+    <block type="event" id="E5b" action="log" level="info" desc="Log section filling">
+Step 5b Status: COMPLETED - All sections filled using search_replace
+    </block>
+  </sequence>
 
-{{performanceAnalysis}}</replace>
-      </task>
-      
-      <checkpoint name="all-sections-filled" verify="all.sections.filled"/>
-      <event action="log" level="info" message="Step 5b Status: COMPLETED - All sections filled using search_replace"/>
-    </script>
-  </task>
-  
   <!-- ==================== STEP 6: REPORT RESULTS ==================== -->
-  <task name="step6-report" action="run-skill">
-    <description>Return analysis result summary</description>
-    <script>
-      <output name="status" value="success"/>
-      <output name="feature_name" value="{{fileName}}"/>
-      <output name="generated_file" value="{{documentPath}}"/>
-      <output name="message" value="Successfully analyzed {{fileName}} feature from {{sourcePath}}"/>
-      
-      <event action="log" level="info" message="Step 6 Status: COMPLETED - Analysis {{status}}: {{message}}"/>
-    </script>
-  </task>
-  
+  <sequence id="S6" name="Step 6: Report Results" status="pending" desc="Report analysis results">
+    <block type="event" id="E6" action="log" level="info" desc="Log final status">
+Step 6 Status: COMPLETED - Analysis success: Successfully analyzed ${fileName} feature from ${sourcePath}
+    </block>
+  </sequence>
+
   <!-- ==================== FINAL OUTPUT ==================== -->
-  <output name="status" from="step6-report.status"/>
-  <output name="feature" from="step6-report.feature"/>
-  <output name="platformType" from="input.platform_type"/>
-  <output name="module" from="input.module"/>
-  <output name="featureName" from="step6-report.feature_name"/>
-  <output name="generatedFile" from="step6-report.generated_file"/>
-  <output name="message" from="step6-report.message"/>
-  
+  <block type="output" id="O1" desc="UI feature analysis output results">
+    <field name="status" value="success"/>
+    <field name="feature_name" from="${fileName}"/>
+    <field name="generated_file" from="${documentPath}"/>
+    <field name="message" value="Successfully analyzed ${fileName} feature from ${sourcePath}"/>
+    <field name="platformType" from="${platform_type}"/>
+    <field name="module" from="${module}"/>
+  </block>
+
   <!-- ==================== ERROR HANDLING ==================== -->
-  <error-handler>
-    <catch type="file-not-found">
-      <event action="log" level="error" message="Source file not found: {{sourcePath}}"/>
-      <output name="status" value="failed"/>
-      <output name="message" value="Source file not found: {{sourcePath}}"/>
+  <block type="error-handler" id="EH1" desc="Handle workflow errors">
+    <try>
+      <!-- Main workflow defined in sequences above -->
+    </try>
+    <catch error-type="file-not-found">
+      <block type="event" id="EH1-E1" action="log" level="error" desc="File not found error">
+Source file not found: ${sourcePath}
+      </block>
+      <field name="status" value="failed"/>
+      <field name="message" value="Source file not found: ${sourcePath}"/>
     </catch>
-    <catch type="template-error">
-      <event action="log" level="error" message="Template processing error"/>
-      <output name="status" value="failed"/>
-      <output name="message" value="Failed to process template"/>
+    <catch error-type="template-error">
+      <block type="event" id="EH1-E2" action="log" level="error" desc="Template error">
+Template processing error
+      </block>
+      <field name="status" value="failed"/>
+      <field name="message" value="Failed to process template"/>
     </catch>
-    <catch type="validation-error">
-      <event action="log" level="error" message="Validation failed: {{error.message}}"/>
-      <output name="status" value="partial"/>
-      <output name="message" value="Analysis completed with validation errors"/>
+    <catch error-type="validation-error">
+      <block type="event" id="EH1-E3" action="log" level="error" desc="Validation error">
+Validation failed: ${error.message}
+      </block>
+      <field name="status" value="partial"/>
+      <field name="message" value="Analysis completed with validation errors"/>
     </catch>
     <finally>
-      <event action="log" level="info" message="Workflow execution completed"/>
+      <block type="event" id="EH1-E4" action="log" level="info" desc="Workflow completed">
+Workflow execution completed
+      </block>
     </finally>
-  </error-handler>
-  
+  </block>
+
 </workflow>
-```
 
 ## Constraints