Skip to content

docs(adr-0057): Amendment A1 — build conversations bind a package (lazy binding) - #2457

Merged
os-zhuang merged 1 commit into
mainfrom
claude/adr-0057-amendment-a1
Jul 13, 2026
Merged

docs(adr-0057): Amendment A1 — build conversations bind a package (lazy binding)#2457
os-zhuang merged 1 commit into
mainfrom
claude/adr-0057-amendment-a1

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Docs-only. Proposes Amendment A1 to ADR-0057, distilled from the 2026-07-13 live browser-testing rounds and the follow-up design discussion.

The three live-reproduced defects it addresses

  1. Agent ambiguity — with a blueprint Awaiting Approval in the same thread, a second handoff made the agent ask "which app do you mean?" (no declarable binding to reason from).
  2. Thread mixing — a bare /ai/build (the magic flow) keys to product-only scope: ONE global build thread for every project.
  3. Continuity break — the thread that built app X and the app:X:build thread "Edit with AI" opens later are different conversations; the original build history is stranded.

The proposal in one line

Every build conversation carries a visible, switchable, lazily-established package binding — the Claude-Code-picks-a-repo idiom for display, never for gating: the magic flow starts as "✨ New app" with zero create-first friction and auto-binds + re-keys when the build mints the package.

Phasing: A1.a read-only chip (folds into P3a's dock header) → A1.b bind-on-create + conversation re-key (+ legacy-scope fallback) → A1.c cloud prompt injection + the pending-blueprint "default to amend" rule.

Refs: epic #2409 (ADR-0057), ADR-0070 (active package), the consolidated UX-findings issue (linked after filing).

🤖 Generated with Claude Code

…zily
Proposed amendment from live-testing findings: build threads get a visible,
switchable, lazily-established package binding (chip: bound app / "New app").
Magic flow starts unbound (no create-first friction) and auto-binds + re-keys
to app:X:build when the build mints the package — fixing agent ambiguity
("which app?"), global thread mixing, and the build-history continuity break.
Phased A1.a chip → A1.b bind-on-create+re-key → A1.c cloud prompt injection +
pending-blueprint amend rule.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 13, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredJul 13, 2026 2:14pm

Request Review

@os-zhuang

Copy link
Copy Markdown
ContributorAuthor

Consolidated UX-findings issue filed: #2458 (its item 2 = this amendment's A1.c).

@os-zhuang
os-zhuang merged commit 6f132f2 into mainJul 13, 2026
4 checks passed
@os-zhuang
os-zhuang deleted the claude/adr-0057-amendment-a1 branch July 13, 2026 14:49
@os-zhuang

Copy link
Copy Markdown
ContributorAuthor

A1.a (the binding chip) is implemented + live-verified in #2461; A1.c (pending-blueprint amend) in objectstack-ai/cloud#823.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@os-zhuang