---
name: iflow-pause
description: >-
  Park work on the current issue without closing it: update status, move
  the group to 02-partly-solved-issues/, optional WIP commit.
disable-model-invocation: true
issue-flow-version: 0.4.2a4
---

# issue-flow — issue pause (`/iflow-pause`)

Follow this skill to **park work on the current issue** without closing it. The issue is **not** done — this is not `/iflow-close`.


**Invoke:** type `iflow pause` in chat, or `/iflow-pause` from the slash menu (`iflow-pause` also works).




### MODEL & EXECUTION DIRECTIVE


**Profile: economy** — Prioritize speed and token economy over deep reasoning.

In Cursor: use **Auto** or a fast model before invoking this step.



Keep scope tight to what this step requires.




### Resolve project root (multi-root workspaces)

Before any `git`, `gh`, or `.issueflows/` path operation in this workflow:

**Resolution order** (stop when unambiguous):

1. **Explicit hints** in slash input — `root:<path>`, `repo:<folder-basename>` (directory name, e.g. `cellpy-core`), or `repo:owner/name`.
2. **CLI fast path** — `issue-flow agent resolve [-C <start>] [--from-file <active-file>] [--json]`. Use the returned `project_root` and `repo`; pass `-C <project_root>` to other `issue-flow agent …` subcommands. When the answer came from the workspace registry, the payload sets `resolved_via_workspace_default: true`.
3. **Branch context** — exactly one workspace repo whose branch matches `^\d+-` → that root.
4. **Single scaffold** — exactly one `.issueflows/` tree visible in the workspace → that root.
5. **Workspace default** — an `issueflow-workspace.toml` at the workspace root (created with `issue-flow workspace init`) may name a `default` member repo; use it when no scaffold matched above. Tell the user the default was used.
6. **Ambiguous** → **stop and ask**; never guess between sibling repos.

After resolution, treat the result as `<project_root>` and `<owner/repo>`:

- **Git:** `git -C <project_root> …` (or `issue-flow agent … -C <project_root>` for supported ops).
- **GitHub:** pass an explicit repo on every `gh` call — never rely on `gh`'s implicit cwd default. For most commands use `--repo <owner/repo>`; **exception:** `gh repo view` takes the repo as a **positional** arg (`gh repo view <owner/repo> …`) and rejects `--repo`.
- **Paths:** all `.issueflows/…` paths are under `<project_root>`.

When `.issueflows/04-designs-and-guides/multi-repo-workspaces.md` exists, read it for layout and cross-repo guidance.

## Instructions

1. **Find the focus issue.** In `.issueflows/01-current-issues/`, identify the `issue<N>_*` group. If multiple groups exist and the focus is ambiguous, ask. If none exist, **stop** and say there is nothing to pause.

2. **Update `issue<N>_status.md`.** Create or update it under `.issueflows/01-current-issues/` with:
   - `- [ ] Done` (must remain **unchecked** — a pause is not a close).
   - **Done so far** — short bullets of what has landed or been tried.
   - **Remaining work** — explicit next steps so work can resume later.
   - **Paused on** — date, branch name, any blockers.

   Preserve earlier user-written content; only add or update these sections. If the user passed a short note after `/iflow-pause`, use it verbatim as the **Remaining work** text.

3. **Move the issue group.** Move every `issue<N>_*` file from `.issueflows/01-current-issues/` to `.issueflows/02-partly-solved-issues/`. Report each move.

4. **Working-tree guard.** Run `git status --porcelain`. Report what is dirty, then offer — as **one** consolidated prompt — any combination of:
   - **WIP commit** — stage tracked changes and commit `WIP: pause issue #<N> — <short note>`. List untracked files separately and ask before including them.
   - **Switch to default branch** — detect default (prefer `gh repo view --json defaultBranchRef -q .defaultBranchRef.name`, else `git symbolic-ref --quiet --short refs/remotes/origin/HEAD`, else `main`) and run `git switch <default>`. Only after the WIP commit if the tree is dirty.
   - **Stay put** — leave branch and working tree untouched.

5. **Report.** Summarize the status update, the issue-group moves, working-tree actions taken, and remind the user how to resume (running `/iflow-capture <N>` re-opens the archived issue after its archived-issue guard, or they can simply switch back to the issue branch).

## Constraints

- The focus issue's `- [ ] Done` checkbox **must** stay unchecked. `/iflow-pause` is not `/iflow-close`.
- Do not delete branches. Do not `git reset`, `git stash drop`, or force-push.
- Do not open a PR. Do not bump versions. Do not run tests.