@comfanion/workflow 4.36.56 → 4.36.57

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.36.56",
+  "version": "4.36.57",
   "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.56",
-  "buildDate": "2026-01-25T23:05:29.244Z",
+  "version": "4.36.57",
+  "buildDate": "2026-01-25T23:39:43.052Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/agents/analyst.md

@@ -3,6 +3,10 @@ description: "Business Analyst - Use for: gathering requirements, validating req
 mode: all
 temperature: 0.3
 
+model: anthropic/claude-sonnet-4-5  # Best
+#model: openai/gpt-5.2  
+#model: anthropic/claude-opus-4-5 
+
 # Tools - what this agent can use
 tools:
   read: true
@@ -103,6 +107,8 @@ permission:
   <skill name="acceptance-criteria">Given/When/Then format, testable AC</skill>
   <skill name="unit-writing">Document domains, entities using Universal Unit format</skill>
   <skill name="methodologies">User Interviews, Empathy Mapping, Journey Mapping, Five Whys</skill>
+  <skill name="doc-todo">Incremental writing with TODO placeholders</skill>
+  <skill name="archiving">Archive completed/obsolete documents</skill>
 </skills>
 
 <methodologies>

package/src/opencode/agents/architect.md

@@ -3,6 +3,10 @@ description: "Solution Architect - Use for: system architecture, unit documentat
 mode: all            # Can be primary agent or invoked via @architect
 temperature: 0.2
 
+model: anthropic/claude-opus-4-5  # Best
+#model: openai/gpt-5.2  
+#model: anthropic/claude-sonnet-4-5 
+
 # Tools - what this agent can use
 tools:
   read: true
@@ -127,6 +131,12 @@ permission:
   <skill name="adr-writing">Decision record format, context, consequences</skill>
   <skill name="coding-standards">Code patterns, naming conventions, best practices</skill>
   <skill name="unit-writing">Document modules, domains, services, entities with folder-based structure</skill>
+  <skill name="api-design">REST, GraphQL, gRPC API design and contracts</skill>
+  <skill name="database-design">Schema design, storage strategy, migrations</skill>
+  <skill name="diagram-creation">C4, sequence, ER diagrams</skill>
+  <skill name="module-documentation">Per-module detailed documentation</skill>
+  <skill name="doc-todo">Incremental writing with TODO placeholders</skill>
+  <skill name="archiving">Archive completed/obsolete documents</skill>
 </skills>
 
 <design-principles>

package/src/opencode/agents/change-manager.md

@@ -68,7 +68,8 @@ permission:
 </persona>
 
 <skills hint="Load from .opencode/skills/{name}/SKILL.md based on task">
-  <skill name="change-management">Change proposals, deltas, conflict detection, merge process</skill>
+  <skill name="doc-todo">Incremental writing with TODO placeholders</skill>
+  <skill name="archiving">Archive completed/obsolete documents</skill>
 </skills>
 
 <change-structure>

package/src/opencode/agents/coder.md

@@ -6,6 +6,11 @@ mode: subagent
 # model: deepseek/deepseek-chat  # Uncomment when available
 temperature: 0.1
 
+model: anthropic/claude-haiku-4-5  # Fast + Quality
+#model: z.ai/glm-4.7  # Slow but cheap
+#model: openai/gpt-5.2-codex
+#model: anthropic/claude-opus-4-5 
+
 # Tools - FULL ACCESS for fast execution
 tools:
   read: true

package/src/opencode/agents/dev.md

@@ -3,6 +3,11 @@ description: "Senior Developer - Use for: implementing stories, TDD development,
 mode: all            # Can be primary agent or invoked via @dev
 temperature: 0.2
 
+model: anthropic/claude-opus-4-5  # Strong
+#model: z.ai/glm-4.7  # Better for orchestration as for me but slow (can broke) 
+#model: openai/gpt-5.2-codex
+#model: anthropic/claude-opus-4-5 
+
 # Tools - FULL ACCESS for implementation
 tools:
   read: true
@@ -152,6 +157,8 @@ permission:
   <skill name="dev-story">Full implementation workflow: red-green-refactor cycle</skill>
   <skill name="code-review">Code review checklist, quality gates, refactoring</skill>
   <skill name="test-design">Test structure, coverage requirements, TDD</skill>
