@comfanion/workflow 4.36.42 → 4.36.44

package/bin/cli.js

@@ -124,6 +124,7 @@ program
       install_vectorizer: true,   // Vectorizer ON by default
       vectorizer_enabled: true,
       vectorizer_auto_index: true,
+      vectorizer_model: 'Xenova/bge-small-en-v1.5',  // Default: balanced (quality + speed)
       project_name: path.basename(process.cwd())
     };
     
@@ -146,6 +147,7 @@ program
           // Parse vectorizer settings
           const vectorizerEnabledMatch = existingContent.match(/vectorizer:[\s\S]*?enabled:\s*(true|false)/);
           const vectorizerAutoIndexMatch = existingContent.match(/vectorizer:[\s\S]*?auto_index:\s*(true|false)/);
+          const vectorizerModelMatch = existingContent.match(/vectorizer:[\s\S]*?model:\s*["']?([^"'\n]+)["']?/);
           
           if (nameMatch) config.user_name = nameMatch[1];
           if (langMatch) config.communication_language = langMatch[1];
@@ -155,6 +157,7 @@ program
           if (jiraProjMatch) config.jira_project = jiraProjMatch[1];
           if (vectorizerEnabledMatch) config.vectorizer_enabled = vectorizerEnabledMatch[1] === 'true';
           if (vectorizerAutoIndexMatch) config.vectorizer_auto_index = vectorizerAutoIndexMatch[1] === 'true';
+          if (vectorizerModelMatch) config.vectorizer_model = vectorizerModelMatch[1].trim();
           
           isUpdate = true;
         } catch (e) {
@@ -249,6 +252,27 @@ program
           message: 'Install vectorizer? (semantic code search, ~100MB)',
           default: true
         },
