Devise

/rune:devise — Multi-Agent Planning Workflow

Load skills: roundtable-circle, context-weaving, rune-orchestration, elicitation, team-sdk

Orchestrates a planning pipeline using Agent Teams with dependency-aware task scheduling.

Usage

/rune:devise                              # Full pipeline (brainstorm + research + validate + synthesize + shatter? + forge + review)
/rune:devise --quick                      # Quick: research + synthesize + review only (skip brainstorm, forge, shatter)
/rune:devise --brainstorm-context PATH    # Skip Phase 0, use existing brainstorm workspace for rich research context

Legacy Flags (still functional, undocumented)

/rune:devise --no-brainstorm              # Skip brainstorm only (granular)
/rune:devise --no-forge                   # Skip forge only (granular)
/rune:devise --no-arena                   # Skip Arena only (granular)
/rune:devise --no-verify-research          # Skip research output verification (Phase 1C.5)
/rune:devise --exhaustive                 # Exhaustive forge mode (lower threshold, research-budget agents)
/rune:devise --brainstorm                 # No-op (brainstorm is already default)
/rune:devise --forge                      # No-op (forge is already default)

Pipeline Overview

Phase -1: Team Bootstrap (TeamCreate + state file — enables ATE-1 enforcement)
    ↓
Phase 0: Gather Input (3 paths: --brainstorm-context → read workspace, --quick → skip, default → delegate to brainstorm protocol)
    ↓
Phase 0.2: Source Image Analysis (conditional — fetch + vision describe source_images from plan frontmatter)
    ↓
Phase 1: Research (up to 10 agents, conditional — join existing team)
    ├─ Phase 1A: LOCAL RESEARCH (always — repo-surveyor, echo-reader, git-miner, wiring-cartographer, activation-pathfinder)
    ├─ Phase 1B: RESEARCH DECISION (talisman plan config bypass, risk + local sufficiency scoring, URL sanitization)
    ├─ Phase 1C: EXTERNAL RESEARCH (conditional — practice-seeker + Context7 MCP, lore-scholar + Context7)
    ├─ Phase 1C.5: RESEARCH VERIFICATION (conditional — research-verifier, serial/blocking)
    └─ Phase 1D: SPEC VALIDATION (always — flow-seer)
    ↓ (all research tasks converge)
Phase 1.5: Research Consolidation Validation (AskUserQuestion checkpoint)
    ↓
Phase 1.8: Solution Arena (competitive evaluation — skip with --quick or --no-arena)
    ↓
Phase 2: Synthesize (lead consolidates findings, detail level selection)
    ↓
Phase 2.3: Predictive Goldmask (risk scoring + wisdom advisories — skip with --quick)
    ↓
Phase 2.5: Shatter Assessment (complexity scoring → optional decomposition)
    ↓
Phase 3: Forge (default — skipped with --quick)
    ↓
Phase 4: Plan Review (scroll review + optional iterative refinement)
    ↓
Phase 4.5: Technical Review (optional — decree-arbiter + knowledge-keeper)
    ↓
Phase 4D: Grounding Gate (ALWAYS — evidence-verifier + assumption-slayer, even with --quick)
    ↓
Phase 6: Cleanup & Present (shutdown teammates, TeamDelete, present plan)
    ↓
Output: plans/YYYY-MM-DD-{type}-{name}-plan.md
        (or plans/YYYY-MM-DD-{type}-{name}-shard-N-plan.md if shattered)

Workflow Lock (planner)

const lockConflicts = Bash(`cd "${CWD}" && source plugins/rune/scripts/lib/workflow-lock.sh && rune_check_conflicts "planner"`)
// Planner conflicts are ADVISORY only — inform, never block
if (lockConflicts.includes("CONFLICT") || lockConflicts.includes("ADVISORY")) {
  warn(`Active workflow(s) detected:\n${lockConflicts}`)
}
Bash(`cd "${CWD}" && source plugins/rune/scripts/lib/workflow-lock.sh && rune_acquire_lock "devise" "planner"`)

Phase -1: Team Bootstrap

Creates the Agent Team before any agents spawn using the teamTransition protocol (6-step: validate → TeamDelete with retry → filesystem fallback → TeamCreate with "Already leading" recovery → post-create verification → state file write). Enables ATE-1 enforcement for all subsequent phases.

See [team-bootstrap.md](references/team-bootstrap.md) for the full protocol.

Phase 0: Gather Input

Three paths based on flags:

