iflow-yolo

name	iflow-yolo
description	Chain init → plan → start → close yolo for a small, low-risk issue under one consolidated confirm. Stops on any ambiguity.
disable-model-invocation	true
issue-flow-version	0.4.2a4

issue-flow — issue yolo (/iflow-yolo)

Follow this skill to blast through a small, low-risk issue in one shot, with no mid-run confirmation checkpoints beyond the single consolidated confirm.

Use only for minor fixes, doc tweaks, and similar low-risk changes. Anything non-trivial should go through the individual commands.

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

MODEL & EXECUTION DIRECTIVE

Profile: reasoning — Prioritize deep thinking and careful trade-offs over speed or token economy.

In Cursor: switch to a thinking-capable model before invoking this step (not Auto-only).

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: always gh … --repo <owner/repo> — never rely on gh's implicit cwd default.
• 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.

Preflight (abort on any failure)

1. Refuse on default branch. If the current branch is main / master / the detected default, stop and tell the user to create or switch to an issue branch first. Do not silently create one from yolo.

2. Refuse with dirty unrelated changes. Run git status --porcelain. If anything uncommitted is not clearly part of the target issue, ask once; if still unclear, stop. Suggest committing or stashing first.

3. Tests must pass up front. Run uv run pytest (or the repo's documented test command). On any failure, stop before the chain starts.

4. Single consolidated confirm. Present the full planned chain explicitly (issue reference, target branch, repo, downstream commands including any bump / patch / draft / stay flags). Require an explicit yes; any other input aborts. (When /iflow-pick routed here via the yolo issue label, its combined confirmation already covered this — do not ask twice.)

Chain

Once preflight has passed and the user confirmed:

1. /iflow-init — capture the issue (or skip if *_original.md already exists for the focus issue).
2. /iflow-plan — write a short issue<N>_plan.md (Goal + Approach + Files to touch + Test strategy). Auto-confirm — the consolidated confirm above covered it. If the scope check reveals the change is not actually small, abort the yolo chain and tell the user to run the commands individually.
3. /iflow-start — implement the plan without an additional plan-mode prompt.
4. Re-run tests. uv run pytest again. On failure, stop before commit / push / PR.
5. /iflow-close yolo — run the close flow with the yolo token (plus forwarded bump / log / nohistory / draft / stay tokens). The yolo token makes close hands-off: changelog bullet written without a confirm prompt; PR listed/reused via gh pr list, then merged via gh pr merge --squash (on pending checks: gh pr checks --watch --fail-fast for up to 15 minutes, then retry merge; --squash --auto only as last resort when the cap elapses or checks never register), then default-branch switch + git pull --ff-only. draft conflicts with auto-merge — when passed, skip the merge and say so. Do not chain /iflow-cleanup automatically — local branch deletion stays a user decision.

Post-run

Report the PR URL, the merge result (merged, or queued via --auto), and the final branch. By default /iflow-close yolo merges the PR and switches back to the default branch with a pull; forwarded stay text leaves the user on the issue branch instead. Remind them that /iflow-cleanup will delete the now-merged local branch when they are ready.

Constraints

• Do not override downstream commands' own constraints (no -D, no force-push, etc.). /iflow-yolo is a chain, not a free pass.
• If any downstream step requires a human decision (unrelated changes in git status, ambiguous version bump, merge conflict, failed test), stop and hand back to the user.
• Never run /iflow-cleanup from this skill. Branch deletion always needs the user to see the merged PR first.