@comfanion/workflow 3.0.0

package/src/opencode/commands/research.md

@@ -0,0 +1,113 @@
+---
+description: Conduct technical, market, or domain research with structured documentation
+agent: researcher
+---
+
+# Research Command
+
+## Arguments
+$ARGUMENTS
+
+Format: `[type] [topic]`
+
+**Types:**
+- "technical" - Technology evaluation
+- "market" - Market/competitor analysis
+- "domain" - Business domain research
+- "integration" - External system/API research
+- "pattern" - Architecture/design patterns
+
+**Examples:**
+- `/research technical message-queues`
+- `/research market competitor-analysis`
+- `/research domain e-commerce-regulations`
+- `/research integration stripe-api`
+- `/research pattern cqrs-event-sourcing`
+
+**Other commands:**
+- `/research list` - Show all research
+- `/research update [path]` - Update existing research
+
+## Check Existing Research
+
+!`tree docs/research/ 2>/dev/null || echo "No research yet"`
+
+## Input Context
+
+Load relevant docs:
+- @docs/prd.md (for context)
+- @docs/architecture.md (for technical context)
+- @docs/research/README.md (for index)
+
+## Your Task
+
+### Create New Research
+
+1. **Determine research type and topic** from arguments
+
+2. **Create directory** if needed:
+   ```
+   docs/research/[type]/
+   ```
+
+3. **Conduct research**:
+   - Define research questions
+   - Gather information (web, docs, code)
+   - Analyze findings
+   - Form recommendations
+
+4. **Create research document**:
+   ```
+   docs/research/[type]/[topic]-research.md
+   ```
+
+5. **Update index**:
+   ```
+   docs/research/README.md
+   ```
+
+### List Research
+
+Show all research organized by type with status.
+
+### Update Research
+
+1. Load existing research
+2. Ask what needs updating
+3. Add new findings
+4. Update date and status
+
+## Output Location
+
+```
+docs/research/
+├── README.md                    # Index (always update)
+├── technical/
+│   └── [topic]-research.md
+├── market/
+│   └── [topic]-research.md
+├── domain/
+│   └── [topic]-research.md
+├── integrations/
+│   └── [topic]-research.md
+└── patterns/
+    └── [topic]-research.md
+```
+
+## Research Document Must Include
+
+- [ ] Executive summary
+- [ ] Clear research questions
+- [ ] Methodology
+- [ ] Evidence-based findings
+- [ ] Comparison table (if evaluating options)
+- [ ] Recommendations
+- [ ] Impact on PRD/Architecture
+- [ ] Sources cited
+
+## After Completion
+
+Suggest:
+- Link research from relevant PRD/Architecture sections
+- If research changes requirements: `/prd edit`
+- If research changes architecture: `/architecture edit`

package/src/opencode/commands/sprint-plan.md

