Delegation, Isolation and Feedback Ratchets

Plan from evidence, split work by exclusive ownership, and promote each correction to the earliest owning layer.

Plan, delegate, integrate#

Factor	Delegate	Keep serial
Files	Disjoint files and contracts	Same files
Decisions	Different unknowns	Same unresolved decision
Environment	Separate worktrees or sandboxes	Same mutable environment
Lab example	API and docs units, disjoint paths	Docs unit owns app/, plan blocks

Filesystem: separate worktrees or sandboxes stop accidental shared edits.
Ownership: contracts stop two workers from editing the same path.
State: separate logs and outputs keep each worker's evidence.
Limit: two clean worktrees can still produce conflicting designs.
Integrator: reads proof output, merges in dependency order, runs the full gate.

When is evidence real?: When it can change the plan.
Integrator rewrites most of a result?: The decomposition was wrong.
Why count sessions, not events?: Repeated hook delivery is not independent evidence.
Promote every correction?: No. Only when recurrence or consequence justifies it.
Who owns public behavior changes?: The human. Agents own bounded work.

Command	What it does
`python3 scripts/project_test.py workflow-hooks --init learning-artifacts/workflow-hooks`	Makes the learner workspace
`python3 scripts/project_test.py workflow-hooks --stage <n> --path learning-artifacts/workflow-hooks`	Tests one stage
`python3 scripts/project_test.py workflow-hooks --all --solution --strict`	Checks the reference solution
`node <dir>/cli.ts capture <store> <corrections.jsonl>`	Ingests corrections and saves the store
`node <dir>/cli.ts inspect <store>`	Lists rules with `approval_digest`
`node <dir>/cli.ts approve <store> <digest>`	Approves the rule with the exact current digest
`node <dir>/cli.ts emit <store> <scope>`	Prints `additional_context` for approved rules in scope
`node <dir>/cli.ts retire <store> <digest>`	Removes the rule from emits. Evidence stays

const c = ingest(raw);scope lowercased, rule case kept

const rules = consolidate(corrections);group by scope and rule text

rule.sessions.lengthunique sessions, not events

transition(rule, "approve");needs minimumSessions = 2

transition(rule, "retire");retired cannot be approved

hook(rules, "orchard");approved, scope or global

ruleDigest(rule);sha256 of scope, text, evidence

await save("rules.json", rules);temp file, then fs.rename

await load("rules.json");ENOENT gives an empty list

Setting	Default	Note
`minimumSessions`	2	Independent sessions to approve
`c.rule.length`	500	Larger rule is "too large"
`c.source.length`	2000	Larger source is "too large"
Store `version`	1	Other versions give "invalid store"
Temp file `mode`	0o600	Owner-only permissions
`recurrence` floor	1	Below it the correction is skipped
Control fingerprint	12	Hex characters of sha256
Signal `severity`	range(1, 6)	Frequency must be positive

Symptom	Cause	Fix
`has no repository evidence`	A work item has no receipt	Add a file path and line
`has no proof command`	Empty proof	Name the exact check that closes it
`dependency cycle among`	Items wait on each other	Find the hidden product disagreement
`overlap at` in `conflicts`	Docs unit owns `app/`, a parent path	Give each unit exclusive paths
`insufficient independent sessions`	One session, many events	Wait for a second session
`exact current rule digest required`	Digest is old after new evidence	Run inspect, approve the new digest
`credential-like content`	Rule or source holds a key shape	Redact before ingestion
`conflicting correction id`	Same id, different content	Never reuse an id for new content