AI Workflow Orchestration with Control & Validation
Moira is an MCP server that guides AI agents through structured workflows with clear directives, success criteria, and validation at every step. Instead of free-form AI responses, Moira ensures predictable, verifiable execution.
AI agents on complex tasks tend to:
- Lose focus and skip steps
- Produce inconsistent results
- Miss quality checks
- Forget context after interruptions
Moira provides Directive + Completion Condition for every step:
Directive: "Write unit tests for the authentication module"
Completion Condition: "All tests pass, coverage > 80%"
The agent knows exactly what to do and when it's done. No ambiguity, no shortcuts.
flowchart LR
Agent[Agent<br/>Claude/GPT/Gemini] <--> Moira[Moira<br/>MCP Server]
Moira <--> Engine[Workflow<br/>Engine]
Moira --> Output[Directive +<br/>Success Criteria]
- Agent connects to Moira via MCP protocol
- Agent starts a workflow (e.g.,
test-generation,research,content-creation) - Moira returns current step directive and success criteria
- Agent executes the directive and reports completion
- Moira validates and advances to next step
- Repeat until workflow completes
- Structured Execution: Node-based workflow graphs with 7 node types
- Step-by-Step Guidance: One directive at a time with clear completion conditions
- Built-in Validation: JSON Schema validation for structured agent responses
- Execution Persistence: Resume from exact step after session interruption
- Template System: Dynamic workflows with
{{variable}}substitution - Multi-Agent Support: Works with any MCP-compatible client
Setup tutorials for every supported client:
| Client | Type | Guide |
|---|---|---|
| Claude Code | CLI/VS Code | Setup Guide |
| Claude Desktop | Desktop App | Setup Guide |
| Claude Web | Browser | Setup Guide |
| Cursor | IDE | Setup Guide |
| VS Code + Continue | IDE Extension | Setup Guide |
| Windsurf | IDE | Setup Guide |
| Zed | Editor | Setup Guide |
| ChatGPT | Browser | Setup Guide |
| Gemini CLI | CLI | Setup Guide |
- Code Review: Structured review with checklist validation
- Test Generation: Unit, integration, E2E tests with coverage requirements
- Refactoring: Step-by-step transformation with verification
- Bug Investigation: Systematic debugging with evidence collection
- Technical Writing: Articles with research, drafts, and review cycles
- Documentation: API docs, guides, tutorials with quality gates
- Marketing Materials: Copy with iteration and approval workflows
- Technical Research: Investigation with source verification
- Data Analysis: Structured analysis with reproducible steps
- Competitive Analysis: Systematic comparison with evidence
- Test Planning: P0-P3 prioritization with coverage tracking
- Release Validation: Pre-release checklists with sign-offs
- Security Review: Audit workflows with compliance checks
| Workflow | Description |
|---|---|
software-development-flow |
Full development cycle with planning, implementation, review |
task-breakdown-flow |
Break complex tasks into verified steps |
test-generation |
Generate unit/integration/e2e tests |
test-planning |
Create test plans with P0-P3 prioritization |
content-creation |
Articles and documentation with quality gates |
research |
Structured research with source verification |
prd-creation |
Product Requirements Documents |
ux-design |
UX/UI design with accessibility checks |
data-analysis |
Data analysis from problem to conclusions |
marketing-campaign |
Marketing materials with differentiation |
- Introduction — Problem, solution, architecture
- Quick Start — 5-minute setup for any client
- Core Concepts — Workflows, nodes, templates
- MCP Tools Reference — Available tools and parameters
- Agent Guide — How agents interact with Moira
- Troubleshooting — Common issues and recovery
See CONTRIBUTING.md