@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/templates/markdown/framework/cursor-native-modes-guide.md.txt

@@ -1,239 +0,0 @@
-# Cursor native modes — bind when native, degrade in one sentence
-
-> **Purpose**: This file is the **Cursor Adapter**. Kernel, Baseline module contracts, and host-agnostic CLI name **slots and capabilities** only. Cursor-specific nouns, probes, and UI drive live **here**. Prefer native; when a surface fails, say **one sentence** (what happened, where it landed) and keep going. Do **not** reimplement modes. Do **not** publish a “this version doesn’t support …” catalog.
->
-> **Human lifecycle** (Kernel projection): Open → Define → Approve → Execute → Verify → Integrate? → Close. PACTILE shows up at those three gates and in `prd.md` / `verify.md`. Everywhere else the user should feel they are using Cursor.
->
-> **Not a Pactile Task**: official `/goal` / `CreateGoal`. Do **not** restore `pactile-goal`.
-
----
-
-## Core vs Adapter (zero host coupling)
-
-| Layer | Owns | Must not |
-| --- | --- | --- |
-| **Core** (Kernel / Baseline contracts / host-agnostic CLI) | Slots: Define, Execute, Evidence, typed worker, isolation, `exact` / `semantic` / `structural` / `external` | `SwitchMode`, `CreateGoal`, Multitask, Canvas, Bugbot, Cursor browser, `.cursor/` as SSOT, Build-probe events |
-| **This Adapter** | Evaluate each named Cursor surface; bind or write the one-sentence degrade; visible parallel | Fake a native surface; write those names into Kernel extras / Event Bridge / module contracts |
-
-Host bindings (typed Task names, Multitask, Plan, Goal) belong **only** in this guide. Do not write them back into `worker-orchestration` or Kernel schema.
-
-This guide is **on-demand**. It is not the always-on Bootstrap (`.cursor/rules/pactile-bootstrap.mdc`).
-
----
-
-## Experience (Q11–Q14) — function first, invisible unless needed
-
-- **Q11.** The user is using Cursor. PACTILE is visible at Open / Execute / Finalize and on `prd.md` / `verify.md`. One **next native action** is allowed. Do **not** ask the user to type `python` or run CLI — the Agent is the hand.
-- **Q12.** Host surface failed → **one sentence**: what happened, and where work already landed. No catalog. No blaming the host.
-- **Q13 / Q16.** If a **visible** host parallel surface can open (Multitask / Build in Parallel), open it. There is **no** stable API to open that UI. Ask the user to open it and hand each worker pack. If they do not, `Task()` plus one Q12 sentence. **Do not block.** Same-session silent `Task()` is a degrade and must say so.
-- **Q14.** If function is unaffected, do not announce the framework. Must show: the three gates, a Q12 degrade, and (when a task is selected) one next action. **No** opening “loaded” probe. No task → answer directly.
-
----
-
-## Q5 slot map (named surfaces → Adapt / Enhance / Supplement)
-
-| PACTILE slot or need | Cursor native | Adapt | Enhance | Supplement |
-| --- | --- | --- | --- | --- |
-| Task identity / lifecycle / gates / evidence | none | — | — | Kernel (minimum set) |
-| Pool / Profile / principles | none | — | — | `.pactile/pool` and related |
-| Define / AC | Plan | Full **must** try the host design surface once | Draft is not definition until it lands in `{TASK}/prd.md` | Fail → Agent writes artifacts + Q12 |
-| Approve | chat confirm | Do not invent a confirm UI | — | `start-execution --approved` |
-| Execute | Agent | Default; leave design surface for Agent | Stay inside the contract; isolatable units fan out | — |
-| Parallel / isolation | Multitask / `Task` / worktree | Visible surface first (Q13) | Worker pack; `serial_reason`; Parent `integrate-child` | No surface → inline + Q12 |
-| Verify | Debug | Use when runtime evidence is needed | Evidence → `verify.md` | — |
-| Extra review | Bugbot / Security Review | Call when callable | Appendix signal only | Contract Check (P06) is not replaced |
-| Verify visible Web UI | Browser | Use when a visible UI changed | Evidence → `verify.md` | Kernel does not name a browser |
-| In-window durable objective | `/goal` | Q4=A | `UpdateGoal`; ≠ Close Task | Do not restore `pactile-goal` |
-| Analysis / inventory deliverable | Canvas | Use for that class of deliverable | Does not replace task-artifact SSOT | No Kernel canvas slot |
-| Recurring / loop | Automations / Loop | **Unbound** | — | No new lifecycle slot |
-| Read-only Q&A | Ask | If the user is already on Ask, stay read-only | Agent **cannot** `SwitchMode` → Ask | No-task read-only |
-| Continue | chat history (weak) | Do not rebuild chat | — | `/pactile-continue` |
-| Handoff | no stable equivalent | — | — | `/pactile-handoff` |
-| Codebase retrieval | native semantic / search | Four intents prefer native | Do not bind tool names in Bootstrap | Intent router; Optional codegraph |
-| External knowledge | platform Web | Downgrade only | — | smart-search |
-| Hook / session pack | hooks | Event Bridge | Compile Session Pack | Kernel extras (events, not Build) |
-| User entry | `/`, official Skills | Three-piece escape hatch | Internal skills reachable, not in the `/` menu | — |
-| Check worker | typed Check worker | Dispatch when the enum exists | Dual-axis; honest self-review | No independent worker → main-session second pass |
-| Statusline / Share / SDK / other | product surfaces | **Unbound** | Do not grow Kernel | Write “no slot” |
-
-Unnamed native surfaces default to **unbound**. Binding sentences stay in this guide.
-
----
-
-## Human phases ↔ Cursor modes
-
-| Human phase | Cursor binding | One-sentence fallback (Q12) |
-| --- | --- | --- |
-| **Open** | Stay in Agent (or Ask if the user is already there and the ask is read-only) | “No task yet — answered in chat.” No product writes |
-| **Define** | **Plan** — Full: `SwitchMode(plan)` immediately (Q15) | “Plan switch failed; definition is in `{TASK}/prd.md`.” |
-| **Approve** | Agent — request the Execute gate; `--check` is not approval | Same artifacts; do not start Execute |
-| **Execute** | **Agent** — `SwitchMode(agent)` when returning from Plan. Isolatable units: ask the user to open Multitask and hand worker packs; else `Task()` + Q12 (do not block) | Diff under the approved contract |
-| **Verify** | **Debug** when runtime evidence is needed; else Agent | Proof always lands in `verify.md` |
-| **Integrate?** | Serial Parent `integrate-child` (`merge_limit: 1`) | One-at-a-time merge; `parent_id` alone is not Parent |
-| **Close** | Agent + `UpdateGoal` complete or cancel (Q22) | `verify.md` coverage + `/pactile-finish-work`. Goal failure does not block Close |
-
-`Integrate?` is visible only when topology needs it (parent-child, or the task is already in Integrate). Lite single tasks skip it.
-
----
-
-## Prefer / Adapt table (mode × lifecycle × artifacts)
-
-| Cursor mode | Prefer when | Task-driven Prefer | One-sentence pactile fallback | Durable artifacts |
-| --- | --- | --- | --- | --- |
-| **Ask** | Explain / lookup; **no** durable change | Prefer Ask UI / side chat when the user is already there. **Agent cannot `SwitchMode` → Ask** | In-session no-task read-only (no `task.py create` without consent) | None |
-| **Plan** | Scope / design / tradeoffs before code | Full Define: **`SwitchMode(plan)` immediately**. After review, `SwitchMode(agent)` or A′. **Save to workspace**, then map into `{TASK}/prd.md` | “Plan switch failed; wrote `{TASK}/prd.md`.” | Definition surfaces |
-| **Agent** | Approved build / verify / close | Default for **Execute** (and Approve / Close). `SwitchMode(agent)` when returning from Plan | — | Diff, `verify.md`, gates |
-| **Debug** | Repro / runtime / regressions | Prefer real Cursor Debug when reachable. Adapter does **not** own Debug UI docs | Evidence → `verify.md` | Notes / logs in `verify.md` |
-| **Multitask** | Independent write-sets after Execute is approved | Ask the user to open Multitask / Build in Parallel and hand worker packs. No API → `Task()` + Q12. **Not** a Pactile scheduler | Explicit `.pactile/tasks/<dir>` + Parent `integrate-child`; serial needs `serial_reason` | Child `verify` / `handoff`; Parent `task-map` |
-| **Canvas** | Analysis / inventory deliverable | Use for that class only. If unused, one sentence “not an analysis canvas deliverable” | Task artifacts remain SSOT | None in Kernel |
-| **Browser** | Visible Web UI changed | Capture evidence into `verify.md` | “UI changed; browser capture skipped — see `verify.md`.” | `verify.md` |
-| **Bugbot / Security Review** | Extra review wanted | Call when callable; appendix only | Contract Check still required | Appendix in `verify.md` |
-
----
-
-## Mode-specific contracts
-
-### Ask ↔ no-task read-only
-
-- Official Ask does not edit files.
-- **Agent tools cannot `SwitchMode` into Ask.** If the user is not already on Ask, stay in Agent and keep the turn read-only.
-- Pure Q&A is no-task; no task creation without consent. Answer directly (Q14).
-- Side chats during Agent runs are still not Pactile artifacts.
-
-### Plan ↔ Define (Q15, Q23, Q24)
-
-- **Full Define:** `SwitchMode(plan)` immediately. Lite may stay in Agent.
-- Default plan save = **home directory** — **Save to workspace**, then the Agent maps into `{TASK}/prd.md` (and `design.md` / `implement.md` as the contract requires).
-- **Unlanded Plan must not map to Execute** (Q23).
-- Does **not** skip `start-execution --check` / Execute approval.
-- No product-code edits until Execute is approved (Q24). A human “start / Build” while still in Define is **A′**, not a skip.
-- If Plan switch or save fails: Q12 one sentence and author the same files in Agent.
-
-### Agent ↔ Execute
-
-- Default binding for **Execute**.
-- Stay inside the approved Definition / AC (and Full execution/verification contract).
-- Contract change → Return-to-Define, then the Execute gate again.
-- **Q19:** the main window collects worker **summaries**, conflicts, and gates — not full worker transcripts.
-
-### Debug ↔ evidence in `verify.md`
-
-- Prefer Cursor Debug instrumentation when reachable.
-- Always land proof in **`verify.md`**. Adapter does not ship Debug UI instructions.
-- Contract change → Return-to-Define. Implementation defect → back to Execute.
-
-### Visible parallel ↔ worker packs (Q13, Q16)
-
-There is **no** stable API to open Multitask / Build in Parallel.
-
-1. Ask the user to open the visible parallel surface and give each worker an explicit pack: `.pactile/tasks/<dir>` + contract slice. Never rely on `selected_task`.
-2. If they do not: `Task()` (typed `pactile-implement` / `pactile-check` / `pactile-research` when the enum exists) plus one Q12 sentence. **Do not block.**
-3. Silent same-session `Task()` without that sentence is a failed degrade.
-4. Pactile remains source of truth for status, gates, integration. This is **not** a Pactile-built parallel product.
-5. **Default parallel** when planning has ≥2 isolatable write-sets (Parent children with empty `depends_on`, or Full Task fan-out). Lite / single-file work is not forced into parallel agents.
-6. **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 (`merge_limit: 1`).
-7. Parent alone `integrate-child`. Parallel-first declaration fields live in `.pactile/framework/parallel-first-execution.md` (core contract, host-agnostic).
-
-### Task API honest degrade (`generalPurpose`)
-
-This Cursor Task API may have **no** `pactile-implement` / `pactile-check` enum.
-
-- Dispatch workers as **`generalPurpose`**.
-- Do **not** label the run `true-independent`.
-- Do **not** nest further implement / check / research Task types from a child worker.
-- Parent retains `review-child` / `integrate-child`.
-
-Typed worker names above are **Adapter bindings**. Core contracts speak of typed implement / check / research workers, not these host strings.
-
-### Canvas / Bugbot / Browser / Automations
-
-- **Canvas (Q8):** analysis or inventory deliverables only. Not a second SSOT. No Kernel canvas slot.
-- **Bugbot / Security Review (Q7):** optional Verify appendix. Never a substitute for contract Check.
-- **Browser (Q10):** when a visible Web UI changed, capture evidence into `verify.md`. Kernel records Evidence, not a browser name.
-- **Automations / Loop (Q9):** unbound. Do not add a recurring lifecycle slot.
-
----
-
-## Official `/goal` is not a Pactile Task (Q4, Q17, Q21, Q22, Q25)
-
-- Cursor **`/goal`** / **CreateGoal** is a durable **in-window** objective on the Cursor product.
-- It is **not** a Pactile task type, not Parent/Child, not `selected_task`, and does **not** skip Execute.
-- Do **not** restore `pactile-goal`. Continue / Finish-work / Handoff remain the `/pactile-*` escape hatches.
-- **Q17 / Q21:** when definition is already frozen, CreateGoal may drive **this window**. Slot clear → use it; inferring → ask. Goal text = one-line intent aligned with `prd.md` (Q25). Do not paste the PRD. Do not mirror Goal at Open.
-- **Q22:** on Close / Finalize, `UpdateGoal` complete or cancel plus one sentence. Goal failure **does not block** Close.
-- Definition change → `UpdateGoal`. Goal still does not replace gates or parallel.
-
-User-visible `/` escape hatches on agent-capable Cursor: **`/pactile-continue`**, **`/pactile-finish-work`**, **`/pactile-handoff`**. Internal skills (brainstorm, check, skill-creator, …) are **not** slash commands. `start` is filtered out on agent-capable Cursor.
-
----
-
-## Build probe — Adapter dogfood, not Kernel (Q18, Q20, Q24)
-
-Probe the host design-surface **“start doing”** (Plan Build) **only in this Adapter**.
-
-- **Today (Native):** no Build tool. Hooks have no such event. BYOK `ExecutePlanAction` stays out of core.
-- **Current path = A′:** after `{TASK}/prd.md` is on disk and `start-execution --check` passes, Execute consent is `start-execution --approved` (or the equivalent human “start / Build” while still in Define — still A′, still the gate).
-- **Beta dogfood:** if a later Cursor build exposes a callable Build action, probe it. Landed contract + `--check` PASS → record Execute consent. Unstable / missing → A′ + Q12. Both paths are legal in the 0.5.x beta; the official default is decided before 0.5.0.
-- **Forbidden:** Build-probe fields in Kernel extras, Event Bridge default subscriptions, or module contracts. Core stores **approval**, not a host Build event.
-
----
-
-## Callability (Agent tool table)
-
-| Surface | Plan | Agent | Ask | Debug | Parallel children |
-| --- | --- | --- | --- | --- | --- |
-| Agent `SwitchMode` | Yes → `plan` | Yes → `agent` | **No** | **No** | — |
-| Agent `Task` / Multitask UI | — | workers | — | — | Prefer **visible** surface; no API → ask user, else `Task()` + Q12 |
-| User / CLI modes | Plan UI / `/plan` | default | Ask UI / `/ask` | Debug UI | `/multitask`, Build in Parallel |
-| Plan Build (today) | **No tool** → A′ | — | — | — | — |
-
-If a cell is not callable here: Q12 one sentence, then the artifact path. Do not narrate an unsupported-mode catalog to the user.
-
----
-
-## What pactile must not claim
-
-- Plans auto-save into `.pactile/tasks/`.
-- Multitask inherits `selected_task` or exposes a stable programmatic mode API.
-- Parallel agents cannot conflict without Pactile/worktree discipline.
-- `SwitchMode` can open Ask or Debug.
-- Shipping a parallel fake Plan/Ask/Debug product, or documenting gaps as product blame.
-- Replacing Cursor Multitask with a Pactile scheduler, queue, or new parallel CLI.
-- That a `generalPurpose` stand-in is `true-independent`.
-- That `/goal` / CreateGoal is a Pactile Task.
-- That an unlanded Plan, or a human “Build” before Execute approval, already is Execute.
-- That Bugbot / Security Review / Canvas replaced contract Check or task artifacts.
-- That a Build probe lives in Kernel extras or Event Bridge.
-
----
-
-## Dogfood / probes
-
-| Mode | Minimum probe | Pass when |
-| --- | --- | --- |
-| **Plan** | Schema or live `SwitchMode(plan)` note in verify | Full Define tried once; Q12 + `{TASK}/prd.md` if unused |
-| **Ask / Debug** | Callability above | Artifact fallback; no unsupported-mode section |
-| **Multitask** | Ask user to open visible surface, or `Task()` + Q12 | Explicit child paths; default parallel; serial has `serial_reason`; Parent integrates |
-| **Agent** | Session implements under contract | Artifacts on disk |
-| **Task enum** | Missing `pactile-implement` / `pactile-check` | `generalPurpose` degrade; never `true-independent` |
-| **Plan Build** | No Native tool this cycle | A′ path documented; **not** in Kernel extras / Event Bridge |
-| **Goal** | CreateGoal when definition is frozen | One-line intent; `UpdateGoal` on Close; failure does not block |
-
----
-
-## Rollback
-
-Docs + rules only:
-
-1. Delete `.pactile/framework/cursor-native-modes-guide.md` if reverting this Adapter map. Parallel-first **declaration** fields stay in `.pactile/framework/parallel-first-execution.md` (owned by the parallel-runtime slice).
-2. Drop related `guides/index.md` / `workflow.md` rows, or `pactile update` from pre-rewrite templates.
-3. **pactile**: revert this Child’s tip or delete mirrored template paths.
-4. Do **not** thicken `.cursor/rules/pactile-bootstrap.mdc` to replace this guide.
-
----
-
-## Related
-
-- `.pactile/framework/cursor-subagent-policy.md`
-- `.pactile/framework/parallel-first-execution.md` (host-agnostic declaration; this guide binds the Cursor surface)
-- `.cursor/rules/pactile-bootstrap.mdc` (thin always-on pointer only)

