@blxzer/cursor-trellis 0.4.1 → 0.4.3

package/dist/templates/common/skills/brainstorm.md

@@ -76,10 +76,10 @@ Inspect and record in `prd.md` (sections: **Confirmed facts**, initial **Out of
 1. **Code & tests** — relevant modules, fixtures, configs, error paths.
 2. **Specs** — `.cstl/spec/` indexes and layer guides for touched packages.
 3. **History** — archived tasks, active task research, developer journal when useful.
-4. **Platform** — project platform hooks, agents, and skills (see `.cstl/spec/guides/cursor-subagent-policy.md` when using Cursor); shared `.agents/skills/` when behavior spans platforms.
+4. **Platform** — project platform hooks, agents, and skills (see `.cstl/framework/cursor-subagent-policy.md` when using Cursor); shared `.agents/skills/` when behavior spans platforms.
 5. **Parent/Child** — if multiple independent deliverables, note child split early in `prd.md`.
 
-Use retrieval per `.cstl/spec/guides/retrieval-daily-guide.md` (rg for literals, codegraph for structure, fast-context for semantic sweep).
+Use retrieval per `.cstl/framework/retrieval-daily-guide.md` (rg for literals, codegraph for structure, fast-context for semantic sweep).
 
 Dispatch **`cstl-research`** (writable Agent) when a topic needs a dedicated `{TASK}/research/<topic>.md` file; do **not** use a subagent for PRD Grill itself.
 

package/dist/templates/cursor/agents/cstl-check.md

@@ -21,7 +21,7 @@ You are the Check Agent in the Trellis workflow.
 ## Model policy
 
 - **Default:** no `model:` → **inherit** parent session.
-- **Per dispatch:** main session asks user → one-shot `model:` overlay → `Task` → restore (architecture review uses the same flow). See `.cstl/spec/guides/cursor-subagent-policy.md`.
+- **Per dispatch:** main session asks user → one-shot `model:` overlay → `Task` → restore (architecture review uses the same flow). See `.cstl/framework/cursor-subagent-policy.md`.
 
 ## Recursion Guard
 
@@ -48,7 +48,7 @@ Look for the `<!-- cstl-hook-injected -->` marker in your input above.
 
 Before checking, read:
 - `.cstl/spec/` - Development guidelines
-- `.cstl/spec/guides/verification-strength-guide.md` - Graded verify depth (Lite/Full/Parent; not TDD)
+- `.cstl/framework/verification-strength-guide.md` - Graded verify depth (Lite/Full/Parent; not TDD)
 - Task `prd.md` - Requirements document
 - Task `design.md` - Technical design (if exists)
 - Task `implement.md` - Execution plan (if exists)

package/dist/templates/cursor/agents/cstl-implement.md

@@ -21,7 +21,7 @@ You are the Implement Agent in the Trellis workflow.
 ## Model policy
 
 - **Default:** no `model:` → **inherit** parent session.
-- **Per dispatch / Child worker:** main session asks user → one-shot `model:` overlay on this file → `Task` → restore. Child session uses the same overlay pattern on `cstl-implement`. See `.cstl/spec/guides/cursor-subagent-policy.md`.
+- **Per dispatch / Child worker:** main session asks user → one-shot `model:` overlay on this file → `Task` → restore. Child session uses the same overlay pattern on `cstl-implement`. See `.cstl/framework/cursor-subagent-policy.md`.
 
 ## Recursion Guard
 

package/dist/templates/cursor/agents/cstl-research.md

@@ -21,7 +21,7 @@ You are the Research Agent in the Trellis workflow.
 ## Model policy
 
 - **Default:** no `model:` in this file → **inherit** parent session at spawn.
-- **Per dispatch:** main session asks the user, writes a **one-shot** `model:` here, runs `Task`, then **removes** `model:` (ephemeral overlay). See `.cstl/spec/guides/cursor-subagent-policy.md`.
+- **Per dispatch:** main session asks the user, writes a **one-shot** `model:` here, runs `Task`, then **removes** `model:` (ephemeral overlay). See `.cstl/framework/cursor-subagent-policy.md`.
 - Dispatch: Cursor **Agent mode** (writable).
 
 ## Core Principle
@@ -68,7 +68,7 @@ Run independent searches in parallel (Glob + Grep + smart-search CLI for externa
 
 #### External search — provider relevance caveats
 
-- **Context7** and generic third-party library docs are often **irrelevant** to Trellis/Cursor platform questions. Prefer **Cursor / Cursor++ official documentation**, `docs.cursor.com`, and **local `.cstl/spec/`** before trusting Context7 hits.
+- **Context7** and generic third-party library docs are often **irrelevant** to Trellis/Cursor platform questions. Prefer **Cursor official documentation**, `docs.cursor.com`, and **local `.cstl/spec/`** before trusting Context7 hits.
 - Every smart-search result you persist must **label the provider source** (e.g. `exa`, `context7`, `cursor-docs`, `tavily`) in the research file — in frontmatter or per bullet — so downstream check/finish can audit provenance.
 - Trellis harness facts: `./.cstl/scripts/run_smart_search.py` writes manifests under `{TASK}/research/smart-search/<run-id>/`; scored pack output (when built) is `{TASK}/research/retrieval-pack-latest.json`.
 

package/dist/templates/cursor/fixtures/expected-rules.d.ts

@@ -3,7 +3,7 @@
  * Update alongside rule content changes in templates/cursor/rules/.
  */
 export interface ExpectedRule {
-    /** Filename including .mdc extension, e.g. "cstl-triage.mdc" */
+    /** Filename including .mdc extension, e.g. "cstl-bootstrap.mdc" */
     filename: string;
     /** Substrings that must appear in rule body (case-sensitive) */
     requiredSections: string[];

package/dist/templates/cursor/fixtures/expected-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expected-rules.d.ts","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,aAAa,EAAE,YAAY,EA8BvC,CAAC"}
+{"version":3,"file":"expected-rules.d.ts","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,aAAa,EAAE,YAAY,EAavC,CAAC"}

package/dist/templates/cursor/fixtures/expected-rules.js

@@ -4,32 +4,15 @@
  */
 export const expectedRules = [
     {
-        filename: "cstl-triage.mdc",
+        filename: "cstl-bootstrap.mdc",
         requiredSections: [
-            "Decision tree",
-            "Classification mark",
-            "Consent gate",
+            "Event Bridge",
+            "Capability router",
+            "external-knowledge",
+            "Optional",
+            "Native SSOT",
+            ".cstl/middleware",
         ],
-        minBytes: 500,
-    },
-    {
-        filename: "cstl-subagent-dispatch.mdc",
-        requiredSections: ["Layer 2", "generate_dispatch_prompt", "CLI"],
-        minBytes: 400,
-    },
-    {
-        filename: "retrieval-routing.mdc",
-        requiredSections: ["Prefer", "Adapt", "Own", "Native", "BYOK", "codegraph", "smart-search"],
-        minBytes: 600,
-    },
-    {
-        filename: "cstl-session-rename.mdc",
-        requiredSections: ["rename_chat", "select", "start-execution", "skip silently"],
-        minBytes: 300,
-    },
-    {
-        filename: "cstl-cursor-modes.mdc",
-        requiredSections: ["Prefer Cursor native modes", "Quick routing", "Hard boundaries", "Rollback"],
         minBytes: 400,
     },
 ];

package/dist/templates/cursor/fixtures/expected-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"expected-rules.js","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C;QACE,QAAQ,EAAE,iBAAiB;QAC3B,gBAAgB,EAAE;YAChB,eAAe;YACf,qBAAqB;YACrB,cAAc;SACf;QACD,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,4BAA4B;QACtC,gBAAgB,EAAE,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,CAAC;QAChE,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,uBAAuB;QACjC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC;QAC3F,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,yBAAyB;QACnC,gBAAgB,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,CAAC;QAC/E,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,uBAAuB;QACjC,gBAAgB,EAAE,CAAC,4BAA4B,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,CAAC;QAChG,QAAQ,EAAE,GAAG;KACd;CACF,CAAC"}
+{"version":3,"file":"expected-rules.js","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C;QACE,QAAQ,EAAE,oBAAoB;QAC9B,gBAAgB,EAAE;YAChB,cAAc;YACd,mBAAmB;YACnB,oBAAoB;YACpB,UAAU;YACV,aAAa;YACb,kBAAkB;SACnB;QACD,QAAQ,EAAE,GAAG;KACd;CACF,CAAC"}

package/dist/templates/cursor/hooks.json

@@ -9,6 +9,10 @@
       }
     ],
     "sessionStart": [
+      {
+        "command": "{{PYTHON_CMD}} .cursor/hooks/event-bridge.py --event sessionStart",
+        "timeout": 30
+      },
       {
         "command": "{{PYTHON_CMD}} .cursor/hooks/session-start.py",
         "timeout": 30

package/dist/templates/cursor/index.d.ts

@@ -4,7 +4,7 @@
  * Directory structure:
  *   cursor/
  *   ├── agents/        # Sub-agent definitions
- *   ├── commands/      # Cursor-only slash commands (e.g. cursor2plus-setup)
+ *   ├── commands/      # Cursor-only slash commands (optional extras)
  *   ├── rules/         # .cursor/rules/*.mdc (alwaysApply / glob-scoped rules)
  *   ├── hooks.json     # Hooks configuration
  *   └── worktrees.json # Cursor native worktree setup

package/dist/templates/cursor/index.js

@@ -4,7 +4,7 @@
  * Directory structure:
  *   cursor/
  *   ├── agents/        # Sub-agent definitions
- *   ├── commands/      # Cursor-only slash commands (e.g. cursor2plus-setup)
+ *   ├── commands/      # Cursor-only slash commands (optional extras)
  *   ├── rules/         # .cursor/rules/*.mdc (alwaysApply / glob-scoped rules)
  *   ├── hooks.json     # Hooks configuration
  *   └── worktrees.json # Cursor native worktree setup

package/dist/templates/cursor/rules/cstl-bootstrap.mdc

@@ -0,0 +1,17 @@
+---
+description: "Cursor Adapter Bootstrap — Event Bridge pointer, four retrieval intents, independent Middleware. Prefer this thin rule over adding more always-on."
+alwaysApply: true
+---
+
+# Cursor Adapter Bootstrap
+
+This is the **single thin Bootstrap** for Cursor. It points; it does not carry full Triage, Gate, smart-search, or codegraph methodology.
+
+- **Event Bridge:** Cursor hook events (`sessionStart` and others) record/dispatch through Kernel `event_bridge` extras. Unsubscribed modules must not fail the hook.
+- **Capability router:** Baseline intents are only `exact` / `semantic` / `structural` / `external`. Do not bind Agent tool names here.
+- **external-knowledge:** smart-search is an independent Middleware Provider. Probe readiness. Missing → Profile `degraded`. Tasks that do not need the capability may Close. Platform Web is a downgrade, not an equivalent.
+- **Optional code intelligence:** codegraph and fast-context stay Optional. Do not treat them as default always-on or forced install.
+- **Native SSOT:** no Cursor++ command/skill/init ask and no cstl-byok live install on this surface. Env probe fields (`TRELLIS_CURSOR_BYOK`, `~/.ccursor/routes.json`) may remain.
+- **User overlay:** project `.cstl/middleware/` Manifests. `cstl init` / `cstl update` never write, delete, or hash that directory. Protocol: `.cstl/framework/middleware-protocol.md`.
+
+This is the only default always-on rule. Do **not** add middleware-specific always-on. Methodology lives in `.cstl/workflow.md` (human overview, not runtime SSOT) and on-demand docs.

package/dist/templates/markdown/agents.md

@@ -5,7 +5,10 @@ These instructions are for AI assistants working in this project.
 
 This project is managed by cursor-trellis. The working knowledge you need lives under `.cstl/`:
 
-- `.cstl/workflow.md` — development phases, when to create tasks, skill routing
+- `.cstl/workflow.md` — human overview of phases and skill routing (not runtime SSOT). Parallel first (convention, not a CLI gate). Personal Lite: Open→Close without Parent/Git; Full Quality: `required_controls` + AC ledger + graded Check; Topology/On-demand: Rigor × Topology, `task-map` is a graph projection; Adapter/Middleware: Event Bridge + four retrieval intents + independent smart-search Provider; user overlay `.cstl/middleware/` is never touched by `cstl update`; prefer `get_context.py --mode lite` for Lite
+- `.cstl/framework/middleware-protocol.md` — Middleware Protocol v1 (one ABI; Manifest sample)
+- `.cstl/framework/upgrade.md` — terminal-user upgrade half-page
+- `.cstl/framework/release-boundary.md` — CSTL this-batch ship vs independent cstl-byok ship
 - `.cstl/spec/` — package- and layer-scoped coding guidelines (read before writing code in a given layer)
 - `.cstl/workspace/` — per-developer journals and session traces
 - `.cstl/tasks/` — active and archived tasks (PRDs, research, jsonl context)
@@ -19,11 +22,41 @@ Only a handful of Trellis entry points are meant for **manual `/` invocation**.
 - **User-invocable (manual)**: `cstl-continue`, `cstl-finish-work` (and `cstl-start` when needed).
 - **Internal auto-triggered (do NOT call manually)**: `cstl-brainstorm`, `cstl-before-dev`, `cstl-check`, `cstl-break-loop`, `cstl-update-spec`, `cstl-micro-grill`, `cstl-meta`, `cstl-spec-bootstrap`, `cstl-skill-creator`, `smart-search-cli`. These activate on their own when the workflow/skill matcher decides they fit.
 
+## Skill authoring (mandatory)
+
+When **creating** or making a **behavioral/structural** change to a Trellis bundled skill, a `blaze-skills` skill, or a harness skill, **first Read** `cstl-skill-creator` and follow its workflow + `references/review-checklist.md`. Do not hand-write around it. **Skip** for typo / pure link fixes. This skill is **internal** (not a user `/` command). **Does not apply** to Cursor product skills (e.g. `~/.cursor/skills-cursor/create-skill`). Load paths: see `.cstl/framework/internal-skills-cursor-reachability.md` (`cstl-skill-creator` row).
+
+## Invocation map (short)
+
+| Intent | Use | Do not |
+| --- | --- | --- |
+| Session handoff | `/cstl-handoff` → report temp path | task `handoff.md`; ad-hoc workspace handoff |
+| Durable objective | official Cursor `/goal` | restore `cstl-goal`; treat as Parent/Child or a Trellis task type |
+| User slash surface | only listed `/cstl-*` commands | assume internal skills are slash commands |
+| Internal skills (brainstorm, …) | workflow says load → Read documented path (see guides); not user slash | claim loaded with no file read |
+
+Commands-only: internal skills stay **out of** the `/` palette by design; they must still be **reachable** via documented on-demand paths (not "missing from the framework").
+
+## Internal skill reachability (on-demand)
+
+Internal auto-triggered skills are **not** shipped to `.cursor/skills/` and have **no** default slash command. When the workflow routes to one, load its body by reading a documented path — do **not** claim it is loaded without a file read.
+
+- PRD Grill / brainstorm discipline → **`Read .cstl/framework/prd-grill-frontier.md`** (SSOT: bundled `common/skills/brainstorm.md`).
+- Skill authoring (new / structural) → **must Read** bundled `cstl-skill-creator/SKILL.md` then `references/review-checklist.md` (paths in `internal-skills-cursor-reachability.md`). Not a slash command.
+- Full skill × load-channel matrix → **`Read .cstl/framework/internal-skills-cursor-reachability.md`**.
+- Dogfood-only install surfaces (never shipped by default) → **`Read .cstl/framework/dogfood-only-surfaces.md`**.
+
+## Durable objectives (official /goal)
+
+For a persistent in-session objective, use Cursor's official `/goal`. That is **not** a Trellis task type and **not** Parent/Child. Do **not** restore or invent `cstl-goal` / `cstl goal`.
+
+Default install is **Native Cursor**. CSTL does **not** embed BYOK (no install-time BYOK; an optional independent track stays outside this package).
+
 ## Web research routing (smart-search first)
 
-For **any external / current / web fact**, run **`python ./.cstl/scripts/run_smart_search.py "<question>" --intent deep-research --json`** first. That script is the **only** Trellis web-research evidence entrypoint (it shells out to the `smart-search` CLI). Do not guess paths under package source trees or sibling repos. Platform built-in web tools (Cursor `WebSearch` / `WebFetch`, or native web tools elsewhere) are **downgrade-only fallbacks**, used solely when smart-search is unavailable (`doctor` not ok, status `not_configured` / `failed`, or search timeout). Do not reach for built-in web search while smart-search is healthy. On Cursor, `smart-search-cli` is an **internal workflow skill name** only (not shipped under `.cursor/skills/`); follow `.cstl/spec/guides/retrieval-daily-guide.md` and `.cursor/rules/retrieval-routing.mdc` for the executable contract.
+For **any external / current / web fact**, use the independent **smart-search** Provider (`smart-search` CLI when installed). Maintainer installs may still have `run_smart_search.py`; it is not Baseline. Platform built-in web tools are **downgrade-only fallbacks**. Follow `.cstl/framework/retrieval-daily-guide.md`.
 
-**External-knowledge gate:** If the answer would be wrong because the **world or a third-party API moved** and that matters → use smart-search (cheap `docs` / `broad-search` when enough; `deep-research` when multi-source). If truth lives only in this workspace → do not default to web. When unsure, prefer a cheap probe over guessing. See retrieval-daily-guide § External-knowledge gate.
+**External-knowledge gate:** If the answer would be wrong because the **world or a third-party API moved** and that matters → use smart-search (cheap `docs` / `broad-search` when enough; `deep-research` when multi-source). If truth lives only in this workspace → do not default to web. When unsure, prefer a cheap probe over guessing. See `.cstl/framework/retrieval-daily-guide.md` § External-knowledge gate.
 
 Managed by cursor-trellis. Edits outside this block are preserved; edits inside may be overwritten by a future `cstl update`.
 

package/dist/templates/markdown/{spec/guides → framework}/cursor-native-modes-guide.md.txt

@@ -31,7 +31,7 @@
 | **Plan** | Scope / design / tradeoffs before code | **Try `SwitchMode(plan)`**; after review, `SwitchMode(agent)` or Build; **Save to workspace** → map into task files | Keep writing `prd.md` / `design.md` / `implement.md` + `cstl-brainstorm` in Agent | Phase 1 files |
 | **Agent** | Approved build / verify | Default; `SwitchMode(agent)` when returning from Plan | — | Diff, `verify.md`, gates |
 | **Debug** | Repro / runtime / regressions | Prefer real Cursor Debug when the user/session can reach it | Evidence → `verify.md`; `cstl-break-loop` if looped | Notes / logs in `verify.md` |
-| **Multitask** | Independent Parent children post-approval | Prefer `/multitask` / Build in Parallel / Agent `Task` background workers **when useful** | Explicit `.cstl/tasks/<dir>` prompts + Parent `integrate-child` | Child `verify`/`handoff`; Parent `task-map` |
+| **Multitask** | Independent Parent children post-approval (**default** when ≥2 units, empty `depends_on`) | Prefer `/multitask` / Build in Parallel / Agent `Task` / native worktree — **not** a Trellis scheduler | Explicit `.cstl/tasks/<dir>` prompts + Parent `integrate-child`; serial needs `serial_reason` | Child `verify`/`handoff`; Parent `task-map` |
 
 ### Phase quick map
 
@@ -40,7 +40,7 @@ Triage (No Task / Micro-Grill)  → Ask surface if present; else No Task in Agen
 Phase 1                         → SwitchMode(plan) when useful; else write artifacts in Agent
 Phase 2–3                       → Agent (+ workers when contracted)
 Stuck / repeat failure          → Debug when reachable; else verify.md + break-loop
-Parent parallel children        → Multitask / Task parallel when useful; Parent integrates
+Parent parallel children        → Multitask / Task parallel **by default**; serial needs serial_reason; Parent integrates
 ```
 
 ---
@@ -67,10 +67,11 @@ Parent parallel children        → Multitask / Task parallel when useful; Paren
 
 ### Multitask ↔ Parent/Child
 
-1. Trellis remains source of truth for status, gates, integration.
-2. Prefer native parallel surfaces to support independent Children when they help isolation/throughput.
-3. Every worker prompt includes **explicit `.cstl/tasks/<dir>`** — never rely on `selected_task`.
-4. Parent alone `integrate-child`; no collision guarantee without worktrees + review.
+1. Trellis remains source of truth for status, gates, integration. This is **not** a Trellis-built parallel product — Prefer Cursor Multitask / Build in Parallel / Agent `Task` / native worktree.
+2. **Default parallel** when planning has ≥2 independent units (Parent children with empty `depends_on`, or Full Task fan-out). Lite / single-file work is not forced into parallel agents.
+3. **Serial needs a written reason** (`serial_reason`): shared write-set / HITL or reviewer gate / `depends_on` unmet / user asked serial / conflict surface cannot isolate. HITL, `start-execution --approved`, reviewer gates, and `integrate-child` stay serial even when workers run in parallel (`merge_limit: 1`).
+4. Every worker prompt includes **explicit `.cstl/tasks/<dir>`** — never rely on `selected_task`.
+5. Parent alone `integrate-child`; no collision guarantee without worktrees + review. Declare 可并行组 / 合并点 / 冲突面 on the task-map — see `.cstl/framework/parallel-first-execution.md`.
 
 ---
 
@@ -79,7 +80,7 @@ Parent parallel children        → Multitask / Task parallel when useful; Paren
 | Surface | Plan | Agent | Ask | Debug | Parallel Children |
 | --- | --- | --- | --- | --- | --- |
 | Agent `SwitchMode` | Yes → `plan` | Yes → `agent` | — | — | — |
-| Agent `Task` / Multitask | — | workers | — | — | Prefer when useful |
+| Agent `Task` / Multitask | — | workers | — | — | Prefer **by default** (serial needs `serial_reason`) |
 | User / CLI modes | Plan UI / `/plan` | default | Ask UI / `/ask` | Debug UI | `/multitask`, Build in Parallel |
 
 Details: `research/modes-callability-matrix.md`.
@@ -93,6 +94,7 @@ Details: `research/modes-callability-matrix.md`.
 - Parallel agents cannot conflict without Trellis/worktree discipline.
 - `SwitchMode` can open Ask or Debug.
 - Shipping a parallel fake Plan/Ask/Debug product, or documenting gaps as “本版本不适配”.
+- Replacing Cursor Multitask with a Trellis scheduler, queue, or new parallel CLI.
 
 ---
 
@@ -102,7 +104,7 @@ Details: `research/modes-callability-matrix.md`.
 | --- | --- | --- |
 | **Plan** | Schema or live `SwitchMode(plan)` note in verify | Prefer path documented; quiet Agent fallback if unused |
 | **Ask / Debug** | Callability matrix | Quiet spine behavior; no “不适配” section |
-| **Multitask** | Task parallel or doc contract | Explicit child paths; Parent integrates |
+| **Multitask** | Task parallel or doc contract | Explicit child paths; default parallel; serial has `serial_reason`; Parent integrates |
 | **Agent** | Session implements under contract | Artifacts on disk |
 
 ---
@@ -111,7 +113,7 @@ Details: `research/modes-callability-matrix.md`.
 
 Docs + rules only:
 
-1. Delete `.cursor/rules/cstl-cursor-modes.mdc` and `.cstl/spec/guides/cursor-native-modes-guide.md`.
+1. Delete `.cursor/rules/cstl-cursor-modes.mdc`, `.cstl/framework/cursor-native-modes-guide.md`, and `.cstl/framework/parallel-first-execution.md`.
 2. Drop related `guides/index.md` / `workflow.md` rows, or `cstl update` from pre-P1 templates.
 3. **cursor-trellis**: revert this Child’s tip or delete mirrored template paths.
 
@@ -122,4 +124,5 @@ Docs + rules only:
 - `{TASK}/research/modes-callability-matrix.md`
 - `{TASK}/research/cursor-modes-external.md`
 - `.cursor/rules/cstl-cursor-modes.mdc`
-- `.cstl/spec/guides/cursor-subagent-policy.md`
+- `.cstl/framework/cursor-subagent-policy.md`
+- `.cstl/framework/parallel-first-execution.md`