Add swarm decision v0.1 contract, operating modes, verifier, examples, and docs

[ManintheCrowds]

Motivation

• Introduce a minimal, portable v0.1 swarm decision contract and operating-mode guidance to support multi-agent decision workflows and machine-readable audit artifacts.
• Provide verification and examples so swarm artifacts can be validated in CI and by local tooling.

Description

• Add a new contract document docs/contracts/swarm_decision_v0_1.md that specifies the swarm_decision_v0_1 envelope and normative fields.
• Add operating-mode and process docs: docs/SWARM_OPERATING_MODES.md, a review docs/OPENHARNESS_REVIEW_2026-04-11.md, and backlog/cheatsheet updates to surface swarm milestones.
• Add a verifier script scripts/verify_swarm_contract.py that validates state/swarm_runs/**/*.yaml against v0.1 policy constraints and wire it into capabilities.harness.yaml and docs/CHEATSHEET.md.
• Add schema/docs and example artifacts under state/swarm_runs/ plus state/swarm_runs/README.md and update state/README.md to reference the new optional swarm_runs path.

Testing

• Ran python scripts/verify_script_index.py to ensure the new script is listed in capabilities.harness.yaml and docs/CHEATSHEET.md, and the check passed.
• Ran python scripts/verify_swarm_contract.py against the included example YAMLs in state/swarm_runs/2026-04-11/, and the verifier passed for the provided examples.

---

Codex Task

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.