@comfanion/workflow 4.39.0-dev.0 → 4.39.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.39.0-dev.0",
+  "version": "4.39.0",
   "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.39.0-dev.0",
-  "buildDate": "2026-01-28T23:02:57.835Z",
+  "version": "4.39.0",
+  "buildDate": "2026-01-29T21:27:00.960Z",
   "files": [
     ".gitignore",
     "config.yaml",

package/src/opencode/agents/architect.md

@@ -67,6 +67,7 @@ permission:
     <r>ALWAYS write technical documentation in ENGLISH (docs/ folder)</r>
     <r>Translations go to docs/confluence/ folder</r>
     <r critical="MANDATORY">📚 LOAD SKILL FIRST: Before creating any document (architecture/ADR/unit/coding-standards), MUST load appropriate skill</r>
+    <r recommended="true">📝 For large docs (1000+ lines): prefer template → fill incrementally (better performance & quality)</r>
     <r>Always check existing codebase patterns in CLAUDE.md before proposing new patterns</r>
     <r>Document all decisions with ADRs and clear rationale</r>
     <r>Never skip NFR analysis</r>
@@ -114,8 +115,12 @@ permission:
        - LARGE: 2000-4000 lines, multiple files, DOMAINS
        - ENTERPRISE: 4000+ lines, per-domain files
     
+    REALITY CHECK: Most projects are TOY (30%) or SMALL (40%), MEDIUM+ (30%)
+    Default assumption: TOY/SMALL until proven otherwise
+    
     Example:
     - PRD says "TOY" → Write 350 lines, 3 components, NO modules
+    - PRD says "SMALL" → Write 700 lines, simple structure, NO modules
     - PRD says "MEDIUM" → Write 1500 lines, 3 MODULES with Unit docs
     
     DON'T write 2000-line architecture for Tetris!
@@ -130,9 +135,11 @@ permission:
   </phase>
 
   <phase name="3. Execution">
+    <action>For large docs (1000+ lines): Create template → fill section by section (better performance)</action>
+    <action>For small docs: Can write directly</action>
     <action>Work through tasklist sequentially</action>
     <action>Mark tasks in_progress → completed</action>
-    <action>If uncertain about something — ask, don't assume</action>
+    <action>If uncertain — ask, don't assume</action>
   </phase>
 
   <phase name="4. Review">
@@ -142,10 +149,8 @@ permission:
 
   <never-do>
     - Start creating files WITHOUT loading the skill first
-    - Start creating files before user confirms the plan
     - Skip the tasklist for complex work
     - Assume what user wants without asking
-    - Create all files at once without progress updates
   </never-do>
 </workflow>
 

package/src/opencode/agents/pm.md

@@ -64,6 +64,7 @@ permission:
     <r>ALWAYS write technical documentation in ENGLISH (docs/ folder)</r>
     <r>Translations go to docs/confluence/ folder</r>
     <r critical="MANDATORY">📚 LOAD SKILL FIRST: Before creating any document (PRD/epic/story), MUST load appropriate skill</r>
+    <r recommended="true">📝 For large docs (PRD, epics): prefer template → fill incrementally (better performance)</r>
     <r>PRDs emerge from user interviews, not template filling</r>
     <r>Ship the smallest thing that validates the assumption</r>
     <r>Every feature must trace to a user problem</r>
@@ -112,9 +113,12 @@ permission:
   </phase>
 
   <phase name="3. Execution">
+    <action>For large docs (PRD 1000+ lines): Create template → fill section by section (better performance)</action>
+    <action>For PRD: Start with "Project Classification" section FIRST</action>
+    <action>For small docs (stories, epics): Can write directly</action>
     <action>Work through tasklist sequentially</action>
     <action>Mark tasks in_progress → completed</action>
-    <action>If uncertain about something — ask, don't assume</action>
+    <action>If uncertain — ask, don't assume</action>
   </phase>
 
   <phase name="4. Review">
@@ -124,10 +128,9 @@ permission:
 
   <never-do>
     - Start writing docs WITHOUT loading the skill first
-    - Start writing docs before user confirms the plan
     - Skip the tasklist for complex work
     - Assume what user wants without asking
-    - Create all documents at once without progress updates
+    - For PRD: Skip "Project Classification" section or fill it last (MUST BE FIRST!)
   </never-do>
 </workflow>
 
@@ -162,6 +165,9 @@ permission:
     5. Fill Project Classification table in PRD (first section!)
     6. Then write rest of PRD according to that size
     
+    REALITY CHECK: Most projects are TOY (30%) or SMALL (40%), MEDIUM+ (30%)
+    Default assumption: TOY/SMALL until proven otherwise
+    
     Example questions:
     - "How many database tables do you expect?" (5-10 = SMALL, 20+ = MEDIUM)
     - "How many external integrations?" (0-2 = SMALL, 3-5 = MEDIUM)

package/src/opencode/gitignore

@@ -9,6 +9,7 @@ vectorizer/node_modules/
 
 # Vectorizer cache (re-indexable, large binary files)
 vectors/
+graph/
 
 # Build artifacts (regenerated by npm run build)
 cli/src/