Skip to content

docs(v2): adopt v2 rearchitecture plan from 3-repo deep-dive review - #106

Merged
SamPlvs merged 1 commit into
mainfrom
claude/v2-rearchitecture-plan
Aug 12, 2026
Merged

docs(v2): adopt v2 rearchitecture plan from 3-repo deep-dive review#106
SamPlvs merged 1 commit into
mainfrom
claude/v2-rearchitecture-plan

Conversation

@SamPlvs

@SamPlvs SamPlvs commented Aug 12, 2026

Copy link
Copy Markdown
Owner

Summary

Adopts all 12 features synthesized from full-source deep-dive reviews of three agent-orchestration repos, and documents the v2 direction publicly:

  • Plan: plans/zo-v2-rearchitecture.md — five layer-based workstreams (enforcement plane / control plane / execution substrate / self-learning & platform oracle / operator experience), six gated phases, 20-check tiered oracle, anti-scope encoding 11 anti-patterns we refuse to copy
  • Docs: new docs/reference/v2-rearchitecture.mdx (full feature table with provenance + repo links, added to nav), v2 section atop docs/roadmap.mdx
  • Website: new §11 "What's next" crediting the three source repos (quick start renumbered §12, drawer nav updated)
  • Memory: research corpus (63 features, per-repo verdicts, synthesis) at memory/zo-platform/research/2026-08-12-repo-reviews/, STATE session 040, DECISION_LOG decision

Reference repositories

Verification

  • validate-docs.sh: 9 passed / 0 failed / 2 pre-existing warnings
  • Website: HTML tag-balance check + static-server DOM inspection (all links, nav, renumbering verified rendered). Astro build deferred to CI — no Node.js on the authoring machine.
  • Adversarial consistency review (counts, priorities, URLs, MDX hazards, confidentiality) passed; 5 minor findings fixed pre-commit

🤖 Generated with Claude Code

Adopt all 12 features synthesized from full-source reviews of
oh-my-claudecode (yeachan-heo), ruflo (ruvnet), and ralph (snarktank),
organized into five layer-based workstreams across six gated phases.

- plans/zo-v2-rearchitecture.md: 20-check tiered oracle, anti-scope,
  reference repo links (+ .gitignore exception)
- docs/reference/v2-rearchitecture.mdx: full feature table w/ provenance
- docs/roadmap.mdx: v2 section (4 pillars + repo credits)
- website: new §11 'What's next' crediting the three source repos
- memory: STATE session 040, DECISION_LOG v2 decision, research corpus
  at memory/zo-platform/research/2026-08-12-repo-reviews/

Website change verified via HTML balance check + static-server DOM
inspection; Astro build deferred to CI (no Node.js on this machine).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying zero-operators with  Cloudflare Pages  Cloudflare Pages

Latest commit: e2baab4
Status: ✅  Deploy successful!
Preview URL: https://2b4e875f.zero-operators.pages.dev
Branch Preview URL: https://claude-v2-rearchitecture-pla.zero-operators.pages.dev

View logs

@SamPlvs
SamPlvs merged commit ac07a26 into main Aug 12, 2026
5 checks passed
@SamPlvs
SamPlvs deleted the claude/v2-rearchitecture-plan branch August 12, 2026 15:25
SamPlvs pushed a commit that referenced this pull request Aug 12, 2026
…de kept for all stacked-file conflicts

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant