execute-story

Locate a story, prepare its worktree, and run a tmux worker session.

13|1|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/Roeia1/SAGA --skill execute-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: execute-story
Source: https://github.com/Roeia1/SAGA/tree/main/plugin/skills/execute-story
Command: npx skills add https://github.com/Roeia1/SAGA --skill execute-story

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initiates autonomous story implementations by coordinating discovery of the target story, preparing its worktree, and launching a worker session to automate execution, reducing manual setup and context switching.

Core Features & Use Cases

  • Orchestrates story discovery and worktree preparation to streamline autonomous execution.
  • Handles single-session workflow with strict task boundaries and commit discipline.
  • Provides disambiguation when multiple matching stories exist, or reports clear errors when none are available.

Quick Start

Provide a story-id to initiate autonomous story implementation.

Frequently Asked Questions about execute-story

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

FAQPage Schema
How do I automate story implementation from start to commit?

Autonomous story implementation is automated by locating the target story, preparing its worktree, and launching a tmux worker session that executes the task and commits changes to the repository.

How does autonomous story execution handle multiple matching stories?

Autonomous story execution handles multiple matching stories by triggering a disambiguation process, ensuring you select the correct target before preparing the worktree and launching the worker session.

Can I run multiple story implementations in a single worker session?

Running multiple story implementations in a single session is not supported; the workflow enforces a strict one-task-per-session boundary to maintain commit discipline and autonomous execution focus.

What do I need to provide to start autonomous story execution?

To start autonomous story execution, you need to provide a story-id so the worker can locate the target story, prepare the worktree, and run the tmux session automatically.

Why does autonomous story execution report an error instead of starting?

Autonomous story execution reports a clear error instead of starting when no matching stories are available in the repository, preventing the worker session from launching on invalid targets.

Does autonomous story execution use tmux for worker sessions?

Autonomous story execution uses tmux workers to run the implementation sessions, isolating the worktree preparation and task execution within a strict single-task workflow boundary.