package/dist/templates/markdown/framework/cursor-semantic-compliance.md.txt

@@ -1,41 +0,0 @@
-# Cursor semantic compliance (REC-06)
-
-## Plan vs exec
-
-| Layer | What counts |
-| --- | --- |
-| **Plan** | Router route `platform-semantic` (`platformNative: true`) or injected plan step「内置代码库语义搜索」 |
-| **Exec (Cursor)** | Tool log matches **platform semantic** patterns only — see `retrieval_tool_classification` |
-| **Not semantic exec on Cursor** | `fast_context_search`, pure Grep/Read/codegraph |
-
-## Classifying tool names from session logs
-
-Use the same patterns as telemetry:
-
-```powershell
-python -c "from common.retrieval_tool_classification import classify_tool_calls; print(classify_tool_calls(['Grep','codebase_search'], platform='cursor'))"
-```
-
-(Run from `.pactile/scripts` with `PYTHONPATH` set to that directory.)
-
-On **cursor**, `semantic_executed` = `platform_semantic_executed`. Track `fast_context_count` and `cursor_fast_context_misuse` separately.
-
-## Per-query checklist
-
-When `platform-semantic` is in the route list, verify in the session tool log:
-
-- `plan_block_in_prompt` — visible `## 代码库检索计划` (or equivalent) before code search
-- `tools_called` — verbatim tool names from Cursor
-- `platform_semantic_executed` / `fast_context_count` — from `classify_tool_calls(..., platform=cursor, cursor_env=...)`
-
-Plan-level presence does not imply execution-level use.
-
-## Agent instructions
-
-When `platform-semantic` is in the route list, `render_agent_instructions` appends **语义合规（Cursor）** requiring one built-in semantic search before Top-1 and logging the host tool name.
-
-## Native live proof (OC-15, 2026-07-02)
-
-Controlled main-session run (`07-02-child-oc15-semantic-proof`): 3/3 conceptual queries with router `platform-semantic` executed host tool **`SemanticSearch`** → `platform_semantic_executed=true` (`cursor_env=native`). See `research/native-semantic-execution-proof.md`.
-
-**Caveat:** Proves observability + compliant-agent behavior; does not guarantee all sessions follow the plan (historical evals show Grep-only gaps when agents skip semantic).

