Initial commit

skills/skill-factory/references/workflow-architecture.md

@@ -0,0 +1,67 @@
+# Workflow Architecture
+
+## Entry Point Detection
+
+The skill analyzes your prompt to determine the workflow path:
+
+**Explicit Research Path (Path 1):**
+
+```text
+User: "Create coderabbit skill, research in docs/research/skills/coderabbit/"
+→ Detects research location, uses Path 1 (skip research phase)
+```
+
+**Ambiguous Path:**
+
+```text
+User: "Create coderabbit skill"
+→ Asks: "Have you already gathered research?"
+→ User response determines path
+```
+
+**Research Needed (Path 2):**
+
+```text
+User selects "No - Help me gather research"
+→ Uses Path 2 (full workflow including research)
+```
+
+## Workflow Paths
+
+### Path 1: Research Exists
+
+```text
+format → create → review-content → review-compliance →
+validate-runtime → validate-integration → validate-audit → complete
+```
+
+### Path 2: Research Needed
+
+```text
+research → format → create → review-content → review-compliance →
+validate-runtime → validate-integration → validate-audit → complete
+```
+
+## State Management
+
+Progress tracking uses TodoWrite for real-time visibility:
+
+**Path 2 Example (Full Workflow):**
+
+```javascript
+[
+  {"content": "Research skill domain", "status": "in_progress", "activeForm": "Researching skill domain"},
+  {"content": "Format research materials", "status": "pending", "activeForm": "Formatting research materials"},
+  {"content": "Create skill structure", "status": "pending", "activeForm": "Creating skill structure"},
+  {"content": "Review content quality", "status": "pending", "activeForm": "Reviewing content quality"},
+  {"content": "Review technical compliance", "status": "pending", "activeForm": "Reviewing technical compliance"},
+  {"content": "Validate runtime loading", "status": "pending", "activeForm": "Validating runtime loading"},
+  {"content": "Validate integration", "status": "pending", "activeForm": "Validating integration"},
+  {"content": "Audit skill (non-blocking)", "status": "pending", "activeForm": "Auditing skill"},
+  {"content": "Complete workflow", "status": "pending", "activeForm": "Completing workflow"}
+]
+```
+
+**Path 1 Example (Research Exists):**
+
+Omit first "Research skill domain" task from TodoWrite list.