@comfanion/workflow 4.38.0-dev.1 → 4.38.1-dev.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.38.0-dev.1",
+  "version": "4.38.1-dev.11",
   "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.38.0-dev.1",
-  "buildDate": "2026-01-26T23:39:37.098Z",
+  "version": "4.38.1-dev.11",
+  "buildDate": "2026-01-27T11:48:48.852Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/commands/dev-epic.md

@@ -5,165 +5,15 @@ agent: dev
 
 # /dev-epic Command
 
-Implement entire epic by executing all stories with automatic compaction and context preservation.
+Implement an entire epic by following the `dev-epic` skill.
 
 ## Process
 
-### Phase 1: Epic Setup
-1. Find or load epic file (from path or sprint-status.yaml)
-2. Parse all story references from epic
-3. Load project context (CLAUDE.md, docs/prd.md, docs/architecture.md)
-4. **Create TODO list from epic** (critical for compaction!):
-   - Parse epic file, extract all stories
-   - For each story: read story file, count tasks
-   - Add stories to TODO with task counts
-   - Add epic-level tasks (integration tests, acceptance criteria)
-   ```
-   [ ] Story 1: User Registration (12 tasks)
-   [ ] Story 2: Login Flow (8 tasks)
-   [ ] Story 3: Password Reset (6 tasks)
-   [ ] Run epic integration tests
-   [ ] Verify all acceptance criteria
-   ```
-5. **Create epic state file:** `docs/sprint-artifacts/sprint-N/.sprint-state/epic-XX-state.yaml`
-6. Mark epic as `in-progress`
-
-### Phase 2: Story Execution Loop (for each story)
-
-7. **Mark story as `in_progress` in TODO** (e.g., "Story 1: User Registration")
-8. Execute story via `/dev-story` workflow:
-   - RED → GREEN → REFACTOR
-   - @coder implements tasks
-   - @reviewer validates (if auto_review: true)
-9. **Mark story as `completed` in TODO** (✓ Story 1: User Registration)
-10. **Update epic state file**:
-   - Move story from `pending_stories` → `completed_stories`
-   - Add metadata (tasks_completed, tests_added, review_status)
-   - Increment `current_story_index`
-   - Set `next_action: "Execute story-XX-XX.md"` (next story filename)
-   - Update `last_compaction` timestamp
-11. **Trigger compaction** (if `epic_workflow.auto_compact: true`)
-12. **After compaction:** 
-    - Plugin reads TODO → sees next pending story
-    - Plugin reads epic state → gets story path
-    - Agent continues next story automatically
-
-### Phase 3: Epic Completion
-
-13. All stories done → **mark integration test TODO as `in_progress`**
-14. Run epic integration tests (if configured)
-15. **Mark integration test TODO as `completed`**
-16. Update epic state: `status: "done"`
-17. **Clear TODO** (all tasks done)
-18. Generate epic summary
-
-## TODO List
-
-**Create at epic start:**
-```
-[ ] Story 1: User Registration
-[ ] Story 2: Login Flow  
-[ ] Story 3: Password Reset
-[ ] Run epic integration tests
-[ ] Verify acceptance criteria
-```
-
-**Update after each story:**
-- Mark story `completed` in TODO
-- Mark next story `in_progress` in TODO
-- TODO survives compaction - plugin shows it to agent
-
-## Epic State File Format
-
-**Location:** `docs/sprint-artifacts/sprint-N/.sprint-state/epic-XX-state.yaml`
-
-```yaml
-epic_id: "PROJ-E01"
-epic_title: "User Authentication"
-epic_path: "docs/sprint-artifacts/backlog/epic-01-user-auth.md"
-sprint: "sprint-1"
-status: "in-progress"
-
-current_story_index: 1
-total_stories: 3
-
-completed_stories:
-  - path: "docs/sprint-artifacts/sprint-1/stories/story-01-01-registration.md"
-    title: "User Registration"
-    tasks_completed: 12
-    tests_added: 45
-    review_status: "approved"
-    completed_at: "2026-01-27T10:15:00Z"
-
-pending_stories:
-  - path: "docs/sprint-artifacts/sprint-1/stories/story-01-02-login.md"
-    title: "Login Flow"
-  - path: "docs/sprint-artifacts/sprint-1/stories/story-01-03-password-reset.md"
-    title: "Password Reset"
-
-next_action: "Execute story-01-02-login.md"
-last_compaction: "2026-01-27T10:15:00Z"
-```
-
-## Compaction Strategy
-
-**After compaction, agent reads (minimal context):**
-1. Epic state file (progress + next action)
-2. Next story file (from `next_action`)
-3. CLAUDE.md, docs/prd.md, docs/architecture.md
-
-**Agent does NOT re-read:**
-- ❌ Epic file (info in state)
-- ❌ Completed stories
-- ❌ Previous tasks
-
-**Context savings: ~68% less than reading all files**
-
-## Configuration
-
-From `config.yaml → epic_workflow`:
-
-```yaml
-epic_workflow:
-  auto_compact: true              # Compact between stories
-  auto_fix: true                  # Auto-fix review issues
-  max_fix_attempts: 3             # Max fix attempts before HALT
-  pause_between_stories: false    # Continue automatically
-  test_after_each_story: false    # Skip per-story integration tests
-  test_after_epic: true           # Run epic integration tests at end
-```
+1.  **Load Skill**: Read and follow the instructions in `.opencode/skills/dev-epic/SKILL.md`.
+2.  **Initialize**: Create the epic-level TODO list and the epic state file as described in the skill.
+3.  **Execute**: Enter the story -> review -> compact -> loop until all stories in the TODO list are complete.
+4.  **Finalize**: Run final tests and report completion.
 
 ## IMPORTANT SKILLS TO LOAD
 