+        {
+          type: 'list',
+          name: 'vectorizer_model',
+          message: 'Embedding model for semantic search:',
+          when: (answers) => answers.install_vectorizer,
+          choices: [
+            { 
+              name: 'MiniLM-L6 (Fast)    - ~10 files/10sec, 384 dims, good quality', 
+              value: 'Xenova/all-MiniLM-L6-v2' 
+            },
+            { 
+              name: 'BGE-small (Balanced) - ~9 files/10sec, 384 dims, better quality', 
+              value: 'Xenova/bge-small-en-v1.5' 
+            },
+            { 
+              name: 'BGE-base (Quality)   - ~3 files/10sec, 768 dims, best quality', 
+              value: 'Xenova/bge-base-en-v1.5' 
+            }
+          ],
+          default: 'Xenova/bge-small-en-v1.5'
+        },
         {
           type: 'confirm',
           name: 'vectorizer_auto_index',
@@ -449,6 +473,23 @@ program
         .replace(/(# Auto-index files.*\n\s+auto_index:)\s*(true|false)/, 
           `$1 ${config.vectorizer_auto_index}`);
       
+      // Add/update vectorizer model
+      if (config.vectorizer_model) {
+        if (configContent.includes('model:') && configContent.match(/vectorizer:[\s\S]*?model:/)) {
+          // Update existing model setting
+          configContent = configContent.replace(
+            /(vectorizer:[\s\S]*?)model:\s*["']?[^"'\n]+["']?/,
+            `$1model: "${config.vectorizer_model}"`
+          );
+        } else {
+          // Add model setting after auto_index
+          configContent = configContent.replace(
+            /(auto_index:\s*(true|false))/,
+            `$1\n  \n  # Embedding model for semantic search\n  # Options: Xenova/all-MiniLM-L6-v2 (fast), Xenova/bge-base-en-v1.5 (quality)\n  model: "${config.vectorizer_model}"`
+          );
+        }
+      }
+      
       await fs.writeFile(configPath, configContent);
       
       // Create docs structure (always)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.36.42",
+  "version": "4.36.44",
   "description": "Initialize OpenCode Workflow system for AI-assisted development with semantic code search",
   "type": "module",
   "bin": {

package/src/build-info.json

@@ -1,6 +1,6 @@
 {
-  "version": "4.36.42",
-  "buildDate": "2026-01-24T22:23:56.887Z",
+  "version": "4.36.44",
+  "buildDate": "2026-01-25T01:16:46.417Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/FLOW.yaml

@@ -17,7 +17,7 @@ description: |
 # CONFIGURATION
 # =============================================================================
 config:
-  file: config.yaml
+  file: .opencode/config.yaml
   variables:
     - user_name
     - communication_language

package/src/opencode/commands/architecture.md

@@ -1,7 +1,6 @@
 ---
-description: Create or update the Architecture document
+description: Use when creating or updating system architecture document. Designs modules, data ownership, integration patterns
 agent: architect
-model: anthropic/claude-sonnet-4-20250514
 ---
 
 # Architecture Creation/Update

package/src/opencode/commands/archive.md

@@ -1,6 +1,6 @@
 ---
-description: Archive outdated documents while preserving history
-agent: archivist
+description: Use when archiving outdated documents or completed sprints while preserving history
+agent: pm
 ---
 
 # Archive Command

package/src/opencode/commands/change.md

@@ -1,5 +1,5 @@
 ---
-description: Manage change proposals for modifying existing documentation
+description: Use when managing change proposals for modifying existing documentation. Tracks deltas and impact
 agent: change-manager
 ---
 

package/src/opencode/commands/clarify.md

@@ -1,6 +1,6 @@
 ---
-description: Structured clarification of requirements before creating PRD/Architecture
-agent: requirements-analyst
+description: Use when clarifying requirements before creating PRD or Architecture. Asks structured questions to uncover gaps
+agent: analyst
 ---
 
 # Clarify Command

package/src/opencode/commands/code-review.md

@@ -1,3 +1,8 @@
+---
+description: Use when reviewing implemented code for quality, correctness, and adherence to project standards
+agent: dev
+---
+
 # /code-review Command
 
 Review implemented code for quality, correctness, and adherence to standards.
@@ -14,7 +19,7 @@ Review implemented code for quality, correctness, and adherence to standards.
 
 ## Agent
 
-This command invokes the **Dev** agent (Amelia) in review mode.
+This command invokes the **Dev** agent (Rick) in review mode.
 
 ## Process
 

package/src/opencode/commands/coding-standards.md

@@ -1,6 +1,6 @@
 ---
-description: Create or update coding standards documentation (modular, multiple files)
-agent: coding-standards
+description: Use when creating or updating coding standards documentation. Creates modular files for patterns, testing, API conventions
+agent: architect
 ---
 
 # Coding Standards Creation

package/src/opencode/commands/dev-story.md

@@ -1,3 +1,8 @@
+---
+description: Use when implementing a story using red-green-refactor TDD cycle. Finds next ready story or uses specified path
+agent: dev
+---
+
 # /dev-story Command
 
 Implement a story using red-green-refactor cycle with TODO tracking.
@@ -14,7 +19,7 @@ Implement a story using red-green-refactor cycle with TODO tracking.
 
 ## Agent
 
-This command invokes the **Dev** agent (Amelia).
+This command invokes the **Dev** agent (Rick).
 
 ## Process
 

package/src/opencode/commands/diagram.md

@@ -1,6 +1,6 @@
 ---
-description: Create technical diagrams (C4, sequence, ER, flowcharts) in Mermaid format
-agent: diagram-creator
+description: Use when creating technical diagrams - C4 architecture, sequence flows, ER data models, flowcharts in Mermaid format
+agent: architect
 ---
 
 # Diagram Creation

package/src/opencode/commands/epics.md

@@ -1,7 +1,6 @@
 ---
-description: Create epics from PRD and Architecture
-agent: sm
-model: anthropic/claude-sonnet-4-20250514
+description: Use when creating epics from PRD and Architecture. Breaks PRD requirements into implementable epics aligned with architecture modules
+agent: pm
 ---
 
 # Epic Creation

package/src/opencode/commands/help.md

@@ -1,6 +1,6 @@
 ---
-description: Analyze project state and suggest next steps (context-aware guidance)
-agent: workflow-orchestrator
+description: Use when needing guidance on project state, next steps, blockers, or quick wins in the workflow
+agent: pm
 ---
 
 # Help Command

package/src/opencode/commands/jira-sync.md

@@ -1,7 +1,6 @@
 ---
-description: Synchronize epics and stories with Jira
-agent: sm
-model: anthropic/claude-sonnet-4-20250514
+description: Use when synchronizing epics and stories with Jira. Creates issues, updates status, links branches
+agent: pm
 ---
 
 # Jira Synchronization

package/src/opencode/commands/module-docs.md

@@ -1,6 +1,6 @@
 ---
-description: Create detailed documentation for a module in docs/architecture/[module]/
-agent: module-docs
+description: Use when creating detailed documentation for a module - index.md, data-model.md, API specs, events
+agent: architect
 ---
 
 # Module Documentation

package/src/opencode/commands/prd.md

@@ -1,7 +1,6 @@
 ---
-description: Create or update the Product Requirements Document
+description: Use when creating or updating Product Requirements Document. Defines scope, FRs, NFRs, user journeys
 agent: pm
-model: anthropic/claude-sonnet-4-20250514
 ---
 
 # PRD Creation/Update

package/src/opencode/commands/quick.md

@@ -1,6 +1,6 @@
 ---
-description: Quick mode for small changes - minimal documentation workflow
-agent: workflow-orchestrator
+description: Use when making small changes (bug fixes, minor features) that don't need full documentation workflow
+agent: pm
 ---
 
 # Quick Mode

package/src/opencode/commands/requirements.md

@@ -1,7 +1,6 @@
 ---
-description: Gather and document FR/NFR requirements through stakeholder interview
+description: Use when gathering FR/NFR requirements through stakeholder interviews. First step before PRD
 agent: analyst
-model: anthropic/claude-sonnet-4-20250514
 ---
 
 # Requirements Gathering

package/src/opencode/commands/research.md

@@ -1,5 +1,5 @@
 ---
-description: Conduct technical, market, or domain research with structured documentation
+description: Use when conducting technical, market, or domain research. Creates structured research documentation
 agent: researcher
 ---
 

package/src/opencode/commands/search.md

@@ -1,5 +1,5 @@
 ---
-description: Semantic code search - find code by meaning, not just text
+description: Use when searching codebase semantically - find code by meaning, not just text matching
 agent: crawler
 ---
 

package/src/opencode/commands/sprint-plan.md

@@ -1,7 +1,6 @@
 ---
-description: Plan and manage sprints
-agent: sm
-model: anthropic/claude-sonnet-4-20250514
+description: Use when planning sprints, organizing epics into sprints, or tracking sprint progress. REQUIRES epics to exist first
+agent: pm
 ---
 
 # Sprint Planning

package/src/opencode/commands/stories.md

@@ -1,7 +1,6 @@
 ---
-description: Create stories for a specific epic
-agent: sm
-model: anthropic/claude-sonnet-4-20250514
+description: Use when creating stories for a specific epic. Breaks epic into implementable user stories with Given/When/Then acceptance criteria
+agent: pm
 ---
 
 # Story Creation

package/src/opencode/commands/unit-docs.md

@@ -1,5 +1,5 @@
 ---
-description: Document module/domain/service/entity/feature using Universal Unit format
+description: Use when documenting module/domain/service/entity using Universal Unit format with index.md, data-model.md
 agent: architect
 skills_loaded:
   - unit-writing

package/src/opencode/commands/validate.md

@@ -1,7 +1,6 @@
 ---
-description: Validate project artifacts (requirements, prd, architecture, epics)
+description: Use when validating project artifacts - requirements, PRD, architecture, or epics for completeness and quality
 agent: architect
-model: anthropic/claude-sonnet-4-20250514
 ---
 
 # Artifact Validation

package/src/opencode/commands/workflow-status.md

@@ -1,7 +1,6 @@
 ---
-description: Show project workflow status and suggest next steps
-agent: sprint-manager
-model: anthropic/claude-sonnet-4-20250514
+description: Use when checking project workflow status or getting guidance on next steps in the documentation pipeline
+agent: pm
 ---
 
 # Workflow Status

package/src/opencode/skills/sprint-planning/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sprint-planning
-description: How to organize epics and stories into sprints, manage sprint-status.yaml, and track progress
+description: Use when organizing epics into sprints, creating sprint-status.yaml, or tracking sprint progress. REQUIRES epics to exist first - run /epics if none
 license: MIT
 compatibility: opencode
 metadata:
@@ -18,6 +18,34 @@ Use this skill when you need to:
 - Track sprint progress
 - Plan new sprints
 
+## Prerequisites
+
+**CRITICAL: Epics must exist before sprint planning!**
+
+```
+Check: ls docs/sprint-artifacts/backlog/epic-*.md 2>/dev/null || ls docs/sprint-artifacts/sprint-*/epic-*.md 2>/dev/null
+```
+
+| Check | Action if Missing |
+|-------|-------------------|
+| No epics in backlog or sprints | **STOP** → Run `/epics` first to create epics from PRD |
+| Epics exist but no stories | Epics can be planned, stories created later with `/stories` |
+| PRD missing | **STOP** → Run `/prd` first |
+
+### Dependency Chain
+
+```
+/prd → /architecture → /epics → /sprint-plan
+                          ↑
+                    YOU ARE HERE
+                    (need epics first!)
+```
+
+If user asks for sprint planning without epics:
+1. Inform them epics are required
+2. Offer to create epics first with `/epics`
+3. Only proceed with sprint planning after epics exist
+
 ## Sprint Duration
 
 - **Recommended:** 2 weeks

package/src/vectorizer/index.js

@@ -45,6 +45,7 @@ const DEFAULT_PRESETS = {
 // Will be populated from config.yaml if available
 let INDEX_PRESETS = { ...DEFAULT_PRESETS };
 let GLOBAL_IGNORE = [];
+let EMBEDDING_MODEL = 'Xenova/all-MiniLM-L6-v2';  // Default: fast model
 
 /**
  * Load index configuration from config.yaml
@@ -61,6 +62,13 @@ async function loadConfig(projectRoot) {
     
     const section = vectorizerMatch[1];
     
+    // Parse embedding model
+    const modelMatch = section.match(/^\s{2}model:\s*["']?([^"'\n]+)["']?/m);
+    if (modelMatch) {
+      EMBEDDING_MODEL = modelMatch[1].trim();
+      if (DEBUG) console.log('[vectorizer] Using model from config:', EMBEDDING_MODEL);
+    }
+    
     // Parse global exclude
     const excludeMatch = section.match(/^\s{2}exclude:\s*\n((?:\s{4}-\s+.+\n?)*)/m);
     if (excludeMatch) {
@@ -148,11 +156,14 @@ class CodebaseIndexer {
 
   async loadModel() {
     if (!this.model) {
-      if (DEBUG) console.log('[vectorizer] Loading embedding model...');
-      this.model = await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2', {
+      if (DEBUG) console.log(`[vectorizer] Loading embedding model: ${EMBEDDING_MODEL}...`);
+      // Model options:
+      // - Xenova/all-MiniLM-L6-v2: fast, 384 dims, ~10 files/10sec
+      // - Xenova/bge-base-en-v1.5: quality, 768 dims, ~3 files/10sec
+      this.model = await pipeline('feature-extraction', EMBEDDING_MODEL, {
         progress_callback: DEBUG ? undefined : null  // Suppress progress bar unless DEBUG
       });
-      if (DEBUG) console.log('[vectorizer] Model loaded');
+      if (DEBUG) console.log(`[vectorizer] Model loaded: ${EMBEDDING_MODEL}`);
     }
     return this.model;
   }
@@ -485,6 +496,7 @@ class CodebaseIndexer {
     return { 
       indexName: this.indexName,
       description: preset?.description || 'Custom index',
+      model: EMBEDDING_MODEL,
       fileCount, 
       chunkCount 
     };
@@ -553,4 +565,9 @@ class CodebaseIndexer {
   }
 }
 
-export { CodebaseIndexer, INDEX_PRESETS };
+// Getter for current embedding model (after config loaded)
+function getEmbeddingModel() {
+  return EMBEDDING_MODEL;
+}
+
+export { CodebaseIndexer, INDEX_PRESETS, getEmbeddingModel };