flower-trellis 0.5.2-beta.0 → 0.5.2

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/patch.json

@@ -0,0 +1,179 @@
+{
+  "schemaVersion": 2,
+  "id": "trellis-meta-managed-customization-routing",
+  "purpose": "managed_customization_routing",
+  "operations": [
+    {
+      "id": "trellis-meta-managed-customization-entry",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" }
+      ],
+      "selector": { "type": "literal", "source": "customization-entry-selector.md", "expectedMatches": 1 },
+      "content": { "source": "customization-entry-content.md" }
+    },
+    {
+      "id": "trellis-meta-managed-customization-order",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/references/customize-local/overview.md", "missing": "skip" }
+      ],
+      "selector": { "type": "markdown-section", "heading": "## General Operation Order" },
+      "baselines": ["customization-order-baseline.md"],
+      "content": { "source": "customization-order-content.md" }
+    },
+    {
+      "id": "trellis-meta-managed-workflow-entry",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" }
+      ],
+      "selector": { "type": "literal", "source": "workflow-entry-selector.md", "expectedMatches": 1 },
+      "content": { "source": "workflow-entry-content.md" }
+    },
+    {
+      "id": "trellis-meta-managed-workflow-edit-route",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/references/customize-local/change-workflow.md", "missing": "skip" }
+      ],
+      "selector": { "type": "markdown-section", "heading": "## Modification Steps" },
+      "baselines": ["workflow-edit-route-baseline.md"],
+      "content": { "source": "workflow-edit-route-content.md" }
+    },
+    {
+      "id": "trellis-meta-managed-skill-classification",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" }
+      ],
+      "selector": { "type": "literal", "source": "skill-classification-selector.md", "expectedMatches": 1 },
+      "content": { "source": "skill-classification-content.md" }
+    },
+    {
+      "id": "trellis-meta-managed-skill-edit-route",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/references/customize-local/change-skills-or-commands.md", "missing": "skip" }
+      ],
+      "selector": { "type": "markdown-section", "heading": "### Bundled vs. Project-Local" },
+      "baselines": ["skill-edit-route-baseline.md"],
+      "content": { "source": "skill-edit-route-content.md" }
+    },
+    {
+      "id": "trellis-meta-managed-platform-edit-route",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/references/platform-files/overview.md", "missing": "skip" }
+      ],
+      "selector": { "type": "markdown-section", "heading": "## Local Modification Order" },
+      "baselines": ["platform-edit-route-baseline.md"],
+      "content": { "source": "platform-edit-route-content.md" }
+    }
+  ]
+}

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/platform-edit-route-baseline.md

@@ -0,0 +1,11 @@
+## Local Modification Order
+
+When the user asks to customize behavior for a platform, the AI should inspect files in this order:
+
+1. Read `.trellis/workflow.md` to confirm the shared flow.
+2. Read the target platform's settings/config to see which hooks/agents/skills/commands are registered.
+3. Read the target platform's agents/skills/commands/hooks.
+4. Modify the local file closest to the user's need.
+5. If the change affects the shared flow, synchronize `.trellis/workflow.md` or `.trellis/spec/`.
+
+Do not modify only platform files and forget the shared workflow. Do not modify only `.trellis/workflow.md` and forget that platform entry points may still contain old descriptions.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/platform-edit-route-content.md

@@ -0,0 +1,11 @@
+## Local Modification Order
+
+When customizing a platform:
+
+1. Read `.trellis/workflow.md` and the target platform's settings, hooks, agents, skills, commands, prompts, or workflows.
+2. Inspect `.flower/plugin-lock.json`, `.flower/state.json`, template hashes, and managed markers for every candidate target.
+3. For project-local files, modify the narrow local source and keep shared workflow semantics aligned.
+4. For managed files, modify the owning Plugin/Patch source and preserve explicit platform targets with `each-existing`/`missing: skip`; do not create roots for platforms that are not enabled.
+5. Apply the lifecycle and compare final bytes across all existing platform roots. Shared `.agents/skills` consumers must remain byte-consistent, while platform-specific frontmatter may retain its native differences.
+
+Never claim cross-platform support after changing only one deployed copy.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/skill-classification-content.md

