← ClaudeAtlas

engine_surgerylisted

Procedure for changing the engine you are running — pull/reconcile/restart cadence and their costs, three-artifact engine-skill commits with a hermetic mirror render, migrating the live DB safely, and verifying claims about engine code against the remote rather than a possibly-stale checkout. SOURCE-REPO ONLY; a fork consumes the engine as a pinned dependency and never edits it. Load before touching .super-coder/ in the repo that owns it.
jedbjorn/subfloor · ★ 14 · Code & Development · score 76
Install: claude install-skill jedbjorn/subfloor
# engine_surgery — changing the engine you are running This repo IS the engine. Every shell here runs on the code it edits, reads a DB it migrates, and is served by a process started from the tree it commits to. That is surgery on a moving car, and it has one characteristic failure mode: **a command answers confidently from a target you did not mean.** **Fork shells never load this.** A fork consumes `.super-coder/` as a gitignored dependency pinned by `engine.ref` and updates it with `./sc update`; it never authors engine changes. Granted only in the source repo. ## The four trees, and which one bites | tree | what it is | who keeps it current | |---|---|---| | your worktree | `.sc-worktrees/<shortname>` — your cwd, your branch | you; boot reports it as `sync:` | | the main checkout | resolves your `./sc`, hosts the live DB, runs the server | admin / the FnB; boot reports it as `floor:` | | the running process | code already imported — changes only on restart | the FnB | | `origin/main` | the truth | whoever merged last | `sc:11-21` derives the engine root from git's **common dir**, so `./sc` from any worktree reads the MAIN CHECKOUT. Being current in your own tree tells you nothing about it. Read the `floor:` line in ACTIVE SESSION. **Verify any claim about engine code against the remote:** ``` git show origin/main:<path> # correct ./sc help | grep <thing> # answers from the main checkout — may be stale ``` Three wrong answers in one session came from ski