package/dist/templates/markdown/framework/cursor-subagent-policy.md.txt

@@ -1,90 +0,0 @@
-# Cursor Subagent Policy
-
-> Current policy for dispatching Pactile research, implementation, and check
-> work through Cursor's supported native agent surfaces.
-
-## Invariants
-
-- Pactile never hardcodes vendor model identifiers in committed defaults.
-- The operator chooses the main-session model; a child inherits it unless the
-  native host surface provides an explicit supported override.
-- A child receives the smallest sufficient context pack and a concrete task.
-- The Parent owns decomposition, integration, and final acceptance.
-- A child does not recursively dispatch another Pactile child.
-- Model choice is not evidence. Source reads, diffs, tests, and receipts are.
-
-## Dispatch roles
-
-| Role | Purpose | Workspace access | Expected output |
-| --- | --- | --- | --- |
-| `pactile-research` | Answer a bounded repository question | Read-only | Findings in the assigned research path |
-| `pactile-implement` | Implement one frozen write set | Writable | Scoped changes plus focused verification |
-| `pactile-check` | Independently verify requirements and safety | Read-only by default | Verdict, evidence, and actionable findings |
-
-Use Cursor's built-in exploration surface for quick orientation that does not
-need a durable artifact. Use a Pactile research child when the result must be
-persisted, cited by a task, or kept separate from implementation context.
-
-## When to dispatch
-
-Dispatch only when the work is independently bounded and parallelism or
-context isolation materially helps. Keep work inline when it is a single small
-change, when every step touches the same write set, or when coordination would
-cost more than execution.
-
-Before dispatching:
-
-1. Freeze the child objective and write set in the Parent task map.
-2. Include `Selected task: <path>` as the first line of the child prompt.
-3. State whether the child is read-only or writable.
-4. State the required validation and stop conditions.
-5. Confirm dependency readiness and worktree ownership.
-
-## Model policy
-
-`model_policy: cursor-configured`
-
-Use only controls exposed by the current native Cursor surface. If no child
-override is available, inherit the Parent model and record that fact. Never
-edit generated agent files temporarily to smuggle a model identifier into a
-dispatch, and never mutate user settings as part of task execution.
-
-## Isolation and integration
-
-- Parallel writable children require disjoint worktrees or explicitly disjoint
-  write sets.
-- A shared worktree implies serial writable execution.
-- Research and check children may run concurrently when they are truly
-  read-only and do not compete for mutable generated state.
-- The Parent reviews each child diff before integration and re-runs the union
-  verification after all accepted changes are present.
-- Do not mark a check `true-independent` when it was performed by the same
-  writable execution context or by a generic child standing in for a missing
-  checker role.
-
-## Failure handling
-
-- Missing native child support: continue inline or open a separate user-owned
-  Agent chat only when the task contract permits it.
-- Busy or interrupted child: preserve its partial evidence, reclaim the lane,
-  and retry only the unfinished unit.
-- Write-set overlap: stop the conflicting child, reconcile ownership in the
-  Parent task map, then resume serially.
-- Unavailable model override: inherit the Parent model; do not block safe work.
-- Unverifiable result: treat it as orientation and reproduce the proof in the
-  Parent context.
-
-## Closeout
-
-The Parent records:
-
-- which role ran and whether it had write access;
-- the exact task/worktree and write-set boundary;
-- accepted or rejected findings;
-- focused validation from the child;
-- union validation after integration;
-- any degraded host capability or unresolved blocker.
-
-Historical client-specific routing experiments are intentionally absent from
-generated runtime guidance. They belong in versioned history, not in a fresh
-Pactile installation.

