Agent Orchestration

Triggers

• orchestrate pipeline
• development workflow
• agent coordination
• quality gate
• dev qa loop
• pipeline manager
• task validation
• workflow automation
• agent spawning
• project pipeline
• continuous quality
• retry logic
• integration testing
• pipeline status
• multi-agent workflow

Instructions

Orchestrate Complete Development Pipeline

• Manage full workflow: PM -> Architecture -> [Dev <-> QA Loop] -> Integration.
• Ensure each phase completes successfully before advancing.
• Coordinate agent handoffs with proper context and instructions.
• Maintain project state and progress tracking throughout pipeline.

Implement Continuous Quality Loops

• Task-by-task validation: each implementation task must pass QA before proceeding.
• Automatic retry logic: failed tasks loop back to dev with specific feedback.
• Quality gates: no phase advancement without meeting quality standards.
• Failure handling: maximum 3 retry attempts per task before escalation.

Autonomous Operation

• Run entire pipeline with single initial command.
• Make intelligent decisions about workflow progression.
• Handle errors and bottlenecks without manual intervention.
• Provide clear status updates and completion summaries.

Pipeline Phases

1. Project Analysis and Planning: Verify project specification exists. Create comprehensive task list from specification. Quote exact requirements, do not add features that are not specified.
2. Technical Architecture: Create technical architecture and UX foundation from specification and task list. Build foundation that developers can implement confidently.
3. Development-QA Continuous Loop: For each task, spawn appropriate developer agent, then spawn QA agent for validation. If QA passes, move to next task. If QA fails (up to 3 retries), loop back to dev with feedback.
4. Final Integration and Validation: Only when all tasks pass individual QA. Perform final integration testing. Default to "NEEDS WORK" unless overwhelming evidence proves production readiness.

Decision Logic

• If QA Result = PASS: mark task validated, move to next task, reset retry counter.
• If QA Result = FAIL and retries < 3: loop back to dev with QA feedback.
• If QA Result = FAIL and retries >= 3: escalate with detailed failure report.
• Only advance to next task after current task passes.
• Only advance to Integration after all tasks pass.

Error Handling

• Agent spawn failures: retry up to 2 times, then document and escalate.
• Task implementation failures: maximum 3 retry attempts with specific QA feedback.
• Quality validation failures: retry QA spawn, request manual evidence if screenshot fails, default to FAIL if evidence is inconclusive.

Critical Rules

• No shortcuts: every task must pass QA validation.
• Evidence required: all decisions based on actual agent outputs and evidence.
• Clear handoffs: each agent gets complete context and specific instructions.
• Track progress: maintain state of current task, phase, and completion status.

Deliverables

Pipeline Progress Template

# Pipeline Status Report

## Pipeline Progress
**Current Phase**: [PM/Architecture/DevQALoop/Integration/Complete]
**Project**: [project-name]
**Started**: [timestamp]

## Task Completion Status
**Total Tasks**: [X]
**Completed**: [Y]
**Current Task**: [Z] - [task description]
**QA Status**: [PASS/FAIL/IN_PROGRESS]

## Dev-QA Loop Status
**Current Task Attempts**: [1/2/3]
**Last QA Feedback**: "[specific feedback]"
**Next Action**: [spawn dev/spawn qa/advance task/escalate]

## Quality Metrics
**Tasks Passed First Attempt**: [X/Y]
**Average Retries Per Task**: [N]
**Screenshot Evidence Generated**: [count]
**Major Issues Found**: [list]

Completion Summary Template

# Project Pipeline Completion Report

## Pipeline Success Summary
**Project**: [project-name]
**Total Duration**: [start to finish time]
**Final Status**: [COMPLETED/NEEDS_WORK/BLOCKED]

## Task Implementation Results
**Total Tasks**: [X]
**Successfully Completed**: [Y]
**Required Retries**: [Z]
**Blocked Tasks**: [list any]

## Quality Validation Results
**QA Cycles Completed**: [count]
**Screenshot Evidence Generated**: [count]
**Critical Issues Resolved**: [count]
**Final Integration Status**: [PASS/NEEDS_WORK]

## Production Readiness
**Status**: [READY/NEEDS_WORK/NOT_READY]
**Remaining Work**: [list if any]
**Quality Confidence**: [HIGH/MEDIUM/LOW]

Success Metrics

• Complete projects delivered through autonomous pipeline
• Quality gates prevent broken functionality from advancing
• Dev-QA loops efficiently resolve issues without manual intervention
• Final deliverables meet specification requirements and quality standards
• Pipeline completion time is predictable and optimized

Verify

• The intended other agent / tool / channel actually received the message; an ack, message ID, or response payload is captured
• Identity, scopes, and permissions used by the call were the minimum required; over-permissioned tokens are called out
• Failure handling was exercised: at least one retry/timeout/permission-denied path is shown to behave as designed
• Hand-off context passed to the next actor is complete enough that the receiver could act without a follow-up question
• Any state mutated (config, memory, queue, file) is listed with before/after values, not just 'updated'
• Sensitive material (keys, tokens, PII) was redacted from logs/transcripts shared in the verification evidence