@comfanion/workflow 4.36.55 → 4.36.57

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.36.55",
+  "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.55",
-  "buildDate": "2026-01-25T22:59:29.545Z",
+  "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

@@ -3,7 +3,8 @@ description: "Code Reviewer - Use for: security review, bug finding, test covera
 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: 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:

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