@comfanion/workflow 4.38.1-dev.6 → 4.38.1-dev.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.38.1-dev.6",
+  "version": "4.38.1-dev.8",
   "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.1-dev.6",
-  "buildDate": "2026-01-27T10:43:41.794Z",
+  "version": "4.38.1-dev.8",
+  "buildDate": "2026-01-27T11:22:36.149Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/plugins/custom-compaction.ts

@@ -911,6 +911,74 @@ This is /dev-epic autopilot mode. Execute stories sequentially until epic done.`
 4. Update todo/story when task complete`
   }
 
+  function buildBriefing(agent: string | null, ss: SessionState | null, ctx: SessionContext, readCommands: string): string {
+    const lines: string[] = []
+
+    // 1. WHO you are
+    if (agent) {
+      lines.push(`You are @${agent} (→ .opencode/agents/${agent}.md).`)
+    }
+
+    // 2. WHAT you are doing
+    if (ss) {
+      const cmd = ss.command || "unknown command"
+      if (ss.epic) {
+        lines.push(`You are executing ${cmd} ${ss.epic.id}: ${ss.epic.title}.`)
+      } else if (ss.story) {
+        lines.push(`You are executing ${cmd} ${ss.story.id}: ${ss.story.title}.`)
+      } else {
+        lines.push(`You are executing ${cmd}.`)
+      }
+    } else if (ctx.activeCommand) {
+      lines.push(`You are executing ${ctx.activeCommand}.`)
+    }
+
+    // 3. WHERE you stopped
+    if (ss?.story) {
+      const task = ss.story.current_task || "review"
+      lines.push(`You were on story ${ss.story.id}: ${ss.story.title}, task ${task}.`)
+      if (ss.story.completed_tasks.length > 0) {
+        lines.push(`Completed: ${ss.story.completed_tasks.join(", ")}.`)
+      }
+      if (ss.story.pending_tasks.length > 0) {
+        lines.push(`Remaining: ${ss.story.pending_tasks.join(", ")}.`)
+      }
+    } else if (ss?.epic) {
+      lines.push(`Epic progress: ${ss.epic.progress}.`)
+    } else if (ctx.story) {
+      lines.push(`You were on story: ${ctx.story.title}, task ${ctx.story.currentTask || "review"}.`)
+    }
+
+    // 4. WHAT to do next
+    if (ss?.next_action) {
+      lines.push(`\nNext action: ${ss.next_action}`)
+    }
+
+    // 5. READ these files
+    lines.push(`\n${readCommands}`)
+
+    // 6. KEY DECISIONS (if any)
+    if (ss?.key_decisions && ss.key_decisions.length > 0) {
+      lines.push(`\nKey decisions from your session:`)
+      for (const d of ss.key_decisions) {
+        lines.push(`- ${d}`)
+      }
+    }
+
+    // 7. TODO status (brief)
+    if (ctx.todos.length > 0) {
+      const inProgress = ctx.todos.filter(t => t.status === "in_progress")
+      const pending = ctx.todos.filter(t => t.status === "pending")
+      const completed = ctx.todos.filter(t => t.status === "completed")
+      lines.push(`\nTODO: ${completed.length} done, ${inProgress.length} in progress, ${pending.length} pending.`)
+    }
+
+    // 8. RULES
+    lines.push(`\nDO NOT ask user what to do. Read files above, then resume automatically.`)
+
+    return lines.join("\n")
+  }
+
   return {
     // Track active agent from chat messages
     "chat.message": async (input, output) => {
@@ -967,24 +1035,10 @@ This is /dev-epic autopilot mode. Execute stories sequentially until epic done.`
       const instructions = await formatInstructions(ctx)
       const readCommands = await generateReadCommands(agent, ctx.story, ctx.activeCommand, ctx.sessionState)
 
-      // Agent identity reminder
-      const agentIdentity = agent 
-        ? `You are @${agent} (.opencode/agents/${agent}.md). Load your persona and continue.`
-        : "You are an AI assistant helping with this project."
-
-      output.context.push(`# Session Continuation
-
-${agentIdentity}
-
-${readCommands}
-
----
-
-${context}
-
----
-
-${instructions}`)
+      // Build agentic briefing
+      const ss = ctx.sessionState
+      const briefing = buildBriefing(agent, ss, ctx, readCommands)
+      output.context.push(briefing)
       
       await log(directory, `  -> output.context pushed (${output.context.length} items)`)
       await log(directory, `=== COMPACTION DONE ===`)

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

@@ -40,7 +40,7 @@ metadata:
   </phase>
 
   <phase name="2-init" title="Initialize Epic">
-    <step n="1">Parse epic file → extract story list</step>
+    <step n="1">Parse epic file → "Story Tasks" section has all stories + tasks (no need to read story files yet)</step>
     <step n="2">Create epic state: docs/sprint-artifacts/sprint-N/.sprint-state/epic-XX-state.yaml</step>
     <step n="3">Create TODO list with IDs — stories, their tasks, and reviews:
       ```

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

@@ -79,10 +79,10 @@ Epic is complete when:
 
 ## Stories
 
-| ID | Title | Size | Focus | Status |
-|----|-------|------|-------|--------|
-| S{{E}}-01 | {{title}} | S/M/L | → Unit: `{{unit}}` | ⬜ |
-| S{{E}}-02 | {{title}} | S/M/L | → Unit: `{{unit}}` | ⬜ |
+| ID | Title | Size | File | Status |
+|----|-------|------|------|--------|
+| E{{E}}-S01 | {{title}} | S/M/L | `story-{{E}}-01-{{slug}}.md` | ⬜ |
+| E{{E}}-S02 | {{title}} | S/M/L | `story-{{E}}-02-{{slug}}.md` | ⬜ |
 
 **Dependency Flow:**
 ```
@@ -91,8 +91,32 @@ S01 ──► S02 ──► S03
          └──► S04
 ```
 
-**Notes:**
-- {{implementation_note}}
+---
+
+## Story Tasks
+
+<!-- This section is populated by /stories command.
+     Used by /dev-epic to build TODO without reading all story files. -->
+
+### E{{E}}-S01: {{story title}}
+- E{{E}}-S01-T01: {{task title}}
+- E{{E}}-S01-T02: {{task title}}
+
+### E{{E}}-S02: {{story title}}
+- E{{E}}-S02-T01: {{task title}}
+- E{{E}}-S02-T02: {{task title}}
+
+<!-- Example:
+### E04-S01: Merge Domain Logic
+- E04-S01-T01: MergeResult value object
+- E04-S01-T02: Merge service — primary selection
+- E04-S01-T03: Unit tests
+
+### E04-S02: Auto Merge on Link
+- E04-S02-T01: Event handler for link
+- E04-S02-T02: Best-effort merge logic
+- E04-S02-T03: Integration tests
+-->
 
 ---
 

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

@@ -233,6 +233,26 @@ T1 ──► T2 ──► T3
 
 Save to: `docs/sprint-artifacts/sprint-[N]/stories/story-[EPIC]-[NN]-[description].md`
 
+## MANDATORY: Update Epic File
+
+After creating stories, update the parent epic's **Story Tasks** section.
+This lets `/dev-epic` build TODO from epic file alone — no need to read all stories.
+
+```markdown
+## Story Tasks
+
+### E04-S01: Merge Domain Logic
+- E04-S01-T01: MergeResult value object
+- E04-S01-T02: Merge service — primary selection
+- E04-S01-T03: Unit tests
+
+### E04-S02: Auto Merge on Link
+- E04-S02-T01: Event handler for link
+- E04-S02-T02: Best-effort merge logic
+```
+
+**Format:** `E{NN}-S{NN}-T{NN}: {task title}` — one line per task.
+
 ## Related Skills
 
 - `acceptance-criteria` - For detailed AC