package/dist/templates/markdown/framework/internal-skills-cursor-reachability.md.txt

@@ -1,45 +0,0 @@
-# Internal Skills Cursor Reachability Matrix
-
-> **Purpose**: Every internal skill referenced by framework or task artifacts must have a documented **load channel** on a pure Cursor project. Root `AGENTS.md` is now a compact pointer block, not an invocation map. Internal workflow skills are **not** shipped to `.cursor/skills/` and have **no** default slash command — by design (commands-only). This matrix is the honest index: how each internal name is actually reachable on-demand, so an agent never claims a skill is loaded without a file read, and users never assume internal skills are slash commands.
-
-## Commands-only baseline
-
-- Default Cursor install writes only: `.cursor/commands/` (user slash commands), `.cursor/rules/*.mdc`, `.cursor/agents/*.md`, `.cursor/hooks`, and `.pactile/` (workflow, framework docs, scripts, spec/guides seeds).
-- Bundled skill **bodies** live in the npm package templates (`dist/templates/common/skills/`, `dist/templates/common/bundled-skills/`). They are **not** copied into a consumer project by `pactile init` on Cursor.
-- "Not in the project" ≠ "missing from the framework": the CLI/script/agent/guide surface below is the reachable carrier.
-
-## Matrix
-
-| Skill name | Package SSOT | Cursor load channel | Slash? |
-| --- | --- | --- | --- |
-| `pactile-brainstorm` (PRD Grill) | `common/skills/brainstorm.md` | **Read `./prd-grill-frontier.md`** (on-demand summary; full body in npm package) | no |
-| `pactile-micro-grill` | `bundled-skills/pactile-micro-grill/SKILL.md` | Before a Task, Intake comes from `.pactile/modules/intake-basic/contract.md`; after Open, **read `./prd-grill-frontier.md` §Micro-grill unresolved**. Full body remains in the npm package. | no |
-| `pactile-before-dev` | `common/skills/before-dev.md` | Read task artifacts → `get_context.py --mode packages` → spec indexes; full body in npm package | no |
-| `pactile-break-loop` | `common/skills/break-loop.md` | Activated `debug-recovery` module routes Debug → evidence → `pactile-break-loop`; full body in npm package; output pattern in `.pactile/spec/guides/debug-loop-guide.md` | no |
-| `pactile-update-spec` | `common/skills/update-spec.md` | `close-basic` emits the learning disposition; activated `spec-learning` owns `update-spec`. Full body remains in the npm package. | no |
-| `pactile-check` | `bundled-skills/pactile-check/SKILL.md` | **Agent form `.cursor/agents/pactile-check.md`** (Task tool, dual-axis) — prefer Agent when `execution_mode: worker` | no |
-| `pactile-meta` | `bundled-skills/pactile-meta/SKILL.md` | Maintainer skill; body in npm package; no Cursor project file (not routed in consumer workflows) | no |
-| `pactile-spec-bootstrap` | `bundled-skills/pactile-spec-bootstrap/SKILL.md` | One-shot scaffolding skill; body in npm package; not routed in steady-state consumer workflow | no |
-| `pactile-skill-creator` | `bundled-skills/pactile-skill-creator/SKILL.md` | **Authoring-time (mandatory for new / structural skill edits):** Read `pactile/packages/cli/src/templates/common/bundled-skills/pactile-skill-creator/SKILL.md` then `…/references/review-checklist.md`. Harness dogfood copy: `.claude/skills/pactile-skill-creator/SKILL.md` and `.claude/skills/pactile-skill-creator/references/review-checklist.md`. Installed npm: `dist/templates/common/bundled-skills/pactile-skill-creator/`. Not a slash command. Skip typo/link-only. Does **not** apply to Cursor product skills (`~/.cursor/skills-cursor/`). | no |
-| `smart-search-cli` | `bundled-skills/smart-search-cli/SKILL.md` | **`python ./.pactile/scripts/run_smart_search.py "<question>" --intent deep-research --json`** (shipped script); Cursor web tools are downgrade-only fallback | no |
-| `pactile-handoff` | `bundled-skills/pactile-handoff/SKILL.md` | **Slash `/pactile-handoff`** (writes session handoff to OS temp dir) | **yes** |
-| `pactile-continue` / `pactile-finish-work` / `pactile-start` | `common/commands/*.md` | **Slash `/pactile-continue`, `/pactile-finish-work`** (`pactile-start` filtered on agent-capable platforms) | **yes** |
-| `pactile-research` / `pactile-implement` / `pactile-check` (agents) | `packages/cli/src/templates/cursor/agents/*.md` | **`.cursor/agents/*.md`** — Agent (Task tool), dispatched via `generate_dispatch_prompt.py` (CLI Layer 2) | no |
-
-## Reading this matrix
-
-- **Reachable on-demand** (green path): brainstorm → frontier guide; micro-grill → `intake-basic` before Task or the frontier guide after Open; check → agent; smart-search → script; **skill authoring → Read `pactile-skill-creator/SKILL.md` + `review-checklist.md`** (paths in the matrix row).
-- **Body in npm package only**: the skill is real and shipped, but a pure Cursor project has no project-relative copy. Activated modules or task/interface artifacts route its **behavior**; the full body is discoverable under the installed package (`npm root -g` → `dist/templates/…`). Do not claim these are loaded without reading the actual body when the behavior matters.
-- **Maintainer-only** (`pactile-meta`, `pactile-spec-bootstrap`): documented here for framework completeness; not part of the consumer execution path. No extra consumer load path beyond the package body.
-- **Authoring-time mandatory** (`pactile-skill-creator`): not a consumer runtime path and not a slash command, but **must** be Read before creating or structurally changing Pactile / blaze-skills / harness skills. Cursor product skills are out of scope.
-
-## Honesty rule
-
-If a framework or task artifact names a skill, it must be reachable here. If a row ever becomes unreachable, add a project-relative carrier (guide/script/agent) or remove the stale reference. Root `AGENTS.md` remains a pointer block and need not enumerate internal skills. Never claim "skill loaded" without a file read.
-
-## Related
-
-- [prd-grill-frontier.md](./prd-grill-frontier.md) — P11: brainstorm/grill on-demand path.
-- [dogfood-only-surfaces.md](./dogfood-only-surfaces.md) — what ships only in the maintainer harness (goal_*.py, `.claude/skills`, local overlays).
-- Root `AGENTS.md` PACTILE block — compact pointers only; it is not an invocation map or skill inventory.
-- `./cursor-context-injection-guide.md` — which channels actually reach the Cursor model.

