skills.rest
jota-batuta
jota-batutaCOMMUNITY
Explore all skills by this author →
GitHub

user-execution-guide

Generate operator-facing SPO.md files from planning artifacts for multi-wave task execution.

Updated Feb 20, 2026
Search Tags:#workflow#planning#guide#execution#operator#SPO
One-click install
npx skills add https://github.com/jota-batuta/batuta-dots --skill user-execution-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: user-execution-guide
Source: https://github.com/jota-batuta/batuta-dots/tree/main/BatutaClaude/skills/user-execution-guide
Command: npx skills add https://github.com/jota-batuta/batuta-dots --skill user-execution-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates operator-facing, step-by-step execution instructions from planning artifacts so humans can reliably run tasks.

Core Features & Use Cases

  • Produces a human-readable SPO aligned with the current Task Plan and PRD.
  • Outlines waves, sessions, and gates to guide operator actions and verifications.
  • Outputs openspec/changes/{change-name}/SPO.md to persist the SOP for audits and handoffs.

Quick Start

Invoke this skill after Task Plan Approval to generate the SPO.md for the operator.

Frequently Asked Questions about user-execution-guide

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

FAQPage Schema
How do I generate an operator execution guide from planning artifacts?▼

To generate an operator execution guide, you use planning context like the PRD, tasks.md, and design.md to produce a human-readable SPO. This SPO outlines waves, sessions, gates, and verification steps for reliable task execution.

What is an SPO in software factory task execution?▼

An SPO is an operator-facing Standard Procedure Outline that guides human operators through task execution. It applies to multi-wave task plans by outlining waves, sessions, gates, and verification steps to ensure reliable execution.

When do I need to create an SPO for a multi-wave task plan?▼

You need to create an SPO after Task Plan Approval to guide the operator. It is required for multi-wave task plans in software factories where humans need step-by-step instructions, gates, and verification steps to reliably run tasks.

Can I use a PRD and tasks.md to generate human-facing execution instructions?▼

Yes, you can use a PRD and tasks.md along with design.md as planning context to generate human-facing execution instructions. The process outputs a concise wave-by-wave execution plan and an SPO.md file for audits and handoffs.

What's the best way to outline waves and gates for human operators?▼

The best way to outline waves and gates for human operators is by generating a human-readable SPO from your planning artifacts. This aligns the current Task Plan and PRD into a structured procedure with sessions and verification steps.

Does generating an SPO require any external dependencies?▼

Generating an SPO does not require external dependencies, but it does require planning context. You must provide the PRD, tasks.md, and design.md files to produce the SPO.md and the wave-by-wave execution plan.

Related Skills

Explore More Software Engineering Skills→
JonnyCBBJonnyCBB

create-plan-tdd

Generate TDD implementation plans with wave-based task grouping and multi-persona reviews.

Community
Advanced
ArtRivArtRiv

gsd-execute-phase

Execute phase plans in dependency-aware parallel waves with subagents.

Community
Intermediate
mistakeknotmistakeknot
1

spec-sprint

Draft PRD-ready specs by orchestrating Arbiter, Ranger, and Forger into YAML/Markdown exports.

Community
Advanced
abrahamgreysonabrahamgreyson

gsd:plan-phase

Generate detailed execution plans from wave descriptions and acceptance criteria.

Community
Intermediate