-- `dev-story` - Story implementation workflow
-- `test-design` - Test writing patterns
-- `code-review` - Review and validation
-
-## Output
-
-- All story implementations (code + tests)
-- Epic state file (updated)
-- Updated epic file (stories marked `[x]`)
-- Epic summary report
-
-## HALT Conditions
-
-The workflow will HALT and ask for input when:
-- Story fails 3 times (implementation/tests)
-- Code review fails after max_fix_attempts
-- Missing dependencies
-- Ambiguous requirements
-- Integration tests fail
-
-## Epic Status Flow
-
-```
-ready-for-dev → in-progress → [story 1] → compact → [story 2] → compact → ... → done
-```
-
-## Next Steps After Completion
-
-- Epic marked `done` in epic state file
-- All stories marked `done`
-- If part of `/dev-sprint`: continue to next epic automatically
-- If standalone: ready for sprint review
+- `dev-epic` - The primary algorithm for this command.

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

@@ -5,174 +5,15 @@ agent: dev
 
 # /dev-sprint Command
 
-Implement entire sprint by executing all epics with automatic compaction.
+Implement an entire sprint by following the `dev-sprint` skill.
 
 ## Process
 
-### Phase 1: Sprint Setup
-1. Find sprint (from number or sprint-status.yaml)
-2. Read `sprint-status.yaml`
-3. Parse all epics in sprint
-4. Load project context (CLAUDE.md, docs/prd.md, docs/architecture.md)
-5. **Create TODO list from sprint** (critical for compaction!):
-   - Parse sprint-status.yaml, extract all epics
-   - For each epic: read epic file, count stories and tasks
-   - Add epics to TODO with story/task counts
-   - Add sprint-level tasks (integration tests, acceptance criteria, metrics)
-   ```
-   [ ] Epic 1: User Authentication (3 stories, 26 tasks)
-   [ ] Epic 2: Product Catalog (5 stories, 42 tasks)
-   [ ] Epic 3: Shopping Cart (4 stories, 31 tasks)
-   [ ] Run sprint integration tests
-   [ ] Verify sprint acceptance criteria
-   [ ] Generate sprint metrics
-   ```
-6. Mark sprint as `in-progress` in sprint-status.yaml
-
-### Phase 2: Epic Execution Loop (for each epic)
-
-7. **Mark epic as `in_progress` in TODO** (e.g., "Epic 1: User Authentication")
-8. Execute epic via `/dev-epic` workflow:
-   - Epic creates its own TODO for stories
-   - Epic executes all stories
-   - Auto-compacts between stories
-   - Auto-fixes code review issues
-9. **Mark epic as `completed` in TODO** (✓ Epic 1: User Authentication)
-10. **Update sprint-status.yaml**:
-    - Mark epic as `done`
-    - Update `stories_completed` count
-    - Find next epic
-11. **Trigger compaction** (if `epic_workflow.auto_compact: true`)
-12. **After compaction:** 
-    - Plugin reads TODO → sees next pending epic
-    - Plugin reads sprint-status.yaml → gets epic path
-    - Agent continues next epic automatically
-
-### Phase 3: Sprint Completion
-
-13. All epics done → **mark integration test TODO as `in_progress`**
-14. Run sprint integration tests (if configured)
-15. **Mark integration test TODO as `completed`**
-16. **Mark acceptance criteria TODO as `in_progress`**
-17. Verify sprint acceptance criteria
-18. **Mark acceptance criteria TODO as `completed`**
-19. **Mark metrics TODO as `in_progress`**
-20. Generate sprint metrics (velocity, completion rate, etc.)
-21. **Mark metrics TODO as `completed`**
-22. Update sprint-status.yaml: `status: "done"`
-23. **Clear TODO** (all tasks done)
-24. Generate sprint summary
-
-## TODO List
-
-**Create at sprint start:**
-```
-[ ] Epic 1: User Authentication (3 stories)
-[ ] Epic 2: Product Catalog (5 stories)
-[ ] Epic 3: Shopping Cart (4 stories)
-[ ] Run sprint integration tests
-[ ] Verify sprint acceptance criteria
-[ ] Generate sprint metrics
-```
-
-**Update after each epic:**
-- Mark epic `completed` in TODO
-- Mark next epic `in_progress` in TODO
-- TODO survives compaction - plugin shows it to agent
-
-**Note:** Each epic creates its own TODO for stories, clears it when done
-
-## Sprint State Tracking
-
-**Location:** `docs/sprint-artifacts/sprint-status.yaml`
-
-```yaml
-sprints:
-  - id: sprint-1
-    name: "Sprint 1 - Core Features"
-    status: in-progress
-    start_date: "2026-01-20"
-    end_date: "2026-02-03"
-    
-    epics:
-      - id: PROJ-E01
-        title: "User Authentication"
-        path: "docs/sprint-artifacts/backlog/epic-01-user-auth.md"
-        status: done
-        stories_completed: 3
-        stories_total: 3
-        
-      - id: PROJ-E02
-        title: "Product Catalog"
-        path: "docs/sprint-artifacts/backlog/epic-02-catalog.md"
-        status: in-progress  # ← Current epic
-        stories_completed: 2
-        stories_total: 5
-        
-      - id: PROJ-E03
-        title: "Shopping Cart"
-        path: "docs/sprint-artifacts/backlog/epic-03-cart.md"
-        status: ready-for-dev
-        stories_total: 4
-```
-
-Each epic also has state file in `.sprint-state/epic-XX-state.yaml`
-
-## Compaction Strategy
-
-**After compaction, agent reads:**
-1. sprint-status.yaml (knows which epic is next)
-2. Next epic file
-3. Next epic state file (if exists)
-4. CLAUDE.md, docs/prd.md, docs/architecture.md
-
-**Agent does NOT re-read:**
-- ❌ Completed epic files
-- ❌ Completed story files
-- ❌ Previous epic states
-
-## Configuration
-
-From `config.yaml → epic_workflow`:
-
-```yaml
-epic_workflow:
-  auto_compact: true              # Compact between epics
-  auto_fix: true                  # Auto-fix review issues
-  pause_between_stories: false    # Continue automatically
-```
+1.  **Load Skill**: Read and follow the instructions in `.opencode/skills/dev-sprint/SKILL.md`.
+2.  **Initialize**: Create the sprint-level TODO list and update `sprint-status.yaml` as described in the skill.
+3.  **Execute**: Enter the epic -> review -> compact -> loop until all epics in the TODO list are complete.
+4.  **Finalize**: Run final sprint tests and report completion.
 
 ## IMPORTANT SKILLS TO LOAD
 