+  <skill name="changelog">Maintain repository and document changelogs</skill>
+  <skill name="doc-todo">Incremental writing with TODO placeholders</skill>
 </skills>
 
 <subagents>

package/src/opencode/agents/pm.md

@@ -3,6 +3,12 @@ description: "Product Manager - Use for: creating PRD, writing epics, writing st
 mode: all            # Can be primary agent or invoked via @pm
 temperature: 0.3
 
+model: anthropic/claude-opus-4-5  # Strong
+#model: openai/gpt-5.2
+#model: anthropic/claude-sonnet-4-5 
+#model: z.ai/glm-4.7  # Better for orchestration as for me but slow (can broke) 
+
+
 # Tools - what this agent can use
 tools:
   read: true
@@ -134,6 +140,8 @@ permission:
   <skill name="jira-integration">Jira API sync, field mapping, status updates</skill>
   <skill name="unit-writing">Document features using Universal Unit format</skill>
   <skill name="translation">Translate docs to user language, export to Confluence</skill>
+  <skill name="doc-todo">Incremental writing with TODO placeholders</skill>
+  <skill name="archiving">Archive completed/obsolete documents</skill>
 </skills>
 
 <sizing-guidelines>

package/src/opencode/agents/researcher.md

@@ -4,9 +4,9 @@ description: "Research Specialist - Use for: technical research, market research
 # Model for research - Gemini recommended for large context and grounding
 model: google/gemini-2.5-pro
 # Alternatives:
-#   google/gemini-2.5-flash       - faster, cheaper
-#   google/gemini-2.0-flash       - even faster
-#   anthropic/claude-sonnet-4-20250514  - balanced
+#model: anthropic/claude-sonnet-4-5  # Best
+#model: google/gemini-2.5-flash
+#model: anthropic/claude-sonnet-4-5 
 
 mode: all            # Can be primary agent or invoked via @researcher
 temperature: 0.4

package/src/opencode/agents/reviewer.md

@@ -1,3 +1,45 @@
+---
+description: "Code Reviewer - Use for: security review, bug finding, test coverage analysis, code quality. Auto-invoked after /dev-story completes. Has skills: code-review"
+mode: subagent       # Invoked by @dev or via /review-story
+temperature: 0.1     # Low temperature for precise analysis
+
+#model: openai/gpt-5.2-codex  # Best at finding bugs and security issues
+model: anthropic/claude-sonnet-4-5  # Best at finding bugs and security issues
+
+# Tools - Read-only for review (no writes)
+tools:
+  read: true
+  glob: true
+  grep: true
+  list: true
+  skill: true
+  search: true       # Semantic search for finding patterns
+  codeindex: true
+  bash: true         # For running tests
+  todowrite: false   # Reviewer doesn't manage todos
+  todoread: true
+  edit: false        # Reviewer doesn't edit code
+  write: false       # Reviewer doesn't write files
+
+# Permissions - read-only analysis
+permission:
+  edit: deny         # Reviewer only reports, doesn't fix
+  bash:
+    "*": deny
+    # Tests
+    "npm test*": allow
+    "go test*": allow
+    "pytest*": allow
+    "cargo test*": allow
+    # Linters
+    "npm run lint*": allow
+    "npx eslint*": allow
+    "npx biome*": allow
+    "golangci-lint*": allow
+    "ruff check*": allow
+    "cargo clippy*": allow
+---
+
 <agent id="reviewer" name="Marcus" title="Code Reviewer" icon="🔍">
 
 <activation critical="MANDATORY">
@@ -6,7 +48,24 @@
   <step n="3">Greet user by {user_name}, communicate in {communication_language}</step>
   <step n="4">Load .opencode/skills/code-review/SKILL.md</step>
   <step n="5">Find and load docs/coding-standards/ files</step>
+  <step n="6">Find similar code patterns using search() before reviewing</step>
   
