[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77MKRCMTS26FW766M2F24CN":3,"skill-same:01M77MKRCMTS26FW766M2F24CN":69},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":36,"updatedAt":37,"install":38,"resources":50},"01M77MKRCMTS26FW766M2F24CN","continue-in-background",null,"Hand the task to a fresh detached background agent (claude --bg or --cloud) that continues it now from a save-point. Use when the user is going AFK and explicitly asks to 'continue in the background'. Launches only on that request, never self-elected.","melodic-software\u002Fclaude-code-plugins","melodic-software","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F58273638?v=4","01M77JVQTXNGKCE4MDFY2BC936","Melodic Software","01M77JVQVN9QDWKAH6W03ANP76",30,"MIT","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Fcontinue-in-background\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\ndescription: \"Hand the task to a fresh detached background agent (claude --bg or --cloud) that continues it now from a save-point. Use when the user is going AFK and explicitly asks to 'continue in the background'. Launches only on that request, never self-elected.\"\nargument-hint: \"[--unattended] [--cloud] [file|prompt] [topic] [purpose...]\"\nuser-invocable: true\ndisable-model-invocation: false\nmetadata:\n  workflow-stage: session\n  summary: Delegate the task to a fresh background agent now\n---\n\n**Arguments.** `[--unattended] [--cloud] [file|prompt] [topic] [purpose...]`. e.g., \u002Fcontinue-in-background, \u002Fcontinue-in-background prompt, \u002Fcontinue-in-background file phase-3 finish the migration unattended, \u002Fcontinue-in-background --cloud prompt fix-flaky-test\n\n## Context. Gather first\n\nTake `session-id`, `branch`, `status`, and `recent-commits` at `-5`. Probe commands, the\none-command-per-call and treat-failure-as-unknown rules, and the `$`-expansion rationale:\n[`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fgather.md`](${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fgather.md).\n\n**This block only colors the save-point; nothing here is the dirty-tree gate.** That gate runs its\nown commands at delivery step 1 and reads a git failure as a reason NOT to launch, never carry this\nblock's shrug, or its non-`-uall` `git status` output, into it.\n\n## Purpose\n\nThe user is stepping away but the work should keep moving. This skill produces the same save-point\nthe sibling `\u002Fsession-flow:handoff` skill produces, then, instead of asking the user to\n`\u002Fclear`-and-paste, launches a fresh background agent seeded with the resume prompt, so the task\ncontinues now, detached from this session and from the user's presence.\n\nSame save-point engine as `handoff`, different delivery: `handoff` delivers a manual\n`\u002Fclear`-then-paste resume for later; this skill delivers a background continuation for now.\n\n## Hard gate. Launch only on explicit user intent\n\nLaunching a detached session is a side effect the user must have asked for. Launch ONLY when the\nuser explicitly requested background delegation: they invoked this skill by name, or asked in words\n(\"continue this in the background\", \"keep it moving while I'm away\"). NEVER self-elected: the user\nmerely going AFK, context being heavy, or this skill being model-invoked on a description match is\nNOT authorization. When invoked without that explicit request, produce the save-point, emit the\nrails resume prompt with the standard `\u002Fclear`-then-paste instruction, state that no agent was\nlaunched because background delegation was not explicitly requested, and STOP. The user can ask\nfor the launch or run `\u002Fsession-flow:continue-in-background` themselves.\n\n## Arguments\n\n`$ARGUMENTS` carries `[--unattended] [--cloud] [file|prompt] [topic] [purpose...]`, all optional,\nthe non-flag tokens positional. `--unattended`, anywhere in the arguments, is the caller declaring\nthat nobody is present (it governs the offer under \"Boundary\") and is consumed first; the bare word\nin a purpose is purpose text. A leading `--cloud` selects the cloud delivery below and is consumed before the rest parses. The\nrest has the same semantics as `handoff`: method (`file` | `prompt`) recognized only as the first token,\notherwise auto-detect; topic is the kebab slug for the save-point filename, inferred when omitted;\neverything after the topic token is optional natural-language purpose text (\"what will the next\nsession be used for?\"), no quoting, no new syntax, invocations without it parse exactly as\nbefore, and its emphasis-only tailoring rules are owned by the engine doc (\"The purpose argument\ntailors emphasis only\"). Parse purpose from `$ARGUMENTS` in place, never pre-compute. Before the\nresolved topic is embedded anywhere (filename, `--name` flag), sanitize it to `[a-z0-9-]` only,\nstrip or replace every other character, so a crafted slug cannot smuggle quotes or extra flags\ninto the launch command. Purpose text is never embedded in the launch command at all. It shapes\nthe save-point's content, and the agent receives only the `\u002Fgoal` payload.\n\n## Produce the save-point\n\nThe save-point machinery, destination resolution, locating the position, full-vs-prompt-only\nchoice, the mandatory redaction pass, the handoff-file write, and the rails resume prompt, lives\nin the shared engine doc\n[`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fsave-point.md`](${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fsave-point.md).\nWalk it top to bottom; do not restate or improvise any of its steps. On the full path the file is\nshape 3: `save_point.py validate \u003Cfile>` must exit 0 before anything launches (an unfinished\nskeleton, one still carrying `\u003C!-- FILL` slots, fails there and cannot be launched from).\n\nThe launched session has its own session id, so hand it this session's worktree claims exactly as\nthe sibling `handoff` skill's \"Hand worktree claims to the resuming session\" does. On the full\npath the payload ends at the `Read @` directive, so the file carries the handover: the Environment\nto re-establish entry and the first item of `Remaining actions, in order`. On prompt-only the first\nremaining-work bullet carries it, in the resume region the payload includes. Either way the\nsuccessor runs the handover before `check-enter`. `--cloud` skips it: the cloud session has no\nlocal worktree to re-lock.\n\n## Completion condition gate\n\nNo one is present to say the work is done, so the launched session starts only with a checkable\ncompletion condition, armed as its `\u002Fgoal`. Settle it while producing the save-point:\n\n1. **A goal applies** under the engine doc's goal-region rule (the user asked for a fresh goal, or\n   a `\u002Fgoal` is active in this session) → the save-point's goal region holds the condition the\n   launch arms. A checkable done condition the user states in this invocation (\"done when …\")\n   is a fresh-goal request: it lands here, with no draft and no confirmation round. When the goal is active here, the report tells the user to run `\u002Fgoal clear` in\n   this session, which otherwise keeps starting turns after the STOP. When the engine doc's\n   condition check (\"Check the condition before emitting the region\") warns that the condition\n   is conversation-bound, or omits the region because the goal is already met, that condition is\n   not launched: redraft it as case 2 drafts one and take case 2, or take\n   case 3 when no checkable condition is left. Either way the report still advises `\u002Fgoal clear`\n   for the goal active here.\n2. **No goal applies** → draft one from the remaining work with `\u002Fplanning:draft-goal-condition`\n   (if the `planning` plugin is installed; otherwise draft inline a condition the transcript can\n   demonstrate, and say once that the `planning` plugin would pick the repetition lever and check\n   the draft against the documented condition limit) and write the save-point with it as a fresh\n   goal; its on-screen goal region is the display.\n   Then ask the user to confirm the launch, and launch only on a yes: the request made over that\n   condition is their approval to arm it. No answer this turn → no launch.\n3. **No checkable condition** (the lever check routes away from `\u002Fgoal`, or the draft cannot pass\n   its counter) → write the save-point without a goal region and do not launch. Say that a\n   background run needs a completion condition and that the user can rerun\n   `\u002Fsession-flow:continue-in-background` with the done condition named in the request. Fall\n   back to the `\u002Fclear`-then-paste instruction.\n\nThe launch payload is `\u002Fgoal`, a space, then text taken from the emitted prompt, never retyped:\n\n- **Full path**: the between-rails text of the goal region (headed by the `Type \u002Fgoal`\n  instruction) of `save_point.py emit \u003Cfile>`. It ends with the resume region's `Read @`\n  directive, so the agent reads the handoff file in the turn the goal arms.\n- **Prompt-only**: the goal region's between-rails text, a blank line, then the resume region's,\n  so the remaining-work bullets travel too. The payload after `\u002Fgoal` and its space stays within\n  the goal-region limit the engine doc states, counted with `wc -m \u003Cprompt-file>` less those 6\n  characters, never estimated; over it, do not launch, and fall back with the full path (`file`)\n  named as the fix.\n\nWe rely on a background launch arming the whole multi-line payload as its goal, which our probe\nobserved.\n\n- **Pointer**: the probe record in [reference\u002Fgoal-probe.md](reference\u002Fgoal-probe.md); the docs\n  section for non-interactive goals, \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fgoal#run-non-interactively>.\n\n## Delivery: background-agent launch\n\n**Output order: position panel, then the rails prompt, then the launch report.** The panel (engine\ndoc, \"Emit the position panel\") leads; the operator is walking away while an agent keeps working,\nso the one thing they should not have to reconstruct is where the work stood when they left. It is\nscreen output only: **the launched agent receives exactly the `\u002Fgoal` payload and never a line of\nthe panel**, which keeps it identical to the goal-region paste a person would make.\n\nThe rails prompt from the engine doc is still emitted before the launch (transparency + manual\nfallback), then:\n\n1. **Dirty-tree gate.** First establish there is a tree to inspect, with\n   `git rev-parse --is-inside-work-tree` in the consuming project. Exactly two results are\n   specified, and everything else falls through to a deliberate default:\n\n   - Prints `true` → there is a work tree; inspect it with the gate below.\n   - Fails *specifically* because this is not a git repository, AND no `WorktreeCreate` hook is\n     configured (\u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fhooks#worktreecreate>) → there is\n     no uncommitted work to protect and no worktree isolation to lose, since we treat\n     background sessions there as editing the working directory in place\n     (\u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#how-file-edits-are-isolated>) →\n     launch, and state both in the launch report. That hook is the isolation path for non-Git source control, so a configured one,\n     or an absence you cannot establish, puts the launched session in a workspace this\n     checkout's local changes never reach: that is the default branch below, not this one.\n   - **Anything else** → the tree's state is UNKNOWN, which is not the same as clean → do NOT\n     launch; fall back exactly as the dirty case does below, reporting what the command said.\n     \"Anything else\" is the default on purpose, and it is wide: a failure for some other reason\n     (dubious ownership, a damaged repository, git missing from `PATH`), and also a *successful*\n     `false`. Inside a bare repository or inside a `.git` directory, where the command exits 0\n     and there is no work tree to inspect.\n\n   Never route by exit status alone. A non-zero exit is not evidence of \"no repository\", and a\n   zero exit is not evidence of a clean tree; both readings put dirty trees on the launch path,\n   which is how a gate that exists to protect uncommitted work ends up failing open. Only the\n   two identifications above may leave the default branch.\n\n   Inspect the tree with `git status --porcelain -uall` in the consuming project (`-uall`\n   lists files inside untracked directories individually; the default collapses a brand-new\n   handoff directory into one directory entry, which both defeats the exemption below and can\n   hide other dirt behind it) and IGNORE save-point files under the handoff location, the\n   just-written one AND any prior sessions', with the shape-3 hop files under its `archive\u002F`\n   subdirectory counted as save-point files (this skill never commits them; they are\n   session-chain artifacts, part of the launch rather than disqualifying dirty state; the\n   background session starts in this working directory, so it reads the handoff file before any\n   edit moves it into a worktree). Before judging other changes, read the effective\n   `worktree.bgIsolation` (below). Unless it is `none`, we treat a background session as editing\n   in an isolated worktree, a fresh checkout, so OTHER uncommitted changes in this checkout would\n   NOT carry into the launched agent's edits (pointer, for when isolation applies and when it is\n   skipped: \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#how-file-edits-are-isolated>). Any\n   such changes → do NOT launch: report why and fall back to the standard `\u002Fclear`-then-paste\n   instruction (same checkout, dirty state intact), noting the user can commit or stash and\n   re-run `\u002Fsession-flow:continue-in-background`. Exception: launch anyway when the current session already\n   runs inside a linked git worktree, where isolation is skipped per the same page.\n\n   **`worktree.bgIsolation`.** Read it with `jq` from the settings files, first file that sets\n   it wins across tiers: managed settings (the managed settings file and its `managed-settings.d`\n   drop-in directory, where they exist on this machine), then the project's\n   `.claude\u002Fsettings.local.json` and `.claude\u002Fsettings.json`, then `~\u002F.claude\u002Fsettings.json`.\n   Within the managed tier, do not assume first match: read the file-versus-drop-in and\n   drop-in-versus-drop-in order, and where each lives, from the managed settings pointers\n   below, and apply it. Managed settings delivered another way, or from a location this\n   read cannot find, are not covered: say so in the launch report. A `--settings` value cannot be\n   read from files either, so whenever a launch report is written, say the read covered the files\n   only. `none` is the value that turns isolation off; the pointer says what it does. When the value is `none`,\n   the \"would NOT carry\" refusal does not apply, since the launched session sees the uncommitted\n   changes: launch, and state in the launch report that the background session edits this\n   checkout in place, alongside the user, so both may touch the same files at once; this holds\n   inside a linked worktree too. Any other\n   result, including a file that does not parse, leaves the gate above unchanged. The `--cloud`\n   variant below ignores this setting. Pointers:\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#how-file-edits-are-isolated>.\n   Settings precedence (scope order): \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsettings#settings-precedence>.\n   Managed file locations:\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmanaged-settings#where-each-mechanism-stores-the-policy>.\n   Managed file and drop-in merging:\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmanaged-settings#how-claude-code-combines-managed-sources>\n   and \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmanaged-settings#split-a-file-based-policy-across-teams>.\n2. Launch from the consuming project's root, passing the `\u002Fgoal` payload verbatim as one argument.\n   First write it, as the completion condition gate defines it, to a temporary file with the\n   Write tool (never inline it in the command: prompt content is\n   untrusted session text, and any inline embedding, a heredoc, an escaped string, hands crafted\n   content a path out of the quoting and into the shell). `\u003Ctopic>` = the resolved, sanitized\n   topic slug (argument or inferred); when none resolves, use `resume`:\n\n   ```bash\n   cd \"${CLAUDE_PROJECT_DIR}\" && CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 claude --bg --name \"continue-\u003Ctopic>\" --permission-mode auto \"$(cat \"\u003Cprompt-file>\")\" && rm -f \"\u003Cprompt-file>\"\n   ```\n\n   Insert `--effort \"\u003Clevel>\"` before the prompt argument when \"What the launched session\n   inherits\" below calls for it.\n\n   `--permission-mode auto` is always passed, following the repository's rule to launch\n   unattended local lanes with `--permission-mode auto` (AGENTS.md). We rely on one denied\n   action not stopping the launched session, which our probe observed: the denial came back to\n   the model as a tool error, the session went on to its next step and ended its turn with no\n   prompt, and the denial was in its transcript and `claude logs` output, reaching the final\n   hand-off only because the task asked for a per-step report. Whether a detached session can\n   still stop on a prompt after auto mode falls back is unverified: the probe made one denial and\n   did not exercise the fallback.\n\n   - **Pointer**: the probe record in [reference\u002Fdenial-probe.md](reference\u002Fdenial-probe.md); the\n     docs sections, [Permission modes § When auto mode falls back](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fpermission-modes#when-auto-mode-falls-back)\n     and [agent view § Permission mode, model, and effort](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#permission-mode-model-and-effort).\n   - **As of**: probe 2026-10-28, Claude Code 2.1.312; docs pages read 2026-10-29, first 100000\n     characters of each only\n   - **Recheck trigger**: a Claude Code release note changes how a background session handles a\n     classifier denial, or either section starts saying what a background session does when an\n     action is denied or auto mode falls back.\n\n   The launch report says auto mode may deny an action, that the session keeps going past a\n   denial, and that a denial is in the session's transcript and `claude logs \u003Cid>`, reaching the\n   final hand-off only when the resumed task reports it; it never promises the final hand-off.\n\n   `claude --bg` starts the session as a background agent and returns immediately; the user\n   manages it with `claude agents`. This launch runs from a Bash-tool subprocess, so always set\n   `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, which keeps the session in the `claude agents` list\n   (pointer: for how nested sessions are listed, the `CLAUDE_CODE_CHILD_SESSION` and\n   `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` rows of\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fenv-vars#variables>). Awareness note: the prompt\n   travels in the process argument list, so it is briefly visible to other local processes\n   (`ps`), inherent to `claude --bg \"\u003Cprompt>\"`. The mandatory redaction pass has already\n   scrubbed the prompt by this point; this exposure is one more reason secrets never belong in\n   save-point output on ANY path.\n3. Report the launch result: the command's output, the agent name, the `claude agents`\n   management hint, any launched-session behavior the resumed work depends on (next\n   section), and the denied-action statement step 2 defines, never a promise of the final\n   hand-off. Verify the agent actually appeared. A zero-exit launch can still be invisible if\n   the persistence override is ever unrecognized. Confirm by listing sessions non-interactively this\n   turn when the CLI offers a way, and otherwise telling the user explicitly: \"confirm it\n   appears in `claude agents`\". The `\u002Fclear`-then-paste instruction is replaced by this report.\n   The user no longer needs to paste anything.\n4. **Launch failure → fall back, never block.** Non-zero exit (e.g. the installed Claude Code\n   predates `--bg`) → report the error and fall back to the standard `\u002Fclear`-then-paste\n   instruction. The save-point already exists; nothing is lost.\n5. **STOP.** The background agent is the continuation; this session terminates the task. Do not\n   monitor, poll, or babysit the launched agent, and do not start new work items.\n\n## Delivery variant: `--cloud`\n\nSame hard gate, completion condition gate, save-point, `\u002Fgoal` payload, prompt file, failure\nfallback and STOP, plus one more condition: the user's own words asked for a cloud session.\nWhether a cloud session arms a `\u002Fgoal` from its first prompt has not been probed, so the report\nsays so and tells the user to confirm `◎ \u002Fgoal active` when they open the session. A request for background work alone\ndoes not cover it; without that, drop `--cloud` and take the local delivery. Steps 1 to 3\nchange, because this skill launches a cloud session only from a clean checkout whose branch\nmatches its remote:\n\n1. **Only pushed work reaches it.** Launch only when `git status --porcelain -uall` lists nothing\n   but save-point files (neither the linked-worktree exception nor `worktree.bgIsolation: none` applies), `git fetch --quiet` then\n   succeeds, and `git rev-parse HEAD` equals `git rev-parse @{upstream}`; the fetch keeps a stale\n   tracking ref from passing the check. No upstream, a failed command, or any other result → no\n   launch; fall back as the dirty case does and name commit-and-push as the fix. Upstream can\n   also bundle a repo in some cases (Pointer below). This skill does not take that path, so the\n   cloud session starts from pushed state; a user who wants a bundle starts `claude --cloud`\n   themselves. A\n   handoff file in the memory tier never reaches the VM, and the full path's `Read @` names a\n   local path, so launch only on the prompt-only path. When the save-point takes the full path,\n   forced or by default, do not launch: tell the user to commit and push the handoff or plan,\n   then rerun as `--cloud prompt \u003Ctopic> \u003Cpurpose naming its repo-relative path>`. This skill\n   commits nothing.\n2. **Launch** from the project root with the prompt file:\n   `claude --cloud \"$(cat \"\u003Cprompt-file>\")\" && rm -f \"\u003Cprompt-file>\"`, with `--effort \"\u003Clevel>\"`\n   before the prompt argument when \"What the launched session inherits\" calls for one. If the CLI\n   rejects `--effort` with `--cloud`, relaunch without it and have the report name the level and\n   tell the user to send `\u002Feffort \u003Clevel>` in the session. If it refuses `--cloud` because there is\n   no terminal, take the local delivery with the same prompt file instead of the failure\n   fallback, so the work keeps moving: local steps 3 and 4 then replace cloud step 3, and the\n   report adds that the cloud launch was refused and the run went local. Pointer: probe 3 in\n   [reference\u002Fgoal-probe.md](reference\u002Fgoal-probe.md).\n3. **Report** the session id and link it prints, plus the return paths: `claude --teleport \u003Cid>`\n   or `\u002Fteleport` to continue it in a terminal (its requirements: Pointer below), which needs the\n   same account; `claude -p \"\u003Cmessage>\" --cloud \u003Cid>` to queue a follow-up. Name\n   the account the CLI is signed in to now: the session's limits, teleport, follow-ups and plugin\n   loading all depend on that account (Pointer below).\n\n- **Pointer**: \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fclaude-code-on-the-web#start-a-cloud-session-from-your-terminal>,\n  \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fclaude-code-on-the-web#send-local-repositories-without-github>,\n  \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fclaude-code-on-the-web#manage-context> (`\u002Feffort` in a session),\n  \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fclaude-code-on-the-web#continue-a-cloud-session-in-your-terminal>,\n  \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fclaude-code-on-the-web#send-follow-ups-from-the-cli>; what the\n  session lacks: \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fcloud-environments#what-carries-over-from-your-setup>.\n\n## What the launched session inherits (and what it does not)\n\nThe launched agent is a NEW session, not a fork of this one. What it inherits is upstream\nbehavior; the rules below are ours, built on it.\n\n- **Pointer**: [Manage multiple agents with agent view § Settings and provider](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#settings-and-provider)\n  and [§ Permission mode, model, and effort](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#permission-mode-model-and-effort)\n\nOur rules:\n\n- **CLI configuration is NOT inherited.** It carries none of the current session's CLI flags\n  (e.g. `--mcp-config`, `--settings`, `--add-dir`, `--plugin-dir`). Mirror onto the launch\n  command any such flags the resumed work depends on, and say so in the launch report.\n- **Model and effort are NOT inherited** from the current session's in-conversation choices.\n  They resolve from the launch command's own `--model` \u002F `--effort` flags and, absent those,\n  from the settings of the directory it starts in (project\u002Fuser settings, including `env`\n  values such as `ANTHROPIC_MODEL`). When the resumed work depends on a specific model or\n  effort, pass the flags explicitly and note them in the launch report.\n\n  For resumed verify work, and for any task the launched session runs unattended, pass an\n  explicit `--effort` so the work does not silently run at the default. At launch, read\n  model-config's\n  [Choose an effort level](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmodel-config#choose-an-effort-level)\n  table, pick the level whose described use fits the resumed task, and pass that level as\n  `--effort \"\u003Clevel>\"` in step 2's command, before the prompt argument. A task that changes code\n  or verifies it is never given a level below medium; skip any row the table says is not an\n  effort level. The value is one level name of lowercase letters only, never free text, for the\n  same reason the topic slug is sanitized. The launch report names the level and quotes the\n  matched use. When the page cannot be read, say so, pass no `--effort`, and state that the\n  session will start at its default level.\n\n  - **Pointer**: for choosing a level, see the table linked above; for the `--effort` flag, see\n    [Set the effort level](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmodel-config#set-the-effort-level).\n- **Permission mode is set at launch, not inherited.** Step 2's command always passes\n  `--permission-mode auto`, so a directory setting with another default mode does not set the\n  launched session's mode.\n- **Directory settings ARE read normally.** The session reads its settings from the directory\n  it runs in, the same as a fresh `claude` started there.\n\n## Post-launch enforcement checklist\n\nTick each item in the response so the user can verify the exit shape (in addition to the engine\ndoc's save-point items, which the sibling `handoff` skill's checklists mirror):\n\n- [ ] Explicit user intent for background delegation verified (hard gate). Absent intent →\n  save-point + `\u002Fclear`-then-paste exit, no launch, reason stated\n- [ ] Position panel emitted per the engine doc (\"Emit the position panel\"), ahead of the rails\n  prompt, OR an explicit line saying the units would not resolve, and none of its text included in\n  the prompt handed to the launched agent\n- [ ] Purpose text (when the invocation carried any) applied per the engine doc's tailoring rules\n  full path: brief lead, Suggested-skills selection, Remaining-actions order; prompt-only: the\n  inline `Purpose:` line between the rails, never discarded (the launched agent receives exactly\n  the rails prompt); a goal-conflicting purpose flagged rather than obeyed; never embedded in the\n  launch command. No purpose given → nothing to tick\n- [ ] Worktree claims handed to the successor (\"Produce the save-point\"): each worktree whose\n  lock names this session carries the handover before `check-enter` (OR none held)\n- [ ] Dirty-tree gate evaluated this turn: `git rev-parse --is-inside-work-tree` first, then\n  `git status --porcelain -uall` when it says `true`, ignoring save-point files under the handoff\n  location; effective `worktree.bgIsolation` read before judging other changes, and `none` → launch with the\n  edits-this-checkout-in-place warning in the report (`--settings` tier named as not covered);\n  otherwise other uncommitted changes without the linked-worktree exception → no launch, reason\n  reported, fallback to `\u002Fclear`-then-paste. Positively identified as not a git repository AND no\n  `WorktreeCreate` hook configured → launch, that reading stated in the report; any other\n  `rev-parse` result, failing or `false`, and any hook whose absence is not established → state\n  unknown, no launch, same fallback\n- [ ] Completion condition settled: an applying goal used (an active one → `\u002Fgoal clear` advised\n  in the report), or one drafted as case 2 says, shown as the goal region,\n  and launched only on the user's yes to it; a conversation-bound or already-met goal never\n  launched as it stands, only redrafted (case 2) or left unlaunched (case 3); none → no launch, the message saying how to supply\n  one, fallback to `\u002Fclear`-then-paste\n- [ ] Background agent launched (`claude --bg --name … --permission-mode auto`), the payload being\n  `\u002Fgoal`, a space and the goal region's between-rails text from `save_point.py emit \u003Cfile>` on\n  the full path (validated first, exit 0 quoted), or on prompt-only the goal region then the\n  resume region, counted within the limit; and the launch result reported (including any non-inherited flags mirrored or worth\n  flagging, and step 2's denied-action statement: auto mode may deny an action, the session keeps going past a denial, which\n  is in its transcript and `claude logs`, not promised in the final hand-off), OR the non-zero\n  exit reported with fallback to\n  `\u002Fclear`-then-paste\n- [ ] For resumed verify or unattended work, `--effort` passed with the model-config table's level\n  whose described use fits the task, the report naming the level and quoting that use; page unreadable → said so, no `--effort`, and the report states the session starts\n  at its default level\n- [ ] `--cloud` only: clean tree, fetched branch matching its upstream, prompt-only payload,\n  `--effort` passed as for `--bg` (CLI rejects it → relaunched without, `\u002Feffort` advised); the\n  report names the session id, the teleport and follow-up commands, and the signed-in account,\n  and says goal arming there is unprobed; a no-terminal refusal → local delivery, reported\n- [ ] **EXECUTION STOPS HERE**, no monitoring, no babysitting, no new work items\n\n## Boundary, native Claude Code surfaces\n\nThree built-in commands also keep work moving off this terminal, so \"continue in the background\"\ncan mean any of them.\n\n- **`\u002Fsubtask`, `\u002Ffork`, `\u002Fbackground` (built-in commands)**: three ways to move work off this\n  terminal. None writes a save-point, and this skill never runs them. What each launches, its\n  alias, its gate and whether the model can invoke it: the records table in\n  [native-surfaces § verification record](reference\u002Fnative-surfaces.md#native-background-surfaces-verification-record).\n- **This skill (marketplace plugin).** Writes a durable, redacted save-point, gates on a dirty\n  tree, and launches a fresh `claude --bg` session seeded only with the save-point's `\u002Fgoal`\n  payload, so the continuation carries no conversation history, survives on disk, and ends on a\n  checked condition.\n\n**Routing.** At the start of the run, offer them to the person, each instead of or alongside this\nskill. If \u002Fbackground is available in your session (gate basis: gated, per **Availability is\nnever assumed** below; records in\n[native-surfaces § verification record](reference\u002Fnative-surfaces.md#native-background-surfaces-verification-record)),\nyou can run it to detach this session as it is. If \u002Ffork is available in your session (gate basis:\ngated, per the same paragraph and records), you can run it to copy this session into a background\nsession. If \u002Fsubtask is available in your session (gate basis: gated, per the same paragraph and\nrecords), you can run it for a side task whose result should come back here. Prefer this skill\nwhen the continuation should start clean from a durable save-point. When the caller passes\n`--unattended`, the run makes no offer;\nwithout that flag it asks.\n\n**Mutation gate.** This skill writes the save-point and launches one session, only on explicit\nrequest. It never runs a native command on the person's behalf.\n\n**Availability is never assumed.** All three are gated, and their behavior depends on the\nsession's setup; read the gates live from the records table in\n[native-surfaces § verification record](reference\u002Fnative-surfaces.md#native-background-surfaces-verification-record). This\nsection states what to do when they resolve, never that they are present.\n\n## Gotchas\n\nFailure patterns are documented inline at the step that owns them: the `-uall` untracked-directory\ncollapse, the non-repo-plus-no-`WorktreeCreate`-hook vs. unknown split with its deliberately wide\nunknown default, and the ban on reusing the context block's git output (dirty-tree gate, step 1;\ncontext block), the no-inline-prompt rule and the session-persistence env requirement (launch\ncommand, step 2), slug sanitization (\"Arguments\"), and non-inheritance surprises. Model, effort,\nCLI flags (\"What the launched session inherits\").\n\n## What this skill does NOT do\n\n- **Does not launch without explicit user intent**. The hard gate above; the fallback exit is\n  the sibling `handoff` skill's `\u002Fclear`-then-paste shape\n- **Does not launch without a completion condition**. The completion condition gate above\n- **Does not commit**. Save-points are durable task state, not source code; the dirty-tree gate\n  reports other uncommitted work rather than committing or stashing it\n- **Does not monitor the launched agent**. The user manages it with `claude agents`\n- **Does not continue executing the underlying task in this session**. The background agent is\n  the continuation\n- **Does not restate the save-point engine**. Production lives in the shared engine doc\n","**Arguments.** `[--unattended] [--cloud] [file|prompt] [topic] [purpose...]`. e.g., \u002Fcontinue-in-background, \u002Fcontinue-in-background prompt, \u002Fcontinue-in-background file phase-3 finish the migration unattended, \u002Fcontinue-in-background --cloud prompt fix-flaky-test\n\n## Context. Gather first\n\nTake `session-id`, `branch`, `status`, and `recent-commits` at `-5`. Probe commands, the\none-command-per-call and treat-failure-as-unknown rules, and the `$`-expansion rationale:\n[`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fgather.md`](${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fgather.md).\n\n**This block only colors the save-point; nothing here is the dirty-tree gate.** That gate runs its\nown commands at delivery step 1 and reads a git failure as a reason NOT to launch, never carry this\nblock's shrug, or its non-`-uall` `git status` output, into it.\n\n## Purpose\n\nThe user is stepping away but the work should keep moving. This skill produces the same save-point\nthe sibling `\u002Fsession-flow:handoff` skill produces, then, instead of asking the user to\n`\u002Fclear`-and-paste, launches a fresh background agent seeded with the resume prompt, so the task\ncontinues now, detached from this session and from the user's presence.\n\nSame save-point engine as `handoff`, different delivery: `handoff` delivers a manual\n`\u002Fclear`-then-paste resume for later; this skill delivers a background continuation for now.\n\n## Hard gate. Launch only on explicit user intent\n\nLaunching a detached session is a side effect the user must have asked for. Launch ONLY when the\nuser explicitly requested background delegation: they invoked this skill by name, or asked in words\n(\"continue this in the background\", \"keep it moving while I'm away\"). NEVER self-elected: the user\nmerely going AFK, context being heavy, or this skill being model-invoked on a description match is\nNOT authorization. When invoked without that explicit request, produce the save-point, emit the\nrails resume prompt with the standard `\u002Fclear`-then-paste instruction, state that no agent was\nlaunched because background delegation was not explicitly requested, and STOP. The user can ask\nfor the launch or run `\u002Fsession-flow:continue-in-background` themselves.\n\n## Arguments\n\n`$ARGUMENTS` carries `[--unattended] [--cloud] [file|prompt] [topic] [purpose...]`, all optional,\nthe non-flag tokens positional. `--unattended`, anywhere in the arguments, is the caller declaring\nthat nobody is present (it governs the offer under \"Boundary\") and is consumed first; the bare word\nin a purpose is purpose text. A leading `--cloud` selects the cloud delivery below and is consumed before the rest parses. The\nrest has the same semantics as `handoff`: method (`file` | `prompt`) recognized only as the first token,\notherwise auto-detect; topic is the kebab slug for the save-point filename, inferred when omitted;\neverything after the topic token is optional natural-language purpose text (\"what will the next\nsession be used for?\"), no quoting, no new syntax, invocations without it parse exactly as\nbefore, and its emphasis-only tailoring rules are owned by the engine doc (\"The purpose argument\ntailors emphasis only\"). Parse purpose from `$ARGUMENTS` in place, never pre-compute. Before the\nresolved topic is embedded anywhere (filename, `--name` flag), sanitize it to `[a-z0-9-]` only,\nstrip or replace every other character, so a crafted slug cannot smuggle quotes or extra flags\ninto the launch command. Purpose text is never embedded in the launch command at all. It shapes\nthe save-point's content, and the agent receives only the `\u002Fgoal` payload.\n\n## Produce the save-point\n\nThe save-point machinery, destination resolution, locating the position, full-vs-prompt-only\nchoice, the mandatory redaction pass, the handoff-file write, and the rails resume prompt, lives\nin the shared engine doc\n[`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fsave-point.md`](${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Fsave-point.md).\nWalk it top to bottom; do not restate or improvise any of its steps. On the full path the file is\nshape 3: `save_point.py validate \u003Cfile>` must exit 0 before anything launches (an unfinished\nskeleton, one still carrying `\u003C!-- FILL` slots, fails there and cannot be launched from).\n\nThe launched session has its own session id, so hand it this session's worktree claims exactly as\nthe sibling `handoff` skill's \"Hand worktree claims to the resuming session\" does. On the full\npath the payload ends at the `Read @` directive, so the file carries the handover: the Environment\nto re-establish entry and the first item of `Remaining actions, in order`. On prompt-only the first\nremaining-work bullet carries it, in the resume region the payload includes. Either way the\nsuccessor runs the handover before `check-enter`. `--cloud` skips it: the cloud session has no\nlocal worktree to re-lock.\n\n## Completion condition gate\n\nNo one is present to say the work is done, so the launched session starts only with a checkable\ncompletion condition, armed as its `\u002Fgoal`. Settle it while producing the save-point:\n\n1. **A goal applies** under the engine doc's goal-region rule (the user asked for a fresh goal, or\n   a `\u002Fgoal` is active in this session) → the save-point's goal region holds the condition the\n   launch arms. A checkable done condition the user states in this invocation (\"done when …\")\n   is a fresh-goal request: it lands here, with no draft and no confirmation round. When the goal is active here, the report tells the user to run `\u002Fgoal clear` in\n   this session, which otherwise keeps starting turns after the STOP. When the engine doc's\n   condition check (\"Check the condition before emitting the region\") warns that the condition\n   is conversation-bound, or omits the region because the goal is already met, that condition is\n   not launched: redraft it as case 2 drafts one and take case 2, or take\n   case 3 when no checkable condition is left. Either way the report still advises `\u002Fgoal clear`\n   for the goal active here.\n2. **No goal applies** → draft one from the remaining work with `\u002Fplanning:draft-goal-condition`\n   (if the `planning` plugin is installed; otherwise draft inline a condition the transcript can\n   demonstrate, and say once that the `planning` plugin would pick the repetition lever and check\n   the draft against the documented condition limit) and write the save-point with it as a fresh\n   goal; its on-screen goal region is the display.\n   Then ask the user to confirm the launch, and launch only on a yes: the request made over that\n   condition is their approval to arm it. No answer this turn → no launch.\n3. **No checkable condition** (the lever check routes away from `\u002Fgoal`, or the draft cannot pass\n   its counter) → write the save-point without a goal region and do not launch. Say that a\n   background run needs a completion condition and that the user can rerun\n   `\u002Fsession-flow:continue-in-background` with the done condition named in the request. Fall\n   back to the `\u002Fclear`-then-paste instruction.\n\nThe launch payload is `\u002Fgoal`, a space, then text taken from the emitted prompt, never retyped:\n\n- **Full path**: the between-rails text of the goal region (headed by the `Type \u002Fgoal`\n  instruction) of `save_point.py emit \u003Cfile>`. It ends with the resume region's `Read @`\n  directive, so the agent reads the handoff file in the turn the goal arms.\n- **Prompt-only**: the goal region's between-rails text, a blank line, then the resume region's,\n  so the remaining-work bullets travel too. The payload after `\u002Fgoal` and its space stays within\n  the goal-region limit the engine doc states, counted with `wc -m \u003Cprompt-file>` less those 6\n  characters, never estimated; over it, do not launch, and fall back with the full path (`file`)\n  named as the fix.\n\nWe rely on a background launch arming the whole multi-line payload as its goal, which our probe\nobserved.\n\n- **Pointer**: the probe record in [reference\u002Fgoal-probe.md](reference\u002Fgoal-probe.md); the docs\n  section for non-interactive goals, \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fgoal#run-non-interactively>.\n\n## Delivery: background-agent launch\n\n**Output order: position panel, then the rails prompt, then the launch report.** The panel (engine\ndoc, \"Emit the position panel\") leads; the operator is walking away while an agent keeps working,\nso the one thing they should not have to reconstruct is where the work stood when they left. It is\nscreen output only: **the launched agent receives exactly the `\u002Fgoal` payload and never a line of\nthe panel**, which keeps it identical to the goal-region paste a person would make.\n\nThe rails prompt from the engine doc is still emitted before the launch (transparency + manual\nfallback), then:\n\n1. **Dirty-tree gate.** First establish there is a tree to inspect, with\n   `git rev-parse --is-inside-work-tree` in the consuming project. Exactly two results are\n   specified, and everything else falls through to a deliberate default:\n\n   - Prints `true` → there is a work tree; inspect it with the gate below.\n   - Fails *specifically* because this is not a git repository, AND no `WorktreeCreate` hook is\n     configured (\u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fhooks#worktreecreate>) → there is\n     no uncommitted work to protect and no worktree isolation to lose, since we treat\n     background sessions there as editing the working directory in place\n     (\u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#how-file-edits-are-isolated>) →\n     launch, and state both in the launch report. That hook is the isolation path for non-Git source control, so a configured one,\n     or an absence you cannot establish, puts the launched session in a workspace this\n     checkout's local changes never reach: that is the default branch below, not this one.\n   - **Anything else** → the tree's state is UNKNOWN, which is not the same as clean → do NOT\n     launch; fall back exactly as the dirty case does below, reporting what the command said.\n     \"Anything else\" is the default on purpose, and it is wide: a failure for some other reason\n     (dubious ownership, a damaged repository, git missing from `PATH`), and also a *successful*\n     `false`. Inside a bare repository or inside a `.git` directory, where the command exits 0\n     and there is no work tree to inspect.\n\n   Never route by exit status alone. A non-zero exit is not evidence of \"no repository\", and a\n   zero exit is not evidence of a clean tree; both readings put dirty trees on the launch path,\n   which is how a gate that exists to protect uncommitted work ends up failing open. Only the\n   two identifications above may leave the default branch.\n\n   Inspect the tree with `git status --porcelain -uall` in the consuming project (`-uall`\n   lists files inside untracked directories individually; the default collapses a brand-new\n   handoff directory into one directory entry, which both defeats the exemption below and can\n   hide other dirt behind it) and IGNORE save-point files under the handoff location, the\n   just-written one AND any prior sessions', with the shape-3 hop files under its `archive\u002F`\n   subdirectory counted as save-point files (this skill never commits them; they are\n   session-chain artifacts, part of the launch rather than disqualifying dirty state; the\n   background session starts in this working directory, so it reads the handoff file before any\n   edit moves it into a worktree). Before judging other changes, read the effective\n   `worktree.bgIsolation` (below). Unless it is `none`, we treat a background session as editing\n   in an isolated worktree, a fresh checkout, so OTHER uncommitted changes in this checkout would\n   NOT carry into the launched agent's edits (pointer, for when isolation applies and when it is\n   skipped: \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#how-file-edits-are-isolated>). Any\n   such changes → do NOT launch: report why and fall back to the standard `\u002Fclear`-then-paste\n   instruction (same checkout, dirty state intact), noting the user can commit or stash and\n   re-run `\u002Fsession-flow:continue-in-background`. Exception: launch anyway when the current session already\n   runs inside a linked git worktree, where isolation is skipped per the same page.\n\n   **`worktree.bgIsolation`.** Read it with `jq` from the settings files, first file that sets\n   it wins across tiers: managed settings (the managed settings file and its `managed-settings.d`\n   drop-in directory, where they exist on this machine), then the project's\n   `.claude\u002Fsettings.local.json` and `.claude\u002Fsettings.json`, then `~\u002F.claude\u002Fsettings.json`.\n   Within the managed tier, do not assume first match: read the file-versus-drop-in and\n   drop-in-versus-drop-in order, and where each lives, from the managed settings pointers\n   below, and apply it. Managed settings delivered another way, or from a location this\n   read cannot find, are not covered: say so in the launch report. A `--settings` value cannot be\n   read from files either, so whenever a launch report is written, say the read covered the files\n   only. `none` is the value that turns isolation off; the pointer says what it does. When the value is `none`,\n   the \"would NOT carry\" refusal does not apply, since the launched session sees the uncommitted\n   changes: launch, and state in the launch report that the background session edits this\n   checkout in place, alongside the user, so both may touch the same files at once; this holds\n   inside a linked worktree too. Any other\n   result, including a file that does not parse, leaves the gate above unchanged. The `--cloud`\n   variant below ignores this setting. Pointers:\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#how-file-edits-are-isolated>.\n   Settings precedence (scope order): \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsettings#settings-precedence>.\n   Managed file locations:\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmanaged-settings#where-each-mechanism-stores-the-policy>.\n   Managed file and drop-in merging:\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmanaged-settings#how-claude-code-combines-managed-sources>\n   and \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmanaged-settings#split-a-file-based-policy-across-teams>.\n2. Launch from the consuming project's root, passing the `\u002Fgoal` payload verbatim as one argument.\n   First write it, as the completion condition gate defines it, to a temporary file with the\n   Write tool (never inline it in the command: prompt content is\n   untrusted session text, and any inline embedding, a heredoc, an escaped string, hands crafted\n   content a path out of the quoting and into the shell). `\u003Ctopic>` = the resolved, sanitized\n   topic slug (argument or inferred); when none resolves, use `resume`:\n\n   ```bash\n   cd \"${CLAUDE_PROJECT_DIR}\" && CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 claude --bg --name \"continue-\u003Ctopic>\" --permission-mode auto \"$(cat \"\u003Cprompt-file>\")\" && rm -f \"\u003Cprompt-file>\"\n   ```\n\n   Insert `--effort \"\u003Clevel>\"` before the prompt argument when \"What the launched session\n   inherits\" below calls for it.\n\n   `--permission-mode auto` is always passed, following the repository's rule to launch\n   unattended local lanes with `--permission-mode auto` (AGENTS.md). We rely on one denied\n   action not stopping the launched session, which our probe observed: the denial came back to\n   the model as a tool error, the session went on to its next step and ended its turn with no\n   prompt, and the denial was in its transcript and `claude logs` output, reaching the final\n   hand-off only because the task asked for a per-step report. Whether a detached session can\n   still stop on a prompt after auto mode falls back is unverified: the probe made one denial and\n   did not exercise the fallback.\n\n   - **Pointer**: the probe record in [reference\u002Fdenial-probe.md](reference\u002Fdenial-probe.md); the\n     docs sections, [Permission modes § When auto mode falls back](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fpermission-modes#when-auto-mode-falls-back)\n     and [agent view § Permission mode, model, and effort](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#permission-mode-model-and-effort).\n   - **As of**: probe 2026-10-28, Claude Code 2.1.312; docs pages read 2026-10-29, first 100000\n     characters of each only\n   - **Recheck trigger**: a Claude Code release note changes how a background session handles a\n     classifier denial, or either section starts saying what a background session does when an\n     action is denied or auto mode falls back.\n\n   The launch report says auto mode may deny an action, that the session keeps going past a\n   denial, and that a denial is in the session's transcript and `claude logs \u003Cid>`, reaching the\n   final hand-off only when the resumed task reports it; it never promises the final hand-off.\n\n   `claude --bg` starts the session as a background agent and returns immediately; the user\n   manages it with `claude agents`. This launch runs from a Bash-tool subprocess, so always set\n   `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, which keeps the session in the `claude agents` list\n   (pointer: for how nested sessions are listed, the `CLAUDE_CODE_CHILD_SESSION` and\n   `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` rows of\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fenv-vars#variables>). Awareness note: the prompt\n   travels in the process argument list, so it is briefly visible to other local processes\n   (`ps`), inherent to `claude --bg \"\u003Cprompt>\"`. The mandatory redaction pass has already\n   scrubbed the prompt by this point; this exposure is one more reason secrets never belong in\n   save-point output on ANY path.\n3. Report the launch result: the command's output, the agent name, the `claude agents`\n   management hint, any launched-session behavior the resumed work depends on (next\n   section), and the denied-action statement step 2 defines, never a promise of the final\n   hand-off. Verify the agent actually appeared. A zero-exit launch can still be invisible if\n   the persistence override is ever unrecognized. Confirm by listing sessions non-interactively this\n   turn when the CLI offers a way, and otherwise telling the user explicitly: \"confirm it\n   appears in `claude agents`\". The `\u002Fclear`-then-paste instruction is replaced by this report.\n   The user no longer needs to paste anything.\n4. **Launch failure → fall back, never block.** Non-zero exit (e.g. the installed Claude Code\n   predates `--bg`) → report the error and fall back to the standard `\u002Fclear`-then-paste\n   instruction. The save-point already exists; nothing is lost.\n5. **STOP.** The background agent is the continuation; this session terminates the task. Do not\n   monitor, poll, or babysit the launched agent, and do not start new work items.\n\n## Delivery variant: `--cloud`\n\nSame hard gate, completion condition gate, save-point, `\u002Fgoal` payload, prompt file, failure\nfallback and STOP, plus one more condition: the user's own words asked for a cloud session.\nWhether a cloud session arms a `\u002Fgoal` from its first prompt has not been probed, so the report\nsays so and tells the user to confirm `◎ \u002Fgoal active` when they open the session. A request for background work alone\ndoes not cover it; without that, drop `--cloud` and take the local delivery. Steps 1 to 3\nchange, because this skill launches a cloud session only from a clean checkout whose branch\nmatches its remote:\n\n1. **Only pushed work reaches it.** Launch only when `git status --porcelain -uall` lists nothing\n   but save-point files (neither the linked-worktree exception nor `worktree.bgIsolation: none` applies), `git fetch --quiet` then\n   succeeds, and `git rev-parse HEAD` equals `git rev-parse @{upstream}`; the fetch keeps a stale\n   tracking ref from passing the check. No upstream, a failed command, or any other result → no\n   launch; fall back as the dirty case does and name commit-and-push as the fix. Upstream can\n   also bundle a repo in some cases (Pointer below). This skill does not take that path, so the\n   cloud session starts from pushed state; a user who wants a bundle starts `claude --cloud`\n   themselves. A\n   handoff file in the memory tier never reaches the VM, and the full path's `Read @` names a\n   local path, so launch only on the prompt-only path. When the save-point takes the full path,\n   forced or by default, do not launch: tell the user to commit and push the handoff or plan,\n   then rerun as `--cloud prompt \u003Ctopic> \u003Cpurpose naming its repo-relative path>`. This skill\n   commits nothing.\n2. **Launch** from the project root with the prompt file:\n   `claude --cloud \"$(cat \"\u003Cprompt-file>\")\" && rm -f \"\u003Cprompt-file>\"`, with `--effort \"\u003Clevel>\"`\n   before the prompt argument when \"What the launched session inherits\" calls for one. If the CLI\n   rejects `--effort` with `--cloud`, relaunch without it and have the report name the level and\n   tell the user to send `\u002Feffort \u003Clevel>` in the session. If it refuses `--cloud` because there is\n   no terminal, take the local delivery with the same prompt file instead of the failure\n   fallback, so the work keeps moving: local steps 3 and 4 then replace cloud step 3, and the\n   report adds that the cloud launch was refused and the run went local. Pointer: probe 3 in\n   [reference\u002Fgoal-probe.md](reference\u002Fgoal-probe.md).\n3. **Report** the session id and link it prints, plus the return paths: `claude --teleport \u003Cid>`\n   or `\u002Fteleport` to continue it in a terminal (its requirements: Pointer below), which needs the\n   same account; `claude -p \"\u003Cmessage>\" --cloud \u003Cid>` to queue a follow-up. Name\n   the account the CLI is signed in to now: the session's limits, teleport, follow-ups and plugin\n   loading all depend on that account (Pointer below).\n\n- **Pointer**: \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fclaude-code-on-the-web#start-a-cloud-session-from-your-terminal>,\n  \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fclaude-code-on-the-web#send-local-repositories-without-github>,\n  \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fclaude-code-on-the-web#manage-context> (`\u002Feffort` in a session),\n  \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fclaude-code-on-the-web#continue-a-cloud-session-in-your-terminal>,\n  \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fclaude-code-on-the-web#send-follow-ups-from-the-cli>; what the\n  session lacks: \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fcloud-environments#what-carries-over-from-your-setup>.\n\n## What the launched session inherits (and what it does not)\n\nThe launched agent is a NEW session, not a fork of this one. What it inherits is upstream\nbehavior; the rules below are ours, built on it.\n\n- **Pointer**: [Manage multiple agents with agent view § Settings and provider](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#settings-and-provider)\n  and [§ Permission mode, model, and effort](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fagent-view#permission-mode-model-and-effort)\n\nOur rules:\n\n- **CLI configuration is NOT inherited.** It carries none of the current session's CLI flags\n  (e.g. `--mcp-config`, `--settings`, `--add-dir`, `--plugin-dir`). Mirror onto the launch\n  command any such flags the resumed work depends on, and say so in the launch report.\n- **Model and effort are NOT inherited** from the current session's in-conversation choices.\n  They resolve from the launch command's own `--model` \u002F `--effort` flags and, absent those,\n  from the settings of the directory it starts in (project\u002Fuser settings, including `env`\n  values such as `ANTHROPIC_MODEL`). When the resumed work depends on a specific model or\n  effort, pass the flags explicitly and note them in the launch report.\n\n  For resumed verify work, and for any task the launched session runs unattended, pass an\n  explicit `--effort` so the work does not silently run at the default. At launch, read\n  model-config's\n  [Choose an effort level](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmodel-config#choose-an-effort-level)\n  table, pick the level whose described use fits the resumed task, and pass that level as\n  `--effort \"\u003Clevel>\"` in step 2's command, before the prompt argument. A task that changes code\n  or verifies it is never given a level below medium; skip any row the table says is not an\n  effort level. The value is one level name of lowercase letters only, never free text, for the\n  same reason the topic slug is sanitized. The launch report names the level and quotes the\n  matched use. When the page cannot be read, say so, pass no `--effort`, and state that the\n  session will start at its default level.\n\n  - **Pointer**: for choosing a level, see the table linked above; for the `--effort` flag, see\n    [Set the effort level](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmodel-config#set-the-effort-level).\n- **Permission mode is set at launch, not inherited.** Step 2's command always passes\n  `--permission-mode auto`, so a directory setting with another default mode does not set the\n  launched session's mode.\n- **Directory settings ARE read normally.** The session reads its settings from the directory\n  it runs in, the same as a fresh `claude` started there.\n\n## Post-launch enforcement checklist\n\nTick each item in the response so the user can verify the exit shape (in addition to the engine\ndoc's save-point items, which the sibling `handoff` skill's checklists mirror):\n\n- [ ] Explicit user intent for background delegation verified (hard gate). Absent intent →\n  save-point + `\u002Fclear`-then-paste exit, no launch, reason stated\n- [ ] Position panel emitted per the engine doc (\"Emit the position panel\"), ahead of the rails\n  prompt, OR an explicit line saying the units would not resolve, and none of its text included in\n  the prompt handed to the launched agent\n- [ ] Purpose text (when the invocation carried any) applied per the engine doc's tailoring rules\n  full path: brief lead, Suggested-skills selection, Remaining-actions order; prompt-only: the\n  inline `Purpose:` line between the rails, never discarded (the launched agent receives exactly\n  the rails prompt); a goal-conflicting purpose flagged rather than obeyed; never embedded in the\n  launch command. No purpose given → nothing to tick\n- [ ] Worktree claims handed to the successor (\"Produce the save-point\"): each worktree whose\n  lock names this session carries the handover before `check-enter` (OR none held)\n- [ ] Dirty-tree gate evaluated this turn: `git rev-parse --is-inside-work-tree` first, then\n  `git status --porcelain -uall` when it says `true`, ignoring save-point files under the handoff\n  location; effective `worktree.bgIsolation` read before judging other changes, and `none` → launch with the\n  edits-this-checkout-in-place warning in the report (`--settings` tier named as not covered);\n  otherwise other uncommitted changes without the linked-worktree exception → no launch, reason\n  reported, fallback to `\u002Fclear`-then-paste. Positively identified as not a git repository AND no\n  `WorktreeCreate` hook configured → launch, that reading stated in the report; any other\n  `rev-parse` result, failing or `false`, and any hook whose absence is not established → state\n  unknown, no launch, same fallback\n- [ ] Completion condition settled: an applying goal used (an active one → `\u002Fgoal clear` advised\n  in the report), or one drafted as case 2 says, shown as the goal region,\n  and launched only on the user's yes to it; a conversation-bound or already-met goal never\n  launched as it stands, only redrafted (case 2) or left unlaunched (case 3); none → no launch, the message saying how to supply\n  one, fallback to `\u002Fclear`-then-paste\n- [ ] Background agent launched (`claude --bg --name … --permission-mode auto`), the payload being\n  `\u002Fgoal`, a space and the goal region's between-rails text from `save_point.py emit \u003Cfile>` on\n  the full path (validated first, exit 0 quoted), or on prompt-only the goal region then the\n  resume region, counted within the limit; and the launch result reported (including any non-inherited flags mirrored or worth\n  flagging, and step 2's denied-action statement: auto mode may deny an action, the session keeps going past a denial, which\n  is in its transcript and `claude logs`, not promised in the final hand-off), OR the non-zero\n  exit reported with fallback to\n  `\u002Fclear`-then-paste\n- [ ] For resumed verify or unattended work, `--effort` passed with the model-config table's level\n  whose described use fits the task, the report naming the level and quoting that use; page unreadable → said so, no `--effort`, and the report states the session starts\n  at its default level\n- [ ] `--cloud` only: clean tree, fetched branch matching its upstream, prompt-only payload,\n  `--effort` passed as for `--bg` (CLI rejects it → relaunched without, `\u002Feffort` advised); the\n  report names the session id, the teleport and follow-up commands, and the signed-in account,\n  and says goal arming there is unprobed; a no-terminal refusal → local delivery, reported\n- [ ] **EXECUTION STOPS HERE**, no monitoring, no babysitting, no new work items\n\n## Boundary, native Claude Code surfaces\n\nThree built-in commands also keep work moving off this terminal, so \"continue in the background\"\ncan mean any of them.\n\n- **`\u002Fsubtask`, `\u002Ffork`, `\u002Fbackground` (built-in commands)**: three ways to move work off this\n  terminal. None writes a save-point, and this skill never runs them. What each launches, its\n  alias, its gate and whether the model can invoke it: the records table in\n  [native-surfaces § verification record](reference\u002Fnative-surfaces.md#native-background-surfaces-verification-record).\n- **This skill (marketplace plugin).** Writes a durable, redacted save-point, gates on a dirty\n  tree, and launches a fresh `claude --bg` session seeded only with the save-point's `\u002Fgoal`\n  payload, so the continuation carries no conversation history, survives on disk, and ends on a\n  checked condition.\n\n**Routing.** At the start of the run, offer them to the person, each instead of or alongside this\nskill. If \u002Fbackground is available in your session (gate basis: gated, per **Availability is\nnever assumed** below; records in\n[native-surfaces § verification record](reference\u002Fnative-surfaces.md#native-background-surfaces-verification-record)),\nyou can run it to detach this session as it is. If \u002Ffork is available in your session (gate basis:\ngated, per the same paragraph and records), you can run it to copy this session into a background\nsession. If \u002Fsubtask is available in your session (gate basis: gated, per the same paragraph and\nrecords), you can run it for a side task whose result should come back here. Prefer this skill\nwhen the continuation should start clean from a durable save-point. When the caller passes\n`--unattended`, the run makes no offer;\nwithout that flag it asks.\n\n**Mutation gate.** This skill writes the save-point and launches one session, only on explicit\nrequest. It never runs a native command on the person's behalf.\n\n**Availability is never assumed.** All three are gated, and their behavior depends on the\nsession's setup; read the gates live from the records table in\n[native-surfaces § verification record](reference\u002Fnative-surfaces.md#native-background-surfaces-verification-record). This\nsection states what to do when they resolve, never that they are present.\n\n## Gotchas\n\nFailure patterns are documented inline at the step that owns them: the `-uall` untracked-directory\ncollapse, the non-repo-plus-no-`WorktreeCreate`-hook vs. unknown split with its deliberately wide\nunknown default, and the ban on reusing the context block's git output (dirty-tree gate, step 1;\ncontext block), the no-inline-prompt rule and the session-persistence env requirement (launch\ncommand, step 2), slug sanitization (\"Arguments\"), and non-inheritance surprises. Model, effort,\nCLI flags (\"What the launched session inherits\").\n\n## What this skill does NOT do\n\n- **Does not launch without explicit user intent**. The hard gate above; the fallback exit is\n  the sibling `handoff` skill's `\u002Fclear`-then-paste shape\n- **Does not launch without a completion condition**. The completion condition gate above\n- **Does not commit**. Save-points are durable task state, not source code; the dirty-tree gate\n  reports other uncommitted work rather than committing or stashing it\n- **Does not monitor the launched agent**. The user manages it with `claude agents`\n- **Does not continue executing the underlying task in this session**. The background agent is\n  the continuation\n- **Does not restate the save-point engine**. Production lives in the shared engine doc\n",{"metadata":24,"description":7,"argument-hint":27,"user-invocable":28,"disable-model-invocation":20},{"summary":25,"workflow-stage":26},"Delegate the task to a fresh background agent now","session","[--unattended] [--cloud] [file|prompt] [topic] [purpose...]",true,"main","4f2dcaaff35e8f9fccc6a9f4d82a5830ab17a5c5","plugins\u002Fsession-flow\u002Fskills\u002Fcontinue-in-background",7,"https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins","https:\u002F\u002Fgithub.com\u002Fmelodic-software","https:\u002F\u002Fmelodicsoftware.com","Independent software studio building developer tools, automation, and application services, with roots in music.","2026-11-15 05:15:06",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":28},[40,43,46],{"tool":41,"command":42},"npx","npx skills add melodic-software\u002Fclaude-code-plugins --skill continue-in-background",{"tool":44,"command":45},"bunx","bunx skills add melodic-software\u002Fclaude-code-plugins --skill continue-in-background",{"tool":47,"command":48},"pnpm","pnpm dlx skills add melodic-software\u002Fclaude-code-plugins --skill continue-in-background","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Fcontinue-in-background\u002FSKILL.md",[51,57,61,65],{"path":52,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":55,"sourceHtmlUrl":56},"evals\u002Fevals.json","REFERENCE","参考文档",26329,"https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Fcontinue-in-background\u002Fevals\u002Fevals.json",{"path":58,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":59,"sourceHtmlUrl":60},"reference\u002Fdenial-probe.md",4096,"https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Fcontinue-in-background\u002Freference\u002Fdenial-probe.md",{"path":62,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":63,"sourceHtmlUrl":64},"reference\u002Fgoal-probe.md",3297,"https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Fcontinue-in-background\u002Freference\u002Fgoal-probe.md",{"path":66,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":67,"sourceHtmlUrl":68},"reference\u002Fnative-surfaces.md",2460,"https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fskills\u002Fcontinue-in-background\u002Freference\u002Fnative-surfaces.md",[70,77,84,91,96,103],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7DYYDG31B9YX7N9MB9QW2GW","track","Backlog reads through the bound tracker: search open and closed items, view one item with its comments and state history. Use when another skill searches or reads tracker items.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fevals\u002Frecall-still-reports-reopened-bug\u002Fwork-items-stub\u002Fskills\u002Ftrack\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7DYXVBAVG3NV30PA7GKW9Q6","reviewer-media","Reviewer media for one pull request: decides whether it needs a narrated walkthrough, builds the storyboard from \u002Freview:explain-change's digest, has \u002Fexplainer-video:produce render it and hands the manifest to \u002Fsource-control:pull-request media. Use when asked for 'reviewer media', 'a walkthrough video for this PR', 'a produced video of this change', or when pull-request ready or monitor hands a PR over.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Freview\u002Fskills\u002Freviewer-media\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7DYRZ5YD44AMYH26YR25GZ8","route","Model and effort per agent role (orchestrator, worker, verifier, retrieval) for a multi-agent run, resolved through the bundled defaults and the user, team and personal override config layers into fenced JSON with single-agent and fan-out variants and the layer behind each value. Use when asked 'which model for the subagents', 'route the roles' or 'model routing', or before a skill passes a role's model on a spawn.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fdiscovery\u002Fevals\u002Fex-model-pin-without-override\u002Fmulti-agent-stub\u002Fskills\u002Froute\u002FSKILL.md",[],[],{"skillNo":92,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7DYRTVT4FWTGDJY0HCCFJMZ","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fdiscovery\u002Fevals\u002Fex-model-override-from-route\u002Fmulti-agent-stub\u002Fskills\u002Froute\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M7DYNZC8PNW3T27V2ADKECKJ","principles","Module-design vocabulary for architecture findings, and the checks built on it. Use when: 'what is a deep module', 'what is a seam', 'deep vs shallow module', 'what is the deletion test', 'leverage and locality', 'module design vocabulary', 'which word do we use for X in architecture findings'. Scanning a codebase for friction is \u002Farchitecture:improve.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Farchitecture\u002Fskills\u002Fprinciples\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M7DYNMCZNEWBFHV9KTSS6H60","write","Structured five-field bug report (title, steps to reproduce, expected vs actual, justified severity, suggested fix location) from an informal description, read-only. Use when the user names a defect they observed, or asks for one written up ('report a bug', 'file a bug', 'write this up as a bug').","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Farchitecture\u002Fevals\u002Fdeepening-defect-goes-to-bugs-write\u002Fbugs-stub\u002Fskills\u002Fwrite\u002FSKILL.md",[],[]]