Repository navigation
docs: propose ADR-0061..0064 — the continuous creative workflow - #369
Merged
jeffcrouse merged 2 commits intoSep 18, 2026
Merged
Conversation
Adds the discussion plan (docs/product/continuous-creative-workflow.md) and four proposed ADRs for background refinement + native review: - ADR-0061 creative work persists across bounded refinement rounds - ADR-0062 candidates are isolated, versioned, and promoted explicitly - ADR-0063 background work is resumable and uses an external runner - ADR-0064 review is a first-class workspace alongside creation Reconciled against the trunk before proposing: - the preferred-version reference is a DOCUMENT field, so promotion is one edit-gateway command and undo restores content + pointer together; a whole-document revision counter (per-clip `rev` precedent) backs the stale-promotion check (ADR-0062) - the worker shares no per-user mutable state: VIVID_PORT, the single autosave/recovery slot + crash/quarantine records, VIVID_NO_RECOVER; project-local operators compile into the candidate copy (ADR-0063) - the deterministic offline AV export is already the worker's surface-free render primitive; the gap is device-free bring-up (headless GPU context, no audio device, sample rate as a job input), not a new render loop (ADR-0063) - Candidate vs. the planned Take / Variation Well: same audition/keep/choose pattern at version vs. cell scope; a promoted or kept clip-scoped candidate lands in the well as a take; the well holds content only (ADR-0062/0064, glossary) All four remain `proposed` with acceptance evidence pending. Glossary gains a "Background Refinement Vocabulary (proposed)" section; docs/README.md points at the proposal. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
jeffcrouse
enabled auto-merge (squash)
September 18, 2026 00:49
Contributor
Production gate (core): ✅ PASS
|
jeffcrouse
deleted the
docs-adr-0061-0064-continuous-creative-workflow
branch
September 18, 2026 01:18
4 of 5 tasks
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
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
Adds the discussion plan
docs/product/continuous-creative-workflow.mdand four proposed ADRs for background refinement + native review:Also: a "Background Refinement Vocabulary (proposed)" section in the glossary, and a pointer from
docs/README.md.Reconciled against the trunk before proposing
UndoManager's whole-document snapshots restore both for free. A whole-document revision counter (per-cliprevfrom #313 is the precedent) backs the stale-promotion check, including unsaved manual edits. (ADR-0062 §1/§3/§4/§5)VIVID_PORT(main.cpp:594), the single autosave/recovery slot underuser_data_dir()/autosave/(a worker autosave would populate the foreground's recovery prompt), crash-history/quarantine records,VIVID_NO_RECOVER. Project-local operators compile into the candidate copy on load (isolation holds; a compile per worker load; build outputs are not snapshot content). (ADR-0063 §2 + acceptance evidence)av_bounce_app.cpp) already renders surface-free at a synthetic clock and is resumable. The gap is device-free bring-up:GpuContext::initneeds aGLFWwindow*/compatibleSurface, andav_export_startrefuses without a device-derived sample rate. Worker = headless GPU context + no audio device + sample rate as a job input. (ADR-0063 Consequences + acceptance evidence)Status
All four ADRs are
proposedwith acceptance evidence pending — no runner, automation, or UI change is created here. Proof sequence in the discussion doc: Review UX → persistence across agent restart → isolated background execution → multi-day rounds.Test plan
🤖 Generated with Claude Code