docs: #1272 - [Planner]: GPU Condensation Physics Parity#1273
Conversation
Add the epic-level and feature-level planning documents for the GPU condensation physics parity effort. The new plan set captures the problem statement, milestones, dependencies, risks, and implementation strategy for the E4 workstream. Closes uncscode#1272 ADW-ID: 8046db7b
Plan clarification questionsReviewed plans: E4, E4-F1, E4-F2, E4-F3, E4-F4, E4-F5, E4-F6, E4-F7. Found 51 unresolved decision groups: 1 reviewer-curated question and 50 residual questions/marker groups. These should be resolved before implementation or explicitly assigned to the named phase. Reviewer-curated — blocking
Residual questions by document.opencode/plans/sections/epics/E4/open_questions.md:3-8
.opencode/plans/sections/features/E4-F1/open_questions.md:3-12
.opencode/plans/sections/features/E4-F2/open_questions.md:3-12
.opencode/plans/sections/features/E4-F3/open_questions.md:3-16
.opencode/plans/sections/features/E4-F4/open_questions.md:9-16
.opencode/plans/sections/features/E4-F5/open_questions.md:3-13
.opencode/plans/sections/features/E4-F6/open_questions.md:3-14
.opencode/plans/sections/features/E4-F7/open_questions.md:3-14
Residual marker groups
No accepted answers were present in workflow spec context, so no unresolved items were suppressed. |
Gorkowski
left a comment
There was a problem hiding this comment.
Clarification required: Should the M/L milestone labels represent aggregate workstream scope, or should the work be split/relabelled so each label represents implementation-phase size?
There was a problem hiding this comment.
Pull request overview
This PR adds the planning artifacts for Epic E4: GPU Condensation Physics Parity under .opencode/plans/, defining a 7-track dependency-ordered plan (E4-F1..E4-F7) plus epic narrative sections (vision, scope, risks, milestones, etc.) to guide upcoming implementation work.
Changes:
- Added the E4 epic plan record and narrative sections describing scope/constraints, dependency ordering, and guardrails.
- Added feature plan records (E4-F1..E4-F7) and their section documents (architecture, tasks, testing strategy, success criteria, etc.).
- Established testing/validation expectations for Warp CPU baseline, optional CUDA parity, conservation, and documentation guardrails.
Reviewed changes
Copilot reviewed 112 out of 112 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| .opencode/plans/epics/E4.json | Epic E4 plan metadata record |
| .opencode/plans/features/E4-F1.json | Feature plan metadata for E4-F1 |
| .opencode/plans/features/E4-F2.json | Feature plan metadata for E4-F2 |
| .opencode/plans/features/E4-F3.json | Feature plan metadata for E4-F3 |
| .opencode/plans/features/E4-F4.json | Feature plan metadata for E4-F4 |
| .opencode/plans/features/E4-F5.json | Feature plan metadata for E4-F5 |
| .opencode/plans/features/E4-F6.json | Feature plan metadata for E4-F6 |
| .opencode/plans/features/E4-F7.json | Feature plan metadata for E4-F7 |
| .opencode/plans/sections/epics/E4/appendix.md | Epic E4 appendix/references |
| .opencode/plans/sections/epics/E4/change_log.md | Epic E4 change log |
| .opencode/plans/sections/epics/E4/child_plans.md | Epic E4 child-plan index |
| .opencode/plans/sections/epics/E4/dependency_map.md | Epic E4 dependency graph |
| .opencode/plans/sections/epics/E4/governance.md | Epic E4 governance/decisions |
| .opencode/plans/sections/epics/E4/implementation_strategy.md | Epic E4 implementation strategy |
| .opencode/plans/sections/epics/E4/milestones_timeline.md | Epic E4 milestones/timeline template |
| .opencode/plans/sections/epics/E4/open_questions.md | Epic E4 open questions |
| .opencode/plans/sections/epics/E4/outcomes_guardrails.md | Epic E4 outcomes + non-goals |
| .opencode/plans/sections/epics/E4/risk_register.md | Epic E4 risk register |
| .opencode/plans/sections/epics/E4/scope_constraints.md | Epic E4 scope/constraints |
| .opencode/plans/sections/epics/E4/success_metrics.md | Epic E4 success metrics |
| .opencode/plans/sections/epics/E4/vision_problem.md | Epic E4 vision/problem statement |
| .opencode/plans/sections/features/E4-F1/architecture_design.md | E4-F1 architecture section |
| .opencode/plans/sections/features/E4-F1/change_log.md | E4-F1 change log section |
| .opencode/plans/sections/features/E4-F1/dependencies.md | E4-F1 dependencies section |
| .opencode/plans/sections/features/E4-F1/documentation_updates.md | E4-F1 documentation updates section |
| .opencode/plans/sections/features/E4-F1/implementation_tasks.md | E4-F1 implementation tasks section |
| .opencode/plans/sections/features/E4-F1/infrastructure_reuse.md | E4-F1 infrastructure reuse section |
| .opencode/plans/sections/features/E4-F1/open_questions.md | E4-F1 open questions section |
| .opencode/plans/sections/features/E4-F1/overview.md | E4-F1 overview section |
| .opencode/plans/sections/features/E4-F1/phase_details.md | E4-F1 phase breakdown section |
| .opencode/plans/sections/features/E4-F1/risk_register.md | E4-F1 risk register section |
| .opencode/plans/sections/features/E4-F1/scope.md | E4-F1 scope section |
| .opencode/plans/sections/features/E4-F1/success_criteria.md | E4-F1 success criteria section |
| .opencode/plans/sections/features/E4-F1/testing_strategy.md | E4-F1 testing strategy section |
| .opencode/plans/sections/features/E4-F2/architecture_design.md | E4-F2 architecture section |
| .opencode/plans/sections/features/E4-F2/change_log.md | E4-F2 change log section |
| .opencode/plans/sections/features/E4-F2/dependencies.md | E4-F2 dependencies section |
| .opencode/plans/sections/features/E4-F2/documentation_updates.md | E4-F2 documentation updates section |
| .opencode/plans/sections/features/E4-F2/implementation_tasks.md | E4-F2 implementation tasks section |
| .opencode/plans/sections/features/E4-F2/infrastructure_reuse.md | E4-F2 infrastructure reuse section |
| .opencode/plans/sections/features/E4-F2/open_questions.md | E4-F2 open questions section |
| .opencode/plans/sections/features/E4-F2/overview.md | E4-F2 overview section |
| .opencode/plans/sections/features/E4-F2/phase_details.md | E4-F2 phase breakdown section |
| .opencode/plans/sections/features/E4-F2/risk_register.md | E4-F2 risk register section |
| .opencode/plans/sections/features/E4-F2/scope.md | E4-F2 scope section |
| .opencode/plans/sections/features/E4-F2/success_criteria.md | E4-F2 success criteria section |
| .opencode/plans/sections/features/E4-F2/testing_strategy.md | E4-F2 testing strategy section |
| .opencode/plans/sections/features/E4-F3/architecture_design.md | E4-F3 architecture section |
| .opencode/plans/sections/features/E4-F3/change_log.md | E4-F3 change log section |
| .opencode/plans/sections/features/E4-F3/dependencies.md | E4-F3 dependencies section |
| .opencode/plans/sections/features/E4-F3/documentation_updates.md | E4-F3 documentation updates section |
| .opencode/plans/sections/features/E4-F3/implementation_tasks.md | E4-F3 implementation tasks section |
| .opencode/plans/sections/features/E4-F3/infrastructure_reuse.md | E4-F3 infrastructure reuse section |
| .opencode/plans/sections/features/E4-F3/open_questions.md | E4-F3 open questions section |
| .opencode/plans/sections/features/E4-F3/overview.md | E4-F3 overview section |
| .opencode/plans/sections/features/E4-F3/phase_details.md | E4-F3 phase breakdown section |
| .opencode/plans/sections/features/E4-F3/risk_register.md | E4-F3 risk register section |
| .opencode/plans/sections/features/E4-F3/scope.md | E4-F3 scope section |
| .opencode/plans/sections/features/E4-F3/success_criteria.md | E4-F3 success criteria section |
| .opencode/plans/sections/features/E4-F3/testing_strategy.md | E4-F3 testing strategy section |
| .opencode/plans/sections/features/E4-F4/architecture_design.md | E4-F4 architecture section |
| .opencode/plans/sections/features/E4-F4/change_log.md | E4-F4 change log section |
| .opencode/plans/sections/features/E4-F4/dependencies.md | E4-F4 dependencies section |
| .opencode/plans/sections/features/E4-F4/documentation_updates.md | E4-F4 documentation updates section |
| .opencode/plans/sections/features/E4-F4/implementation_tasks.md | E4-F4 implementation tasks section |
| .opencode/plans/sections/features/E4-F4/infrastructure_reuse.md | E4-F4 infrastructure reuse section |
| .opencode/plans/sections/features/E4-F4/open_questions.md | E4-F4 open questions section |
| .opencode/plans/sections/features/E4-F4/overview.md | E4-F4 overview section |
| .opencode/plans/sections/features/E4-F4/phase_details.md | E4-F4 phase breakdown section |
| .opencode/plans/sections/features/E4-F4/risk_register.md | E4-F4 risk register section |
| .opencode/plans/sections/features/E4-F4/scope.md | E4-F4 scope section |
| .opencode/plans/sections/features/E4-F4/success_criteria.md | E4-F4 success criteria section |
| .opencode/plans/sections/features/E4-F4/testing_strategy.md | E4-F4 testing strategy section |
| .opencode/plans/sections/features/E4-F5/architecture_design.md | E4-F5 architecture section |
| .opencode/plans/sections/features/E4-F5/change_log.md | E4-F5 change log section |
| .opencode/plans/sections/features/E4-F5/dependencies.md | E4-F5 dependencies section |
| .opencode/plans/sections/features/E4-F5/documentation_updates.md | E4-F5 documentation updates section |
| .opencode/plans/sections/features/E4-F5/implementation_tasks.md | E4-F5 implementation tasks section |
| .opencode/plans/sections/features/E4-F5/infrastructure_reuse.md | E4-F5 infrastructure reuse section |
| .opencode/plans/sections/features/E4-F5/open_questions.md | E4-F5 open questions section |
| .opencode/plans/sections/features/E4-F5/overview.md | E4-F5 overview section |
| .opencode/plans/sections/features/E4-F5/phase_details.md | E4-F5 phase breakdown section |
| .opencode/plans/sections/features/E4-F5/risk_register.md | E4-F5 risk register section |
| .opencode/plans/sections/features/E4-F5/scope.md | E4-F5 scope section |
| .opencode/plans/sections/features/E4-F5/success_criteria.md | E4-F5 success criteria section |
| .opencode/plans/sections/features/E4-F5/testing_strategy.md | E4-F5 testing strategy section |
| .opencode/plans/sections/features/E4-F6/architecture_design.md | E4-F6 architecture section |
| .opencode/plans/sections/features/E4-F6/change_log.md | E4-F6 change log section |
| .opencode/plans/sections/features/E4-F6/dependencies.md | E4-F6 dependencies section |
| .opencode/plans/sections/features/E4-F6/documentation_updates.md | E4-F6 documentation updates section |
| .opencode/plans/sections/features/E4-F6/implementation_tasks.md | E4-F6 implementation tasks section |
| .opencode/plans/sections/features/E4-F6/infrastructure_reuse.md | E4-F6 infrastructure reuse section |
| .opencode/plans/sections/features/E4-F6/open_questions.md | E4-F6 open questions section |
| .opencode/plans/sections/features/E4-F6/overview.md | E4-F6 overview section |
| .opencode/plans/sections/features/E4-F6/phase_details.md | E4-F6 phase breakdown section |
| .opencode/plans/sections/features/E4-F6/risk_register.md | E4-F6 risk register section |
| .opencode/plans/sections/features/E4-F6/scope.md | E4-F6 scope section |
| .opencode/plans/sections/features/E4-F6/success_criteria.md | E4-F6 success criteria section |
| .opencode/plans/sections/features/E4-F6/testing_strategy.md | E4-F6 testing strategy section |
| .opencode/plans/sections/features/E4-F7/architecture_design.md | E4-F7 architecture section |
| .opencode/plans/sections/features/E4-F7/change_log.md | E4-F7 change log section |
| .opencode/plans/sections/features/E4-F7/dependencies.md | E4-F7 dependencies section |
| .opencode/plans/sections/features/E4-F7/documentation_updates.md | E4-F7 documentation updates section |
| .opencode/plans/sections/features/E4-F7/implementation_tasks.md | E4-F7 implementation tasks section |
| .opencode/plans/sections/features/E4-F7/infrastructure_reuse.md | E4-F7 infrastructure reuse section |
| .opencode/plans/sections/features/E4-F7/open_questions.md | E4-F7 open questions section |
| .opencode/plans/sections/features/E4-F7/overview.md | E4-F7 overview section |
| .opencode/plans/sections/features/E4-F7/phase_details.md | E4-F7 phase breakdown section |
| .opencode/plans/sections/features/E4-F7/risk_register.md | E4-F7 risk register section |
| .opencode/plans/sections/features/E4-F7/scope.md | E4-F7 scope section |
| .opencode/plans/sections/features/E4-F7/success_criteria.md | E4-F7 success criteria section |
| .opencode/plans/sections/features/E4-F7/testing_strategy.md | E4-F7 testing strategy section |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| "owners": [], | ||
| "start_date": null, | ||
| "target_date": null, | ||
| "completion_date": null, | ||
| "last_updated": null, | ||
| "dependencies": [], |
| "completion_date": null, | ||
| "last_updated": "2026-07-13", | ||
| "dependencies": [], | ||
| "section_files": { |
| "completion_date": null, | ||
| "last_updated": "2026-07-13", | ||
| "dependencies": [], | ||
| "section_files": { |
| "completion_date": null, | ||
| "last_updated": "2026-07-13", | ||
| "dependencies": [], | ||
| "section_files": { |
| "completion_date": null, | ||
| "last_updated": "2026-07-13", | ||
| "dependencies": [], | ||
| "section_files": { |
Document code-backed decisions across E4 and all child plans, clarify deferred scheduling and aggregate milestone sizing, and align machine-readable dependency metadata with the plan graph.
E4 clarification resolutionResolved the reviewer-curated question and all residual question groups across E4 and E4-F1 through E4-F7 in commit Key decisions:
Metadata fixes:
Validation:
|
🤖 Agent Developer Workflow
Current Status
Workflow Plan
📋 Recent Activity🔍 Archived UpdatesThis comment is automatically updated as the workflow progresses |
Update the E4 feature plan sections to reflect review decisions on milestone labeling, typed keyword-only sidecars, latent-heat handling, and autodiff scope. This keeps the planning artifacts aligned with the latest implementation and testing guidance before the ship step. Closes uncscode#1273 ADW-ID: 300ac127
Fix SummaryUpdated the E4 plan set to reflect the review decisions for milestone labeling, typed operation sidecars, vapor-pressure handling, condensation return shape, inventory-limit behavior, parity/conservation targets, and autodiff scope. Changes Made
Review Comments Addressed
Files ChangedPlan sections and manifests across E4, E4-F1 through E4-F7 (112 files total). Automated fix by ADW workflow |
Target Branch:
mainFixes #1272 | Workflow:
8046db7bSummary
Adds the planning artifacts for the GPU condensation physics parity epic. This PR captures the scope, dependencies, implementation strategy, risks, and success criteria for the fixed-shape Warp condensation path, including vapor-pressure refresh, selected activity/surface-tension models, four-substep integration, latent-heat bookkeeping, gas-coupled conservation, and validation gates.
What Changed
New Components
.opencode/plans/epics/E4.json- Epic-level plan record for the GPU condensation parity track..opencode/plans/features/E4-F1.jsonthrough.opencode/plans/features/E4-F7.json- Child feature-track plan records covering thermodynamic configuration, physics models, substep integration, latent heat, gas coupling, parity evidence, and documentation..opencode/plans/sections/epics/E4/*- Epic narrative sections for vision, strategy, dependency map, milestones, risks, and outcomes..opencode/plans/sections/features/E4-F1/*throughE4-F7/*- Feature sections detailing scope, architecture, tasks, tests, dependencies, and success criteria.Modified Components
.opencode/plans/- Populated the multi-track epic structure and aligned child tracks with their dependency order and validation signals.How It Works
The epic is structured as a dependency-ordered planning tree:
Each child track has a dedicated feature plan with explicit implementation steps and done signals so downstream implementation work can proceed in a controlled order.
Implementation Notes
Testing