spec-kitty-runtime-next

Execute spec-kitty next runtime decisions for mission step advancement.

Updated May 13, 2026
One-click install
npx skills add https://github.com/kimprobably/maestro-os --skill spec-kitty-runtime-next
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-kitty-runtime-next
Source: https://github.com/kimprobably/maestro-os/tree/main/.claude/skills/spec-kitty-runtime-next
Command: npx skills add https://github.com/kimprobably/maestro-os --skill spec-kitty-runtime-next

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you reliably advance a Spec Kitty mission step-by-step, including handling WP-level iteration and doctrine-scoped context, so you can keep progress moving and interpret runtime decisions correctly.

Core Features & Use Cases

  • Canonical runtime control loop: Drives the mission forward using the single entry point spec-kitty next and the returned decision kind (step, decision_required, blocked, terminal).
  • WP iteration without step advancement: Ensures implement/review steps can return different WP IDs while keeping the same step_id until all WPs reach terminal/handoff lanes.
  • Doctrine-aware, action-scoped context loading: Loads agent profile at init and refreshes governance context at each step boundary, with bootstrap-vs-compact loading and on-demand directive/tactic pulls.
  • Decision interpretation and safety checks: Guides handling of guard_failures, prompt_file null cases, and the “completed missions return step” workaround.

Quick Start

Use the AI to run the canonical loop by repeatedly calling spec-kitty next --agent <agent> --mission <mission-slug> --json, executing the returned prompt when kind is step, answering when kind is decision_required, resolving blockers when kind is blocked, and running final acceptance when kind is terminal.

Frequently Asked Questions about spec-kitty-runtime-next

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

FAQPage Schema
How do I automate mission orchestration when a workflow step is stalled or blocked?

Mission orchestration for stalled workflows is automated by running the canonical runtime control loop, which applies doctrine-aware action context loading to interpret decision kinds, resolve guard failures, and advance blocked steps. It repeatedly executes the returned prompt to drive the mission forward.

What is a runtime control loop and how does it handle agent context during mission execution?

A runtime control loop drives mission execution by loading an agent profile at initialization and refreshing governance context at each step boundary. It uses bootstrap-versus-compact loading and pulls directives or tactics on-demand to maintain doctrine-aware agent context.

How do I iterate on implement and review steps without advancing the mission step ID?

To iterate on implement and review steps without advancing the step ID, the runtime control loop keeps the same step_id while returning different WP IDs. This continues until all WPs reach terminal or handoff lanes, ensuring WP-level iteration without step advancement.

Why does a completed mission return a step instead of terminating, and how do I handle it?

A completed mission returning a step is a known workaround in the runtime control loop. You handle it by checking the returned decision kind; when the kind is terminal, you run final acceptance instead of executing the prompt as a standard step.

What should I do when guard conditions fail or the prompt file is null during workflow automation?

When guard conditions fail or the prompt file is null during workflow automation, the runtime control loop requires strict handling by interpreting the returned decision kind as blocked. You must resolve the underlying blockers before the mission can advance safely.

Does mission orchestration require any specific dependencies to run the runtime control loop?

Mission orchestration via the runtime control loop requires no external dependencies. It operates independently using the canonical entry point to execute mission steps, handle decision kinds, and manage doctrine-scoped context loading during stalled or blocked workflows.