1. --brainstorm-context PATH: Read existing brainstorm workspace. Skip brainstorm entirely. Inject workspace context (advisor research, decisions, quality score, scope classification, effort estimate) into Phase 1 research agents. Quality score from workspace-meta.json determines confidence level (>= 0.70: high-confidence, = 0.9), sparse research ( proceed with available data

Comprehensive only: Re-runs flow-seer on the drafted plan for a second SpecFlow pass

See [synthesize.md](references/synthesize.md) for the full protocol.

Phase 2.3: Predictive Goldmask

Runs predictive risk analysis on files likely affected by the plan. Supports 3 depth modes (basic/enhanced/full); v3.x defaults to basic (see references/v3-defaults.md).

Skip conditions: --quick mode, non-git repo. (Goldmask + devise predictive layer are always enabled in v3.x.)

See [goldmask-prediction.md](references/goldmask-prediction.md) for the full protocol — depth modes, agent spawning, plan injection, and error handling.

Phase 2.5: Shatter Assessment

Skipped when --quick is passed. Assesses plan complexity and optionally decomposes into shards or hierarchical children.

Complexity Scoring

| Signal | Weight | Threshold | |--------|--------|-----------| | Task count | 40% | >= 8 tasks | | Phase count | 30% | >= 3 phases | | Cross-cutting concerns | 20% | >= 2 shared deps | | Estimated effort | 10% | >= 2 L-size phases |

Score >= 0.65: Offer shatter. Score address before presenting; CONCERN verdicts -> include as warnings Iterative: Max 2 refinement passes for HIGH severity issues

See [plan-review.md](references/plan-review.md) for the full protocol.

Phase 4D: Grounding Gate (ALWAYS runs)

Mandatory anti-hallucination gate. Runs evidence-verifier + assumption-slayer to verify plan solutions are grounded in codebase reality. Even with --quick, this phase runs — a fast-but-wrong plan wastes more time than a slower-but-correct one.

Inputs: Plan document, timestamp Outputs: tmp/plans/{timestamp}/grounding-evidence.md, tmp/plans/{timestamp}/grounding-assumptions.md Error handling: BLOCK verdict (grounding auto-fix + 1 retry; still BLOCK -> present with warnings Agents: grounding-evidence-verifier, grounding-assumption-slayer

See [plan-review.md](references/plan-review.md) Phase 4D section for the full protocol.

Phase 6: Cleanup & Present

Standard 5-component team cleanup: dynamic member discovery (with 30+ member fallback array covering all conditional phases), shutdown_request broadcast, grace period, retry-with-backoff TeamDelete (4 attempts), process-level kill + filesystem fallback (QUAL-012 gated), workflow lock release, then present plan to user.

See [phase6-cleanup.md](references/phase6-cleanup.md) for the full cleanup protocol.

Output

Plan file written to: plans/YYYY-MM-DD-{type}-{feature-name}-plan.md

Filename convention: plans/YYYY-MM-DD-{type}-{feature-name}-plan.md

Type options: feat, fix, refactor, docs, test, chore

Filename examples:

• plans/2026-02-12-feat-user-authentication-plan.md
• plans/2026-02-12-fix-checkout-race-condition-plan.md
• plans/2026-02-12-refactor-api-client-plan.md
• plans/2026-02-12-docs-api-reference-plan.md
• plans/2026-02-12-test-auth-flow-plan.md
• plans/2026-02-12-chore-deps-update-plan.md

After presenting the plan, offer next steps using AskUserQuestion:

• /rune:strive → Skill("rune:strive", plan_path)
• /rune:forge → Skill("rune:forge", plan_path)
• Open in editor → Bash("open plans/${path}") (macOS)
• Create issue → See [issue-creation.md](../rune-orchestration/references/issue-creation.md)

Issue Creation

See [issue-creation.md](../rune-orchestration/references/issue-creation.md) for the full algorithm.

Read and execute when user selects "Create issue".

Error Handling

| Error | Recovery | |-------|----------| | Research agent timeout (>5 min) | Proceed with partial research | | Research verification timeout (>5 min) | Proceed with unverified research + warning | | No git history (git-miner) | Skip, report gap | | No echoes (echo-reader) | Skip, proceed without history | | Solution Arena: all solutions killed | Recovery protocol — relax constraints, re-evaluate (see solution-arena.md) | | Solution Arena: sparse research (5 min) | Proceed with partial enrichment | | Forge: no agent above threshold | Use inline generic Task prompt for standard enrichment | | Predictive Goldmask agent failure | Non-blocking — proceed with partial data or skip injection | | Predictive Goldmask: enhanced budget exceeded | Fallback to basic mode (2 agents) | | TeamCreate failure ("Already leading") | Catch-and-recover via teamTransition protocol | | TeamDelete failure (cleanup) | Retry-with-backoff (4 attempts), filesystem fallback | | Scroll review finds critical gaps | Address before presenting | | Plan review BLOCK verdict | Address blocking issues before presenting plan | | Grounding Gate: evidence score 5 min) | Proceed with warning "Plan not grounding-verified" |

Guardrails

Do not generate implementation code, test files, or configuration changes. This command produces research and plan documents only. If a research agent or forge agent starts writing implementation code, stop it and redirect to plan documentation. Code examples in plans are illustrative pseudocode only.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: vinhnxv
• Source: vinhnxv/rune
• License: MIT

Install and usage instructions live in the source repository linked above.