The exact JSON spec + Single-Source-of-Truth discipline that runs every multi-agent sprint inside ForgedOps.Ai — now packaged for operators running Claude + Codex + Gemini on real production work.
Built, battle-tested, and shipped inside the WCS Enterprise Suite. Used on live commercial-construction AI deploys worth $1,499/mo per client (Command Pro tier).
You open Claude in one window, Codex in another. You hand off a task. Claude rewrites the brief mid-stream. Codex interprets differently. Your files fork. Your tokens burn. Your day ends with three half-finished versions and zero shipped code.
This isn't a model problem. It's a discipline problem. Research shows 36% of all long-horizon agent failures trace directly to context and goal drift — not reasoning, not hallucination. The agents are fine. Your interface between them is broken.
The fix isn't a better prompt. It's a canonical task spec that every agent reads from disk before acting — a deterministic execution shell around probabilistic agents. 8 rules. One source of truth. Zero blind writes.
The 16-field doctrine. Flat, parseable, auditable. Covers task_id, write_scope, validation_commands, handoff_notes, and 12 more. Battle-tested on live AEO pillar deploys.
The blank canonical spec. Drop it in .agents/tasks/, fill in your task, hand to Codex. First spec takes 10 minutes; every one after takes 3.
Re-read-before-act, version bumps, explicit write scope, one-way status transitions, no blind writes, second-agent review. The same governance pattern enterprise platforms enforce at the infrastructure level — implemented as 8 human-readable rules at the file level.
.agents/tasks/ + .agents/logs/ + .agents/diffs/ — git-tracked, collision-safe, and ready for n8n relay upgrade.
Exact command you paste to execute any spec. Works with OpenAI Codex CLI, ChatGPT Codex agent, or Claude Code CLI's sub-agent mode.
Watch the actual run — JSON spec → Codex execution → Claude validation → nuke-and-push deploy. End-to-end pairing in under 15 minutes.
_SCHEMA.md v1.1.0 file_TEMPLATE.json canonical spec_SCHEMA.md v1.1.0 file_TEMPLATE.json canonical spec.agents/tasks/ folderA prompt lives in chat. A spec lives on disk, gets versioned, gets read by every agent fresh, and survives context compaction. Prompts don't compound. Specs do.
No. The protocol works for any multi-agent workflow — Claude + ChatGPT, Claude + Cursor, Claude + local LLM, Claude + Claude (sub-agents). The schema is agent-agnostic.
Yes — .agents/tasks/ is already the convention Claude Code uses for skills. The playbook drops in cleanly.
The Done-For-You tier is built for you. We set up the folder, write the first 3 specs, and train your ops lead.
DIY: no refunds (you get the files immediately). Coached: 14-day full refund. DFY: 60-day ship-or-refund guarantee.
Immediately after Stripe confirmation. Automated delivery via email with GitHub gist link.
Stop inventing your own handoff protocol in the middle of a deploy. Get the one that already works.