bmad-loop-resolve

Resolve frozen specification ambiguities during paused bmad-loop orchestrator runs.

Updated Jul 11, 2026
One-click install
npx skills add https://github.com/marcmontecalvo/kinward --skill bmad-loop-resolve-marcmontecalvo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-loop-resolve
Source: https://github.com/marcmontecalvo/kinward/tree/main/.agents/skills/bmad-loop-resolve
Command: npx skills add https://github.com/marcmontecalvo/kinward --skill bmad-loop-resolve-marcmontecalvo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves critical contradictions or ambiguities in frozen specifications that cause the bmad-loop orchestrator to pause, preventing stalled development workflows.

Core Features & Use Cases

  • Interactive Escalation Resolution: Facilitates a structured dialogue between the AI and a human to clarify ambiguous requirements.
  • Spec Correction: Updates the frozen specification to ensure future automated dev and review sessions have a single, authoritative source of truth.
  • Use Case: When a development session hits a contradiction in the spec and pauses, use this skill to present the conflict to the human, record their decision, and update the spec so the orchestrator can resume the story.

Quick Start

Invoke the bmad-loop-resolve skill followed by the specific story key to begin the interactive resolution process for a paused orchestrator run.

Frequently Asked Questions about bmad-loop-resolve

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

FAQPage Schema
How do I resolve critical ambiguities in frozen specifications during paused orchestrator runs?

Resolving critical ambiguities in frozen specifications during paused orchestrator runs requires a human-in-the-loop dialogue to clarify conflicts, update implementation artifacts, and enable story resumption.

What is human-in-the-loop workflow automation for spec resolution?

Human-in-the-loop workflow automation for spec resolution is a process that facilitates structured dialogue between AI and humans to clarify ambiguous requirements, correct frozen specifications, and ensure automated development continues with a single source of truth.

How do I update frozen markdown specification files when a development workflow stalls?

To update frozen markdown specification files when a development workflow stalls, you resolve contradictions by capturing human decisions and modifying the spec artifacts directly to restore orchestrator functionality.

Do I need access to the run directory and context JSON to resolve orchestrator escalations?

Yes, resolving orchestrator escalations requires access to the run directory, context JSON, and the ability to modify markdown specification files to successfully update implementation artifacts and resume the paused story.

Why does the bmad-loop orchestrator pause during automated development sessions?

The bmad-loop orchestrator pauses during automated development sessions when it encounters critical contradictions or ambiguities in frozen specifications, preventing stalled workflows until a human clarifies the ambiguous requirements.

What is the best way to resume a stalled orchestrator run after a spec contradiction?

The best way to resume a stalled orchestrator run after a spec contradiction is to invoke an interactive escalation resolution process that records human decisions and updates the frozen specification to establish an authoritative source of truth.