Workflow Orchestration
A stable agent workflow does not ask a model to solve everything in one pass. It breaks intent, context, tools, and verification into recoverable steps.
Basic loop
- Clarify the goal, scope, and acceptance criteria.
- Read local project context and official docs.
- Plan small verifiable tasks.
- Make focused changes that follow project conventions.
- Verify with builds, tests, link checks, or visual review.
- Record state, evidence, and remaining risk.
How the modules connect
| Module | Workflow role |
|---|---|
| Skills | Package repeatable operations |
| MCP | Provide tools, resources, and external context |
| OpenSpec | Record requirements, design, and tasks |
| Harness | Validate behavior, failure modes, and regressions |
| Evaluation | Decide whether release criteria are met |
Orchestration checklist
- Every step has input and output.
- Tool calls have permission boundaries.
- Failures can recover or roll back.
- Critical behavior has Harness or build evidence.
- Final reports include evidence, not only completion claims.
Next: Retrieval and Knowledge.