agent-orchestrator/docs
Ashish Huddar 319d4b551b docs(canvases): plan-eng-review locks v0.4, defers behind v0.2 + v0.3
Ran /plan-eng-review on the v0.4 canvas-renderer plugin slot plan.
Four sections, 7 architecture / code-quality / performance forks
(all chose Option A), one codex outside-voice consult, 3 cross-model
tensions resolved (1A + 2A + 3A).

KEY DECISIONS LOCKED:

1A. Defer v0.4 — ship v0.2 (CanvasProducer wiring) and v0.3 (mux push)
    first. Codex outside-voice was decisive: v0.4 is high-infrastructure
    + low-immediate-user-value, and the deferred-CLI scope was confusing
    on its own terms. v0.2 + v0.3 deliver immediate user value
    (PR-status canvases, sub-second updates) for less eng cost.

2A. When v0.4 ships, scope is Maximalist (CLI auto-rebuild + warning
    UI included). The original "Selective" scope was rejected because
    deferring CLI tooling makes the build-time-discovery design ship
    a confusing path to users.

3A. AST package-contract scanner stays in v0.4 but reframes as
    compatibility lint, not a safety mechanism. The trust statement
    ("installing a renderer plugin grants full dashboard code
    execution") does the security work; AST scanner just keeps plugins
    shaped right.

ARTIFACTS:

- docs/canvases-v0.4-plan.html (NEW): the locked v0.4 plan with all 9
  numbered decisions, codex's 12 design constraints folded in,
  failure-mode-organized test scope, ship-cost breakdown, NOT-in-scope.
- docs/canvases-feature.html: roadmap row v0.4 updated to reflect new
  ordering + Maximalist scope + 2.5-4 eng-week estimate. Known-tradeoff
  section's "rebuild required" framing aligned with CLI-included scope.
- TODOS.md (NEW): captures v0.2, v0.3, v0.4 (with 10 implementation
  lanes A-J), and v0.5+ deferred work. Test scope is organized around
  failure modes (stale artifact, missing rebuild, npm-pack vs symlink,
  Zod peer mismatch, etc.), not test count theater.

Review persisted to ~/.gstack/projects/ for the dashboard. Test plan
artifact written for future /qa consumption.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 01:08:16 +05:30
..
assets docs(canvases): drop mobile section, mark mobile as out-of-scope for v0.1 2026-05-09 21:52:30 +05:30
design fix(core): address lifecycle review feedback 2026-04-15 12:41:06 +05:30
specs fix(web): runtime terminal port resolution + project-id hardening 2026-03-28 19:23:15 +05:30
ARCHITECTURE.md feat(windows): complete Windows support (#1025) 2026-05-09 00:10:53 +05:30
CLI.md feat(windows): complete Windows support (#1025) 2026-05-09 00:10:53 +05:30
CROSS_PLATFORM.md feat(windows): complete Windows support (#1025) 2026-05-09 00:10:53 +05:30
DEVELOPMENT.md feat(windows): complete Windows support (#1025) 2026-05-09 00:10:53 +05:30
PLUGIN_SPEC.md chore: rename @composio scope to @aoagents across all packages 2026-04-09 15:59:33 +00:00
SECURITY-AUDIT-SUMMARY.md fix: migrate to hash-based project isolation architecture 2026-02-18 00:19:55 +05:30
canvases-codex-review-2026-05-06.html docs(canvases): add feature writeup + codex review writeup HTMLs 2026-05-09 22:31:45 +05:30
canvases-feature.html docs(canvases): plan-eng-review locks v0.4, defers behind v0.2 + v0.3 2026-05-10 01:08:16 +05:30
canvases-launch.html docs(canvases): drop markdown twins, HTML is canonical 2026-05-09 23:31:16 +05:30
canvases-v0.4-plan.html docs(canvases): plan-eng-review locks v0.4, defers behind v0.2 + v0.3 2026-05-10 01:08:16 +05:30
design-cli-redesign-analysis.html refactor: remove --decompose feature entirely 2026-04-10 13:02:52 +05:30
design-npm-global-install-fixes.html docs: sync install-flow design doc with current start/preflight behavior 2026-03-26 16:05:59 +05:30
design-onboarding-improvements.html Expand design doc section on ao-web npm publishing 2026-03-14 19:04:57 +05:30
observability.md feat(web): copy observability debug bundle from dashboard (#1320) 2026-04-21 11:35:43 +05:30
openclaw-plugin-setup.md chore(cli): remove deprecated 'ao init' command (#1438) 2026-05-05 18:43:55 +05:30
opencode-workflows-spec.md feat (core): inject worker prompt as instructions file (#1302) 2026-04-26 15:44:39 +05:30
state-machine-stage2-evidence-recovery-plan.md docs: add stage 2 evidence and recovery plan (#95) 2026-04-16 22:22:23 +05:30