-
Notifications
You must be signed in to change notification settings - Fork 0
substrate(backlog): single-agent-speed → collaboration-speed trajectory + trajectory-registry concept (Aaron 2026-04-27) #55
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,162 @@ | ||||||
| --- | ||||||
| name: Substrate is currently optimized for single-agent speed; multi-agent/multi-fork hardening needs many rounds of iterative work over time (Aaron 2026-04-27) | ||||||
| description: Aaron 2026-04-27 substrate-level reframe of the factory's evolutionary trajectory. Today's substrate design is **optimized for single-agent speed** — fast iteration with one maintainer-agent pair (Aaron + Otto). Future operation requires **collaboration speed** — multi-agent + multi-fork hardening. The transition is **many rounds of iterative work over time**, not a one-shot fix. Frames the ROUND-HISTORY hotspot concern (and analogous concerns) as instances of a broader trajectory: "single-agent-speed substrate → collaboration-speed substrate" via progressive hardening. Critically, the single-agent-speed phase IS the right phase for now — collaboration-speed is post-starting-point work, not blocking, evolves over time. | ||||||
| type: feedback | ||||||
| --- | ||||||
|
|
||||||
| # Substrate optimized for single-agent speed; collaboration-speed hardening is iterative future work | ||||||
|
|
||||||
| ## Verbatim quote (Aaron 2026-04-27) | ||||||
|
|
||||||
| After Otto filed the ROUND-HISTORY hotspot concern as backlog research: | ||||||
|
|
||||||
| > "we are going to have to do many rounds of multiagent multifork hardening for our subsgtraight design, we've been really focused on single agent speed at this poing and not colloboration speed, we'll get to it and make it better over time" | ||||||
|
|
||||||
| ## The two substrate optimization regimes | ||||||
|
|
||||||
| ### Regime 1 (today): single-agent speed | ||||||
|
|
||||||
| What we have today: | ||||||
| - Single maintainer-agent pair (Aaron + Otto on AceHack) | ||||||
| - Single autonomous loop | ||||||
| - Single writer to most shared files (BACKLOG.md, ROUND-HISTORY.md, GLOSSARY.md, GOVERNANCE.md, CLAUDE.md, etc.) | ||||||
| - Mostly serial PR landings (no concurrent-conflict pressure) | ||||||
| - All work originates AceHack-side (homebase-first), syncs to LFG | ||||||
|
|
||||||
| Substrate-design choices that fit this regime: | ||||||
| - Big shared single-writer files (low coordination cost when there's one writer) | ||||||
| - Memory-as-flat-files (one writer, no merge concerns) | ||||||
| - ROUND-HISTORY as project-wide single file (single pair = single voice) | ||||||
| - Tick-history as single shared file (single pair tickrate) | ||||||
| - Manual hand-coordination of cross-fork sync (low frequency, hand-doable) | ||||||
|
|
||||||
| This regime **prioritizes iteration speed for one pair over coordination scale across many pairs**. It's the right choice for the bootstrap phase — getting the factory operational with one pair before scaling to many. | ||||||
|
|
||||||
| ### Regime 2 (future): collaboration speed | ||||||
|
|
||||||
| What we'll need: | ||||||
| - Multiple maintainer-agent pairs (Aaron+Otto, Bob+Gemini, Carol+Codex, etc.) | ||||||
| - Multiple autonomous agents running concurrently within each pair | ||||||
| - Multiple forks, each contributing back to LFG | ||||||
| - Concurrent PR landings on LFG with merge contention | ||||||
| - Cross-fork data collection on LFG (per fork-storage taxonomy) | ||||||
|
|
||||||
| Substrate-design choices that fit this regime: | ||||||
| - Per-row / per-partition files instead of big shared singletons (e.g., `docs/backlog/**` already; same pattern for other big files) | ||||||
| - CRDT-style or append-only formats for inherently shared narratives | ||||||
| - Per-pair partitioning for per-pair data (PR archives, cost data, tick history, persona notebooks) | ||||||
| - Project-wide synthesis files compiled from per-pair sources (e.g., round-of-rounds rather than ROUND-HISTORY) | ||||||
| - Automated cross-fork sync with conflict-resolution discipline | ||||||
| - Multi-tenant fork-storage architecture (already substrate per Aaron's two-message disclosure) | ||||||
|
|
||||||
| ## Why this matters as a substrate-level reframe | ||||||
|
|
||||||
| This isn't just a list of future concerns — it's a **frame** for how to evaluate today's substrate-design choices: | ||||||
|
|
||||||
| - A choice that's **optimal for single-agent speed** but **suboptimal for collaboration speed** is acceptable today, but flag it for hardening when collaboration arrives. | ||||||
| - A choice that **already serves collaboration speed** is ahead of its time but not wrong — the cost is paid early; benefit comes later. | ||||||
| - A choice that's **suboptimal for both** is just bad design; refactor. | ||||||
|
|
||||||
| Today's known single-agent-speed choices that need future hardening: | ||||||
| - ROUND-HISTORY.md as single shared file → multi-fork hotspot (memory file `feedback_round_history_md_git_hotspot_*` flags this) | ||||||
| - Big shared GLOSSARY/CLAUDE/GOVERNANCE files → similar contention under multi-agent | ||||||
| - Per-pair memory files in `memory/` mixed with project-wide ones → no clean partitioning | ||||||
| - Manual paired-sync flow (Otto cherry-picks AceHack content into LFG branches) → doesn't scale to N forks | ||||||
|
|
||||||
| Today's known collaboration-speed-aware choices already in place: | ||||||
| - `docs/backlog/**` per-row files (Otto-181) — already partitioned | ||||||
| - `docs/pr-preservation/` drain-log discipline — already designed for multi-PR archive | ||||||
| - Multi-tenant fork-storage architecture (post-Aaron's disclosure today) — explicitly multi-fork | ||||||
| - Otto-279 + follow-on closed-list history-surface rule — already understands per-surface partitioning | ||||||
|
|
||||||
| ## Critical framing: this is iterative, NOT a blocking concern | ||||||
|
|
||||||
| Aaron's *"we'll get to it and make it better over time"* is load-bearing. | ||||||
|
|
||||||
| Multi-agent/multi-fork hardening is: | ||||||
| - **Many rounds of work** — not a single-PR fix. | ||||||
| - **Iterative** — each round addresses one or two pressure points; full hardening compounds over time. | ||||||
| - **Triggered by real pressure** — premature hardening is wasted effort; wait for the second pair / second autonomous agent / second fork to surface real contention before designing the fix. | ||||||
| - **Not blocking 0/0/0 starting point** — getting the factory operational with one pair is the priority. | ||||||
|
|
||||||
| The single-agent-speed phase IS the right phase for now. Acknowledging the transition exists doesn't mean accelerating it. | ||||||
|
|
||||||
| ## How to apply going forward | ||||||
|
|
||||||
| When evaluating a substrate-design choice (today, while in single-agent-speed regime): | ||||||
|
|
||||||
| 1. **Will it work for single-agent speed today?** If yes, ship it. | ||||||
| 2. **Will it break under multi-agent/multi-fork pressure?** If yes, flag the breaking-point in a memory file (like the ROUND-HISTORY hotspot memory). | ||||||
| 3. **Is the breaking-point pressure imminent?** If yes (e.g., second pair joining this month), harden now. If no (e.g., theoretical future state), defer with the flag. | ||||||
|
|
||||||
| The flag-and-defer pattern keeps the substrate honest about its limits without blocking iteration speed. | ||||||
|
|
||||||
| ## Composes with | ||||||
|
|
||||||
| - `feedback_round_history_md_git_hotspot_concern_multi_fork_multi_agent_backlog_research_2026_04_27.md` — first instance of this trajectory (ROUND-HISTORY hotspot as single-agent-speed choice that breaks under collaboration-speed pressure). This memory frames it as one of many. | ||||||
|
||||||
| - `feedback_round_history_md_git_hotspot_concern_multi_fork_multi_agent_backlog_research_2026_04_27.md` — first instance of this trajectory (ROUND-HISTORY hotspot as single-agent-speed choice that breaks under collaboration-speed pressure). This memory frames it as one of many. | |
| - The ROUND-HISTORY hotspot concern backlog-research memory — first instance of this trajectory (ROUND-HISTORY hotspot as single-agent-speed choice that breaks under collaboration-speed pressure). This memory frames it as one of many. |
Copilot
AI
Apr 27, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This bullet points to tools/sync/, but there is currently no tools/sync/ directory in the repo (only docs/sync/). If this is intended as a future/planned tool location, consider annotating it as such (or linking to an existing doc/backlog row) to avoid it reading like a present-day path.
| - **Sync model**: manual paired-sync → automated 0-diff verification (`tools/sync/`). | |
| - **Sync model**: manual paired-sync → automated 0-diff verification (planned `tools/sync/`; current sync docs live under `docs/sync/`). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This new
MEMORY.mdindex entry is extremely long.memory/README.mdnotes the index is capped at ~200 lines and entries should be kept terse; long summaries increase the chance of important newer entries being truncated out of the visible index. Suggest tightening this to a much shorter one-line summary and leaving the detail in the underlying memory file.