@@ -0,0 +1,9 @@
+When the user wants to change AI entry points, auto-trigger rules, or explicit command behavior, inspect the deployed skill/command/prompt/workflow and then classify its owner.
+
+- **Upstream bundled**: distributed by Trellis and tracked by template hashes.
+- **Skill-Garden managed**: modified or projected by `flower/skill-garden`, proven by lock/state entries or managed Patch markers.
+- **Flower managed**: owned by another Flower Plugin, adapter, or Flower Patch catalog.
+- **Shared common**: projected with shared ownership and retained across dependent capabilities.
+- **Project-local**: no upstream template or Plugin ownership claim, and intentionally maintained by the project.
+
+Do not classify every non-bundled name as project-local. Use `.flower/state.json`, `.trellis/.template-hashes.json`, local skill roots, and available Bundle declarations as evidence before selecting an edit route.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/skill-classification-selector.md

@@ -0,0 +1,8 @@
+When the user wants to change AI entry points, auto-trigger rules, or explicit command behavior, edit skills, commands, prompts, or workflows in local platform directories.
+
+Before editing, classify the skill you are about to touch:
+
+- **Bundled upstream skill** — `trellis-meta`, `trellis-spec-bootstrap`, `trellis-session-insight`, `trellis-channel`. Source of truth lives in the Trellis CLI repo under `packages/cli/src/templates/common/bundled-skills/<name>/`; auto-dispatched to every platform's skill root by `getBundledSkillTemplates()` on `trellis init` / `trellis update`. Local edits here are tracked by `.trellis/.template-hashes.json` and will be flagged on the next update.
+- **Project-local skill** — anything else under `.{platform}/skills/`. Owned by the user; not refreshed by `trellis update`.
+
+The remainder of this file uses "skill" for the local file; the override and conflict rules differ between the two cases.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/skill-edit-route-baseline.md

@@ -0,0 +1,13 @@
+### Bundled vs. Project-Local
+
+The same directory shape is used by two very different ownership models:
+
+| Aspect | Bundled (`trellis-meta`, `trellis-spec-bootstrap`, `trellis-session-insight`, `trellis-channel`) | Project-local |
+| --- | --- | --- |
+| Source of truth | `packages/cli/src/templates/common/bundled-skills/<name>/` in Trellis CLI repo | Inside the user project itself |
+| Dispatch | Auto-dispatched to every platform skill root by `getBundledSkillTemplates()` (`packages/cli/src/templates/common/index.ts`) on `trellis init` / `trellis update` | Created by the user (or another skill) and never moved |
+| Hash tracking | Every file recorded in `.trellis/.template-hashes.json`; conflict prompt on update | Not tracked |
+| Editing locally | Allowed but will be marked "modified by user" on next update | Free editing |
+| The right way to customize | Add a *new* project-local skill with a *different* name that supplements (or supersedes) the bundled one | Edit the file directly |
+
+If the goal is "make my project's AI behave differently when discussing release notes," the answer is almost always a project-local skill, not surgery on `trellis-meta/`.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/skill-edit-route-content.md

@@ -0,0 +1,13 @@
+### Bundled vs. Project-Local
+
+Use the ownership evidence, not the directory shape:
+
+| Owner | Update evidence | Correct edit route |
+| --- | --- | --- |
+| Upstream Trellis | `.trellis/.template-hashes.json` only | Local supplement/divergence or upstream source, according to user intent |
+| Skill-Garden | `flower/skill-garden` lock/state entry or managed marker | 0.6 Patch/Bundle source under `vendor/skill-garden` when authoring Flower |
+| Flower Plugin | `.flower/state.json` owner/path/patch entry | Owning Plugin source or Flower Patch catalog |
+| Shared common | State path with shared ownership | Shared common source; preserve other consumers |
+| Project-local | No managed ownership claim | Edit the project file directly |
+
+For a managed target, the durable sequence is source change -> required preflight -> transaction -> state/provenance update. For a project-private behavior, a differently named local skill or `.trellis/spec/` remains preferable to mutating a public bundled skill.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/workflow-edit-route-baseline.md

