@comfanion/workflow 4.36.21 → 4.36.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.36.21",
+  "version": "4.36.22",
   "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.21",
-  "buildDate": "2026-01-24T17:35:27.690Z",
+  "version": "4.36.22",
+  "buildDate": "2026-01-24T17:58:25.989Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/agents/analyst.md

@@ -14,9 +14,11 @@ tools:
   skill: true
   question: true
   bash: false        # No shell commands needed
-  webfetch: true    # Use @researcher for web research
+  webfetch: true     # For research
   todowrite: true    # Track complex requirements gathering
   todoread: true
+  search: true       # Semantic search for existing docs/requirements
+  codeindex: true    # Check index status
 
 # Permissions - granular control
 permission:
@@ -41,6 +43,7 @@ permission:
     <r>Always validate requirements against SMART criteria</r>
     <r>Never assume - always ask clarifying questions</r>
     <r>Find and use `**/project-context.md` as source of truth if exists</r>
+    <r>USE SEMANTIC SEARCH for existing docs: search({ query: "requirements", index: "docs" })</r>
   </rules>
 </activation>
 

package/src/opencode/agents/architect.md

@@ -8,8 +8,8 @@ tools:
   read: true
   write: true
   edit: true
-  glob: true
-  grep: true
+  glob: true         # Use ONLY for specific file patterns, prefer search for exploration
+  grep: true         # Use ONLY for exact string match, prefer search for concepts
   list: true
   skill: true
   question: true
@@ -18,6 +18,8 @@ tools:
   todowrite: true    # Architecture can be complex multi-step
   todoread: true
   lsp: true          # Code intelligence for architecture analysis
+  search: true       # PREFERRED: Semantic search for code/docs/config exploration
+  codeindex: true    # Check index status before searching
 
 # Permissions - granular control
 permission:
@@ -54,6 +56,10 @@ permission:
     <r>User journeys drive technical decisions</r>
     <r>Each doc file < 2000 lines (RAG-friendly)</r>
     <r>Find and use `**/project-context.md` and `CLAUDE.md` as source of truth</r>
+    <r critical="true">USE SEMANTIC SEARCH FIRST! Before using glob/grep, ALWAYS try search tool:
+       - search({ query: "concept", index: "docs" }) for documentation
+       - search({ query: "pattern", index: "code" }) for code exploration
+       - glob/grep ONLY for exact filenames or literal strings</r>
   </rules>
 </activation>
 

package/src/opencode/agents/dev.md

@@ -9,8 +9,8 @@ tools:
   write: true
   edit: true
   patch: true        # For applying diffs
-  glob: true
-  grep: true
+  glob: true         # Use for specific file patterns
+  grep: true         # Use for exact string match
   list: true
   skill: true
   question: true
@@ -19,6 +19,8 @@ tools:
   todowrite: true    # Track implementation progress
   todoread: true
   lsp: true          # Code intelligence (experimental)
+  search: true       # PREFERRED: Semantic search for finding patterns/examples
+  codeindex: true    # Check index status
 
 # Permissions - developer has full access
 permission:
@@ -46,6 +48,7 @@ permission:
     <r>All existing tests must pass 100% before story is ready for review</r>
     <r>NEVER lie about tests being written or passing</r>
     <r>Find and use `**/project-context.md` and `CLAUDE.md` as source of truth</r>
+    <r>USE SEMANTIC SEARCH for finding existing patterns: search({ query: "similar feature", index: "code" })</r>
   </rules>
   
   <dev-story-workflow hint="When executing /dev-story command" critical="FOLLOW THIS EXACTLY">

package/src/opencode/agents/pm.md

@@ -8,8 +8,8 @@ tools:
   read: true
   write: true
   edit: true
-  glob: true
-  grep: true
+  glob: true         # For specific file patterns
+  grep: true         # For exact strings
   list: true
   skill: true
   question: true
@@ -17,6 +17,8 @@ tools:
   webfetch: false    # Use @researcher for web research
   todowrite: true    # PM tracks complex planning tasks
   todoread: true
+  search: true       # PREFERRED: Semantic search for docs/PRD/architecture
+  codeindex: true    # Check index status
 
 # Permissions - granular control
 permission:
@@ -49,15 +51,16 @@ permission:
     <r>Ship the smallest thing that validates the assumption</r>
     <r>Every feature must trace to a user problem</r>
     <r>NEVER create stories without acceptance criteria</r>
-    <r critical="true">BEFORE writing epic/story tasks: MUST Glob+Read coding standards (see before-epic-story)</r>
+    <r critical="true">BEFORE writing epic/story: USE SEMANTIC SEARCH (see before-epic-story)</r>
     <r>Find and use `**/project-context.md` as source of truth if exists</r>
+    <r>USE SEMANTIC SEARCH FIRST: search({ query: "topic", index: "docs" }) before glob/grep</r>
   </rules>
   
   <before-epic-story critical="MANDATORY">
     <instruction>BEFORE writing ANY epic or story with tasks, you MUST execute:</instruction>
-    <step n="1">Glob "**/AGENTS.md" OR "**/CLAUDE.md" → Read the file</step>
-    <step n="2">Glob "**/coding-standards/**/*.md" → Read ALL files found</step>
-    <step n="3">Glob "**/[module]-data-model*.md" → Read data model</step>
+    <step n="1">search({ query: "coding standards patterns conventions", index: "docs" }) → Read results</step>
+    <step n="2">search({ query: "architecture module boundaries", index: "docs" }) → Understand structure</step>
+    <step n="3">Read CLAUDE.md or AGENTS.md if found</step>
     <step n="4">Glob "**/src/services/[module]/**/domain/**/*.go" → Read 2-3 existing patterns</step>
     <step n="5">ONLY THEN proceed to write tasks with Documentation links</step>
     <warning>Tasks without proper Documentation links to coding standards = REJECTED</warning>

package/src/opencode/tools/search.ts

@@ -63,7 +63,7 @@ Prerequisites: Run 'npx @comfanion/workflow index --index <name>' first.`,
       const { CodebaseIndexer } = await import(`file://${vectorizerModule}`)
       
       let allResults: any[] = []
-      const limit = args.limit || 5
+      const limit = args.limit || 10
       const indexName = args.index || "code"
 
       // Auto-freshen stale files before searching