Live-tree restructure reference, four-column effects index, sensitivity-shelf template (field-tested) - #11
Open
micahvv wants to merge 3 commits into
Open
Live-tree restructure reference, four-column effects index, sensitivity-shelf template (field-tested)#11micahvv wants to merge 3 commits into
micahvv wants to merge 3 commits into
Conversation
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.
What this method needed after a full home-directory restructure across a dozen repositories and
several agent accounts, four repository system maps, and a nightly drift report — done with the
tree in use throughout.
references/live-tree-restructure.md(new). Restructure mode assumes you can move a file andthen check the result. On a live tree the failures are silent — a scheduled job whose input moved
reports success on an empty set. The reference covers what we actually did: a census before any
design (who has the tree open, every working copy mapped to its parent repo, every
credential-shaped name recorded and never opened, what runs on a schedule); moving the method's
own corpus first; a consumers register where any task writing a path a later phase renames appends
a row, and a phase closes only when every row is DONE or explicitly re-registered; one guarded move
primitive that halts rather than guess; the gates; the worktree convention; the grep gate for
shared repositories; the drift report that catches the decay.
references/system-map.md— four amendments, each from something that failed in the field:test's own step 4, which asks for hits AND does-not-hit.
_index.mdlinevia an anchor and reads
(stub). Mechanical existence check over the diff, before every commit.built-atis by construction thePARENT of the commit that adds it, so sha equality can never mean "current" once a map lands;
every consumer testing it that way calls every real map stale, forever. Record a content hash of
the parsed source set beside the graph and test currency by content.
15k-token house-rules book is out of the map's scope; record it as an observation.
Two templates: the four-column
effects-CONTEXT.md, andprivate-shelf-CONTEXT.mdfor aworkspace with a sensitivity shelf (tiered, with a load rule an agent can follow).
No scripts and no dependencies. We run a graph generator and two hooks behind this, but they are
Node and Python with a lockfile; the reference is written so the method stands without them.