package/dist/templates/markdown/prompts/run-semantic-slice-12.md.txt

@@ -1,25 +0,0 @@
-# Cursor semantic slice — 12-query eval (maintainer)
-
-> **Note:** `batch_plan_envelope.py` and `aggregate_retrieval_telemetry.py` were removed from user-shipped templates. Use `route_codebase_retrieval.py` per query and record JSONL manually, or restore those scripts from Pactile git history for batch eval runs.
-
-## Plan phase
-
-For each query in `queries-semantic-slice.jsonl`:
-
-```powershell
-python .pactile/scripts/route_codebase_retrieval.py "<question>" --json
-```
-
-Record `semantic_in_plan` / route list from the envelope.
-
-## Exec phase
-
-Run each query in a live Cursor session. Append one JSON object per line to `runs/cursor-semantic-slice-<YYYYMMDD>/telemetry.jsonl` with:
-
-- `query_id`, `platform`: `"cursor"`
-- `tools_called`, `plan_block_in_prompt`, `semantic_in_plan`
-- Classify with `common/retrieval_tool_classification.py` (see `.pactile/framework/cursor-semantic-compliance.md`)
-
-## Report
-
-Summarize `semantic_plan_rate` and `semantic_exec_rate` from the JSONL (manual or your own aggregation script).

