pstack-claude-mirror 0.0.0-stage → 0.9.133

package/tools/substitutions.json

@@ -0,0 +1,646 @@
+{
+  "substitutions": [
+    {
+      "pattern": "`https://github.com/cursor/plugins/blob/main/pstack/` followed by its path",
+      "replacement": "`https://github.com/michael-denyer/pstack-claude/blob/main/plugins/pstack/` followed by its path",
+      "rationale": "the public copy of a port skill file lives in this repository under plugins/pstack"
+    },
+    {
+      "pattern": "[README](../../README.md)",
+      "replacement": "[README](https://github.com/michael-denyer/pstack-claude/blob/main/README.md)",
+      "rationale": "upstream's README is excluded and the port's README sits at the repository root, outside the skills tree"
+    },
+    {
+      "pattern": "repro this with /verify-<app>.",
+      "files": "^skills/poteto-help/",
+      "replacement": "repro this with /verify.",
+      "rationale": "the port's create-verification-skill writes a project skill named verify (#71)"
+    },
+    {
+      "pattern": "Write a project-local skill with frontmatter that names the area and says when to use it.",
+      "files": "^skills/create-formal-verification-skill/SKILL\\.md$",
+      "replacement": "Write a project-local skill with frontmatter that names the area and says when to use it. Name the skill for the area, never `verify` or a `verify-` prefix, which belong to the driver skill `/create-verification-skill` writes. On Claude Code it lives at `.claude/skills/<area>/SKILL.md`.",
+      "rationale": "the port's create-verification-skill writes a project skill named verify, and older generators wrote verify-* (#71), so a formal skill must not take either name; the Codex, Copilot, and Pi mappings give their runtimes' paths, and this gives Claude Code's"
+    },
+    {
+      "pattern": "A verify skill has no fixed name, so find it by what it does: a project skill that runs a model checker, a prover, or another verifier against named code.",
+      "files": "^skills/maintain-formal-verification-skill/SKILL\\.md$",
+      "replacement": "A verify skill has no fixed name, so find it by what it does: a project skill that runs a model checker, a prover, or another verifier against named code. The project `verify` skill that `/create-verification-skill` writes drives the app and is not one.",
+      "rationale": "the port's driver skill is named verify (#71), so the formal maintainer must not take it for a formal check"
+    },
+    {
+      "regex": "\\bverify skill\\b",
+      "files": "^skills/(create|maintain)-formal-verification-skill/SKILL\\.md$",
+      "replacement": "formal verification skill",
+      "rationale": "the port's driver skill is named verify (#71), so upstream's generic \"verify skill\" for the formal skill reads as the driver; must follow the two formal rules above, whose patterns contain it"
+    },
+    {
+      "pattern": "The system prompt names the workspace's `agent-transcripts/` directory.",
+      "replacement": "Claude Code stores them at `${CLAUDE_CONFIG_DIR:-$HOME/.claude}/projects/<encoded-cwd>/*.jsonl`. Run `node <plugin>/skills/reflect/scripts/claude-project-dir.mjs` to print this session's directory rather than building `<encoded-cwd>` by hand.",
+      "rationale": "Claude Code's system prompt does not name a transcripts directory, so the port names the path and the script that prints it"
+    },
+    {
+      "pattern": "Typical flow: in **one** message, run two `Task` calls in parallel — `subagent_type: \"shell\"` and `subagent_type: \"explore\"` — to collect `git diff <base>...HEAD` output and full contents of changed files (default base `main`).",
+      "replacement": "Typical flow: run `git diff <base>...HEAD` (default base `main`) and read the full contents of the changed files, through the `Explore` agent when the set is large.",
+      "rationale": "Claude Code has no shell or explore subagent types; the parent runs git itself and its built-in Explore agent reads bulk; must precede the `Task` rule"
+    },
+    {
+      "pattern": "You are a **Task subagent**.",
+      "replacement": "You are an **`Agent` subagent**.",
+      "rationale": "the article changes with the tool name; must precede the Task subagent rule"
+    },
+    {
+      "pattern": "Invoked via Task after a parent gathers diff and file contents.",
+      "replacement": "Invoked through the `Agent` tool after a parent gathers diff and file contents.",
+      "rationale": "the Task tool is the Agent tool on Claude Code, and the port writes the tool name in backticks"
+    },
+    {
+      "pattern": "comments from BugBot or others present",
+      "replacement": "comments from a review bot or others present",
+      "rationale": "the port routes any automated PR-review bot, not only Cursor's Bugbot"
+    },
+    {
+      "pattern": "Flag issues found by BugBot or others",
+      "replacement": "Flag issues found by a review bot or others",
+      "rationale": "the port routes any automated PR-review bot, not only Cursor's Bugbot"
+    },
+    {
+      "pattern": "Incorporate BugBot or human threads",
+      "replacement": "Incorporate review-bot or human threads",
+      "rationale": "the port routes any automated PR-review bot, not only Cursor's Bugbot"
+    },
+    {
+      "pattern": "subagent_type: \"thermo-nuclear-review-subagent\"",
+      "replacement": "subagent_type: \"pstack:thermo-nuclear-review-subagent\"",
+      "rationale": "Claude Code dispatches plugin agents by their namespaced name"
+    },
+    {
+      "pattern": "subagent_type: \"thermo-nuclear-code-quality-review-subagent\"",
+      "replacement": "subagent_type: \"pstack:thermo-nuclear-code-quality-review-subagent\"",
+      "rationale": "Claude Code dispatches plugin agents by their namespaced name"
+    },
+    {
+      "pattern": "(shipped in the Thermos plugin)",
+      "replacement": "(shipped in this plugin)",
+      "rationale": "the port carries the thermos skills inside pstack, not as a separate plugin"
+    },
+    {
+      "pattern": "skill in the Thermos plugin.",
+      "replacement": "skill in this plugin.",
+      "rationale": "the port carries the thermos skills inside pstack, not as a separate plugin"
+    },
+    {
+      "pattern": "find this conversation's transcript in the `agent-transcripts/` directory the system prompt names.",
+      "replacement": "find this conversation's transcript in Claude Code's per-project transcripts directory at `${CLAUDE_CONFIG_DIR:-$HOME/.claude}/projects/<encoded-cwd>/`.",
+      "rationale": "Cursor's system prompt names its agent-transcripts directory; Claude Code's does not, so the port names the path"
+    },
+    {
+      "pattern": "Spawn Comment Sicko, fix",
+      "replacement": "Spawn the comment-sicko subagent, fix",
+      "rationale": "the menu description names the plugin agent by its file name"
+    },
+    {
+      "pattern": "Comment Sicko",
+      "files": "^skills/no-comments/",
+      "replacement": "comment-sicko",
+      "rationale": "the agent's registered name is its file name"
+    },
+    {
+      "pattern": "No `eval`, `test`, `judge`, `experiment`, `rubric`, `score`, `compare`, `benchmark`, `candidate`, or `arena` in any directory",
+      "replacement": "None of the words eval, test, judge, experiment, rubric, score, compare, benchmark, candidate, or arena in any directory",
+      "rationale": "the Claude plugin directory validator reads a backticked eval as a shell execute pattern and holds the submission (0.9.46, #108)"
+    },
+    {
+      "pattern": "list the available MCPs from the Cursor environment. Use the available-tools map when present. Otherwise inspect the `mcps/` directory Cursor exposes for enabled MCP servers.",
+      "replacement": "list the available MCPs in the Claude Code environment. Use the tool list at the top of the system prompt (every MCP appears as a tool with prefix `mcp__<server>__<name>`). Otherwise read `.mcp.json` in the plugin/project, or run `claude mcp list`.",
+      "rationale": "where Claude Code exposes its MCP servers"
+    },
+    {
+      "regex": "default to one each on `(?:claude|gpt|grok|gemini|composer)-[^`]+`(?:(?:,| and|, and) `(?:claude|gpt|grok|gemini|composer)-[^`]+`)*\\.",
+      "files": "^skills/arena/SKILL\\.md$",
+      "replacement": "run one each on the defaults in [Models](#models).",
+      "rationale": "the runner defaults are stamped into the Models section"
+    },
+    {
+      "regex": "choose from `(?:claude|gpt|grok|gemini|composer)-[^`]+`(?:(?:,| and|, and) `(?:claude|gpt|grok|gemini|composer)-[^`]+`)*\\.",
+      "files": "^skills/arena/SKILL\\.md$",
+      "replacement": "choose from the runner defaults in [Models](#models).",
+      "rationale": "the cross-judge pool defaults to the stamped runners"
+    },
+    {
+      "regex": " With the default pool, a Claude parent gets `(?:claude|gpt|grok|gemini|composer)-[^`]+`\\. A parent from any other family gets `(?:claude|gpt|grok|gemini|composer)-[^`]+` first\\.",
+      "files": "^skills/arena/SKILL\\.md$",
+      "replacement": "",
+      "rationale": "the stamped defaults hold one Claude Code family per model name, so pool order already picks the first default from another family"
+    },
+    {
+      "regex": "use `(?:claude|gpt|grok|gemini|composer)-[^`]+`(?:(?:,| and|, and) `(?:claude|gpt|grok|gemini|composer)-[^`]+`)*\\.",
+      "files": "^skills/architect/SKILL\\.md$",
+      "replacement": "use the defaults in [Models](#models).",
+      "rationale": "the runner defaults are stamped into the Models section"
+    },
+    {
+      "regex": "use `(?:claude|gpt|grok|gemini|composer)-[^`]+`\\.",
+      "files": "^skills/swarm/SKILL\\.md$",
+      "replacement": "use the default in [Models](#models).",
+      "rationale": "the worker default is stamped into the Models section"
+    },
+    {
+      "pattern": "(usually `.cursor/skills/verify-*/`)",
+      "replacement": "(`.claude/skills/verify/`, or `.claude/skills/verify-*/` from an older generator)",
+      "rationale": "a project skill named verify replaces Claude Code's user-only bundled /verify (#71); must precede the .cursor/skills/ rule"
+    },
+    {
+      "pattern": "run `scripts/worktree-audit.sh [-b <pr-base-ref>] [repo-path]` (principle-build-the-lever). Without `-b` it checks `MERGED` against `origin/HEAD`, so pass `-b origin/<branch>` when PRs target another branch.",
+      "replacement": "run `skills/poteto-mode/scripts/worktree-audit.mjs` under the installed plugin (principle-build-the-lever).",
+      "rationale": "the port ships its own audit script, which reads MERGED from each PR's state and needs no base ref; a skill-relative path does not resolve from the working directory"
+    },
+    {
+      "pattern": "`.cursor/worktrees/myrepo/x`",
+      "replacement": "`.worktrees/myrepo/x`",
+      "rationale": "Claude Code has no editor-managed worktree directory"
+    },
+    {
+      "pattern": "from the user or sidebar",
+      "replacement": "from the user or your own session list",
+      "rationale": "Claude Code has no chat sidebar"
+    },
+    {
+      "pattern": "never hit the sidebar.",
+      "replacement": "never hit the session list.",
+      "rationale": "same sidebar, later in the step"
+    },
+    {
+      "pattern": "`~/Library/Application Support/Cursor` (`state.vscdb.backup`, and `snapshots/roots/<root>` where a `<root>` named for a folder you opened as a workspace balloons)",
+      "replacement": "your editor's application-support caches, `${CLAUDE_CONFIG_DIR:-$HOME/.claude}/shell-snapshots/` and old `${CLAUDE_CONFIG_DIR:-$HOME/.claude}/projects/` transcripts (keep the recent ones the **recall** skill and Session pickup read)",
+      "rationale": "Claude Code's own disk use, in place of Cursor's"
+    },
+    {
+      "pattern": "This playbook replaces Cursor's built-in babysit skill for these requests, so do not route there even though its description matches the same words.",
+      "replacement": "This playbook supersedes the bundled **babysit** skill for these requests, so do not route there even though its description matches the same words. `/babysit` stays the standalone entry point outside poteto-mode.",
+      "rationale": "the bundled babysit skill stays reachable by slash command; must precede the built-in babysit rule"
+    },
+    {
+      "pattern": "status comes from `scripts/watch-pr/watch-pr`.",
+      "replacement": "status comes from the watcher at `skills/poteto-mode/scripts/watch-pr/watch-pr` under the installed plugin.",
+      "rationale": "a skill-relative path does not resolve from the working directory"
+    },
+    {
+      "pattern": "`environment: \"cloud\"`, `run_in_background: true`, and the step ",
+      "replacement": "`run_in_background: true`, and the step ",
+      "rationale": "the Agent tool has no environment parameter"
+    },
+    {
+      "pattern": " model, left unset for `auto` or `inherit-parent`. Use `environment: \"local\"` only when the worker needs access to something on the user's computer.",
+      "replacement": " model, left unset for `auto` or `inherit-parent`. Claude Code subagents all run on this machine, so isolation comes from the worktree or output directory assigned in Phase A, not from a remote environment.",
+      "rationale": "the Agent tool has no environment parameter"
+    },
+    {
+      "pattern": "When a worker must start from a non-default pushed branch, pass `cloud_base_branch`.",
+      "replacement": "When a worker must start from a non-default branch, check that branch out in the worker's own worktree and name the worktree path in its brief.",
+      "rationale": "the Agent tool has no base-branch parameter"
+    },
+    {
+      "pattern": "Bugbot or the agentic security review commented",
+      "replacement": "An automated PR-review bot or the agentic security review commented",
+      "rationale": "the port routes any automated PR-review bot, not only Cursor's Bugbot"
+    },
+    {
+      "pattern": "(the `deslop` skill from the `cursor-team-kit` plugin (`/deslop`))",
+      "replacement": "(the **deslop** skill, `/deslop`)",
+      "rationale": "the port ships deslop itself; inside a parenthesis the port avoids nesting a second one; must precede the bare phrase"
+    },
+    {
+      "pattern": "the `deslop` skill from the `cursor-team-kit` plugin (`/deslop`)",
+      "replacement": "the **deslop** skill (`/deslop`)",
+      "rationale": "the port ships deslop itself"
+    },
+    {
+      "pattern": "`/deslop` from `cursor-team-kit`",
+      "replacement": "`/deslop`",
+      "rationale": "same skill, in the PR checklist"
+    },
+    {
+      "pattern": "~/.cursor/rules/pstack-models.mdc",
+      "replacement": "pstack-models.md",
+      "rationale": "the per-role override sheet; must precede the generic .cursor/rules/ rule or that rule mangles the path"
+    },
+    {
+      "pattern": "AskQuestion",
+      "replacement": "AskUserQuestion",
+      "rationale": "Claude Code's fixed-choice question tool; upstream Cursor names it AskQuestion"
+    },
+    {
+      "pattern": "the Task tool",
+      "replacement": "the `Agent` tool",
+      "rationale": "Claude Code dispatches subagents with the Agent tool; Cursor calls it Task. The port writes the tool name in backticks"
+    },
+    {
+      "pattern": "`Task`",
+      "replacement": "`Agent`",
+      "rationale": "same tool, backticked; covers `Task` call, `Task` prompts, and the `Task` response body"
+    },
+    {
+      "pattern": "Task subagent",
+      "replacement": "`Agent` subagent",
+      "rationale": "same tool, named bare before the word subagent; the port writes the tool name in backticks"
+    },
+    {
+      "pattern": "a Task error",
+      "replacement": "an `Agent` error",
+      "rationale": "same tool, named bare before the word error; the port writes the tool name in backticks"
+    },
+    {
+      "pattern": "control skill",
+      "replacement": "driver skill",
+      "rationale": "driver selection lives in poteto-mode/SKILL.md Non-negotiables; preserve the older generator trigger in its local description"
+    },
+    {
+      "regex": "\\(default `(?:claude|gpt|grok|gemini|composer)-[^`]+`\\)",
+      "files": "^skills/poteto-mode/playbooks/",
+      "replacement": "(default in poteto-mode's Models section)",
+      "rationale": "model defaults live in models.json and are stamped into Models sections, never hard-coded in prose; playbooks belong to poteto-mode"
+    },
+    {
+      "regex": "\\(default `(?:claude|gpt|grok|gemini|composer)-[^`]+`\\)",
+      "files": "/SKILL\\.md$",
+      "replacement": "(default in [Models](#models))",
+      "rationale": "same rule for a skill body, which carries its own Models section"
+    },
+    {
+      "regex": ", default `(?:claude|gpt|grok|gemini|composer)-[^`]+`",
+      "files": "/SKILL\\.md$",
+      "replacement": ", default in [Models](#models)",
+      "rationale": "a role bullet's default model is stamped into the skill's Models section, never hard-coded in prose"
+    },
+    {
+      "regex": "Defaults `(?:claude|gpt|grok|gemini|composer)-[^`]+` for code, `(?:claude|gpt|grok|gemini|composer)-[^`]+` for prose and judgment",
+      "files": "^skills/poteto-mode/SKILL\\.md$",
+      "replacement": "Role defaults in [Models](#models), with \"judgment and prose\" covering prose and judgment",
+      "rationale": "the delegate defaults are stamped into poteto-mode's Models section, so an upstream model bump on this line is not a change to the port"
+    },
+    {
+      "regex": "strongest judgment model \\(`(?:claude|gpt|grok|gemini|composer)-[^`]+`\\)",
+      "files": "^skills/poteto-mode/SKILL\\.md$",
+      "replacement": "strongest-judgment model (default in [Models](#models))",
+      "rationale": "same line, the strongest-judgment default"
+    },
+    {
+      "pattern": "omit Task `model`",
+      "replacement": "omit `model` on the `Agent` call",
+      "rationale": "Claude Code's subagent tool is `Agent`, and the bare tool name is on the denylist"
+    },
+    {
+      "regex": " \\| `(?:claude|gpt|grok|gemini|composer)-[^`]+` \\| `references/",
+      "files": "^skills/reflect/SKILL\\.md$",
+      "replacement": " | default in [Models](#models) | `references/",
+      "rationale": "a reviewer row's default model is stamped into reflect's Models section, so an upstream model bump in the table is not a change to the port"
+    },
+    {
+      "regex": "(?:claude|gpt|grok|gemini|composer)-[0-9a-z.]+(?:-[0-9a-z.]+)+(?<!\\.)",
+      "files": "^skills/setup-pstack/SKILL\\.md$",
+      "replacement": "<slug>",
+      "rationale": "the port writes its own sheet from models.json and replaces Cursor's budget step, so every upstream slug in setup-pstack is scrubbed to the placeholder the port already uses; a conflict there can then be written and resolved, and a model bump alone is no conflict. Must follow the default-phrase rules above"
+    },
+    {
+      "pattern": "the `pstack-models.mdc` rule and a default.",
+      "replacement": "`pstack-models.md` and a default in [Models](#models).",
+      "rationale": "the override sheet and the stamped defaults a spawn falls back to; must precede the shorter `pstack-models.mdc` rule phrase"
+    },
+    {
+      "pattern": "the `pstack-models.mdc` rule",
+      "replacement": "`pstack-models.md`",
+      "rationale": "the override sheet is a file the user includes, not a Cursor rule"
+    },
+    {
+      "pattern": "the rule or that line is missing",
+      "replacement": "the sheet or that line is missing",
+      "rationale": "the override sheet, not a Cursor rule"
+    },
+    {
+      "pattern": "the rule or the line is missing",
+      "replacement": "the sheet or the line is missing",
+      "rationale": "same sentence, the other wording upstream uses"
+    },
+    {
+      "regex": "Families go by prefix: `[a-z-]+-\\*`(?:(?:,| and|, and| with) `[a-z-]+-\\*`)*\\.",
+      "replacement": "Families go by model name, such as Opus, Fable, or Sonnet.",
+      "rationale": "Claude Code names models by family, not by slug prefix"
+    },
+    {
+      "pattern": "~/.cursor/skills/",
+      "replacement": "${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills/",
+      "rationale": "Claude Code reads user skills from its config directory; must precede the .cursor/skills/ rule, whose pattern it contains"
+    },
+    {
+      "pattern": ".cursor/skills/",
+      "replacement": ".claude/skills/",
+      "rationale": "personal skills directory"
+    },
+    {
+      "pattern": "`~/.cursor/projects/*/`",
+      "replacement": "`${CLAUDE_CONFIG_DIR:-$HOME/.claude}/projects/`",
+      "rationale": "Claude Code keeps every project's transcripts under ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/projects/"
+    },
+    {
+      "regex": "the active workspace's `agent-transcripts/` directory(?: \\(the system prompt names (?:the|this) path\\))?",
+      "replacement": "Claude Code's per-project transcripts directory at `${CLAUDE_CONFIG_DIR:-$HOME/.claude}/projects/<encoded-cwd>/`, which `node <plugin>/skills/reflect/scripts/claude-project-dir.mjs` prints",
+      "rationale": "Cursor's system prompt names its agent-transcripts directory; Claude Code's does not, so the port names the path"
+    },
+    {
+      "pattern": "~/.cursor/plugins/",
+      "replacement": "${CLAUDE_CODE_PLUGIN_CACHE_DIR:-${CLAUDE_CONFIG_DIR:-$HOME/.claude}/plugins}/",
+      "rationale": "Claude Code installs plugins under ${CLAUDE_CODE_PLUGIN_CACHE_DIR:-${CLAUDE_CONFIG_DIR:-$HOME/.claude}/plugins}/"
+    },
+    {
+      "pattern": ".cursor-plugin/plugin.json",
+      "replacement": ".claude-plugin/plugin.json",
+      "rationale": "the port's plugin manifest; the sync excludes upstream's .cursor-plugin/ directory"
+    },
+    {
+      "pattern": "`generalPurpose`",
+      "replacement": "`general-purpose`",
+      "rationale": "Claude Code's built-in agent type is general-purpose"
+    },
+    {
+      "pattern": "subagent_type: generalPurpose",
+      "replacement": "subagent_type: \"general-purpose\"",
+      "rationale": "the built-in agent type, unbackticked inside a backticked parameter list"
+    },
+    {
+      "pattern": "subagent_type: \"comment-sicko\"",
+      "replacement": "subagent_type: \"pstack:comment-sicko\"",
+      "rationale": "Claude Code dispatches plugin agents by their namespaced name, and the bare comment-sicko id upstream adopted in #486 errors"
+    },
+    {
+      "pattern": "subagent_type: \"poteto-agent\"",
+      "replacement": "subagent_type: \"pstack:poteto-agent\"",
+      "rationale": "plugin agents register under the plugin namespace; the bare name errors (#58)"
+    },
+    {
+      "regex": "Cursor's built-in `create-skill`(?: skill)?",
+      "replacement": "the **plugin-dev:skill-development** skill",
+      "rationale": "Claude Code's skill-authoring guidance ships in the plugin-dev plugin; must precede the bare create-skill rule"
+    },
+    {
+      "pattern": "(Cursor's built-in for authoring SKILL.md files)",
+      "replacement": "(Claude Code's authoring guidance for SKILL.md files)",
+      "rationale": "the parenthetical that follows the skill name"
+    },
+    {
+      "pattern": "create-skill",
+      "replacement": "plugin-dev:skill-development",
+      "rationale": "the same skill, named bare or in backticks"
+    },
+    {
+      "pattern": "Cursor's `/loop` command",
+      "replacement": "Claude Code's `loop` skill",
+      "rationale": "Claude Code ships /loop as a bundled skill"
+    },
+    {
+      "pattern": "a Cursor restart",
+      "replacement": "a session restart",
+      "rationale": "the host application"
+    },
+    {
+      "pattern": "Cursor's built-in babysit skill",
+      "replacement": "the bundled **babysit** skill",
+      "rationale": "Claude Code bundles its own babysit skill with the same trigger words"
+    },
+    {
+      "pattern": "bugbot comments",
+      "replacement": "review-bot comments",
+      "rationale": "the port routes any automated PR-review bot, not only Cursor's Bugbot"
+    },
+    {
+      "regex": " A refused `composer-\\*` entry runs on (?:`[^`]+`|Reviewer B's default)\\.",
+      "replacement": "",
+      "rationale": "Claude Code has no composer models, so the fallback for one has nothing to say"
+    },
+    {
+      "pattern": "reasoning level and fast or standard speed for the job",
+      "replacement": "reasoning level for the job",
+      "rationale": "Claude Code sets fast mode for the session, not per spawn, so a spawn picks only its effort"
+    },
+    {
+      "pattern": "pick the reasoning level and speed the job needs. The `/setup-pstack` budget sets each role's starting level, xhigh by default.",
+      "files": "^skills/poteto-mode/SKILL\\.md$",
+      "replacement": "pick the reasoning level the job needs, set as [Reasoning effort](#reasoning-effort) describes. The role's `@level`, or the sheet's `default effort` line, sets its starting level, and `session` starts from the session's level.",
+      "rationale": "the port's per-spawn effort lever is the override sheet's @level and the Agent call's effort parameter, not a slug suffix"
+    },
+    {
+      "pattern": "Use fast mode only when the job is urgent, meaning CI or trunk is red or a person is blocked on the result right now. Otherwise use standard speed, the same slug without `-fast`.",
+      "files": "^skills/poteto-mode/SKILL\\.md$",
+      "replacement": "Claude Code sets fast mode for the whole session, so a spawn changes only its effort.",
+      "rationale": "Claude Code has no per-spawn fast slug"
+    },
+    {
+      "regex": "stays on the `swarm workers` model and speed \\(`[^`]+` by default\\)",
+      "files": "^skills/poteto-mode/SKILL\\.md$",
+      "replacement": "stays on the `swarm workers` model and effort (default in the **swarm** skill's Models section)",
+      "rationale": "model defaults live in models.json and are stamped into Models sections, never hard-coded in prose"
+    },
+    {
+      "pattern": "Change only the effort level and whether the slug is fast, and keep the family the role names",
+      "files": "^skills/poteto-mode/SKILL\\.md$",
+      "replacement": "Change only the effort level, and keep the model the role names",
+      "rationale": "Claude Code has no per-spawn fast slug"
+    },
+    {
+      "pattern": "If the family has no slug at that level and speed, use its nearest slug.",
+      "files": "^skills/poteto-mode/SKILL\\.md$",
+      "replacement": "If the model does not take that level, use its nearest level.",
+      "rationale": "on Claude Code the effort is a level on the dispatch, not a slug"
+    },
+    {
+      "pattern": "rejects the adjusted slug, do not try another adjusted slug.",
+      "files": "^skills/poteto-mode/SKILL\\.md$",
+      "replacement": "rejects the adjusted level, do not try another level.",
+      "rationale": "on Claude Code the effort is a level on the dispatch, not a slug"
+    },
+    {
+      "regex": " \\(?(?:with|through) (?:the matching|its) driver skill,? \\(?such as `control-(?:ui|cli)` or `control-(?:ui|cli)` from `cursor-team-kit`(?:, or a named driver where none exists)?\\)(?: or a named driver)?",
+      "files": "^skills/poteto-mode/playbooks/",
+      "replacement": " through the driver skill",
+      "rationale": "driver selection lives in poteto-mode/SKILL.md Non-negotiables, which resolve the project's driver or a named one"
+    },
+    {
+      "pattern": "Each owner is a Cursor cloud agent that builds",
+      "replacement": "Each owner is a background subagent in its own worktree that builds",
+      "rationale": "Claude Code runs subagents locally; a worktree per writer gives the isolation a cloud VM gave"
+    },
+    {
+      "pattern": "One verifier per PR, each a Cursor cloud agent, runs",
+      "replacement": "One verifier per PR, each a subagent in its own worktree, runs",
+      "rationale": "Claude Code runs subagents locally; a worktree per writer gives the isolation a cloud VM gave"
+    },
+    {
+      "pattern": "Keep the program's state in the Project tracker (`notes.md`) and the Project store.",
+      "files": "^skills/poteto-mode/playbooks/orchestrate\\.md$",
+      "replacement": "Keep the program's state in a store under `~/.claude/orchestrate/<slug>/`, outside the repo, with `notes.md` as its tracker.",
+      "rationale": "Claude Code has no Project tracker or Project store, so the port keeps the program's state in a directory that outlives the session"
+    },
+    {
+      "pattern": "Run workers on a new cloud VM (`environment: \"cloud\"`) unless the work needs this machine: a `control-ui` or `control-cli` runtime check (from `cursor-team-kit`), local transcripts, a simulator, or auth that exists only here.",
+      "files": "^skills/poteto-mode/playbooks/orchestrate\\.md$",
+      "replacement": "Run workers as background subagents (`run_in_background: true`). Claude Code has no remote worker environment, so give each writer its own worktree or branch, and run runtime checks through the driver skill.",
+      "rationale": "Claude Code runs every subagent on this machine, so the cloud placement rule becomes a worktree rule"
+    },
+    {
+      "pattern": "a control-skill check",
+      "files": "^skills/poteto-mode/playbooks/orchestrate\\.md$",
+      "replacement": "a driver-skill check",
+      "rationale": "driver selection lives in poteto-mode/SKILL.md Non-negotiables, and the port calls the skill the driver skill"
+    },
+    {
+      "pattern": "**Fork when new work needs a worker's built state,** such as its checkout, uncommitted changes, or a running process.",
+      "files": "^skills/poteto-mode/playbooks/orchestrate\\.md$",
+      "replacement": "**When new work needs a worker's built state,** such as its checkout or uncommitted changes, start a fresh worker in that worker's worktree. A Claude Code fork copies the coordinator, not the worker.",
+      "rationale": "Claude Code's fork subagent inherits the caller's context, so it cannot take over a worker's checkout; a fresh worker in that worktree can"
+    },
+    {
+      "pattern": "re-reads this playbook from trunk",
+      "files": "^skills/poteto-mode/playbooks/",
+      "replacement": "re-reads this playbook from disk under the installed plugin",
+      "rationale": "the playbook runs from the installed plugin, and the user's trunk is not pstack's"
+    },
+    {
+      "pattern": "Assume the VM dies.",
+      "replacement": "Assume the owner's session dies.",
+      "rationale": "Claude Code subagents run on this machine, not on cloud VMs"
+    },
+    {
+      "pattern": "in the root agent's store (path in the system prompt)",
+      "replacement": "in the program's store under `~/.claude/orchestrate/<slug>/`",
+      "rationale": "Claude Code's system prompt names no agent store, so the port names the orchestrate store path"
+    },
+    {
+      "pattern": "a chart or diagram from `/visualize`",
+      "replacement": "a chart or diagram you render from the data",
+      "rationale": "/visualize is a Cursor command with no Claude Code equivalent"
+    },
+    {
+      "pattern": "a `/visualize` chart for numbers",
+      "replacement": "a chart rendered from the data for numbers",
+      "rationale": "/visualize is a Cursor command with no Claude Code equivalent"
+    }
+  ],
+  "denylist": [
+    {
+      "token": "Project tracker",
+      "hint": "Cursor's Project tracker; the port keeps program state under ~/.claude/orchestrate/<slug>/, so add a substitution rule for the phrase"
+    },
+    {
+      "token": "Project store",
+      "hint": "Cursor's Project store; the port keeps program state under ~/.claude/orchestrate/<slug>/, so add a substitution rule for the phrase"
+    },
+    {
+      "token": "grok-",
+      "hint": "Cursor model slug; point at the Models section, or add a substitution rule for the phrase"
+    },
+    {
+      "token": ".cursor-plugin",
+      "hint": "Cursor's manifest directory, which the sync excludes; the port's manifest is .claude-plugin/plugin.json"
+    },
+    {
+      "regex": "\\b(?:claude|gpt|gemini|composer)-[0-9a-z.-]*-(?:max|fast|xhigh|high|medium|low|thinking)\\b",
+      "hint": "Cursor model slug with an effort suffix; point at the Models section, or add a substitution rule for the phrase"
+    },
+    {
+      "token": "pstack-models.mdc",
+      "hint": "Cursor's rule file; the port's override sheet is pstack-models.md, at the path setup-pstack lists per runtime"
+    },
+    {
+      "token": "`verify` skill (UIs)",
+      "hint": "use the driver policy in poteto-mode/SKILL.md Non-negotiables"
+    },
+    {
+      "token": "`verify` for UIs",
+      "hint": "use the driver policy in poteto-mode/SKILL.md Non-negotiables"
+    },
+    {
+      "token": "/visualize",
+      "hint": "Cursor's chart command; Claude Code has none, so name a chart rendered from the data"
+    },
+    {
+      "token": "control-cli",
+      "hint": "use the driver policy in poteto-mode/SKILL.md Non-negotiables; rewrite the sentence, don't token-swap"
+    },
+    {
+      "token": "control-ui",
+      "hint": "use the driver policy in poteto-mode/SKILL.md Non-negotiables; rewrite the sentence, don't token-swap"
+    },
+    {
+      "token": "AskQuestion",
+      "hint": "should have been substituted to AskUserQuestion; substitution rule failed to apply"
+    },
+    {
+      "token": ".cursor/",
+      "hint": "Cursor config path survived; map it to the Claude Code equivalent"
+    },
+    {
+      "token": "Cursor cloud agent",
+      "hint": "Claude Code runs subagents locally; the port isolates writers with worktrees"
+    },
+    {
+      "token": "cursor.com",
+      "hint": "Cursor product URL; check whether the sentence applies to Claude Code at all"
+    },
+    {
+      "token": "/goal",
+      "hint": "Cursor's /goal has no Claude Code equivalent; the autopilot playbooks keep the objective in the program store's notes.md"
+    },
+    {
+      "token": "create-skill",
+      "hint": "Cursor's built-in skill-authoring skill; Claude Code's equivalent is the plugin-dev:skill-development skill"
+    },
+    {
+      "regex": "\\bTask (?:subagent|tool|schema|error|`model`)",
+      "hint": "Cursor's subagent tool named bare; Claude Code's is the `Agent` tool. Add a substitution rule for the phrase"
+    },
+    {
+      "token": "re-reads both playbooks from trunk",
+      "hint": "the playbooks run from the installed plugin, and the user's trunk is not pstack's; rewrite it as re-reading them from disk under the installed plugin"
+    },
+    {
+      "token": "generalPurpose",
+      "hint": "Cursor's built-in agent type; Claude Code's is \"general-purpose\""
+    },
+    {
+      "token": "agent-transcripts",
+      "hint": "Cursor's per-workspace transcript directory; Claude Code keeps transcripts under ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/projects/"
+    },
+    {
+      "token": "environment: \"cloud\"",
+      "hint": "Cursor cloud-agent dispatch; Claude Code runs subagents locally and isolates writers with worktrees"
+    },
+    {
+      "token": "is_background",
+      "hint": "Cursor-only agent frontmatter key; Claude Code sets run_in_background on each Agent call"
+    },
+    {
+      "token": "cloud_base_branch",
+      "hint": "Cursor's cloud-agent base-branch parameter; the port checks the branch out in the worker's worktree"
+    },
+    {
+      "token": "environment: \"local\"",
+      "hint": "Cursor's agent environment parameter; Claude Code subagents all run on this machine"
+    },
+    {
+      "token": "mcps/",
+      "hint": "Cursor's MCP directory; Claude Code lists MCP servers as tools named mcp__<server>__<name>"
+    },
+    {
+      "token": "Application Support/Cursor",
+      "hint": "Cursor's application data; name Claude Code's own caches"
+    },
+    {
+      "token": "cloud-sleeper",
+      "hint": "Cursor's cloud wake chain; Claude Code's /loop schedules its own wake-up"
+    },
+    {
+      "token": "restart Cursor",
+      "hint": "Cursor is the host application upstream; say restart Claude Code, or add a substitution rule for the phrase"
+    }
+  ]
+}