Release Notes — Protocol Stack V2

Freeze Date: 2026-06-06 Git Commit: 96b816c Verdict: GO ✅

What's New

Protocol Stack V2 is a slimmed three-layer agent architecture that replaces the bloated single-document approach with a clean, auditable, and portable protocol stack.

Three-Layer Architecture

Layer 1: AGENTS.md        — Execution Protocol (how to plan & execute tasks)
Layer 2: GOVERNANCE.md    — Execution Governance (how to manage & monitor)
Layer 3: PORTFOLIO.md     — Portfolio Management (how to coordinate projects)

Automated Verification

npm run audit — 91 checks across all three layers, generates audit-report.md
npm run upgrade — 62 checks for OpenClaw compatibility after upgrades

Key Metrics

Metric	V1	V2	Δ
Protocol Files	56,002 bytes	44,136 bytes	−21%
Audit Checks	—	91	New
Audit PASS	—	78	—
Audit FAIL	—	0	—
Upgrade Tests	—	62	New
Upgrade PASS	—	62	—
OpenClaw Deps	—	0 (scripts)	—
Self-Hosting	—	80/100	—

What Changed

Expanded

Governance protocol (state machine, heartbeat, blocker, health score, auto-stop)
Portfolio management (registry, priority, resource allocation, kill/pause/promotion)
Protocol reference directory (protocol-reference/quality-gates.md, metrics.md, templates.md)
Five new audit/upgrade scripts
Compatibility strategy documents

Shrunk

AGENTS.md: −14% (removed 6 non-protocol sections, condensed §6)
GOVERNANCE.md: −34% (removed §12, migrated templates to reference)
PORTFOLIO.md: −15% (moved example tables to reference)

Removed (no functional loss)

Inline template code blocks → extracted to protocol-reference/templates.md
AGENTS.md non-protocol sections → configuration no longer in execution protocol
GOVERNANCE.md §12 Portfolio Integration → already covered by PORTFOLIO.md

Upgrade Impact

Scenario	Effort	Changes Required
Patch upgrade	0 min	None
Minor upgrade	5 min	Re-register cron, verify tool names
Major upgrade	15 min	Update tool name refs (max 5 locations)
OpenClaw deprecation	2h	Switch to crontab + alternate LLM

Known WARNs (13 total)

All WARNs are expected conditions:

Hard Rules: Current count 3, target ≥ 5 — requires recurring pattern promotion
No active project data: Progress logs, blocker files, and execution audits are only created during project execution
Project directories found: 4 existing directories flagged for duplicate work scan

Self-Hosting Readiness

Score: 80/100

Component	Portable?
Protocol files (markdown)	✅ Fully
Audit scripts (Node.js)	✅ Fully (zero OpenClaw deps)
Templates	✅ Fully
Runtime engine	⚠️ Needs LLM or replacement
Cron orchestration	⚠️ Needs system cron

Conclusion

V2 is frozen, regression-tested, and ready for production use.

62/62 upgrade tests PASS 78/91 audit checks PASS, 0 FAIL Cross-references: 8 refs to protocol-reference/, all valid Zero OpenClaw internal API dependencies in audit code

3.2 KiB Raw Blame History Unescape Escape