-- `dev-story` - Story implementation workflow
-- `test-design` - Test writing patterns
-- `code-review` - Review and validation
-
-## Output
-
-- All epic implementations (code + tests)
-- Updated sprint-status.yaml
-- Sprint summary report
-- Sprint metrics (velocity, completion rate)
-
-## HALT Conditions
-
-The workflow will HALT and ask for input when:
-- Epic fails repeatedly (3+ failed stories)
-- Multiple stories rejected by @reviewer
-- Sprint deadline approaching (< 20% time, > 50% work)
-- Missing dependencies
-- Sprint integration tests fail
-
-## Sprint Status Flow
-
-```
-planned → in-progress → [epic 1] → compact → [epic 2] → compact → ... → done
-```
-
-## Next Steps After Completion
-
-- Sprint marked `done` in sprint-status.yaml
-- All epics and stories marked `done`
-- Ready for sprint review/retrospective
-- Run `/retrospective` to capture learnings
+- `dev-sprint` - The primary algorithm for this command.

package/src/opencode/commands/dev-story.md

@@ -13,8 +13,17 @@ Implement a story using red-green-refactor cycle with TODO tracking.
 1. Find or load story file
 2. Load project context (CLAUDE.md, docs/prd.md, docs/architecture.md)
 3. Use skill dev-story, test-design
