@comfanion/workflow 3.8.0 → 3.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "3.8.0",
+  "version": "3.9.0",
   "description": "Initialize OpenCode Workflow system for AI-assisted development",
   "type": "module",
   "bin": {

package/src/build-info.json

@@ -1,6 +1,6 @@
 {
   "version": "3.0.0",
-  "buildDate": "2026-01-23T17:01:07.473Z",
+  "buildDate": "2026-01-23T17:06:57.357Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/config.yaml

@@ -6,7 +6,7 @@
 # PROJECT CONFIGURATION
 # =============================================================================
 project_name: "ai-wf"
-version: "3.8.0"
+version: "3.9.0"
 
 # =============================================================================
 # USER CONFIGURATION

package/src/opencode/skills/epic-writing/SKILL.md

@@ -168,15 +168,15 @@ Track which FRs are covered:
 
 ```
 EPIC (1-2 weeks)
-  └── STORY (1-3 days)
-        └── TASK (1-2 hours)
+  └── STORY (2-5 days)
+        └── TASK (4-6 hours)
 ```
 
 | Level | Duration | Count | Deliverable |
 |-------|----------|-------|-------------|
 | **Epic** | 1-2 weeks | 1 | Complete feature |
-| **Story** | 1-3 days | 3-8 per epic | User-facing capability |
-| **Task** | 1-2 hours | 4-10 per story | Atomic code change |
+| **Story** | 2-5 days | 3-8 per epic | User-facing capability |
+| **Task** | 4-6 hours | 3-6 per story | Atomic code change with tests |
 
 ### Story Decomposition Pattern
 
@@ -213,17 +213,17 @@ S01 (Domain) ──┬──► S02 (Repo Interface) ──► S04 (Repo Impl)
 
 | Story | Tasks | Hours | Days |
 |-------|-------|-------|------|
-| S01 | 6 | 8h | 1d |
-| S02 | 3 | 4h | 0.5d |
-| S03 | 8 | 12h | 1.5d |
-| S04 | 6 | 9h | 1d |
-| S05 | 5 | 7h | 1d |
-| S06 | 4 | 5h | 0.5d |
-| S07 | 4 | 6h | 1d |
-| **Total** | **36** | **51h** | **6.5d** |
+| S01 | 4 | 20h | 2.5d |
+| S02 | 3 | 15h | 2d |
+| S03 | 5 | 26h | 3d |
+| S04 | 4 | 22h | 3d |
+| S05 | 3 | 16h | 2d |
+| S06 | 3 | 15h | 2d |
+| S07 | 3 | 15h | 2d |
+| **Total** | **25** | **129h** | **~16d** |
 
 **Parallel Opportunities:** S02+S03, S04+S05
-**With Parallelism:** ~5 days
+**With Parallelism:** ~10 days (2 weeks)
 ```
 
 ## Epic Sizing
@@ -232,14 +232,14 @@ S01 (Domain) ──┬──► S02 (Repo Interface) ──► S04 (Repo Impl)
 
 - **Duration:** 1-2 weeks of work
 - **Stories:** 3-8 stories per epic
-- **Tasks:** 25-60 tasks per epic (total across stories)
+- **Tasks:** 15-35 tasks per epic (total across stories)
 - **Scope:** One logical feature/capability
 
 ### Too Big? Split it!
 
 Signs an epic is too big:
 - More than 10 stories
-- More than 80 tasks total
+- More than 40 tasks total
 - Spans multiple sprints
 - Multiple unrelated features
 - Different team members for different parts
@@ -248,8 +248,8 @@ Signs an epic is too big:
 
 Signs an epic is too small:
 - Only 1-2 stories
-- Less than 15 tasks
-- Can be done in 2-3 days
+- Less than 8 tasks
+- Can be done in 3-4 days
 - Part of a larger feature
 
 ### Parallel Execution Opportunities
@@ -261,11 +261,11 @@ Identify which stories can run in parallel:
 
 | Phase | Stories (Parallel) | Duration |
 |-------|-------------------|----------|
-| 1 | S01 | 1d |
-| 2 | S02, S03 | 1.5d |
-| 3 | S04, S05 | 1d |
-| 4 | S06 | 0.5d |
-| 5 | S07 | 1d |
+| 1 | S01 | 2.5d |
+| 2 | S02, S03 | 3d |
+| 3 | S04, S05 | 3d |
+| 4 | S06 | 2d |
+| 5 | S07 | 2d |
 | **Total** | | **5d** |
 
 **Sequential would be:** 6.5d

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

@@ -187,7 +187,7 @@ Each story should have:
 - **Authorization** - Permission checks
 - **Edge cases** - Boundary conditions
 
-## Atomic Tasks (1-2 hours each)
+## Atomic Tasks (4-6 hours each)
 
 ### Task Decomposition Rules
 
@@ -195,7 +195,7 @@ Each story should have:
 
 | Rule | Description |
 |------|-------------|
-| **Max 2 hours** | No task should exceed 2 hours of work |
+| **4-6 hours** | Each task should be 4-6 hours of focused work |
 | **Single responsibility** | One clear deliverable per task |
 | **Explicit dependencies** | Every task declares what it depends on |
 | **Parallel opportunities** | Independent tasks can run in parallel |
@@ -239,28 +239,31 @@ Interface → Stub Implementation → Tests → Real Implementation
 
 **TDD Task:**
 ```markdown
-### T2: Implement {{Entity}} Aggregate
-- **Estimate:** 1.5h
+### T2: Implement {{Entity}} Aggregate + Tests
+- **Estimate:** 5h
 - **Depends on:** T1
 - **Methodology:** TDD
 - **Deliverables:**
   - [ ] Aggregate: `domain/aggregate/entity.go`
+  - [ ] Value objects: `domain/valueobject/*.go`
 - **Validation Test:** `domain/aggregate/entity_test.go`
   - [ ] Test creation happy path
-  - [ ] Test validation errors  
+  - [ ] Test validation errors
+  - [ ] Test business rules
   - [ ] **⚠️ ALL TESTS MUST PASS**
 ```
 
 **STUB Task:**
 ```markdown
-### T2: Implement Repository (Stub → Real)
-- **Estimate:** 1.5h
+### T2: Implement Repository (Stub → Real) + Tests
+- **Estimate:** 6h
 - **Depends on:** T1
 - **Methodology:** STUB
 - **Deliverables:**
   - [ ] Stub: `infrastructure/repo/entity_memory_repo.go`
   - [ ] Real: `infrastructure/repo/entity_postgres_repo.go`
 - **Validation Test:** `infrastructure/repo/entity_repo_test.go`
+  - [ ] Test Save, FindByID, List
   - [ ] Test with stub first
   - [ ] Replace stub with real
   - [ ] **⚠️ ALL TESTS MUST PASS**
@@ -284,7 +287,7 @@ Interface → Stub Implementation → Tests → Real Implementation
 
 ```markdown
 ### T{N}: {Task Name}
-- **Estimate:** 1h | 1.5h | 2h
+- **Estimate:** 4h | 5h | 6h
 - **Depends on:** T1, T2 | - (none)
 - **Blocks:** T5, T6 | - (none)
 - **Type:** 🔴 RED | 🟢 GREEN | 🔵 REFACTOR | 📝 DOCS
@@ -314,16 +317,12 @@ T1 ──┬──► T2 ──► T4
 ```markdown
 | ID | Task | Est | Depends On | Status |
 |----|------|-----|------------|--------|
-| T1 | Write aggregate test | 1h | - | ⬜ |
-| T2 | Implement aggregate | 1.5h | T1 | ⬜ |
-| T3 | Write repository interface | 0.5h | T1 | ⬜ |
-| T4 | Write use case test | 1h | T2 | ⬜ |
-| T5 | Implement use case | 1.5h | T3, T4 | ⬜ |
-| T6 | Implement repository | 1.5h | T3 | ⬜ |
-| T7 | Write HTTP handler test | 1h | T5 | ⬜ |
-| T8 | Implement HTTP handler | 1h | T7 | ⬜ |
-| T9 | Integration tests | 1.5h | T6, T8 | ⬜ |
-| T10 | Refactor & docs | 1h | T9 | ⬜ |
+| T1 | Domain layer (aggregates, value objects, tests) | 6h | - | ⬜ |
+| T2 | Repository interface + use case tests | 5h | T1 | ⬜ |
+| T3 | Use case implementation | 5h | T2 | ⬜ |
+| T4 | Repository implementation (PostgreSQL) | 6h | T2 | ⬜ |
+| T5 | HTTP handlers + tests | 5h | T3 | ⬜ |
+| T6 | Integration tests + refactor | 5h | T4, T5 | ⬜ |
 ```
 
 **Status:** ⬜ TODO | 🔄 IN_PROGRESS | ✅ DONE | ⏸️ BLOCKED
@@ -345,7 +344,7 @@ Phase 7: T9 (waits for T6, T8)
 Phase 8: T10 (final)
 
 **Critical Path:** T1 → T2 → T4 → T5 → T7 → T8 → T9 → T10
-**Total Estimate:** 12h
+**Total Estimate:** 32h (4 days)
 **Parallel Savings:** ~3h (25%)
 ```
 
@@ -354,16 +353,12 @@ Phase 8: T10 (final)
 ```markdown
 | ID | Task | Est | Depends On | Type |
 |----|------|-----|------------|------|
-| T1 | Write Product aggregate test | 1h | - | 🔴 |
-| T2 | Implement Product aggregate | 1.5h | T1 | 🟢 |
-| T3 | Write ProductRepository interface | 0.5h | - | 📝 |
-| T4 | Write CreateProduct use case test | 1h | T2, T3 | 🔴 |
-| T5 | Implement CreateProduct handler | 1.5h | T4 | 🟢 |
-| T6 | Implement PostgreSQL repository | 1.5h | T3 | 🟢 |
-| T7 | Write HTTP handler test | 1h | T5 | 🔴 |
-| T8 | Implement HTTP handler | 1h | T7 | 🟢 |
-| T9 | Write integration tests | 1.5h | T6, T8 | 🔴 |
-| T10 | Refactor & documentation | 1h | T9 | 🔵 |
+| T1 | Domain layer: Product aggregate + value objects + tests | 6h | - | 🔴🟢 |
+| T2 | Repository interface + CreateProduct use case tests | 5h | T1 | 🔴 |
+| T3 | CreateProduct use case implementation | 5h | T2 | 🟢 |
+| T4 | PostgreSQL repository implementation + tests | 6h | T2 | 🟢 |
+| T5 | HTTP handler + tests | 5h | T3 | 🔴🟢 |
+| T6 | Integration tests + refactor + documentation | 5h | T4, T5 | 🔵 |
 
 **Graph:**
 T1 ──► T2 ──┬──► T4 ──► T5 ──► T7 ──► T8 ──┬──► T9 ──► T10
@@ -373,18 +368,18 @@ T3 ─────────┴───────────► T6 ──
 
 ### Splitting Large Tasks
 
-If a task exceeds 2h, split it. **Each split task MUST have validation test.**
+If a task exceeds 6h, consider splitting it. **Each task MUST have validation test.**
 
-| Original (4h) | Split Into (with tests) |
-|---------------|------------------------|
-| "Implement repository" | **T1:** Interface + contract test (0.5h)<br>**T2:** Save method + test (1h)<br>**T3:** FindByID + test (1h)<br>**T4:** List + test (1.5h) |
-| "Write aggregate" | **T1:** Value objects + tests (1h)<br>**T2:** Aggregate + creation test (1h)<br>**T3:** Business rules + tests (1h) |
+| Original (8h+) | Split Into (with tests) |
+|----------------|------------------------|
+| "Full domain layer" (10h) | **T1:** Value objects + tests (4h)<br>**T2:** Aggregate + business rules + tests (6h) |
+| "Full repository" (10h) | **T1:** Interface + Save/FindByID + tests (5h)<br>**T2:** List/Search + advanced queries + tests (5h) |
 
 ### Task Template with Validation
 
 ```markdown
 ### T{N}: {Task Name}
-- **Estimate:** 1.5h
+- **Estimate:** 5h
 - **Depends on:** T{N-1}
 - **Methodology:** TDD | STUB
 - **Deliverables:**

package/src/opencode/templates/epic-template.md

@@ -84,8 +84,8 @@ S01 ──► S02 ──► S03 ──► S04
 ### Story Decomposition Rules
 
 Each story MUST:
-1. Be completable in 1-3 days
-2. Have 4-10 atomic tasks (1-2h each)
+1. Be completable in 2-5 days
+2. Have 3-6 atomic tasks (4-6h each)
 3. Have clear dependencies on other stories
 4. Map to specific Acceptance Criteria
 
@@ -103,11 +103,11 @@ Each story MUST:
 
 | Layer | Stories | Tasks | Hours |
 |-------|---------|-------|-------|
-| Domain | 1 | 6 | 8h |
-| Application | 1 | 8 | 12h |
-| Infrastructure | 2 | 9 | 14h |
-| Testing | 1 | 4 | 6h |
-| **Total** | **5** | **27** | **40h** |
+| Domain | 1 | 4 | 20h |
+| Application | 1 | 4 | 22h |
+| Infrastructure | 2 | 5 | 28h |
+| Testing | 1 | 3 | 15h |
+| **Total** | **5** | **16** | **85h** |
 
 ---
 

package/src/opencode/templates/story-template.md

@@ -55,7 +55,7 @@ METHODOLOGY: {{methodology}} (tdd | stub)
 - STUB: Interface → Stub → Test → Full Implementation
 
 RULES:
-- Each task is 1-2 hours max
+- Each task is 4-6 hours of focused work
 - Each task includes TEST as validation gate
 - Tasks have explicit dependencies
 - Dev agent respects dependency order
@@ -98,108 +98,101 @@ T3 ───────────────┴──► T6
 
 | ID | Task | Est | Deps | Test | Status |
 |----|------|-----|------|------|--------|
-| T1 | {{task_1}} | 1h | - | unit | ⬜ |
-| T2 | {{task_2}} | 1.5h | T1 | unit | ⬜ |
-| T3 | {{task_3}} | 1h | T2 | unit | ⬜ |
-| T4 | {{task_4}} | 1.5h | T1 | unit | ⬜ |
-| T5 | {{task_5}} | 1h | T4 | unit | ⬜ |
-| T6 | {{task_6}} | 1.5h | T3,T5 | integration | ⬜ |
+| T1 | {{task_1}} | 5h | - | unit | ⬜ |
+| T2 | {{task_2}} | 6h | T1 | unit | ⬜ |
+| T3 | {{task_3}} | 5h | T2 | unit | ⬜ |
+| T4 | {{task_4}} | 5h | T1 | unit | ⬜ |
+| T5 | {{task_5}} | 5h | T3,T4 | integration | ⬜ |
 
 **Status:** ⬜ TODO | 🔄 IN_PROGRESS | ✅ DONE | ⏸️ BLOCKED | ❌ FAILED
 
 ---
 
-### T1: Define {{entity}} Interface
-- **Estimate:** 1h
+### T1: Domain Layer (Aggregates, Value Objects)
+- **Estimate:** 6h
 - **Depends on:** -
-- **Blocks:** T2, T4
+- **Blocks:** T2
 - **Deliverables:**
   - [ ] Interface/contract defined
-  - [ ] Value objects defined (if needed)
+  - [ ] Value objects with validation
+  - [ ] Aggregate with business rules
+  - [ ] Factory methods
 - **Validation Test:** 
-  - [ ] Contract test (compile/type check)
+  - [ ] Value object tests (validation, equality)
+  - [ ] Aggregate creation tests
+  - [ ] Business rules tests
+  - [ ] **⚠️ ALL TESTS MUST PASS**
 - **Notes:** {{implementation_hint}}
 
 ---
 
-### T2: Implement {{entity}} Entity/Model
-- **Estimate:** 1.5h
+### T2: Repository Interface + Use Case Tests
+- **Estimate:** 5h
 - **Depends on:** T1
-- **Blocks:** T3
+- **Blocks:** T3, T4
 - **Deliverables:**
-  - [ ] Entity/model with business logic
-  - [ ] Factory method with validation
+  - [ ] Repository interface (ports)
+  - [ ] Use case interface
+  - [ ] Use case DTOs (input/output)
+  - [ ] Use case tests (with mock repository)
 - **Validation Test:**
-  - [ ] Test creation happy path
-  - [ ] Test validation errors
-  - [ ] Test business rules
+  - [ ] Use case happy path test
+  - [ ] Use case error handling tests
   - [ ] **⚠️ ALL TESTS MUST PASS**
 - **Notes:** {{implementation_hint}}
 
 ---
 
-### T3: Implement Use Case / Service
-- **Estimate:** 1h
+### T3: Use Case Implementation
+- **Estimate:** 5h
 - **Depends on:** T2
-- **Blocks:** T6
+- **Blocks:** T5
 - **Deliverables:**
-  - [ ] Use case handler/service
-  - [ ] Input/Output DTOs
+  - [ ] Use case handler implementation
   - [ ] Mappers (entity ↔ DTO)
+  - [ ] Error handling
 - **Validation Test:**
-  - [ ] Test happy path (mock repository)
-  - [ ] Test validation errors
+  - [ ] All use case tests pass
+  - [ ] Edge cases covered
   - [ ] **⚠️ ALL TESTS MUST PASS**
 - **Notes:** {{implementation_hint}}
 
 ---
 
-### T4: Implement Repository / Data Access
-- **Estimate:** 1.5h
-- **Depends on:** T1
+### T4: Repository Implementation
+- **Estimate:** 6h
+- **Depends on:** T2
 - **Blocks:** T5
 - **Deliverables (TDD):**
-  - [ ] Write test first
-  - [ ] Implement repository
+  - [ ] Write repository tests first
+  - [ ] PostgreSQL repository implementation
 - **Deliverables (STUB):**
   - [ ] In-memory stub first
-  - [ ] Real implementation
+  - [ ] PostgreSQL implementation
 - **Validation Test:**
   - [ ] Test Save
-  - [ ] Test FindByID
-  - [ ] Test FindByID not found
+  - [ ] Test FindByID (found/not found)
+  - [ ] Test List with filters
   - [ ] **⚠️ ALL TESTS MUST PASS**
 - **Notes:** {{implementation_hint}}
 
 ---
 
-### T5: Implement API Handler
-- **Estimate:** 1h
-- **Depends on:** T4
-- **Blocks:** T6
-- **Deliverables:**
-  - [ ] API handler/controller
-  - [ ] Routes registered
-- **Validation Test:**
-  - [ ] Test 201 Created
-  - [ ] Test 400 Bad Request
-  - [ ] Test 403 Forbidden
-  - [ ] **⚠️ ALL TESTS MUST PASS**
-- **Notes:** {{implementation_hint}}
-
----
-
-### T6: Integration Test & Refactor
-- **Estimate:** 1.5h
-- **Depends on:** T3, T5
+### T5: HTTP Handlers + Integration Tests
+- **Estimate:** 5h
+- **Depends on:** T3, T4
 - **Blocks:** -
 - **Deliverables:**
-  - [ ] Integration test
-  - [ ] Code refactored, no smells
+  - [ ] HTTP handler/controller
+  - [ ] Routes registered
+  - [ ] Request/response validation
+  - [ ] Integration tests
   - [ ] Documentation updated
 - **Validation Test:**
+  - [ ] Test 201 Created
+  - [ ] Test 400 Bad Request (validation)
+  - [ ] Test 404 Not Found
   - [ ] E2E: API → Service → Repo → DB
-  - [ ] Event published (if applicable)
   - [ ] **⚠️ ALL TESTS MUST PASS**
   - [ ] **⚠️ NO REGRESSIONS**
 - **Notes:** {{implementation_hint}}
@@ -210,14 +203,14 @@ T3 ───────────────┴──► T6
 
 | Phase | Tasks (Parallel) | Duration | Tests Required |
 |-------|-----------------|----------|----------------|
-| 1 | T1 | 1h | Interface contract |
-| 2 | T2, T4 | 1.5h | Unit tests |
-| 3 | T3, T5 | 1h | Unit tests |
-| 4 | T6 | 1.5h | Integration tests |
-| **Total** | | **5h** | **All green** |
-
-**Critical Path:** T1 → T2 → T3 → T6 = 5h
-**With Parallelism:** ~4h
+| 1 | T1 | 6h | Domain layer tests |
+| 2 | T2 | 5h | Use case tests |
+| 3 | T3, T4 | 6h | Implementation tests |
+| 4 | T5 | 5h | Integration tests |
+| **Total** | | **22h** | **All green** |
+
+**Critical Path:** T1 → T2 → T3 → T5 = 21h (~3 days)
+**With Parallelism (T3 || T4):** ~2.5 days
 
 ---
 

package/src/opencode/workflows/dev-story/instructions.md

@@ -363,9 +363,9 @@ Read from `config.yaml → development.methodology`:
   <output>
     | ID | Task | Est | Depends On | Status |
     |----|------|-----|------------|--------|
-    | T1 | ... | 1h | - | ✅ |
-    | T2 | ... | 1.5h | T1 | 🔄 | ← Current
-    | T3 | ... | 1h | T1 | ⬜ | ← Can run parallel with T2
+    | T1 | ... | 5h | - | ✅ |
+    | T2 | ... | 6h | T1 | 🔄 | ← Current
+    | T3 | ... | 5h | T1 | ⬜ | ← Can run parallel with T2
   </output>
 </step>
 ```