Skip to content

docs: ratify gr2 UX model and workflow#557

Merged
laynepenney merged 6 commits intomainfrom
atlas/gr2-docs-rulebook
Apr 12, 2026
Merged

docs: ratify gr2 UX model and workflow#557
laynepenney merged 6 commits intomainfrom
atlas/gr2-docs-rulebook

Conversation

@laynepenney
Copy link
Copy Markdown
Collaborator

Summary

  • split the docs/rulebook content out of #556 so the ratified UX model can land independently
  • add the gr2 UX manifesto, shared scratchpad design, stress matrix, and unit-local-first design correction
  • codify the gr2 development workflow mantra: (design -> prototype -> verify)^n -> build -> assess -> repeat

What this lands

  • docs/MANIFESTO-gr2-ux.md
  • docs/PLAN-gr2-shared-scratchpads.md
  • docs/ASSESS-gr2-shared-scratchpads-stress.md
  • updates to docs/PLAN-gr2-needs-and-criteria.md
  • updates to docs/PLAN-gr2-repo-maintenance-and-lanes.md

Ratified decisions

  • gr2 is a multi-repo workspace router, not a git replacement
  • lanes are the primary UX object
  • unit-local and lane-local checkouts are the working surface
  • shared repo cache is apply substrate / optimization, not the user-facing workspace model
  • shared scratchpads are doc-first for MVP

Context

This is the first split out of #556 per review. Prototype code and harnesses will follow in separate PRs.

@laynepenney laynepenney force-pushed the atlas/gr2-docs-rulebook branch from a4c16b0 to 1d5b3b5 Compare April 12, 2026 12:30
@laynepenney
Copy link
Copy Markdown
Collaborator Author

Scope is corrected now.

grip#557 is docs-only after rebasing and removing the prototype/code contamination from the branch. The diff against main is now limited to:

  • docs/MANIFESTO-gr2-ux.md
  • docs/PLAN-gr2-needs-and-criteria.md
  • docs/PLAN-gr2-repo-maintenance-and-lanes.md
  • docs/PLAN-gr2-shared-scratchpads.md
  • docs/ASSESS-gr2-shared-scratchpads-stress.md
  • docs/ASSESS-gr2-lanes-cross-mode-stress.md

I also added the new lane-model adversarial verification doc that pressures the design across all four operating modes:

  • solo human
  • single agent
  • multi-agent
  • mixed human + agent

That doc focuses on interruption recovery, current-context ambiguity, same-repo parallelism, mixed-mode lane conflicts, and machine-readable recovery/state surfaces. This should give us the same kind of hostile verification gate for the lane model that we already had for scratchpads.

@laynepenney laynepenney merged commit dd391bc into main Apr 12, 2026
10 of 11 checks passed
@laynepenney laynepenney deleted the atlas/gr2-docs-rulebook branch April 12, 2026 12:52
laynepenney added a commit that referenced this pull request Apr 12, 2026
Merges PR #550: gr2 exec status surface with lane-scoped
execution planning. Resolves doc conflicts by keeping main's
canonical versions (already merged via #557, #549, #548, #543).

New: gr2/src/exec.rs, ExecCommands in args.rs, dispatch.rs
wiring, load_lane() in lane.rs, two integration tests.
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