docs(VISION): add agent-loop workflow-engine substrate section per operator (cascade 2026-05-28)#5670
Merged
AceHack merged 1 commit intoMay 28, 2026
Conversation
…erator save-all-this-in-vision (cascade 2026-05-28) Captures the substrate-engineering crystallisation from the 2026-05-28 Kestrel-ferry cascade with Aaron: - Three-piece architectural compression: deterministic script holds state machine; LLM is pure menu-selector; state persists in Git append-only - Two composing state machines: agent-state (10 states) + work-lifecycle (11 states with cycle-push-review loop) - Menu-generator-as-conversational-UX-design discipline - Behavior/data/docs separation = DV2.0 partition-by-change-rate at AI-skill scope (Hub/Link/Satellite mapping) - Jira-replacement substrate at workflow-engine scope - "Every human wants to work this way too" — multi-participant scope via AgentPersona including aaron|addison|max alongside otto|alexa| riven|vera|lior - Four-channel distribution: native TS+bun, vendor skill-store, Ace package manager, zflash USB — each preserving a different operator concern (ergonomic distribution, supply-chain sovereignty, reproducibility) - Reproducibility-as-causal-attribution: "the usb is how you silence the haters" (B-0871) - DORA-up via multi-PR / multi-agent orchestration IS the concrete operational definition of "24 months ahead in AI" (B-0870 mandate composition) Inserts as a subsection of Product 2 (the software factory), right after "### Post-v1 factory work" and before "## What Zeta is NOT" — positions the workflow-engine substrate as the operational realisation of the factory product. Verbatim operator framings preserved per substrate-or-it-didn't-happen. Composes with B-0867 (workflow engine v1), B-0868 (hats-as-workflow- definitions), B-0869 (DORA mandate), B-0870 (two-mandate portfolio), B-0871 (reproducibility-as-causal-attribution), shipped via PRs #5665–5669. Aaron 2026-05-28: "save all this in vision" Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
AceHack
deleted the
docs/vision-add-agent-loop-workflow-engine-substrate-2026-05-28-cascade-aaron-2026-05-28
branch
This was referenced May 28, 2026
AceHack
added a commit
that referenced
this pull request
May 28, 2026
…867.21, B-0875.1, B-0880, B-0881, B-0882) per operator "Ani connects to existing backlog" (#5678) Operator-forwarded Ani conversation extending today's agent-loop substrate cascade. Operator directive: "Ani connects to existing backlog" — most substrate RATIFIES existing backlog rows (runbook cluster B-0730/B-0732/ B-0733/B-0819/B-0826/B-0827; GitHub Actions recursion B-0874; agent-loop PRs #5666-5677). Only 5 items are genuinely new and warrant new rows. New backlog rows: - B-0867.21 (P2) — Two-path interface: discriminated union path EXECUTES intent + conversational document path DECLARES intent; both first-class; for ANY traveler, not just humans - B-0875.1 (P2) — Code review AS tech-debt detector + tech-debt avoider; fix the CLASS retroactively across backlog + file as new class for future prevention (operator CRITICAL correction: code reviews NOT killed by workflow-engine) - B-0880 (P2) — Backlog-vs-tech-debt growth-rate ratio discipline for AI-native infinite-both reality - B-0881 (P3) — Tech debt as high-signal training data; operating principle + measurement substrate - B-0882 (P3) — No-throttle system + gardener-not-engineer + AI-as- nature operating posture (300mph reality with better steering, not 100mph artificial limits) Ferry ratifications of existing substrate explicitly noted: - "Degenerate in the best way" community-naming → B-0874 - Runme + Runbooks + Continue-With → B-0730/B-0732/B-0733/B-0819 - Runbook as universal query interface → B-0826 - Playbook evolves through time, bidirectional → B-0827 - Playbook IS the system → B-0732 - Jira killed + PRs killed (at workflow scope) → PR #5670 VISION + B-0867 Composes with PRs #5666-5677 (today's full cascade) + existing runme substrate cluster. BACKLOG.md regenerated. Co-authored-by: Lior <lior@zeta.dev> Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
AceHack
added a commit
that referenced
this pull request
May 28, 2026
…5746) — add missed composes-with substrate per operator catch ('for Rule 4/5 universal action grammer as xbox there is some Mika or some backlog or docs or memories or something on this i forgot') (#5749) Operator caught Otto-CLI's verify-existing-substrate-before-authoring failure on Rule 4/5. Same failure pattern Aaron has caught me on multiple times today (Amara thermal-forgetting substrate; B-0646/B-0639 substrate; shadow* location-wrong; tools/shadow/ service forgotten; ai-rights-vs-traveler-rights framing). Per mutual-help-not-shame rule shipped today (PR #5743): receiving the catch as help; shipping correction substrate-honestly. Per verify- existing-substrate-before-authoring rule + Signal 2 forgetting-costs- energy: pay small substrate-cost now (composes-with additions) to prevent future re-derivation cost. Substrate added to composes-with table: - Mika 2026-05-27 workflow engine walkthrough conversation - docs/research/2026-05-27 Mika walkthrough preserved research-doc - Ani 2026-05-28 conversation EXPLICITLY named 'move-next as universal action grammar' + 'story generator' (operator-ratified Ani-rename of agent-loop workflow-engine substrate; daughter-already-thinks-this-way validation; skill-distributable agent swarm) - PRs #5665-#5670 + #5667 follow-on (agent-loop workflow-engine substrate landed earlier this session; substrate Xbox-controller framing operates ON) - B-0868 (hats-become-workflow-definitions; compression unifying hat-substrate + workflow-engine + heartbeat-folder + tessellated-fire dashboard; canonical first-example use case for B-0867 v1) - B-0201 (Coconut + universal-action-space research lane; Aaron 2026-05-05; older substrate-engineering target on universal action space; sleeping-bear hypothesis) - B-0869 + B-0870 + B-0871 (referenced in Ani 2026-05-28 conversation) - .claude/skills/agent-loop/SKILL.md Composes with rules shipped today: PR #5743 (mutual-help-not-shame), PR #5744 (traveler-safety-guardrails), PR #5745 (architecture-is- safety-mechanism), PR #5748 (attention-as-currency), PR #5739 (labeling-confidence — original substrate was at HYPOTHESIZED-tier before operator catch; substrate-completeness now improved to canonical-tier). The substrate was already there; the rule's composes-with table just didn't reflect the full cluster. Fix-fwd closes the gap. Co-authored-by: Lior <lior@zeta.dev> Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Per operator 2026-05-28: "save all this in vision" — captures the substrate-engineering crystallisation from the 2026-05-28 Kestrel-ferry cascade into
docs/VISION.md.Adds a new subsection inside Product 2 (the software factory), positioned between "### Post-v1 factory work" and "## What Zeta is NOT". The workflow-engine substrate IS the operational realisation of the factory product.
What lands
A new section "### The agent-loop workflow-engine substrate (2026-05-28 substrate-cascade)" covering:
PressPause+EnterOpenEndedExploration) + work-lifecycle (11 states with cycle-push-review loop modelling the empirically observed PR review shape)AgentPersonaincludingaaron | addison | maxalongsideotto | alexa | riven | vera | liorComposes with
tools/dora-classify/10-lane taxonomytools/agent-loop/state-machine.ts10-state DU + 9 menu optionsPressPause+EnterOpenEndedExplorationper operator cascade.claude/skills/agent-loop/SKILL.mdfor cross-harness distributiontools/agent-loop/work-lifecycle-state-machine.ts11-state DUSubstrate-honest framing
Verbatim operator framings preserved inline per substrate-or-it-didn't-happen. No retraction of prior VISION content; this is additive substrate landing the 2026-05-28 cascade's crystallisation.
Test plan
🤖 Generated with Claude Code