@@ -0,0 +1,7 @@
+## Modification Steps
+
+1. Find the relevant section in `.trellis/workflow.md`.
+2. When changing rules, keep explicit trigger conditions and next actions.
+3. If adding or renaming a skill/agent, synchronize the corresponding files in platform directories.
+4. Workflow-state changes only need an edit to the `[workflow-state:STATUS]` block in `.trellis/workflow.md`. The hook is parser-only — it reads whatever you put in the block. Keep the opening and closing tags' STATUS strings identical (`[workflow-state:foo]…[/workflow-state:foo]`); mismatched STATUS pairs are silently dropped.
+5. Make the AI reread `.trellis/workflow.md`; do not keep using rules from the old conversation.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/workflow-edit-route-content.md

@@ -0,0 +1,8 @@
+## Modification Steps
+
+1. Find the runtime section in `.trellis/workflow.md` and identify the owner named by the Workflow Owner Index or owning skill/helper.
+2. Inspect Plugin state and nearby markers. If the section is not managed, make the narrow local edit and keep trigger/next-action semantics explicit.
+3. If Skill-Garden owns the section, change the matching 0.6 Patch selector/baseline/content and Bundle policy. Do not add a parallel workflow injector or edit only the dogfood workflow.
+4. Keep workflow-state tags paired, but do not duplicate a full owner procedure into the state block. State holds a one-hop gate; the owner skill/helper holds the detailed contract.
+5. Synchronize affected skills, hooks, helpers, or platform entries through their own managed sources when the shared semantics require it.
+6. Run source-to-snapshot sync, conflict checks, compiled target generation/check, final-output review, and idempotent dogfood application before treating the change as complete.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/workflow-entry-content.md

@@ -0,0 +1 @@
+When the user wants to change Trellis phases, next actions, task gates, routing, checking, or wrap-up, read `.trellis/workflow.md` first because it is the current runtime contract. Before editing it, determine whether the relevant section is project-local, an upstream template, or a Skill-Garden managed Patch output.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/workflow-entry-selector.md

@@ -0,0 +1 @@
+When the user wants to change Trellis phases, next-action hints, whether to create tasks, whether to use sub-agents, or when to check/wrap up, edit `.trellis/workflow.md` first.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-mode-precedence/current-rules-baseline.md

@@ -0,0 +1,12 @@
+## Current Rules
+
+- `.trellis/workflow.md` is the local workflow source of truth; its initial content was selected from a workflow template (built-in `native`, `tdd`, `channel-driven-subagent-dispatch`, or a marketplace template) at `trellis init` time and can be re-selected via `trellis workflow --template <id>`. Missing `.trellis/agents/<name>.md` files referenced by the active template trigger a non-blocking stderr warning pointing at `trellis update`.
+- `.trellis/config.yaml` is the project-level Trellis configuration entry point. It hosts task lifecycle hooks (`hooks.after_create` / `after_start` / `after_finish` / `after_archive`), journal shape (`session_commit_message` / `max_journal_lines` / `session_auto_commit`), channel worker guard (`channel.worker_guard.idle_timeout` / `max_live_workers`), Codex dispatch mode (`codex.dispatch_mode: inline | sub-agent`), and the spec registry block (`registry.spec.source` + `registry.spec.template`).
+- `.trellis/spec/` stores the user's project-specific coding conventions and design constraints. When `registry.spec` is set, files are refreshed by `trellis update`; local edits surface as "modified by user" conflicts in `.trellis/.template-hashes.json`.
+- `.trellis/tasks/` stores task PRDs, design notes, implement plans, research files, and JSONL context. Tasks form parent/child trees: `task.py create --parent <slug>`, `task.py add-subtask <parent> <child>`, `task.py remove-subtask <parent> <child>`, and `task.py list-context <task>`. `task.py create` rejects a slug already present in `.trellis/tasks/archive/**`.
+- `.trellis/workspace/` stores **deliberately written** developer journals. Raw cross-session dialogue is **not** stored here — it lives on disk under `~/.claude/projects/`, `~/.codex/sessions/`, and `~/.pi/agent/sessions/` and is recovered via `trellis mem search|extract|context`. The bundled `trellis-session-insight` skill teaches when to reach for `mem`.
+- `.trellis/agents/{check,implement}.md` are bundled, platform-agnostic channel runtime agent definitions loaded by `trellis channel spawn --agent <name>`. Editable; `trellis update` backfills missing ones. Editing the per-platform `trellis-implement.md` / `trellis-check.md` does **not** change channel-runtime worker behavior.
+- `~/.trellis/channels/<project>/<channel>/events.jsonl` is the channel runtime event log per project per channel. User-owned, file-locked sequence numbering, durable `idempotencyKey` support; never under `.trellis/`.
+- Bundled multi-file skills (`trellis-meta`, `trellis-spec-bootstrap`, `trellis-session-insight`, `trellis-channel`) are auto-dispatched to every platform skill root by `getBundledSkillTemplates()` in `packages/cli/src/templates/common/index.ts`. Dropping a new directory under `packages/cli/src/templates/common/bundled-skills/` (upstream) ships it to every platform on the next `trellis update`.
+- Platform settings/config files decide which hooks, agents, skills, commands, prompts, and workflows actually run. Reasonix has no settings file — behavior is encoded inside skill frontmatter.
+- `.trellis/.template-hashes.json` and `.trellis/.runtime/` are management/runtime state files. Confirm necessity before editing them.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-mode-precedence/current-rules-content.md

