ADR 0273: the agent's home is the module's, and the operator's personal rules and lessons are registered through it #254

Merged
mesh-admin merged 2 commits from decision/0273-the-agents-home-configuration-is-the-modules into main 2026-10-09 17:26:55 +00:00
Contributor

Research 040 measured the agent's home on all four nodes on 2026-10-09: nothing placed by the mesh, a retired skill still on all four, the operator's two hand-written rules on the laptop alone, the agent's corrections in one machine's memory.

Decided (ADR 0273, extends ADR 0216, accepted on the operator's direction 2026-10-09):

  1. The claude-code module owns every configuration file under the agent's home (instruction file, rules/, skills/, commands/, agents/, hooks/, settings.json), rendered from registrations, never written by hand; working state excluded by name; a hand edit is the warning agent-home-drift; the guard refuses writes under rendered paths.
  2. A fourth scope, the operator's, and a new kind, the personal rule, rendered on every node naming an operator account; the two existing rules, the skills and settings.json are the first registrations.
  3. Into the operator's home only at the controller's terminal (nox) or on a warrant on an approve ask (ADR 0259); issue 340's protection stands.
  4. Lessons: trigger, cause and rule recorded when the operator is frustrated or corrects a way of working; proposed, accepted or declined by the operator; an accepted lesson is a personal rule; the session-start hook and the guard remind the agent.

Also: to-be 36 §1/§10, to-be 40 WP7-WP10 (builder's brief), notes on ADR 0216 and 0243, glossary entries personal rule and lesson, issue 340 points at to-be 36.

merge-check.sh passes (records, index, cycle, words).

Research 040 measured the agent's home on all four nodes on 2026-10-09: nothing placed by the mesh, a retired skill still on all four, the operator's two hand-written rules on the laptop alone, the agent's corrections in one machine's memory. Decided (ADR 0273, extends ADR 0216, accepted on the operator's direction 2026-10-09): 1. The claude-code module owns every configuration file under the agent's home (instruction file, rules/, skills/, commands/, agents/, hooks/, settings.json), rendered from registrations, never written by hand; working state excluded by name; a hand edit is the warning agent-home-drift; the guard refuses writes under rendered paths. 2. A fourth scope, the operator's, and a new kind, the personal rule, rendered on every node naming an operator account; the two existing rules, the skills and settings.json are the first registrations. 3. Into the operator's home only at the controller's terminal (nox) or on a warrant on an approve ask (ADR 0259); issue 340's protection stands. 4. Lessons: trigger, cause and rule recorded when the operator is frustrated or corrects a way of working; proposed, accepted or declined by the operator; an accepted lesson is a personal rule; the session-start hook and the guard remind the agent. Also: to-be 36 §1/§10, to-be 40 WP7-WP10 (builder's brief), notes on ADR 0216 and 0243, glossary entries personal rule and lesson, issue 340 points at to-be 36. merge-check.sh passes (records, index, cycle, words).
mesh-admin added 1 commit 2026-10-09 16:15:10 +00:00
ADR 0273: the agent's home is the module's, and the operator's personal rules and lessons are registered through it
mesh/merge-gate pass: the change touches no module of the mesh's graph
mesh/repo-check pass: its merge-check.sh passed
mesh/delivery superseded: a newer head of the same pull request
2b1edf046d
Research 040 measured the homes on four nodes: a skill retired a week ago on all four, the
operator's rules on one, nothing raised. The module now owns every configuration file under
the agent's home, excludes the program's working state by name, and raises agent-home-drift
on a hand edit; a fourth scope carries the operator's personal rules to every node; an agent
proposes a lesson when corrected and the operator accepts it at the terminal or on a warrant.
To-be 36 §10 and to-be 40 WP7–WP10 say what is built; ADR 0216 and 0243 gain notes.
Author
Contributor

Delivery novox/hq@a5433164c57b — delivered since 2026-10-09T17:27:11Z

Delivery plan — builds nothing: the change touches no module of the mesh's graph

Transitions

  • 2026-10-09 17:25 (new) → proposed (announced): novox/hq#254's head announced
  • 2026-10-09 17:25 proposed → checked (checked): the verdict names this commit
  • 2026-10-09 17:25 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail
  • 2026-10-09 17:27 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move
  • 2026-10-09 17:27 published → delivered (done): nothing for a walk to move

The commit's note under refs/notes/mesh-plan keeps every transition: git log --notes=mesh-plan.

<!-- mesh-delivery:view --> **Delivery** `novox/hq@a5433164c57b` — **delivered** since 2026-10-09T17:27:11Z **Delivery plan** — builds nothing: the change touches no module of the mesh's graph **Transitions** - 2026-10-09 17:25 (new) → proposed (announced): novox/hq#254's head announced - 2026-10-09 17:25 proposed → checked (checked): the verdict names this commit - 2026-10-09 17:25 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail - 2026-10-09 17:27 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move - 2026-10-09 17:27 published → delivered (done): nothing for a walk to move The commit's note under `refs/notes/mesh-plan` keeps every transition: `git log --notes=mesh-plan`.
jschoubben added 1 commit 2026-10-09 17:24:38 +00:00
ADR 0273: act on drift at once, watch settings.local.json and plugins, and move unrendered files after adoption
mesh/merge-gate pass: the change touches no module of the mesh's graph
mesh/repo-check pass: its merge-check.sh passed
mesh/delivery delivered
a5433164c5
Review of hq #254: a hand edit is written back on the look that finds it, and a key that
decides what runs is never taken over; the guard and the condition cover settings.local.json,
plugins and plugin installs; after a node's first adoption an unrendered file is moved to the
copies; autoMode is a permission rule; the named leftovers, the owned and excluded entries,
pending requests with the exact nox line, and the agent's existing corrections as first lessons.
mesh-admin merged commit 1365ec17c8 into main 2026-10-09 17:26:55 +00:00
mesh-admin deleted branch decision/0273-the-agents-home-configuration-is-the-modules 2026-10-09 17:26:56 +00:00
Sign in to join this conversation.
No Reviewers
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novox/hq#254