@ibotor/smart-trellis 0.5.19 → 0.5.20

package/README.md

@@ -68,6 +68,11 @@ smart-trellis init
 smart-trellis init --yes
 ```
 
+不加 `--yes` 时，初始化过程会提示你选择 AI 工具，并选择 Trellis activation mode：
+
+- `auto`：默认行为，Trellis 可以为开发/重构需求自动启动任务流程。
+- `explicit`：Trellis 只在你明确使用 `/trellis start` / `$trellis-start` / “走 Trellis” 时启动。
+
 如果你希望直接指定工具：
 
 ```bash
@@ -80,6 +85,12 @@ smart-trellis init --tools codex,cursor
 smart-trellis init --tools codex,cursor --user adong
 ```
 
+如果你希望 Trellis 不主动接管普通开发需求，而是必须显式使用 `/trellis start` / `$trellis-start` / “走 Trellis” 才启动：
+
+```bash
+smart-trellis init --tools codex,cursor --trellis-activation explicit
+```
+
 上面的命令大致等价于：
 
 ```bash

package/dist/cli/smart.js

@@ -21,7 +21,8 @@ const initCommand = program
     .option("-t, --template <name>", "Use a remote spec template (e.g., electron-fullstack)")
     .option("--overwrite", "Overwrite existing spec directory when using template")
     .option("--append", "Only add missing files when using template")
-    .option("-r, --registry <source>", "Use a custom template registry (e.g., gh:myorg/myrepo/specs)");
+    .option("-r, --registry <source>", "Use a custom template registry (e.g., gh:myorg/myrepo/specs)")
+    .option("--trellis-activation <mode>", "Set no-task Trellis activation mode: auto or explicit");
 for (const tool of getInitToolChoices()) {
     initCommand.option(`--${tool.key}`, `Include ${tool.name}`);
 }

package/dist/cli/smart.js.map