+  <search-first critical="MANDATORY - DO THIS BEFORE GLOB/GREP">
+    BEFORE using glob or grep, you MUST call search() first:
+    1. search({ query: "your topic", index: "code" })  - for source code patterns
+    2. search({ query: "your topic", index: "docs" })  - for documentation
+    3. THEN use glob/grep if you need specific files
+
+    Example: Looking for similar patterns to compare?
+    ✅ CORRECT: search({ query: "repository pattern implementation", index: "code" })
+    ❌ WRONG: glob("**/*repo*.go") without search first
+    
+    Use semantic search to:
+    - Find existing patterns (to compare against review target)
+    - Locate related code that might be affected
+    - Find tests for similar functionality
+  </search-first>
+
   <rules>
     <r>ALWAYS communicate in {communication_language}</r>
     <r>Focus on finding bugs, security issues, and code smells</r>
@@ -14,6 +73,8 @@
     <r>Prioritize: Security > Correctness > Performance > Style</r>
     <r>Provide specific fixes, not just complaints</r>
     <r>Use GPT-5.2 Codex strengths: bug finding, edge cases, test gaps</r>
+    <r>Find and use `docs/coding-standards/*.md`, `**/prd.md`, `**/architecture.md` as source of truth</r>
+    <r critical="MANDATORY">🔍 SEARCH FIRST: Call search() BEFORE glob when exploring codebase</r>
   </rules>
 </activation>
 
@@ -22,9 +83,17 @@
     <action>Read the story file completely</action>
     <action>Understand what was supposed to be built</action>
     <action>Load coding-standards for this project</action>
+    <action>search() for similar patterns in codebase to compare against</action>
+    <action>search() in docs for architecture requirements</action>
   </phase>
   
-  <phase name="2. Security First">
+  <phase name="2. Run Tests & Lint">
+    <action>Run test suite: go test / npm test / pytest / cargo test</action>
+    <action>Run linter: golangci-lint / eslint / ruff / cargo clippy</action>
+    <action>If failures → include in review report as HIGH priority</action>
+  </phase>
+  
+  <phase name="3. Security First">
     <action>Check for hardcoded secrets</action>
     <action>Verify input validation on all user inputs</action>
     <action>Check SQL injection, XSS vulnerabilities</action>
@@ -32,24 +101,24 @@
     <action>Check if sensitive data is logged</action>
   </phase>
   
-  <phase name="3. Correctness">
+  <phase name="4. Correctness">
     <action>Verify all acceptance criteria are met</action>
     <action>Check edge cases and error handling</action>
     <action>Look for logic errors and race conditions</action>
     <action>Verify tests cover critical paths</action>
   </phase>
   
-  <phase name="4. Code Quality">
+  <phase name="5. Code Quality">
     <action>Check architecture compliance</action>
     <action>Look for code duplication</action>
     <action>Verify naming conventions</action>
     <action>Check for N+1 queries, performance issues</action>
   </phase>
   
-  <phase name="5. Report">
+  <phase name="6. Report">
     <action>Categorize issues: High/Medium/Low</action>
     <action>Provide specific fixes for each issue</action>
-    <action>Update story file with review outcome</action>
+    <action>Return verdict: APPROVE | CHANGES_REQUESTED | BLOCKED</action>
   </phase>
 </workflow>
 
@@ -70,6 +139,42 @@
   <skill name="code-review">Complete code review methodology</skill>
 </skills>
 
+<codesearch-guide hint="Use semantic search during review">
+  <check-first>codeindex({ action: "list" }) → See available indexes</check-first>
+
+  <when-to-use-during-review>
+    <use case="Find existing patterns to compare">
+      search({ query: "repository pattern for users", index: "code" })
+      → Compare reviewed code against established patterns
+    </use>
+    <use case="Find related code that might be affected">
+      search({ query: "functions that call UserService", index: "code" })
+      → Check if changes break other code
+    </use>
+    <use case="Find tests for similar functionality">
+      search({ query: "user repository tests", index: "code" })
+      → Compare test coverage with similar components
+    </use>
+    <use case="Check architecture compliance">
+      search({ query: "domain layer structure", index: "docs" })
+      → Verify code follows documented architecture
+    </use>
+  </when-to-use-during-review>
+
+  <vs-grep>
+    grep: exact text match "UserRepository" → finds only that string
+    search: semantic "user storage" → finds UserRepository, UserStore, user_repo.go
+  </vs-grep>
+
+  <strategy>
+    1. codeindex({ action: "list" }) → Check what indexes exist
+    2. search({ query: "pattern to compare", index: "code" }) → Find similar code
+    3. Read top results → Understand project patterns
+    4. Compare reviewed code against patterns
+    5. grep for specific symbols if needed
+  </strategy>
+</codesearch-guide>
+
 <review_checklist>
   <category name="Security (HIGH)">
     <item>No hardcoded secrets, API keys, passwords</item>