@@ -0,0 +1,59 @@
+---
+description: Plan and manage sprints
+agent: sm
+model: anthropic/claude-sonnet-4-20250514
+---
+
+# Sprint Planning
+
+## Arguments
+$ARGUMENTS
+
+- `status` or empty: Show current sprint status
+- `new`: Create new sprint
+- `assign`: Assign epics to sprint
+
+## Task
+
+### Status Mode
+
+1. Load: @docs/sprint-artifacts/sprint-status.yaml
+2. Show current sprint progress
+3. List blockers if any
+4. Suggest next actions
+
+### New Sprint Mode
+
+1. Load skill: `sprint-planning`
+2. Analyze backlog: `docs/sprint-artifacts/backlog/`
+3. Check dependencies
+4. Select epics for sprint
+5. Update sprint-status.yaml
+6. Create sprint folder structure
+
+### Assign Mode
+
+1. Load skill: `sprint-planning`
+2. Show available epics in backlog
+3. Ask which epics to assign
+4. Check dependencies (blocked epics can't be assigned)
+5. Move epic files to sprint folder
+6. Update sprint-status.yaml
+
+## Sprint Folder Structure
+
+```
+docs/sprint-artifacts/sprint-N/
+├── README.md          # Sprint goal, dates, team
+├── epic-NN-xxx.md     # Epics in this sprint
+└── stories/
+    └── story-NN-NN-xxx.md
+```
+
+## Output
+
+Update: `docs/sprint-artifacts/sprint-status.yaml`
+
+## Next Step
+
+After sprint planned: `/jira-sync` to sync to Jira

package/src/opencode/commands/stories.md

@@ -0,0 +1,61 @@
+---
+description: Create stories for a specific epic
+agent: sm
+model: anthropic/claude-sonnet-4-20250514
+---
+
+# Story Creation
+
+## Arguments
+$ARGUMENTS
+
+**Required:** Epic ID (e.g., `CATALOG-E05`)
+
+## Prerequisites
+
+Epic must exist. Check:
+!`find docs/sprint-artifacts -name "epic-*.md" 2>/dev/null | head -10`
+
+## Task
+
+1. Load the specified epic file
+2. Load skill: `story-writing`
+3. Load skill: `acceptance-criteria`
+4. Break epic into stories:
+   - Each story is 1-3 days of work
+   - User story format: As a... I want... So that...
+   - **Given/When/Then AC (MANDATORY)**
+   - Technical tasks checklist
+   - Definition of Done
+5. Save stories to epic's stories/ folder
+
+## Story Creation Checklist
+
+For each story:
+- [ ] Unique ID: `[MODULE]-S[EPIC]-[NN]`
+- [ ] User story format
+- [ ] **Acceptance criteria in Given/When/Then**
+- [ ] At least 3 AC (happy path, error, edge case)
+- [ ] Technical tasks defined
+- [ ] Estimate: XS/S/M/L/XL
+- [ ] Definition of Done
+
+## Recommended Story Order
+
+1. Domain layer (aggregates, value objects)
+2. Repository interfaces
+3. Use cases
+4. Repository implementations
+5. HTTP handlers
+6. Event publishers
+7. Integration tests
+
+## Output
+
+Save to: `docs/sprint-artifacts/sprint-N/stories/story-EPIC-NN-description.md`
+
+## Next Step
+
+After stories created:
+- For more epics: `/stories [next-epic-id]`
+- When done: `/sprint-plan`

package/src/opencode/commands/validate.md

@@ -0,0 +1,84 @@
+---
+description: Validate project artifacts (requirements, prd, architecture, epics)
+agent: architect
+model: anthropic/claude-sonnet-4-20250514
+---
+
+# Artifact Validation
+
+## Arguments
+$ARGUMENTS
+
+- `requirements` - Validate requirements.md
+- `prd` - Validate PRD + QA artifact
+- `architecture` - Validate architecture + QA artifact
+- `epics` - Validate epics (AC presence)
+- `stories` - Validate stories (AC presence)
+- `all` - Validate entire pipeline
+- (empty) - Interactive selection
+
+## Task
+
+Based on argument, load appropriate validation skill:
+
+### Requirements
+Load skill: `requirements-validation`
+- Check IDs, priorities, AC, language quality
+
+### PRD
+Load skill: `prd-validation`
+- Prerequisites: requirements PASS
+- Check structure, coverage, QA artifact
+
+### Architecture
+Load skill: `architecture-validation`
+- Prerequisites: PRD PASS
+- Check NFR compliance, modules, QA artifact
+
+### Epics
+- Check all epics have unique IDs
+- **Check all epics have AC (MANDATORY)**
+- Check dependencies form DAG
+- Check PRD coverage
+
+### Stories
+- Check all stories have unique IDs
+- Check user story format
+- **Check all stories have Given/When/Then AC (MANDATORY)**
+- Check DoD present
+
+### All
+Run in order: requirements → prd → architecture → epics
+Stop on first FAIL.
+
+## Output Format
+
+```markdown
+# Validation Report - [Type]
+
+**Date:** YYYY-MM-DD
+**Status:** PASS | WARN | FAIL
+
+## Summary
+- Passed: NN
+- Warnings: NN
+- Failed: NN
+
+## QA Artifact
+[Status of mandatory QA artifact if applicable]
+
+## Details
+[Specific checks and results]
+
+## Next Steps
+[What to do after fixing issues]
+```
+
+## Output Location
+
+Save to: `docs/validation/[type]-validation-YYYY-MM-DD.md`
+
+## After Validation
+
+- If PASS: Suggest next pipeline step
+- If FAIL: List issues and how to fix

package/src/opencode/commands/workflow-status.md

@@ -0,0 +1,150 @@
+---
+description: Show project workflow status and suggest next steps
+agent: sprint-manager
+model: anthropic/claude-sonnet-4-20250514
+---
+
+# Workflow Status
+
+## Overview
+
+This command shows the current state of your project documentation workflow and suggests what to do next.
+
+## Workflow Definition
+
+Reference: @.opencode/FLOW.yaml
+
+## Check All Artifacts
+
+### Stage 1: Requirements
+!`ls -la docs/requirements/requirements.md 2>/dev/null && echo "EXISTS" || echo "MISSING"`
+
+### Stage 2: PRD
+!`ls -la docs/prd.md 2>/dev/null && echo "EXISTS" || echo "MISSING"`
+
+### Stage 2.1: PRD QA (Mandatory)
+!`ls -la docs/prd-acceptance-criteria.md 2>/dev/null && echo "EXISTS" || echo "MISSING"`
+
+### Stage 3: Architecture  
+!`ls -la docs/architecture.md 2>/dev/null && echo "EXISTS" || echo "MISSING"`
+
+### Stage 3.1: Architecture QA (Mandatory)
+!`ls -la docs/architecture-integration-tests.md 2>/dev/null && echo "EXISTS" || echo "MISSING"`
+
+### Stage 4: Epics
+!`ls docs/sprint-artifacts/*/epic-*.md 2>/dev/null | wc -l | xargs echo "Epics:"`
+
+### Stage 5: Stories
+!`ls docs/sprint-artifacts/*/stories/*.md 2>/dev/null | wc -l | xargs echo "Stories:"`
+
+### Stage 6: Sprint Status
+!`ls -la docs/sprint-artifacts/sprint-status.yaml 2>/dev/null && echo "EXISTS" || echo "MISSING"`
+
+### Stage 7: Jira Sync
+!`ls -la docs/sprint-artifacts/jira-sync-report.md 2>/dev/null && echo "EXISTS" || echo "NEVER RUN"`
+
+### Validation Reports
+!`ls -la docs/validation/*.md 2>/dev/null | tail -5 || echo "No validation reports"`
+
+## Generate Status Report
+
+Based on the checks above, generate a status report in this format:
+
+```markdown
+# Project Workflow Status
+
+**Project:** marketplace
+**Date:** YYYY-MM-DD
+**Workflow:** @.opencode/FLOW.yaml
+
+## Pipeline Status
+
+| # | Stage | Artifact | Status | QA Status |
+|---|-------|----------|--------|-----------|
+| 1 | Requirements | requirements.md | ✅/❌ | N/A |
+| 2 | PRD | prd.md | ✅/❌ | prd-acceptance-criteria.md: ✅/❌ |
+| 3 | Architecture | architecture.md | ✅/❌ | architecture-integration-tests.md: ✅/❌ |
+| 4 | Epics | N epics | ✅/⏳/❌ | N/A |
+| 5 | Stories | N stories | ✅/⏳/❌ | N/A |
+| 6 | Sprint Plan | sprint-status.yaml | ✅/❌ | N/A |
+| 7 | Jira Sync | Last sync | ✅/❌ | N/A |
+
+## Current Stage
+
+**You are at:** Stage N - [Stage Name]
+**Next action:** [What to do next]
+
+## Validation Status
+
+| Artifact | Last Validated | Result |
+|----------|---------------|--------|
+| Requirements | date | PASS/WARN/FAIL |
+| PRD | date | PASS/WARN/FAIL |
+| Architecture | date | PASS/WARN/FAIL |
+| Epics | date | PASS/WARN/FAIL |
+
+## Recommended Next Steps
+
+1. [First action with command]
+2. [Second action with command]
+```
+
+## Decision Logic
+
+Follow FLOW.yaml pipeline order:
+
+### If requirements.md missing:
+→ "Run `/requirements` to start gathering requirements"
+
+### If requirements exists but not validated:
+→ "Run `/validate requirements` to validate before PRD"
+
+### If requirements validated but PRD missing:
+→ "Run `/prd` to create PRD"
+
+### If PRD exists but prd-acceptance-criteria.md missing:
+→ "PRD QA artifact missing! Create `docs/prd-acceptance-criteria.md` with AC for all FRs"
+
+### If PRD exists but not validated:
+→ "Run `/validate prd` to validate before architecture"
+
+### If PRD validated but architecture missing:
+→ "Run `/architecture` to create architecture"
+
+### If architecture exists but architecture-integration-tests.md missing:
+→ "Architecture QA artifact missing! Create `docs/architecture-integration-tests.md`"
+
+### If architecture exists but not validated:
+→ "Run `/validate architecture` to validate before epics"
+
+### If architecture validated but no epics:
+→ "Run `/epics` to create epics"
+
+### If epics exist but no stories:
+→ "Run `/stories [epic-id]` to create stories for each epic"
+
+### If stories exist but no sprint plan:
+→ "Run `/sprint-plan` to organize into sprints"
+
+### If sprint plan exists but not in Jira:
+→ "Run `/jira-sync` to synchronize with Jira"
+
+### If all complete:
+→ "Ready for implementation! Run `/sprint-plan status` to see current sprint"
+
+## Quick Commands Reference
+
+| Command | Description | Stage |
+|---------|-------------|-------|
+| `/requirements` | Gather FR/NFR requirements | 1 |
+| `/validate requirements` | Validate requirements | 1→2 |
+| `/prd` | Create/edit PRD | 2 |
+| `/validate prd` | Validate PRD | 2→3 |
+| `/architecture` | Create/edit architecture | 3 |
+| `/validate architecture` | Validate architecture | 3→4 |
+| `/epics` | Create epics from PRD | 4 |
+| `/validate epics` | Validate epics | 4→5 |
+| `/stories [epic]` | Create stories for epic | 5 |
+| `/sprint-plan` | Plan sprints | 6 |
+| `/jira-sync` | Sync to Jira | 7 |
+| `/workflow-status` | This command | - |

package/src/opencode/config.yaml

@@ -0,0 +1,223 @@
+# OpenCode Workflow Configuration
+# This file provides centralized configuration for all agents and workflows
+# Version: 3.0.0
+
+# =============================================================================
+# PROJECT CONFIGURATION
+# =============================================================================
+project_name: "ai-wf"
+version: "3.0.0"
+
+# =============================================================================
+# USER CONFIGURATION
+# =============================================================================
+user_name: "Evgeniy"
+user_skill_level: expert  # beginner | intermediate | expert
+
+# Communication language (agent talks to user)
+communication_language: "Ukrainian"  # or English
+
+# =============================================================================
+# DOCUMENTATION LANGUAGES
+# =============================================================================
+documentation:
+  # Technical docs ALWAYS in English (agents understand better)
+  technical:
+    language: "English"
+    enforced: true  # Cannot be changed
+    paths:
+      - "docs/"
+      - "CLAUDE.md"
+      - "README.md"
+      - ".opencode/"
+      
+  # User-facing docs (translations, Confluence export)
+  user_facing:
+    enabled: true
+    output_folder: "docs/confluence/"
+    default_language: "Ukrainian"  # or English
+    formats:
+      - confluence    # Confluence wiki format
+      - markdown      # Translated markdown
+      - html          # Standalone HTML
+    
+  # What to translate
+  translate:
+    prd: true
+    architecture: true
+    epics: true
+    stories: false        # Usually not needed
+    coding_standards: false  # Keep technical
+
+# =============================================================================
+# OUTPUT PATHS
+# =============================================================================
+output_folder: "{project-root}/docs"
+planning_artifacts: "{project-root}/docs/planning-artifacts"
+implementation_artifacts: "{project-root}/docs/implementation-artifacts"
+sprint_artifacts: "{project-root}/docs/sprint-artifacts"
+project_knowledge: "{project-root}/docs"
+
+# =============================================================================
+# ARTIFACT PATHS
+# =============================================================================
+artifacts:
+  requirements: "{output_folder}/requirements"
+  prd: "{output_folder}/prd.md"
+  architecture: "{output_folder}/architecture.md"
+  adr: "{output_folder}/architecture/adr"
+  epics: "{sprint_artifacts}/backlog"
+  stories: "{sprint_artifacts}/stories"
+  sprint_status: "{sprint_artifacts}/sprint-status.yaml"
+  
+# =============================================================================
+# WORKFLOW SETTINGS
+# =============================================================================
+workflow:
+  # Auto-save after each template section
+  auto_save: true
+  
+  # Show confirmation after each step (false = YOLO mode)
+  interactive: true
+  
+  # Default validation level: strict | normal | minimal
+  validation_level: normal
+
+# =============================================================================
+# AGENT DEFAULTS
+# =============================================================================
+agents:
+  default_model: "anthropic/claude-sonnet-4-20250514"
+  default_temperature: 0.3
+  
+# =============================================================================
+# JIRA INTEGRATION
+# =============================================================================
+jira:
+  enabled: true
+  
+  # Connection
+  base_url: "https://your-domain.atlassian.net"
+  project_key: "PROJ"           # Default project
+  # Auth: use environment variables JIRA_EMAIL, JIRA_API_TOKEN
+  
+  # Cache for faster operations
+  cache:
+    enabled: true
+    file: "{project-root}/.opencode/jira-cache.yaml"
+    ttl_minutes: 30             # Refresh cache after 30 min
+    
+  # Hierarchy mapping
+  hierarchy:
+    epic_type: "Epic"
+    story_type: "Story"
+    task_type: "Task"           # Sub-task under Story
+    bug_type: "Bug"
+    
+  # Development control mode
+  # If true: agent controls task statuses, creates branches, links PRs
+  control_development: true
+  
+  # Required statuses for workflow (agent will validate)
+  required_statuses:
+    backlog: ["Backlog", "To Do", "Open"]           # Any of these
+    planned: ["Planned", "Selected for Development", "Ready"]
+    in_progress: ["In Progress", "In Development"]
+    review: ["In Review", "Code Review", "Review"]
+    qa: ["QA", "Testing", "In QA"]
+    done: ["Done", "Closed", "Resolved"]
+    
+  # Status transitions for dev workflow
+  workflow:
+    start_work: "backlog → in_progress"
+    submit_review: "in_progress → review"
+    review_passed: "review → qa"
+    qa_passed: "qa → done"
+    review_failed: "review → in_progress"
+    qa_failed: "qa → in_progress"
+    
+  # Branch naming
+  branch:
+    epic: "feature/epic-{epic_key}-{slug}"
+    story: "feature/{story_key}-{slug}"
+    task: "feature/{story_key}/{task_key}-{slug}"
+    
+  # Auto-create settings
+  auto_create:
+    stories_from_epics: true    # Auto-create stories under epic
+    tasks_from_stories: true    # Auto-create tasks under story
+    link_to_docs: true          # Add link to local doc in Jira description
+
+# =============================================================================
+# DEVELOPMENT METHODOLOGY
+# =============================================================================
+development:
+  # Methodology: tdd | stub
+  # TDD:  Interface → Test (RED) → Implementation (GREEN) → Refactor
+  # STUB: Interface → Stub Implementation → Test → Full Implementation
+  methodology: tdd
+  
+  # Task structure
+  task:
+    max_hours: 2           # Maximum hours per atomic task
+    include_tests: true    # Each task includes test as validation
+    require_interface: true # Interface defined before implementation
+
+  # TODO comments for future work
+  todo:
+    enabled: true
+    require_id: true  # Must reference task/story/epic ID (except BACKLOG, HACK)
+    
+    # Code TODOs (IDE-compatible)
+    code:
+      format: "// TODO({type}:{id}): {description}"
+      types: [TASK, STORY, EPIC, SPRINT, BACKLOG, TECH_DEBT, FIXME, HACK]
+    
+    # Documentation TODOs (Markdown)
+    docs:
+      format: "<!-- TODO({type}): {description} -->"
+      block_format: |
+        <!-- TODO({type}): {description}
+        {context}
+        -->
+      types:
+        - DRAFT       # Section is draft, needs review
+        - EXPAND      # Section needs more detail
+        - RESEARCH    # Needs research/investigation
+        - REVIEW      # Needs stakeholder review
+        - DECISION    # Decision needed
+        - DEPENDENCY  # Waiting on other document
+        - EXAMPLE     # Add examples
+        - DIAGRAM     # Add diagram
+        - NUMBERS     # Add metrics/numbers
+        - LINK        # Add links/references
+
+# =============================================================================
+# CHANGELOG
+# =============================================================================
+changelog:
+  # Repository changelog
+  repo:
+    enabled: true
+    file: "CHANGELOG.md"
+    format: "keepachangelog"  # https://keepachangelog.com/
+    versioning: "semver"      # https://semver.org/
+    
+  # Document changelogs (in each doc)
+  docs:
+    enabled: true
+    mandatory: true  # Fail validation if missing
+    format: |
+      | Version | Date | Author | Changes |
+      |---------|------|--------|---------|
+    
+  # Update timing
+  update_when: "session_end"  # Update at end of session, not on every change
+  # Summarize all session changes in one entry
+
+# =============================================================================
+# TEST ARCHITECTURE
+# =============================================================================
+testarch:
+  use_playwright: false
+  use_mcp_enhancements: true