-3. **Create TODO list from story tasks** (for progress tracking)
-4. Mark story as `in-progress`
+4. **Create TODO list for full scope of work** (tasks + tests + review):
+   - Parse story file, extract all tasks
+   - Add each task to TODO
+   - **If `config.yaml → development.auto_review: true`**: Add review task to TODO
+   ```
+   [ ] Task 1: Create User entity
+   [ ] Task 2: Add repository
+   [ ] Task 3: Write integration tests
+   [ ] Code review by @reviewer    ← if auto_review: true
+   ```
+5. Mark story as `in-progress`
 
 ### Phase 2: Implementation (for each task)
 5. **Mark task as `in_progress` in TODO**

package/src/opencode/commands/quick.md

@@ -19,26 +19,23 @@ Automatically used when:
 - Single file or < 5 files affected
 - No new requirements needed
 - No architecture changes
-- Estimated time < 2 hours
+- T-shirt size: S or M
 
 ## Quick Workflow
 
 ```
 ┌────────────────────┐
-│ 1. Quick Doc       │  Create minimal change doc
-│    (2-5 min)       │
+│ 1. Quick Doc  [XS] │  Create minimal change doc
 └────────┬───────────┘
          │
          ▼
 ┌────────────────────┐
-│ 2. Implement       │  Make the change
-│    (varies)        │
+│ 2. Implement [S-M] │  Make the change
 └────────┬───────────┘
          │
          ▼
 ┌────────────────────┐
-│ 3. Test & Verify   │  Verify it works
-│    (5-10 min)      │
+│ 3. Test       [XS] │  Verify it works
 └────────┬───────────┘
          │
          ▼
@@ -119,7 +116,7 @@ For valid quick changes:
 ## Quick Change: [Title]
 
 **Scale:** L0 (Hotfix) / L1 (Small)
-**Estimated Time:** [X] minutes/hours
+**Size:** S / M
 
 ### Files to Modify
 

package/src/opencode/config.yaml

@@ -164,7 +164,6 @@ development:
   
   # 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
 

package/src/opencode/opencode.json

@@ -4,9 +4,7 @@
   "instructions": [
     "AGENTS.md",
     ".opencode/FLOW.yaml",
-    ".opencode/config.yaml",
-    "docs/prd.md",
-    "docs/architecture.md"
+    ".opencode/config.yaml"
   ],
   
   "agent": {