@comfanion/workflow 4.36.42 → 4.36.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.36.42",
+  "version": "4.36.43",
   "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.43",
+  "buildDate": "2026-01-24T23:17:57.477Z",
   "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