diff --git a/OPSTACK-HANDOFF.md b/OPSTACK-HANDOFF.md index add374d..68a6c3b 100644 --- a/OPSTACK-HANDOFF.md +++ b/OPSTACK-HANDOFF.md @@ -151,7 +151,11 @@ built and green. "~[-1,1]". Over-estimating costs CPU; under-estimating deletes collision. - `ProcessQueue` stays `EQueueMode::Mpsc`; `Epoch` carries through every async path; don't "optimize" the `ARCHITECTURE §8.10` invariants. -- Commit per coherent unit with a real message. **Never push.** `main` is the known-good fallback. +- Commit per coherent unit with a real message. **`experimental` is pushed and tracked + (`origin/experimental`, since 2026-07-29) — keep it in sync. NEVER push `main`**, which stays the + known-good fallback at the commit it has always been. ⚠️ A pushed commit here is **not** a + "verified green" marker: the branch carries unbuilt work by design, and only `OPSTACK-PROGRESS.md` + says what was actually built. - Update `CODEMAP §3`, `ARCHITECTURE §8`, tick `OPSTACK-PLAN`, append to `OPSTACK-PROGRESS.md`. - **When inserting a class into `VoxelDensityOpStack.cpp` / `VoxelHeightOpStack.cpp`, put it ABOVE the labelled end of the anonymous namespace.** Anchoring on the FACTORIES banner puts it outside, diff --git a/OPSTACK-PROMPT.md b/OPSTACK-PROMPT.md index 56485df..94263b5 100644 --- a/OPSTACK-PROMPT.md +++ b/OPSTACK-PROMPT.md @@ -146,7 +146,9 @@ mid-edit, and nobody will be watching.** Everything below follows from that. CRASH-SAFE DISCIPLINE (non-negotiable when unattended) 1. `git commit` after every coherent unit — a file, a test, a header. Small and often. You are on branch `experimental`; `main` is the known-good fallback, so committing costs nothing and a - half-finished commit is infinitely better than an uncommitted half-edit. Never push. + half-finished commit is infinitely better than an uncommitted half-edit. Pushing `experimental` + is fine and expected (it is tracked as `origin/experimental` since 2026-07-29); **never push + `main`.** 2. Maintain `OPSTACK-PROGRESS.md` at the plugin root. APPEND (never rewrite) a dated entry per milestone: what you did, what you believe is true, what is UNVERIFIED (i.e. everything not yet built), and the single next action. Write the entry BEFORE starting the work it describes, so an