@@ -0,0 +1,11 @@
+## Current Rules
+
+- `.trellis/workflow.md` is the runtime semantic source for the current project, but its durable authoring source depends on ownership. When Skill-Garden manages a section, change the owning Patch and workflow owner instead of editing only the deployed file.
+- `.trellis/config.yaml` remains the project configuration entry point. Flower-managed keys must be traced through `.flower/state.json` before editing; unrelated project-local keys retain the native Trellis behavior.
+- `.trellis/spec/`, `.trellis/tasks/`, and `.trellis/workspace/` retain their native task, convention, and deliberate-journal roles unless Plugin state explicitly claims a target within them.
+- `.trellis/.template-hashes.json` describes Trellis template ownership. It does not supersede Flower Plugin ownership recorded in `.flower/plugin-lock.json` and `.flower/state.json`.
+- `.trellis/agents/{check,implement}.md` remain platform-agnostic channel runtime definitions. Per-platform agent files do not change channel-runtime worker behavior.
+- `~/.trellis/channels/<project>/<channel>/events.jsonl` remains the user-owned channel event store; raw platform conversation logs remain local and are queried through `trellis mem`.
+- Upstream bundled skills are still distributed by Trellis. Skill-Garden may then apply declared Patches to those deployed copies, and Flower may project additional managed skills or shared common content.
+- Platform settings/config files decide which hooks, agents, skills, commands, prompts, and workflows execute. Reasonix continues to encode behavior in skill frontmatter rather than a settings file.
+- Discover the active enhanced capability set from the local skill roots, `.trellis/workflow.md`, the selected Bundle catalog when source is available, and `.flower/state.json`; do not maintain a second fixed Skill-Garden skill inventory here.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-mode-precedence/description-content.md

@@ -0,0 +1 @@
+description: "Understand and customize local Trellis architecture, including Flower/Skill-Garden managed Plugin overlays, Patch ownership, platform hooks, settings, agents, skills, commands, prompts, workflows, channel runtime, bundled runtime agents, workflow templates, spec refresh, cross-session memory, and bundled-skill distribution."

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-mode-precedence/description-selector.md

@@ -0,0 +1 @@
+description: "Understand and customize the local Trellis architecture inside a user project. Use when modifying .trellis plus platform hooks, settings, agents, skills, commands, prompts, workflows, the channel runtime (trellis channel), bundled runtime agents under .trellis/agents/, selectable workflow templates, registry-backed spec refresh, cross-session memory (trellis mem) generated by trellis init, or AI-facing bundled skills (trellis-channel, trellis-session-insight, trellis-spec-bootstrap) and bundled-skill auto-dispatch flow."

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-mode-precedence/how-to-use-baseline.md