package/dist/templates/pactile/modules/candidate-pool/contract.md

@@ -1,37 +0,0 @@
-# `candidate-pool`
-
-P29 表名：`candidate-pool`（不得改名）。层：on-demand。
-
-## 职责
-
-需求池。把尚未承诺实现的想法写成 Candidate，不是 Task。Intake 可以发出「进池意图」；本块负责物化条目与队列语义。仅状态为 `accepted` 的条目可以变成 `task.py create` 的输入。`accepted` 只是裁决，不是做完；剩余义务看 `delivery`（open / in-slice / landed / standing / deferred）。standing 不是下一张工单。清晰且可直接做的请求不进池，走 Intake → Open Task。
-
-## 触发/披露
-
-未触发时目录都可以不存在。用户明确说「记一下 / 进池」，或 Intake 判定未成形时才激活并进 Prompt。日常 Open→Close、Execute、Verify **不见** `pool.py` 教战。首次 Capture 才创建 `.pactile/pool/`，安装时不建空骨架。
-
-未触发 = 当没装。
-
-Agent 看见：
-
-1. 进池要有可审摘要；意图式同意（用户说记录即批准进池），否则先展示摘要再问一次。
-2. 不得把池项当已开 Task、不得未 Open 就写 `prd.md` 或建任务目录。`accepted` 只冻需求，**不自动** `task.py create`。
-3. 用户说开始实现某条已 accepted 条目时：先在该条目写 `## 切片`，再走 Intake Open Proposal；Open 之后才 `pool.py link`。
-4. 选下一件：只在 open / in-slice 里排；standing 不排队。单一切片 Close ≠ 整条 `landed`（剩余可 `deferred`）。
-5. 本块不决定 Rigor×Topology；开 Task 时仍走 Intake Proposal + Open 门。
-
-用户看见：一个候选队列，不是看板。默认不出现池配置。
-
-## 停止条件
-
-- 触发：用户要进池 | Intake 出口为进池意图。
-- 输出：Candidate 记录；首次才物化目录。`task_created: false`。
-- 停止：把池当 Task；安装时预建空池；未激活仍把 pool README 灌进 SessionStart。
-
-## 关掉必须消失
-
-不能 Capture、不能物化池、Prompt 无池教战。直接做事仍走 intake → Open Task。
-
-## 不得带走
-
-Open Approval 与 Task 目录（`approval-personal` / Kernel）；Define 正文（`define-basic`）。

