plan-execute

Enforces a gated plan-then-execute workflow for multi-file features and refactorings.

3|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/ruskicoder/system-prompts --skill plan-execute-ruskicoder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-execute
Source: https://github.com/ruskicoder/system-prompts/tree/main/prompt-orchestrator/.opencode/skills/plan-execute
Command: npx skills add https://github.com/ruskicoder/system-prompts --skill plan-execute-ruskicoder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Non-trivial code changes often fail because AI agents jump straight into editing without understanding blast radius, existing patterns, or scope boundaries. This Skill enforces a strict separation between read-only planning and approved execution so changes stay predictable and reviewable. ## Core Features & Use Cases - Intent Gating: Explicitly separates PLAN mode (research, no file changes) from EXECUTE mode (implement only the approved plan), preventing scope creep. - Impact-Aware Planning: Uses GitNexus queries (context, query, impact, detect_changes) to map blast radius and compare at least two implementation approaches before committing. - Verification & Reporting: Runs real test verification, linting, scope checks via detect_changes, and produces a deviation report after execution. - Use Case: When asked to add rate limiting to an API, the agent first researches middleware patterns, presents a plan with risk assessment, waits for approval, then implements and verifies the change. ## Quick Start Invoke the plan-execute workflow with a feature or refactoring goal, such as asking the agent to plan and then implement rate limiting for the API.

Frequently Asked Questions about plan-execute

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make an AI agent plan before editing code?▼

Use a plan-then-execute workflow that gates the agent into a read-only PLAN mode for research and proposal, then switches to EXECUTE mode only after user approval. This prevents unreviewed file changes and scope creep.

What is blast radius analysis before refactoring?▼

Blast radius analysis maps which files and interfaces depend on the code you plan to change. This workflow uses GitNexus impact queries in the upstream direction to identify affected areas before designing the solution.

When should I use plan-execute instead of direct editing?▼

Use it for complex features, multi-file refactorings, or moderate-risk changes where requirements are clear but implementation is non-trivial. Skip it for trivial single-file fixes where planning overhead exceeds the risk.

What is the token budget for a plan-execute workflow?▼

The typical budget is 15K-60K tokens with a recommended maximum of 100K. Beyond 100K tokens, the workflow recommends switching to spec-driven development or session summarization.

Why does the agent add unplanned changes during execution?▼

This happens when plan and execute modes are mixed. The workflow's sanity check phase uses detect_changes to confirm the actual diff matches the approved plan and flags any deviations or orphaned code.