What problem does it solve? Multi-file repository changes often involve several plausible implementation plans, and picking one without evidence leads to collisions, unsafe mutations, or wasted work. This Skill runs a bounded Graph-of-Thoughts search that generates, scores, refutes, and selects a single plan before any file is mutated, with hard halts on hazards like secrets, live worktrees, or budget exhaustion. ## Core Features & Use Cases - Evidence-gated plan selection: Generates competing plans, scores them on coverage, evidence, feasibility, safety, and efficiency, then refutes, improves, aggregates, and selects one deterministic winner. - Sandboxed mutation pipeline: Only the selected plan mutates an isolated origin/main worktree; patches are validated, applied via clamped Bash helpers, and attested with diff digests before any review stage. - Budget and safety controls: Light (55), standard (110), and deep (200) agent-call ceilings, macOS sandbox-exec gated acceptance checks, credential-stripped environments, and explicit halt reasons with resolutions. - Use Case: A developer needs a change spanning several files in a production repo. They invoke the skill with the repo path, scope, and a standard budget; the workflow scouts hazards, researches evidence, selects one plan, applies it in an isolated worktree, runs gated checks, and writes a handoff at .suede-graph-flo-xr/<runKey>/handoff.md. ## Quick Start Ask the agent to run suede-graph-flo-xr on your repository with an absolute repo path, a description of the multi-file change, and a chosen budget of light, standard, or deep.
