amoa-two-phase-mode

Coordinate plan-then-execute workflows with GitHub issues, YAML state files, and verification polls.

13|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/Emasoft/ai-maestro-orchestrator-agent --skill amoa-two-phase-mode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: amoa-two-phase-mode
Source: https://github.com/Emasoft/ai-maestro-orchestrator-agent/tree/main/skills/amoa-two-phase-mode
Command: npx skills add https://github.com/Emasoft/ai-maestro-orchestrator-agent --skill amoa-two-phase-mode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, gh, and includes references (resource) components.

What problem does it solve?

This Skill removes manual coordination overhead by turning high-level project goals into a governed plan-and-execute workflow that assigns, verifies, and monitors work across AI and human implementers so projects complete reliably and audibly.

Core Features & Use Cases

  • Two-Phase Workflow: Clear Plan Phase (requirements, architecture, modules) and Orchestration Phase (assignments, execution, verification).
  • Instruction Verification & Updates: Mandatory pre-start verification and a 5-step update verification flow to prevent misunderstandings and unsafe changes.
  • Proactive Polling & 3-Choice Rule: Periodic 10–15 minute polls with six mandatory questions and a strict triage rule for implementer issues (explain, rewrite, escalate).
  • GitHub & Task Persistence: Creates GitHub issues for modules, maintains YAML state files, and uses Claude-native tasks for persistence across context compacting.
  • Stop Hook Enforcement: Phase-aware stop hook blocks exit until plan/orchestration exit criteria and multi-loop verification are satisfied.
  • Typical Use Case: Preparing a multi-agent engineering project where plans become GitHub-tracked modules assigned to AI or human implementers with enforced verification.

Quick Start

Start planning for "Implement user authentication" then approve the plan and begin orchestration to register agents, assign modules, and start polling implementers.

Frequently Asked Questions about amoa-two-phase-mode

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

FAQPage Schema
How do I coordinate multi-agent implementation projects with plan-then-execute workflows?

Multi-agent implementation projects can be coordinated by breaking user goals into modules, creating GitHub issues, and registering AI and human agents for assigned tasks. This plan-then-execute workflow enforces periodic polling and verification loops to monitor progress audibly.

What is instruction verification in multi-agent orchestration?

Instruction verification in multi-agent orchestration is a mandatory pre-start protocol that runs checks before execution begins. It prevents misunderstandings and unsafe changes by enforcing a 5-step update verification flow for all implementer actions.

How do I sync GitHub issues with AI agents for project task tracking?

You can sync GitHub issues with AI agents by using the gh command line tool to create and track modules from a YAML state file. This process assigns registered human or AI implementers to specific GitHub issues and monitors their progress.

Can I enforce verification loops before an AI agent exits a task?

Yes, verification loops can be enforced before task exit using a phase-aware stop hook. This hook blocks completion until plan and orchestration exit criteria, including multi-loop verification and mandatory polling questions, are fully satisfied.

Do I need the gh CLI installed to manage GitHub issues for orchestration?

Yes, the gh CLI is a required dependency for managing GitHub issues during orchestration. It is used alongside pyyaml to maintain YAML state files and sync tasks across your registered agents.

What are the limitations of using polling for multi-agent orchestration?

Polling limitations include mandatory 10–15 minute intervals where six mandatory questions must be answered, and implementer issues are strictly triaged using a 3-choice rule to explain, rewrite, or escalate, which may slow down rapid iterations.