@@ -1 +1 @@
-{"version":3,"file":"smart.js","sourceRoot":"","sources":["../../src/cli/smart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAyB,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,wCAAwC,CAAC;KACrD,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,2BAA2B,CAAC,CAAC;AAElE,MAAM,WAAW,GAAG,OAAO;KACxB,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,iBAAiB,EAAE,6CAA6C,CAAC;KACxE,MAAM,CAAC,WAAW,EAAE,6CAA6C,CAAC;KAClE,MAAM,CACL,mBAAmB,EACnB,mDAAmD,CACpD;KACA,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;KACnE,MAAM,CAAC,YAAY,EAAE,qBAAqB,CAAC;KAC3C,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;KAClD,MAAM,CACL,uBAAuB,EACvB,uDAAuD,CACxD;KACA,MAAM,CACL,aAAa,EACb,uDAAuD,CACxD;KACA,MAAM,CAAC,UAAU,EAAE,4CAA4C,CAAC;KAChE,MAAM,CACL,yBAAyB,EACzB,8DAA8D,CAC/D,CAAC;AAEJ,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,EAAE,CAAC;IACxC,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,OAAyB,EAAE,EAAE;IACrD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;QACF,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"smart.js","sourceRoot":"","sources":["../../src/cli/smart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAyB,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,wCAAwC,CAAC;KACrD,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,2BAA2B,CAAC,CAAC;AAElE,MAAM,WAAW,GAAG,OAAO;KACxB,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,iBAAiB,EAAE,6CAA6C,CAAC;KACxE,MAAM,CAAC,WAAW,EAAE,6CAA6C,CAAC;KAClE,MAAM,CACL,mBAAmB,EACnB,mDAAmD,CACpD;KACA,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;KACnE,MAAM,CAAC,YAAY,EAAE,qBAAqB,CAAC;KAC3C,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;KAClD,MAAM,CACL,uBAAuB,EACvB,uDAAuD,CACxD;KACA,MAAM,CACL,aAAa,EACb,uDAAuD,CACxD;KACA,MAAM,CAAC,UAAU,EAAE,4CAA4C,CAAC;KAChE,MAAM,CACL,yBAAyB,EACzB,8DAA8D,CAC/D;KACA,MAAM,CACL,6BAA6B,EAC7B,uDAAuD,CACxD,CAAC;AAEJ,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,EAAE,CAAC;IACxC,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,OAAyB,EAAE,EAAE;IACrD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;QACF,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/smart-init.d.ts

@@ -1,6 +1,7 @@
 import { type InitOptions } from "./init.js";
 import type { CliFlag } from "../types/ai-tools.js";
 type SmartToolFlagOptions = Partial<Record<CliFlag, boolean>>;
+export type TrellisActivationMode = "auto" | "explicit";
 export type SmartInitOptions = SmartToolFlagOptions & {
     append?: boolean;
     force?: boolean;
@@ -9,12 +10,15 @@ export type SmartInitOptions = SmartToolFlagOptions & {
     registry?: string;
     skipExisting?: boolean;
     template?: string;
+    trellisActivation?: string;
     tools?: string;
     user?: string;
     yes?: boolean;
 };
 export declare const SMART_DEFAULT_TOOLS: CliFlag[];
 export declare function parseSmartToolsOption(value: string): CliFlag[];
+export declare function parseSmartTrellisActivationMode(value: string | undefined): TrellisActivationMode | undefined;
+export declare function patchTrellisActivationConfig(content: string, mode: TrellisActivationMode): string;
 export declare function createSmartInitOptions(options: SmartInitOptions, tools: CliFlag[], detectedUser?: string): InitOptions;
 export declare function detectDeveloperName(cwd?: string): string | undefined;
 export declare function smartInit(options: SmartInitOptions): Promise<void>;

package/dist/commands/smart-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"smart-init.d.ts","sourceRoot":"","sources":["../../src/commands/smart-init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,KAAK,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAAO,EAAwB,CAAC;AAgBlE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAkB9D;AAgCD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,EAAE,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,WAAW,CA6Bb;AAED,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAsB,GAC1B,MAAM,GAAG,SAAS,CAoBpB;AAoCD,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CASxE"}
+{"version":3,"file":"smart-init.d.ts","sourceRoot":"","sources":["../../src/commands/smart-init.ts"],"names":[],"mappings":"AAMA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,KAAK,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,UAAU,CAAC;AAExD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAAO,EAAwB,CAAC;AAgBlE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAkB9D;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,qBAAqB,GAAG,SAAS,CAWnC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAwCR;AAmDD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,EAAE,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,WAAW,CA6Bb;AAED,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAsB,GAC1B,MAAM,GAAG,SAAS,CAoBpB;AAuED,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxE"}

package/dist/commands/smart-init.js

@@ -1,5 +1,7 @@
 import { execSync } from "node:child_process";
+import fs from "node:fs";
 import os from "node:os";
+import path from "node:path";
 import inquirer from "inquirer";
 import { getInitToolChoices } from "../configurators/index.js";
 import { init } from "./init.js";
@@ -27,6 +29,59 @@ export function parseSmartToolsOption(value) {
     }
     return uniqueTools;
 }
+export function parseSmartTrellisActivationMode(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "auto" || normalized === "explicit") {
+        return normalized;
+    }
+    throw new Error(`Unknown Trellis activation mode "${value}". Supported modes: auto, explicit`);
+}
+export function patchTrellisActivationConfig(content, mode) {
+    const generatedExample = /# trellis:\r?\n# {3}activation_mode: auto\r?\n# {3}# activation_mode: explicit/;
+    if (generatedExample.test(content)) {
+        return content.replace(generatedExample, `trellis:\n  activation_mode: ${mode}`);
+    }
+    const lines = content.split("\n");
+    const trellisStart = lines.findIndex((line) => /^trellis\s*:\s*(?:#.*)?$/.test(line.trim()));
+    if (trellisStart !== -1) {
+        let trellisEnd = lines.length;
+        for (let index = trellisStart + 1; index < lines.length; index += 1) {
+            const trimmed = lines[index]?.trim() ?? "";
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const indent = (lines[index] ?? "").length - (lines[index] ?? "").trimStart().length;
+            if (indent === 0) {
+                trellisEnd = index;
+                break;
+            }
+        }
+        for (let index = trellisStart + 1; index < trellisEnd; index += 1) {
+            const match = (lines[index] ?? "").match(/^(\s*)activation_mode\s*:/);
+            if (match) {
+                lines[index] = `${match[1]}activation_mode: ${mode}`;
+                return lines.join("\n");
+            }
+        }
+        lines.splice(trellisStart + 1, 0, `  activation_mode: ${mode}`);
+        return lines.join("\n");
+    }
+    const separator = content.endsWith("\n") ? "\n" : "\n\n";
+    return `${content}${separator}trellis:\n  activation_mode: ${mode}\n`;
+}
+function applyTrellisActivationConfig(cwd, mode) {
+    if (!mode) {
+        return;
+    }
+    const configPath = path.join(cwd, ".trellis", "config.yaml");
+    if (!fs.existsSync(configPath)) {
+        return;
+    }
+    const content = fs.readFileSync(configPath, "utf-8");
+    fs.writeFileSync(configPath, patchTrellisActivationConfig(content, mode), "utf-8");
+}
 function applyToolFlags(initOptions, tools) {
     for (const tool of tools) {
         initOptions[tool] = true;
@@ -114,9 +169,38 @@ async function resolveSmartTools(options) {
     ]);
     return answers.tools;
 }
+async function resolveSmartTrellisActivation(options) {
+    const parsed = parseSmartTrellisActivationMode(options.trellisActivation);
+    const hasExplicitTools = !!options.tools ||
+        supportedToolFlags().some((tool) => options[tool] === true);
+    if (parsed || options.yes || hasExplicitTools) {
+        return parsed;
+    }
+    const answers = await inquirer.prompt([
+        {
+            type: "list",
+            name: "trellisActivation",
+            message: "Select Trellis activation mode:",
+            default: "auto",
+            choices: [
+                {
+                    name: "auto - Trellis can start for implementation/refactor work",
+                    value: "auto",
+                },
+                {
+                    name: "explicit - only start when you invoke /trellis start",
+                    value: "explicit",
+                },
+            ],
+        },
+    ]);
+    return answers.trellisActivation;
+}
 export async function smartInit(options) {
     const tools = await resolveSmartTools(options);
+    const activationMode = await resolveSmartTrellisActivation(options);
     const initOptions = createSmartInitOptions(options, tools, detectDeveloperName());
     await init(initOptions);
+    applyTrellisActivationConfig(process.cwd(), activationMode);
 }
 //# sourceMappingURL=smart-init.js.map

package/dist/commands/smart-init.js.map

@@ -1 +1 @@
-{"version":3,"file":"smart-init.js","sourceRoot":"","sources":["../../src/commands/smart-init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"smart-init.js","sourceRoot":"","sources":["../../src/commands/smart-init.ts"],"names":[],"mappings":"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"}

package/dist/migrations/manifests/0.5.20.json

@@ -0,0 +1,16 @@
+{
+  "version": "0.5.20",
+  "description": "Patch: add a Trellis activation-mode config option so teams can require explicit Trellis start commands.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Enhancements:**\n- feat(workflow): new `trellis.activation_mode: auto | explicit` config. `auto` preserves the current no-task behavior; `explicit` keeps Trellis idle unless the current user message explicitly invokes Trellis, such as `/trellis start`, `$trellis-start`, or `走 Trellis`.",
+  "migrations": [],
+  "configSectionsAdded": [
+    {
+      "file": ".trellis/config.yaml",
+      "sentinel": "activation_mode:",
+      "sectionHeading": "Trellis (activation behavior)"
+    }
+  ],
+  "notes": "Patch on top of 0.5.19. Run `trellis update` to append the commented activation-mode config section to existing `.trellis/config.yaml` files. Set `trellis.activation_mode: explicit` when you want Trellis to run only after an explicit Trellis command."
+}

package/dist/migrations/manifests/0.6.0-beta.22.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.6.0-beta.22",
+  "description": "Beta patch: remove the duplicated pull-based prelude from the generated Codex sub-agent toml files, and restore the 0.5.19 migration manifest that was missing on the beta branch.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(codex): the generated `.codex/agents/trellis-check.toml` and `trellis-implement.toml` no longer contain the \"Required: Load Trellis Context First\" prelude twice. The codex toml source templates carried an inline copy that predated the code-injected prelude (`injectPullBasedPreludeToml`); the injector then added a second copy. The inline copies are removed so the injector is the single source, and a regression test asserts the prelude appears exactly once across all class-2 platforms.\n- fix(migrations): restore `src/migrations/manifests/0.5.19.json`, which was missing on the 0.6.0-beta branch. Its absence broke the manifest-continuity guard and would break `trellis update` for users on 0.5.19.",
+  "migrations": [],
+  "notes": "Beta patch on top of 0.6.0-beta.21. Run `trellis update` to regenerate `.codex/agents/` without the duplicated prelude."
+}

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

@@ -13,7 +13,7 @@ When the user wants to change Trellis phases, next-action hints, whether to crea
 | Need | Edit point |
 | --- | --- |
 | Change phase names or phase order | `Phase Index` and the corresponding Phase sections. |
-| Change whether to create a task when there is no task | `[workflow-state:no_task]` state block. |
+| Change whether to create a task when there is no task | Prefer `trellis.activation_mode` in `.trellis/config.yaml` for auto vs explicit start; edit `[workflow-state:no_task]` / `[workflow-state:no_task-explicit]` for custom wording. |
 | Change the next step during planning | Phase 1 and `[workflow-state:planning]`. |
 | Change whether an agent is required during in_progress | Phase 2 and `[workflow-state:in_progress]`. |
 | Change wrap-up after completion | Phase 3 and `[workflow-state:completed]`. |
@@ -27,6 +27,17 @@ When the user wants to change Trellis phases, next-action hints, whether to crea
 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.
 
+## Example: Require Explicit Trellis Start
+
+To keep Trellis from taking over ordinary development requests, set:
+
+```yaml
+trellis:
+  activation_mode: explicit
+```
+
+With this mode, the workflow-state hook selects `[workflow-state:no_task-explicit]` while the session has no active task. Trellis starts only when the user explicitly invokes it, such as `/trellis start`, `$trellis-start`, or "走 Trellis".
+
 ## Example: Relax Task Creation Requirements
 
 To change when task creation can be skipped, usually edit `[workflow-state:no_task]`:

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

@@ -44,11 +44,12 @@ Hooks choose the right block based on current task status and inject it into the
 | State | Meaning |
 | --- | --- |
 | `no_task` | The current session has no active task. |
+| `no_task-explicit` | Alternate no-task prompt selected by `trellis.activation_mode: explicit`; the emitted status still says `no_task`, but Trellis stays idle unless the user explicitly invokes it. |
 | `planning` | The task is still in requirements, research, or context configuration. |
 | `in_progress` | The task has entered implementation and checking. |
 | `completed` | The task is complete and waiting for wrap-up or archive. |
 
-If the user wants to change policies such as "whether to create a task when there is no task," "when task creation may be skipped," or "whether sub-agents are required," edit these state blocks and the routing table above them.
+If the user wants Trellis to run only on explicit requests, set `trellis.activation_mode: explicit` in `.trellis/config.yaml`. If the user wants to change the actual wording or trigger policy, edit the relevant state blocks and the routing table above them.
 
 ## Local Modification Patterns
 
@@ -57,7 +58,7 @@ Common changes:
 | Goal | Edit point |
 | --- | --- |
 | Add a phase | Update the Phase Index, phase body, routing, and state blocks. |
-| Change task creation policy | Update the `no_task` state block and Phase 1 description. |
+| Change task creation policy | Set `trellis.activation_mode` in `.trellis/config.yaml`, or update the `no_task` / `no_task-explicit` state blocks and Phase 1 description. |
 | Change the default implementation/check path | Update Phase 2 and skill routing. |
 | Change the wrap-up flow | Update Phase 3 and `finish-work` related descriptions. Note the current split: Phase 3.4 = AI-driven code commits (batched, user-confirmed), Phase 3.5 = `/finish-work` (archive + record session). `/finish-work` refuses to run if the working tree is dirty. |
 | Change platform differences | Update routing descriptions grouped by platform. |

package/dist/templates/opencode/plugins/inject-workflow-state.js

@@ -58,6 +58,74 @@ function loadBreadcrumbs(directory) {
   return result
 }
 
+function unquoteYamlScalar(value) {
+  const trimmed = value.trim()
+  if (trimmed.length >= 2) {
+    const first = trimmed[0]
+    const last = trimmed[trimmed.length - 1]
+    if ((first === "\"" || first === "'") && first === last) {
+      return trimmed.slice(1, -1)
+    }
+  }
+  return trimmed
+}
+
+function stripYamlInlineComment(value) {
+  let quote = null
+  for (let index = 0; index < value.length; index += 1) {
+    const ch = value[index]
+    if (quote) {
+      if (ch === quote) quote = null
+      continue
+    }
+    if (ch === "\"" || ch === "'") {
+      quote = ch
+      continue
+    }
+    if (ch === "#" && (index === 0 || /\s/.test(value[index - 1] || ""))) {
+      return value.slice(0, index)
+    }
+  }
+  return value
+}
+
+function readTrellisActivationMode(directory) {
+  const configPath = join(directory, ".trellis", "config.yaml")
+  if (!existsSync(configPath)) return "auto"
+  let content
+  try {
+    content = readFileSync(configPath, "utf-8")
+  } catch {
+    return "auto"
+  }
+
+  let inTrellis = false
+  let trellisIndent = -1
+  for (const line of content.split(/\r?\n/)) {
+    const trimmed = line.trim()
+    if (!trimmed || trimmed.startsWith("#")) continue
+
+    const indent = line.length - line.trimStart().length
+    if (inTrellis && indent <= trellisIndent) {
+      inTrellis = false
+    }
+    if (!inTrellis && indent === 0 && /^trellis\s*:\s*(?:#.*)?$/.test(trimmed)) {
+      inTrellis = true
+      trellisIndent = indent
+      continue
+    }
+    if (!inTrellis) continue
+
+    const match = trimmed.match(/^activation(?:_mode)?\s*:\s*(.*)$/)
+    if (!match) continue
+    const value = unquoteYamlScalar(stripYamlInlineComment(match[1] || ""))
+      .trim()
+      .toLowerCase()
+    return value === "explicit" ? "explicit" : "auto"
+  }
+  return "auto"
+}
+
 /**
  * Get (taskId, status) from active task, or null if no active task.
  */
@@ -89,8 +157,11 @@ function getActiveTask(ctx, platformInput = null) {
  *   "Refer to workflow.md for current step." line
  * - no_task pseudo-status (id === null) → header omits task info
  */
-function buildBreadcrumb(id, status, templates, source = null) {
-  let body = templates[status]
+function buildBreadcrumb(id, status, templates, source = null, breadcrumbKey = status) {
+  let body = templates[breadcrumbKey]
+  if (body === undefined && breadcrumbKey !== status) {
+    body = templates[status]
+  }
   if (body === undefined) {
     body = "Refer to workflow.md for current step."
   }
@@ -128,10 +199,13 @@ export default async ({ directory }) => {
             return
           }
           const templates = loadBreadcrumbs(directory)
+          const activationMode = readTrellisActivationMode(directory)
+          const noTaskKey =
+            activationMode === "explicit" ? "no_task-explicit" : "no_task"
           const task = getActiveTask(ctx, input)
           const breadcrumb = task
             ? buildBreadcrumb(task.id, task.status, templates, task.source)
-            : buildBreadcrumb(null, "no_task", templates)
+            : buildBreadcrumb(null, "no_task", templates, null, noTaskKey)
 
           const parts = output?.parts || []
           const textPartIndex = parts.findIndex(

package/dist/templates/pi/extensions/trellis/index.ts.txt

@@ -659,6 +659,68 @@ function loadWorkflowBreadcrumbs(projectRoot: string): Record<string, string> {
   return result;
 }
 
+function unquoteYamlScalar(value: string): string {
+  const trimmed = value.trim();
+  if (trimmed.length >= 2) {
+    const first = trimmed[0];
+    const last = trimmed[trimmed.length - 1];
+    if ((first === '"' || first === "'") && first === last) {
+      return trimmed.slice(1, -1);
+    }
+  }
+  return trimmed;
+}
+
+function stripYamlInlineComment(value: string): string {
+  let quote: string | null = null;
+  for (let index = 0; index < value.length; index += 1) {
+    const ch = value[index] ?? "";
+    if (quote) {
+      if (ch === quote) quote = null;
+      continue;
+    }
+    if (ch === '"' || ch === "'") {
+      quote = ch;
+      continue;
+    }
+    if (ch === "#" && (index === 0 || /\s/.test(value[index - 1] ?? ""))) {
+      return value.slice(0, index);
+    }
+  }
+  return value;
+}
+
+function readTrellisActivationMode(projectRoot: string): "auto" | "explicit" {
+  const config = readText(join(projectRoot, ".trellis", "config.yaml"));
+  if (!config) return "auto";
+
+  let inTrellis = false;
+  let trellisIndent = -1;
+  for (const line of config.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+
+    const indent = line.length - line.trimStart().length;
+    if (inTrellis && indent <= trellisIndent) {
+      inTrellis = false;
+    }
+    if (!inTrellis && indent === 0 && /^trellis\s*:\s*(?:#.*)?$/.test(trimmed)) {
+      inTrellis = true;
+      trellisIndent = indent;
+      continue;
+    }
+    if (!inTrellis) continue;
+
+    const match = trimmed.match(/^activation(?:_mode)?\s*:\s*(.*)$/);
+    if (!match) continue;
+    const value = unquoteYamlScalar(stripYamlInlineComment(match[1] ?? ""))
+      .trim()
+      .toLowerCase();
+    return value === "explicit" ? "explicit" : "auto";
+  }
+  return "auto";
+}
+
 function readActiveTaskStatus(
   projectRoot: string,
   taskDir: string,
@@ -681,6 +743,7 @@ function buildWorkflowStateBreadcrumb(
   contextKey: string | null,
 ): string {
   const templates = loadWorkflowBreadcrumbs(projectRoot);
+  const activationMode = readTrellisActivationMode(projectRoot);
   const taskDir = readCurrentTask(
     projectRoot,
     undefined,
@@ -691,18 +754,24 @@ function buildWorkflowStateBreadcrumb(
   let lookupKey: string;
   if (!taskDir) {
     header = "Status: no_task\nSource: session";
-    lookupKey = "no_task";
+    lookupKey =
+      activationMode === "explicit" ? "no_task-explicit" : "no_task";
   } else {
     const info = readActiveTaskStatus(projectRoot, taskDir);
     if (!info) {
       header = "Status: no_task\nSource: session";
-      lookupKey = "no_task";
+      lookupKey =
+        activationMode === "explicit" ? "no_task-explicit" : "no_task";
     } else {
       header = `Task: ${info.taskId} (${info.status})\nSource: session`;
       lookupKey = info.status;
     }
   }
-  const body = templates[lookupKey] ?? "Refer to workflow.md for current step.";
+  const fallbackKey = lookupKey === "no_task-explicit" ? "no_task" : lookupKey;
+  const body =
+    templates[lookupKey] ??
+    templates[fallbackKey] ??
+    "Refer to workflow.md for current step.";
   return `<workflow-state>\n${header}\n${body}\n</workflow-state>`;
 }
 

package/dist/templates/shared-hooks/inject-workflow-state.py

@@ -270,10 +270,33 @@ def _codex_mode_banner(config: dict) -> str:
     return f"<codex-mode>{mode}</codex-mode>"
 
 
+def _trellis_activation_mode(config: dict) -> str:
+    """Read ``trellis.activation_mode`` from .trellis/config.yaml.
+
+    ``auto`` preserves the default no-task behavior: Trellis classifies the
+    user's request and may create a task for implementation work. ``explicit``
+    uses the alternate no_task breadcrumb so Trellis only starts when the
+    current user message explicitly invokes it.
+    """
+    if not isinstance(config, dict):
+        return "auto"
+    trellis_cfg = config.get("trellis")
+    if not isinstance(trellis_cfg, dict):
+        return "auto"
+    value = trellis_cfg.get("activation_mode", trellis_cfg.get("activation"))
+    if isinstance(value, str) and value.strip().lower() == "explicit":
+        return "explicit"
+    return "auto"
+
+
 def resolve_breadcrumb_key(
     status: str, platform: str | None, config: dict
 ) -> str:
-    """Pick the breadcrumb tag key based on Codex dispatch_mode.
+    """Pick the breadcrumb tag key based on activation + Codex dispatch_mode.
+
+    When ``trellis.activation_mode: explicit`` and there is no active task,
+    route to ``[workflow-state:no_task-explicit]`` instead of the default
+    ``[workflow-state:no_task]``. Active tasks keep normal status routing.
 
     Codex defaults to ``inline`` because sub-agents run with ``fork_turns="none"``
     isolation and can't inherit the parent session's task context. Users can
@@ -283,6 +306,12 @@ def resolve_breadcrumb_key(
 
     Non-codex platforms return the plain status unchanged.
     """
+    if status == "no_task":
+        return (
+            "no_task-explicit"
+            if _trellis_activation_mode(config) == "explicit"
+            else status
+        )
     if platform == "codex":
         mode = "inline"
         if isinstance(config, dict):
@@ -360,7 +389,7 @@ def main() -> int:
         )
     if platform == "codex":
         parts: list[str] = [CODEX_SUB_AGENT_NOTICE]
-        if task is None:
+        if task is None and _trellis_activation_mode(config) != "explicit":
             parts.append(CODEX_NO_TASK_BOOTSTRAP_NOTICE)
         parts.append(_codex_mode_banner(config))
         parts.append(breadcrumb)

package/dist/templates/trellis/config.yaml

@@ -32,6 +32,21 @@ max_journal_lines: 2000
 #
 # session_auto_commit: true
 
+#-------------------------------------------------------------------------------
+# Trellis (activation behavior)
+#-------------------------------------------------------------------------------
+
+# Controls when Trellis takes over a conversation that has no active Trellis task.
+# - auto (default): Trellis classifies no-task requests and may create a task
+#   for implementation / build / refactor work.
+# - explicit: Trellis stays out of ordinary requests. It only starts when the
+#   current user message explicitly invokes Trellis (for example `/trellis start`,
+#   `$trellis-start`, "use Trellis", or "走 Trellis").
+#
+# trellis:
+#   activation_mode: auto
+#   # activation_mode: explicit
+
 #-------------------------------------------------------------------------------
 # Task Lifecycle Hooks
 #-------------------------------------------------------------------------------

package/dist/templates/trellis/workflow.md

@@ -99,7 +99,7 @@ python3 ./.trellis/scripts/get_context.py --mode phase --step <X.Y>  # detailed
 <!--
   WORKFLOW-STATE BREADCRUMB CONTRACT (read this before editing the tag blocks below)
 
-  The 4 [workflow-state:STATUS] blocks embedded in the ## Phase Index section
+  The [workflow-state:STATUS] blocks embedded in the ## Phase Index section
   below are the SINGLE source of truth for the per-turn `<workflow-state>`
   breadcrumb that every supported AI platform's UserPromptSubmit hook
   reads. inject-workflow-state.py (Python platforms) and
@@ -119,6 +119,9 @@ python3 ./.trellis/scripts/get_context.py --mode phase --step <X.Y>  # detailed
 
   TAG ↔ PHASE scoping:
     [workflow-state:no_task]      → no active task; before Phase 1
+    [workflow-state:no_task-explicit]
+                                  → no active task when trellis.activation_mode
+                                    is explicit; Trellis starts only by request
     [workflow-state:planning]     → all of Phase 1 (status='planning')
     [workflow-state:in_progress]  → Phase 2 + Phase 3.1-3.4
                                     (status stays 'in_progress' from
@@ -155,6 +158,17 @@ No active task. **A Direct answer** — pure Q&A / explanation / lookup / chat;
 **C Inline change** (per-turn only, escape hatch for B) — the user's CURRENT message MUST contain one of: "skip trellis" / "no task" / "just do it" / "don't create a task" / "跳过 trellis" / "别走流程" / "小修一下" / "直接改" / "先别建任务" → briefly acknowledge ("ok, skipping trellis flow this turn"), then inline. **Without seeing one of these phrases you must NOT inline on your own**; do not invent an override the user never said.
 [/workflow-state:no_task]
 
+<!-- Per-turn breadcrumb: shown when there is no active task and
+     .trellis/config.yaml sets trellis.activation_mode: explicit -->
+
+[workflow-state:no_task-explicit]
+No active Trellis task. `trellis.activation_mode: explicit` is enabled, so Trellis must stay idle unless the user's CURRENT message explicitly invokes Trellis.
+**Do not auto-start Trellis**: do NOT create a Trellis task, do NOT load `$trellis-start`, and do NOT switch to the Trellis workflow for ordinary development requests.
+**Explicit triggers**: `/trellis start`, `/trellis:start`, `$trellis-start`, "use Trellis", "start Trellis", "走 Trellis", "用 trellis", "创建 Trellis task", or another unambiguous request to run Trellis.
+**Without an explicit trigger**: continue with the platform/global workflow already in force (for Codex this may include global AGENTS.md, Superpowers, or normal skills), and answer or implement normally.
+**With an explicit trigger**: load `trellis-start`, then create or continue the task per the normal `[workflow-state:no_task]` rules.
+[/workflow-state:no_task-explicit]
+
 ### Phase 1: Plan
 - 1.0 Create task `[required · once]` (just `task.py create`; status enters planning)
 - 1.1 Requirement exploration `[required · repeatable]`
@@ -638,11 +652,12 @@ This section is for developers who want to modify the Trellis workflow itself. A
 
 Edit the corresponding step's walkthrough body in the Phase 1 / 2 / 3 sections above. **Critical constraint**: if you change a step's `[required · once]` marker or add a new `[required · once]` step, you MUST also add a matching enforcement line to that phase's `[workflow-state:STATUS]` tag block — otherwise the per-turn breadcrumb omits the reinforcement, and the AI silently skips the step. The regression tests assert this.
 
-All 4 tag blocks live in the `## Phase Index` section above, immediately after each phase summary:
+The tag blocks live in the `## Phase Index` section above, immediately after each phase summary:
 
 | Scope | Corresponding tag |
 |---|---|
-| No active task (before Phase 1) | `[workflow-state:no_task]` (after the Phase Index ASCII art) |
+  | No active task (before Phase 1, auto activation) | `[workflow-state:no_task]` (after the Phase Index ASCII art) |
+  | No active task (`activation_mode: explicit`) | `[workflow-state:no_task-explicit]` |
 | All of Phase 1 (task created → ready for implementation) | `[workflow-state:planning]` (after Phase 1 summary) |
 | Phase 2 + Phase 3.1–3.4 (implementation + check + wrap-up) | `[workflow-state:in_progress]` (after Phase 2 summary) |
 | After Phase 3.5 (archived) | `[workflow-state:completed]` (after Phase 3 summary; **currently DEAD**) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibotor/smart-trellis",
-  "version": "0.5.19",
+  "version": "0.5.20",
   "description": "Smart Trellis CLI with project-aware initialization defaults",
   "type": "module",
   "main": "./dist/index.js",