@mindfoldhq/trellis 0.6.0 → 0.6.2

package/dist/migrations/manifests/0.6.1.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.6.1",
+  "description": "Workflow simplification — Phase 3.1 Quality verification removed (folded into 2.2 + 3.4). Phase Index 1.3 label normalized.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Refactor:**\n- workflow.md: Phase 3.1 Quality verification removed. Its two unique value points (full-scope final check + spec-sync trigger) folded into Phase 2.2 (last 2.2 must run full-scope via `--mode packages`) and Phase 3.4 (commit preamble asking if spec sync is needed). Step numbering kept stable (3.1 left as a numbered gap) to avoid breaking external references.\n- workflow.md: Phase Index 1.3 `Configure context` label normalized from non-standard `[conditional · once]` to `[required · once]` with `sub-agent-dispatch-platforms-only` annotation, matching step body. The `[conditional]` tag was a single-use label that no other step used.\n- marketplace workflows `native`, `tdd`, `channel-driven-subagent-dispatch` updated in lockstep with the main workflow template.\n- Bundled `trellis-meta` skill `change-workflow.md` status transition example updated to reflect new Phase 3 numbering.\n- Copilot `finish-work.prompt.md` Phase 3 ASCII flow refreshed.\n\nNo source code changed. This is a docs-only refactor that propagates through `trellis update` template refresh.",
+  "migrations": [],
+  "notes": "Docs-only refactor. Run `trellis update` to refresh `.trellis/workflow.md`, the trellis-meta bundled skill, and (for Copilot users) the finish-work prompt. No `--migrate` needed; no breaking change.\n\nInstall: `npm install -g @mindfoldhq/trellis`"
+}

package/dist/migrations/manifests/0.6.2.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.6.2",
+  "description": "Fix stale Phase 3.1 routing in /continue command left over from 0.6.1 workflow simplification.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- `/continue` command (`commands/continue.md`): the resume-routing table still pointed `status=in_progress + check passed` at the deleted Phase **3.1**. Now routes to **3.3** (spec update) → **3.4** (commit), matching the 0.6.1 workflow simplification. The 0.6.1 cleanup updated `workflow.md`, the marketplace variants, the trellis-meta skill, and the Copilot prompt, but missed `continue.md` because its routing uses a bare-number syntax (`→ **3.1**`) that the `Phase 3.1` grep did not catch.\n\n**Internal:**\n- `.trellis/spec/docs-site/docs/sync-on-change.md` Trigger 1 now lists every in-template file that carries step-routing references and adds a bare-number grep pattern, so a future step delete/renumber audits all routing sites — not just `workflow.md`.\n\nNo source code changed. Run `trellis update` to refresh `.trellis/.../commands/trellis/continue.md`.",
+  "migrations": [],
+  "notes": "Docs-only fix. Run `trellis update` to refresh the `/continue` command routing. No `--migrate` needed.\n\nInstall: `npm install -g @mindfoldhq/trellis`"
+}

package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-workflow.md

@@ -55,7 +55,7 @@ If the user wants only one platform to avoid sub-agents, first confirm whether t
 | `planning` | complex task has `prd.md`, `design.md`, and `implement.md` | ask for start review, then run `task.py start` |
 | `in_progress` | no implementation in conversation history | Phase 2.1 (`trellis-implement`) |
 | `in_progress` | implementation done, no `trellis-check` run | Phase 2.2 (`trellis-check`) |
-| `in_progress` | check passed | Phase 3.1 (verify quality + spec update) |
+| `in_progress` | check passed | Phase 3.3 (spec update) → 3.4 (commit) |
 | `completed` | task is still in active tree | Phase 3.5 (run `/trellis:finish-work` to archive) |
 
 When you add a custom status (e.g. `in-review`), add a `[workflow-state:in-review]` block in `.trellis/workflow.md` for the per-turn breadcrumb AND extend this route table — usually by editing the `/trellis:continue` command file (`.{platform}/commands/trellis/continue.md` or equivalent) to add a row that decides where to resume from. Without the route entry, `/trellis:continue` will fall through to a default branch and the user will not land on the step you intended.