@@ -0,0 +1,7 @@
+## How To Use
+
+1. Read `references/local-architecture/overview.md` first to establish the local Trellis system model.
+2. If the request involves a specific AI tool, read `references/platform-files/platform-map.md` and the relevant platform file notes.
+3. If the request involves multi-agent dispatch or channel workers, read `references/local-architecture/multi-agent-channel.md` and the bundled `.trellis/agents/` files.
+4. If the user wants to change behavior, read `references/customize-local/overview.md`, then open the specific customization topic.
+5. Before editing, read the actual files in the user project and treat local content as authoritative.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-mode-precedence/how-to-use-content.md

@@ -0,0 +1,7 @@
+## How To Use
+
+1. Read `references/local-architecture/overview.md` first to establish the local Trellis system model.
+2. Determine ownership before choosing an edit point. Inspect `.flower/plugins.json`, `.flower/plugin-lock.json`, `.flower/state.json`, `.trellis/.template-hashes.json`, and managed markers that actually exist.
+3. If `flower/skill-garden` owns the target, read `references/customize-local/overview.md` and follow the managed source/Patch route. If it does not, follow the native or project-local route described by the relevant reference.
+4. For a specific AI tool, read `references/platform-files/platform-map.md` and the relevant platform notes. For multi-agent dispatch or channel workers, also read `references/local-architecture/multi-agent-channel.md` and `.trellis/agents/`.
+5. Before editing, read the actual target, its owner state, and its authoring source. Runtime content is authoritative for what currently executes; ownership evidence is authoritative for where a durable change belongs.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-mode-precedence/patch.json

@@ -0,0 +1,105 @@
+{
+  "schemaVersion": 2,
+  "id": "trellis-meta-managed-mode-precedence",
+  "purpose": "managed_meta_precedence",
+  "operations": [
+    {
+      "id": "trellis-meta-trigger-description",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/SKILL.md", "missing": "skip", "markerStyle": "hash" }
+      ],
+      "selector": { "type": "literal", "source": "description-selector.md", "expectedMatches": 1 },
+      "content": { "source": "description-content.md" }
+    },
+    {
+      "id": "trellis-meta-managed-scope",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/SKILL.md", "missing": "skip" }
+      ],
+      "selector": { "type": "literal", "source": "scope-selector.md", "expectedMatches": 1 },
+      "content": { "source": "scope-content.md" }
+    },
+    {
+      "id": "trellis-meta-managed-usage",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/SKILL.md", "missing": "skip" }
+      ],
+      "selector": { "type": "markdown-section", "heading": "## How To Use" },
+      "baselines": ["how-to-use-baseline.md"],
+      "content": { "source": "how-to-use-content.md" }
+    },
+    {
+      "id": "trellis-meta-managed-current-rules",
+      "operation": "replace",
+      "targetPolicy": "each-existing",
+      "targets": [
+        { "kind": "skill", "path": ".agent/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".agents/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".claude/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".codebuddy/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".cursor/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".devin/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".factory/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".github/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kilocode/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".kiro/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".opencode/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".pi/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".qoder/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".reasonix/skills/trellis-meta/SKILL.md", "missing": "skip" },
+        { "kind": "skill", "path": ".trae/skills/trellis-meta/SKILL.md", "missing": "skip" }
+      ],
+      "selector": { "type": "markdown-section", "heading": "## Current Rules" },
+      "baselines": ["current-rules-baseline.md"],
+      "content": { "source": "current-rules-content.md" }
+    }
+  ]
+}

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-mode-precedence/scope-content.md

