maestro

Orchestrate deterministic SDLC workflows by dispatching tasks to subagents with human-gated state transitions.

3|Updated Jul 1, 2026
One-click install
npx skills add https://github.com/KeyValueSoftwareSystems/maestro --skill maestro-keyvaluesoftwaresystems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maestro
Source: https://github.com/KeyValueSoftwareSystems/maestro/tree/main/skills/maestro
Command: npx skills add https://github.com/KeyValueSoftwareSystems/maestro --skill maestro-keyvaluesoftwaresystems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of inconsistent, improvised AI agent behavior by enforcing a deterministic, repeatable SDLC workflow that ensures every team member follows the same steps, gates, and quality standards.

Core Features & Use Cases

  • Deterministic Orchestration: Uses a stdlib-Python engine to manage workflow state, ensuring the LLM acts only as a dispatcher rather than an improviser.
  • Human-in-the-loop Gates: Enforces mandatory human approval for irreversible decisions and artifact reviews, preventing silent drift.
  • Use Case: A platform team can define a standard feature development pipeline—from PRD creation to QA and release—that every developer executes identically within their own IDE.

Quick Start

Run the maestro skill to initialize or resume a feature workflow by providing the feature slug and following the engine prompts.

Frequently Asked Questions about maestro

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

FAQPage Schema
How do I enforce deterministic SDLC workflows for AI agents?

Enforce deterministic SDLC workflows for AI agents by using a Python engine to dispatch tasks to subagents, managing state transitions, and preventing improvised behavior through strict, version-controlled orchestration.

Can I require human approval for irreversible decisions during AI agent orchestration?

Yes, you can require human approval for irreversible decisions during AI agent orchestration by setting up human-in-the-loop gates, ensuring mandatory review for artifact approvals and preventing silent workflow drift.

Do I need a local Python environment to run deterministic workflow orchestration?

Yes, you need a local Python 3.8+ environment to run deterministic workflow orchestration, as it is required to execute the engine-served action loop and maintain the run ledger within your IDE.

What is the best way to standardize feature development pipelines across a team?

The best way to standardize feature development pipelines across a team is to define a deterministic workflow from PRD creation to QA and release, ensuring every developer executes identical steps and quality gates within their IDE.

How does state management work for deterministic software development lifecycles?

State management for deterministic software development lifecycles works by using a stdlib-Python engine to track workflow state, ensuring the LLM acts only as a dispatcher and managing human-gated state transitions.

Why does my AI agent improvise instead of following a standardized release workflow?

Your AI agent improvises instead of following a standardized release workflow because it lacks deterministic orchestration; enforcing a repeatable SDLC workflow with managed state transitions and human gates eliminates this inconsistent behavior.