Certy GH-600: Multi-Agent Orchestration Lab

A public, fully runnable and tested TypeScript training repository for GH-600 domain 5.0, Multi-Agent Systems and Orchestration. It shows how several narrow agents combine into a reliable, deterministic pipeline: routing, queueing, state locking, handoff rules, conflict resolution, and a human approval gate.

Everything is offline and deterministic. There is no network access and there are no API keys.

What is inside

src/
  agents/           triage, planner, coding, review, release agents
  orchestrator/     router, taskQueue, stateLock, handoffManager,
                    conflictResolver, pipeline
  shared/           taskSchema (Task type + validate), sharedState (locked store)
  examples/         sample pipeline run (.ts and .json)
tests/              router, stateLock, handoff, conflictResolver, pipeline
docs/               orchestration-patterns, agent-handoffs, state-locking,
                    conflict-resolution
labs/               eight hands-on labs

The pipeline

triage -> plan -> code -> review -> release
                            |
                            +--> code   (failed review sends work back)

Each agent declares the next stage; the handoff manager only permits legal transitions; every agent runs while holding a lock on the task resource so two agents can never edit the same file at once.

Requirements

• Node.js 22 (the CI uses setup-node 22)
• npm

Install and run

npm install --no-fund --no-audit
npm test
npm run typecheck

Run the sample pipeline and see a deterministic trace:

node --import tsx src/examples/samplePipeline.ts

Tests

• tests/router.test.ts: routes each task type to the right agent, including label overrides and unknown-type errors.
• tests/stateLock.test.ts: the mutex stops two agents holding the same resource; guarded shared-state writes require the lock.
• tests/handoff.test.ts: legal handoffs are allowed, illegal ones are rejected.
• tests/conflictResolver.test.ts: detects a conflict when two agents edit the same file differently.
• tests/pipeline.test.ts: a task flows through all five stages; the approval gate halts before release; schema validation works.

Labs

See labs/README.md for eight guided exercises covering specialist roles, routing, handoff rules, state locking, preventing concurrent edits, conflict resolution, human approval, and trace logs.

Documentation

• docs/orchestration-patterns.md
• docs/agent-handoffs.md
• docs/state-locking.md
• docs/conflict-resolution.md

Links

• Certy: https://certy.pro
• CertyPro on GitHub: https://github.com/CertyPro
• Course content: https://github.com/CertyPro/certy-gh600-course-content

Licence

MIT. See LICENSE.