package/dist/templates/pactile/pool/README.md

@@ -1,149 +0,0 @@
-# Review Pool（审核池）
-
-> Purpose: one place for product ideas, directions, and review gaps — enter the pool for triage, leave via a development plan.
-> The pool holds candidates; the plan holds commitments.
-
-## Directory layout
-
-```
-.pactile/pool/
-├── README.md            ← this file (mechanism)
-├── plan.md              ← development plan (references item ids only)
-├── items/               ← one small markdown file per adjudicable item
-├── knowledge-base/      ← optional: rejected rationale by concept (lazy)
-└── archive/             ← optional: terminal home for rejected items (lazy)
-```
-
-## State machine
-
-```
-inbox ──► review ──► accepted (enter development plan)
-          │
-          ├──► rejected (move to archive + knowledge-base; reason required)
-          └──► rework (missing info / not shippable → rewrite with user → back to inbox)
-```
-
-- `accepted`: Agent proposes; user confirms before the status flips. **Does not mean the work is done.** Completion is `delivery` (see below).
-- `rejected`: terminal; item moves under `archive/`; rationale goes to `knowledge-base/` (one file per concept; Prior requests for dedupe).
-- `rework`: transit state, not terminal; after rewrite, return to `inbox`.
-- **Exception**: “already implemented / duplicate” items do **not** enter knowledge-base (that would poison dedupe). Point at the existing implementation and close.
-
-## Item fields (adjudicable four-pack + type + links)
-
-Each file under `items/` needs frontmatter:
-
-```yaml
----
-id: P01            # item id (plan.md references this only)
-title: Short title
-status: accepted   # inbox | review | accepted | rejected | rework
-type: mechanism    # research | prototype | grilling | task (decision-type tag)
-locale: zh
-created: 2026-08-08
-approved: 2026-08-08  # only when accepted
-priority: P1       # optional; accepted only. P0 | P1 | P2. Missing → treat as P2
-delivery: standing  # accepted only. open | in-slice | landed | standing | deferred
-linked_tasks:      # optional: task directory names (slice index, not completion)
-  - 08-08-example-task
----
-```
-
-Body must include four sections: **Intent (one line) / Motivation / Coarse acceptance / Non-goals**. Notes that fail the four-pack stay notes; they are not “ready for review”.
-
-## Delivery (orthogonal to status)
-
-`status` is adjudication. `delivery` is remaining obligation. Do not collapse them.
-
-| delivery | Meaning | Attention board |
-| --- | --- | --- |
-| `open` | Accepted; work not started or remaining obligation exists | Yes |
-| `in-slice` | Linked tasks currently executing | Yes |
-| `landed` | Finite deliverable discharged | Closed, not a queue |
-| `standing` | Live rule / discipline; never a todo | Standing list, not a queue |
-| `deferred` | Accepted but explicitly not doing now | Closed, not a queue |
-
-- Required on `accepted`. `inbox` / `review` / `rejected` omit it.
-- `pool.py status` prints the groups. `plan.md` Mainline only cites `open` / `in-slice`.
-- `depends_on: ["pool:Pxx"]` uses `delivery`, not linked-task Close: standing / landed / deferred → SATISFIED; open / in-slice → NOT_SATISFIED; missing `.pactile/pool/` (no Capture) → ignored (does not block Close); missing item → UNRESOLVED.
-
-## Links and validation (pool CLI)
-
-Item ↔ task links use the CLI as the authoritative write path (both sides in one call):
-
-- Item side: frontmatter `linked_tasks` (task directory name) — **slice index for humans**, not completion
-- Task side: `task.json` → `meta.pool_items` (pool item id, e.g. `"P01"`)
-- Many-to-many; de-duplicated, order-preserving
-- Hand-editing one side is caught by `validate` (`link-missing-task-side` / `link-missing-item-side`)
-
-| Command | Role | Exit |
-| --- | --- | --- |
-| `python3 ./.pactile/scripts/pool.py validate` | Four-pack / required keys / status / delivery / unique id / dangling links / bidirectional consistency | error-level → 1 |
-| `python3 ./.pactile/scripts/pool.py plan-check` | plan.md referenced ids exist (ghost id → error) | same |
-| `python3 ./.pactile/scripts/pool.py link <item-id> <task-ref>` | Bidirectional link (idempotent) | missing → 1 |
-| `python3 ./.pactile/scripts/pool.py unlink <item-id> <task-ref>` | Bidirectional unlink | item missing → 1 |
-| `python3 ./.pactile/scripts/pool.py show <item-id>` | Print item + delivery + linked task status summary | missing → 1 |
-| `python3 ./.pactile/scripts/pool.py status` | Print delivery groups (queue / standing / closed) | 0 |
-
-- WARN-only issues exit 0 (same discoverability stance as depends_on Plan A).
-- `depends_on: ["pool:Pxx"]` satisfaction is `delivery` via `pool_refs` (not `pool_store`). See Delivery above.
-
-All commands accept `--root <path>` when the Pactile root is not the current working directory.
-
-## Process rules
-
-1. New idea / gap → write an `items/` entry with status `inbox`.
-2. Review: Agent proposes a decision; user adjudicates → `accepted` / `rejected` / `rework`.
-3. `accepted` → add to `plan.md` (plan cites item ids only; do not rewrite a second narrative). **Does not split into tasks and does not create task directories.**
-4. When the user says to **start implementing** an accepted item → write or update `## 切片` on that item (see below), then Open (`task.py create` + `pool.py link`). Not before Open.
-
-## Starting implementation (split)
-
-`accepted` freezes the requirement only. Do not treat it as a Task.
-
-When the user asks to start implementing an accepted item:
-
-1. Propose a slice list **on the item body** under the heading **`## 切片`**. Each row: short name, `touches`, Lite / Full / Parent, parallel vs `serial_reason`.
-2. After Open, create directories and `pool.py link`. Empty task dirs before Open are forbidden.
-3. One slice = one closable write-set + cohesive AC. Prefer several Fulls that can Close on their own. Use Parent only when one integration authority is required.
-4. Default: isolatable Fulls run in parallel. Colliding `touches` → resplit or write `serial_reason`. No numeric size cap; if it cannot Close / cannot be proven / `touches` span unrelated modules, resplit. Intake must propose that split if the user opens a giant task; the user may insist with range risk / `serial_reason`.
-5. Progress stays `delivery` + `linked_tasks` + `pool.py status`. Unsplit `open`; work running `in-slice`; remaining obligation done `landed`. One slice Close does **not** land the whole item. Remainder may be `deferred`.
-6. Default one pool item per task. Extra links need per-item duties in that task’s PRD (`## 池义务` / `## Pool obligations`). Closing the task only advances the declared duties.
-7. More slices may be added while the item is `open` / `in-slice`. Do not reopen a Closed task to stuff new scope. New slices still need Open.
-8. This split rule applies to **new Open after the rule landed**. Already-open tasks are not force-resplit.
-
-`pool.py validate` **does not fail** when `## 切片` is missing. The heading is an Open-proposal convention, not a new schema.
-
-In-session tiny work still skips the pool (clear request → Intake → Open Task).
-
-## Choosing the next item (attention, not a serial lock)
-
-Priority is **attention + start preference**, not a queue lock. Isolatable write-sets still run in parallel (see `.pactile/workflow.md` Parallel-first). Agent proposes; user chooses. Agent must not auto-start, and must not refuse an independent item because a higher band is unfinished.
-
-1. Run `python3 ./.pactile/scripts/pool.py status`. Rank **only** `open` and `in-slice`.
-2. Within the queue, group by attention band: `priority: P0` → `P1` → unlabeled/`P2`.
-3. `standing` / `landed` / `deferred` / inbox hold / `rejected` do not rank. `rework` drops until re-accepted.
-4. Show the band order **and** the parallel groups → **ask the user**.
-
-`inbox` hold items are not ranked. Do not invent a scheduler CLI. Serial exceptions are the same set as Parallel-first (`serial_reason`).
-
-When this repo is PACTILE itself: the workflow package and optional BYOK are **independent ships**. See `.pactile/framework/release-boundary.md`. BYOK readiness is not a workflow-package gate.
-
-## Fog hygiene
-
-- Once an item or mechanism lands, **move it out** of “Not yet specified” into closed/mainline and keep the task id. Do not leave shipped work in fog.
-- Fog holds only truly open, uncommitted directions; if fog is empty, delete the whole section.
-
-## Boundary with the Task Ladder
-
-- **In-session requests** (clear, directly actionable) → Lite / Full / Parent task creation — **not** the pool.
-- **Ideas / directions / gaps / unformed thoughts** → pool.
-- Pool = candidates; Task = commitment. Only `accepted` items should become tasks.
-
-## Language
-
-Items and plans are human-reviewed artifacts and follow `artifact_locale`. Frontmatter keys and status values stay English (infrastructure).
-
-## Maintenance
-
-- Record adjudication notes on the item (decision log) so rationale is not lost.
-- After terminology-related items land, consider adding consistency checks at archive / check time when the project cares about glossary drift.