package/dist/templates/common/commands/continue.md

@@ -30,7 +30,7 @@ Shows the Phase Index (Plan / Execute / Finish) with routing + skill mapping.
 - `status=planning` + required artifacts complete + required jsonl curated or inline mode → **1.4** (ask for start review; only run `task.py start` after user confirms)
 - `status=in_progress` + implementation not started → **2.1**
 - `status=in_progress` + implementation done, not yet checked → **2.2**
-- `status=in_progress` + check passed → **3.1**
+- `status=in_progress` + check passed → **3.3** (spec update) → **3.4** (commit)
 - `status=completed` (rare; usually archived immediately) → archive flow
 
 Phase rules (full detail in `.trellis/workflow.md`):

package/dist/templates/copilot/prompts/finish-work.prompt.md

@@ -79,11 +79,11 @@ Final git log order: `<work commits from 3.4>` → `chore(task): archive ...` (o
 
 ```
 Development Flow (workflow.md Phase 3):
-  3.1 Quality verification
   3.2 Debug retrospective (on demand)
   3.3 Spec update
   3.4 Commit changes  -> AI drafts batched commits, user confirms
   3.5 Wrap-up         -> /finish-work (this prompt: survey + archive + journal)
+  (3.1 was folded into 2.2 + 3.4 — see workflow.md "Phase 3: Finish" note)
 
 Debug Flow:
   Hit bug -> Fix -> /break-loop -> Knowledge capture

package/dist/templates/trellis/workflow.md

@@ -121,7 +121,7 @@ python3 ./.trellis/scripts/get_context.py --mode phase --step <X.Y>  # detailed
     [workflow-state:no_task]      → no active task; before Phase 1
     [workflow-state:planning]     → all of Phase 1 (status='planning')
     [workflow-state:planning-inline] → Codex inline variant of Phase 1
-    [workflow-state:in_progress]  → Phase 2 + Phase 3.1-3.4
+    [workflow-state:in_progress]  → Phase 2 + Phase 3.2-3.4
                                     (status stays 'in_progress' from
                                     task.py start until task.py archive)
     [workflow-state:in_progress-inline] → Codex inline variant of Phase 2/3
@@ -183,7 +183,7 @@ Complex task: ask the user if you can create a Trellis task and enter the planni
 - 1.0 Create task `[required · once]` (only after task-creation consent)
 - 1.1 Requirement exploration `[required · repeatable]` (`prd.md`; complex tasks also need `design.md` + `implement.md`)
 - 1.2 Research `[optional · repeatable]`
-- 1.3 Configure context `[conditional · once]` — Claude Code, Cursor, OpenCode, Codex, Kiro, Gemini, Qoder, CodeBuddy, Copilot, Droid, Pi
+- 1.3 Configure context `[required · once]` — Claude Code, Cursor, OpenCode, Codex, Kiro, Gemini, Qoder, CodeBuddy, Copilot, Droid, Pi (sub-agent-dispatch platforms only; inline platforms skip)
 - 1.4 Activate task `[required · once]` (review gate, then `task.py start`; status → in_progress)
 - 1.5 Completion criteria
 
@@ -215,7 +215,7 @@ Inline mode: skip jsonl curation; Phase 2 reads artifacts/specs via `trellis-bef
 - 2.3 Rollback `[on demand]`
 
 <!-- Per-turn breadcrumb: shown while status='in_progress'.
-     Scope: all of Phase 2 + Phase 3.1-3.4 (status stays 'in_progress' from
+     Scope: all of Phase 2 + Phase 3.2-3.4 (status stays 'in_progress' from
      task.py start until task.py archive; only archive flips it). The body
      therefore must cover every required step from implementation through
      commit, including Phase 3.3 spec update and Phase 3.4 commit. -->
@@ -241,12 +241,13 @@ Read context: `prd.md` -> `design.md if present` -> `implement.md if present`, p
 [/workflow-state:in_progress-inline]
 
 ### Phase 3: Finish
-- 3.1 Quality verification `[required · repeatable]`
 - 3.2 Debug retrospective `[on demand]`
 - 3.3 Spec update `[required · once]`
 - 3.4 Commit changes `[required · once]`
 - 3.5 Wrap-up reminder
 
+> Note: step 3.1 was folded into 2.2 (last-iteration full-scope check) and 3.4 (commit preamble). Numbering kept stable to avoid breaking external references.
+
 <!-- Per-turn breadcrumb: shown while status='completed'.
      Currently DEAD in normal flow: cmd_archive writes status='completed' in
      the same call that moves the task dir to archive/, so the active-task
@@ -550,6 +551,8 @@ If issues are found → fix → re-check, until green.
 
 [/codex-inline, Kilo, Antigravity, Windsurf]
 
+**Final pass (before Phase 3.4 commit)**: the last 2.2 of a task must run full-scope, not just on the latest implement chunk. List all affected packages with `python3 ./.trellis/scripts/get_context.py --mode packages`, then load each package's spec index Quality Check section. This catches cross-layer / multi-package issues a mid-iteration local 2.2 cannot.
+
 #### 2.3 Rollback `[on demand]`
 
 - `check` reveals a prd defect → return to Phase 1, fix `prd.md`, then redo 2.1
@@ -562,15 +565,6 @@ If issues are found → fix → re-check, until green.
 
 Goal: ensure code quality, capture lessons, record the work.
 
-#### 3.1 Quality verification `[required · repeatable]`
-
-Load the `trellis-check` skill and do a final verification:
-- Spec compliance
-- lint / type-check / tests
-- Cross-layer consistency (when changes span layers)
-
-If issues are found → fix → re-check, until green.
-
 #### 3.2 Debug retrospective `[on demand]`
 
 If this task involved repeated debugging (the same issue was fixed multiple times), load the `trellis-break-loop` skill to:
@@ -591,6 +585,8 @@ Update the docs under `.trellis/spec/` accordingly. Even if the conclusion is "n
 
 #### 3.4 Commit changes `[required · once]`
 
+**Spec-sync preamble**: before drafting commits, ask: did this task fix a bug or surface non-obvious knowledge that should land in `.trellis/spec/` so future-you (or future-AI) doesn't repeat the mistake? If yes, return to Phase 3.3 first — spec writes belong in the same task's commit batch, not as a forgotten follow-up.
+
 The AI drives a batched commit of this task's code changes so `/finish-work` can run cleanly afterwards. Goal: produce work commits FIRST, then bookkeeping (archive + journal) commits land after — never interleaved.
 
 **Step-by-step**:
@@ -663,8 +659,8 @@ All tag blocks live in the `## Phase Index` section above, immediately after eac
 | No active task (before Phase 1) | `[workflow-state:no_task]` (after the Phase Index ASCII art) |
 | All of Phase 1 (task created → ready for implementation) | `[workflow-state:planning]` (after Phase 1 summary) |
 | Codex inline Phase 1 | `[workflow-state:planning-inline]` |
-| Phase 2 + Phase 3.1–3.4 (implementation + check + wrap-up) | `[workflow-state:in_progress]` (after Phase 2 summary) |
-| Codex inline Phase 2 + Phase 3.1–3.4 | `[workflow-state:in_progress-inline]` |
+| Phase 2 + Phase 3.2–3.4 (implementation + check + wrap-up) | `[workflow-state:in_progress]` (after Phase 2 summary) |
+| Codex inline Phase 2 + Phase 3.2–3.4 | `[workflow-state:in_progress-inline]` |
 | After Phase 3.5 (archived) | `[workflow-state:completed]` (after Phase 3 summary; **currently DEAD**) |
 
 ### Changing the per-turn prompt text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindfoldhq/trellis",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "AI capabilities grow like ivy — Trellis provides the structure to guide them along a disciplined path",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,7 +34,7 @@
     "inquirer": "^9.3.7",
     "undici": "^6.21.0",
     "zod": "^4.4.2",
-    "@mindfoldhq/trellis-core": "0.6.0"
+    "@mindfoldhq/trellis-core": "0.6.2"
   },
   "devDependencies": {
     "@eslint/js": "^9.18.0",