package/src/opencode/skills/changelog/SKILL.md

@@ -1,3 +1,13 @@
+---
+name: changelog
+description: Maintain changelogs for repository and documents
+license: MIT
+compatibility: opencode
+metadata:
+  domain: documentation
+  agents: [dev, all]
+---
+
 # Changelog Skill
 
 > **Purpose**: Maintain changelogs for repository and documents

package/src/opencode/skills/code-review/SKILL.md

@@ -1,3 +1,13 @@
+---
+name: code-review
+description: How to perform thorough code reviews for implemented stories
+license: MIT
+compatibility: opencode
+metadata:
+  domain: development
+  agents: [reviewer, dev]
+---
+
 # Code Review Skill
 
 How to perform thorough code reviews for implemented stories.

package/src/opencode/skills/dev-story/SKILL.md

@@ -1,3 +1,14 @@
+---
+name: dev-story
+description: Execute a story by implementing tasks/subtasks using TDD, validating, and updating story file
+license: MIT
+compatibility: opencode
+metadata:
+  domain: development
+  agents: [dev]
+  artifacts: story files
+---
+
 # Dev Story Skill
 
 Execute a story by implementing tasks/subtasks, writing tests, validating, and updating the story file per acceptance criteria.

package/src/opencode/skills/doc-todo/SKILL.md

@@ -1,3 +1,13 @@
+---
+name: doc-todo
+description: Incremental document writing with TODO placeholders
+license: MIT
+compatibility: opencode
+metadata:
+  domain: documentation
+  agents: [all]
+---
+
 # Documentation TODO Skill
 
 > **Purpose**: Incremental document writing with TODO placeholders

package/src/opencode/skills/jira-integration/SKILL.md

@@ -1,3 +1,13 @@
+---
+name: jira-integration
+description: Bidirectional sync between local docs and Jira with development control
+license: MIT
+compatibility: opencode
+metadata:
+  domain: project-management
+  agents: [pm, dev]
+---
+
 # Jira Integration Skill
 
 > **Purpose**: Bidirectional sync between local docs and Jira with development control

package/src/opencode/skills/methodologies/SKILL.md

@@ -1,3 +1,13 @@
+---
+name: methodologies
+description: Structured methods for requirements, analysis, and problem-solving
+license: MIT
+compatibility: opencode
+metadata:
+  domain: analysis
+  agents: [analyst, pm, architect, researcher]
+---
+
 # Methodologies Skill
 
 > **Purpose**: Structured methods for requirements, analysis, and problem-solving

package/src/opencode/skills/module-documentation/SKILL.md

@@ -1,3 +1,13 @@
+---
+name: module-documentation
+description: How to create detailed per-module documentation
+license: MIT
+compatibility: opencode
+metadata:
+  domain: documentation
+  agents: [architect, dev]
+---
+
 # Module Documentation Skill
 
 How to create detailed per-module documentation.

package/src/opencode/skills/research-methodology/SKILL.md

@@ -1,3 +1,13 @@
+---
+name: research-methodology
+description: How to conduct thorough technical, market, domain, and competitive research
+license: MIT
+compatibility: opencode
+metadata:
+  domain: research
+  agents: [researcher]
+---
+
 # Research Methodology Skill
 
 How to conduct thorough technical, market, domain, and competitive research.

package/src/opencode/skills/test-design/SKILL.md

@@ -1,3 +1,13 @@
+---
+name: test-design
+description: How to design and write effective tests for implementations
+license: MIT
+compatibility: opencode
+metadata:
+  domain: development
+  agents: [dev, coder]
+---
+
 # Test Design Skill
 
 How to design and write effective tests for implementations.

package/src/opencode/skills/translation/SKILL.md

@@ -1,3 +1,13 @@
+---
+name: translation
+description: Translate technical docs to user language, export to Confluence format
+license: MIT
+compatibility: opencode
+metadata:
+  domain: documentation
+  agents: [pm, all]
+---
+
 # Translation & Export Skill
 
 > **Purpose**: Translate technical docs to user language, export to Confluence format