@@ -0,0 +1,10 @@
+The operating scope depends on target ownership:
+
+- Native or project-local Trellis files may be edited in the user project after reading their current content and update boundaries.
+- Flower-managed or Skill-Garden-managed files are deployed results. Before editing them, inspect `.flower/plugins.json`, `.flower/plugin-lock.json`, `.flower/state.json`, and nearby `skill-garden patch` markers.
+- When `flower/skill-garden` is declared and locked, its Plugin state and managed Patch contracts take precedence over conflicting native-only customization advice in this skill. The deployed file remains runtime truth for current behavior, but it is not automatically the authoring source.
+- In the Flower source checkout, Skill-Garden 0.6 authoring lives under `vendor/skill-garden/.trellis/0.6/`; `enhancements/0.6/` is the synchronized release snapshot, while project `.trellis/`, `.agents/`, and `.claude/` files are dogfood outputs.
+- Outside that source checkout, do not invent those authoring paths. Use the Plugin lifecycle or create separately owned project-local content instead of mutating a managed result.
+- User-owned channel logs remain under `~/.trellis/channels/<project>/<channel>/events.jsonl`; raw conversation logs remain queryable through `trellis mem`.
+
+Do not modify the global npm install directory or `node_modules`. Do not treat the presence of a local file alone as proof that it is user-owned.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-mode-precedence/scope-selector.md

@@ -0,0 +1,9 @@
+The default operating scope is local files in the user project:
+
+- `.trellis/`: workflow, config, tasks, spec, workspace, scripts, bundled runtime agents, and runtime state.
+- Platform directories: `.claude/`, `.codex/`, `.cursor/`, `.opencode/`, `.kiro/`, `.gemini/`, `.qoder/`, `.codebuddy/`, `.github/`, `.factory/`, `.pi/`, `.reasonix/`, `.kilocode/`, `.agent/`, `.devin/`, and similar directories. Pi additionally exposes a native `trellis_subagent` tool with `single` / `parallel` / `chain` dispatch modes, throttled progress cards, and `isTrellisAgent()` validation on top of the file layout. Reasonix stores both workflow skills and subagent skills as `.reasonix/skills/<name>/SKILL.md`; subagent skills carry `runAs: subagent` frontmatter.
+- Shared skill layer: `.agents/skills/`.
+- User-owned channel store outside the project tree: `~/.trellis/channels/<project>/<channel>/events.jsonl`.
+- Raw platform conversation logs queryable via `trellis mem`: `~/.claude/projects/`, `~/.codex/sessions/`, and `~/.pi/agent/sessions/` (OpenCode adapter degraded for the v0.6 line).
+
+Do not assume the user has the Trellis source repository. Do not default to modifying the global npm install directory or `node_modules` — both `@mindfoldhq/trellis` and `@mindfoldhq/trellis-core` ship as published packages sharing one version and one git tag per release.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-workflow-owners/owner-routing-baseline.md

@@ -0,0 +1,8 @@
+## Skill Routing
+
+`workflow.md` separates routing by platform capability:
+
+- Platforms with sub-agent support: dispatch `trellis-implement` by default for implementation and `trellis-check` for checking.
+- Platforms without sub-agent support: the main session reads skills such as `trellis-before-dev`, then executes directly.
+
+When changing local AI behavior, update the routing descriptions in `workflow.md` first, then check whether the corresponding platform skill, command, or agent files need to stay in sync.

package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-workflow-owners/owner-routing-content.md

@@ -0,0 +1,20 @@
+## Skill Routing
+
+Do not choose implementation or checking behavior from a static platform-capability split. Read the current Workflow Owner Index and let `trellis-route` resolve inline versus subagent execution.
+
+Stable owner categories are:
+
+| Gate or behavior | Owner to load |
+| --- | --- |
+| Request intent and project knowledge discovery | Request Triage, `trellis-start`, and the referenced router helper |
+| Active task scope safety | Request Triage and the active-task scope guard |
+| Planning handoff | `trellis-task-brief` and the task-start brief guard |
+| Implement/check execution mode | `trellis-route` |
+| Unified quality verification | `trellis-check-all` |
+| Automatic task loop and return gate | `trellis-auto-loop` plus the matching Check-All result |
+| Executable knowledge capture | `trellis-update-spec` |
+| Commit/push safety | `trellis-push` |
+| Archive and session bookkeeping | `trellis-finish-work` |
+| Cross-session task progress recovery | `trellis-continue` and its progress helper |
+
+This reference names owners; it does not copy their command schemas, interaction templates, state formats, or error matrices. Read `.trellis/workflow.md`, the local owner skill/helper, available `overrides/bundles/`, and `.flower/state.json` for the installed version. Do not maintain a fixed Skill-Garden skill count or exhaustive capability list here.