4315bb6307
A subagent works from hq; a coding one in a worktree under hq's .work, also reading its repository's conventions (the operator, 2026-11-03)
jschoubben2026-11-03 12:46:24 +01:00
e8c154c3a0
Agent definitions: the developer on the smaller model unless the lead says why; review notes
jschoubben2026-11-03 12:15:48 +01:00
666c9271dc
mesh-developer: the test budget is read from the instructions, not copied
jschoubben2026-11-03 12:15:19 +01:00
d829fd6f9b
Playbook 02: name no record in the seams rule
jschoubben2026-11-03 12:14:48 +01:00
10df1c7be5
Playbooks overview: agents from hq's definitions; the seams review of every prepare
jschoubben2026-11-03 12:14:25 +01:00
8420c6f236
Agents work from hq's definitions and start from the knowledge base; every prepare and record gets the seams review (the operator, 2026-11-03)
jschoubben2026-11-03 12:14:12 +01:00
9a2d398070
Merge pull request 'Bus state by template, no readers, and the ledger: designs 25, 32 and 55 and the glossary follow ADR 0595-0597' (#506) from docs/1966-bus-state into main
mesh-tools2026-11-03 10:21:09 +00:00
476557deeb
The review record's seams row names the process's own tool subject
jschoubben2026-11-03 10:51:18 +01:00
3d4e361425
Designs 25, 32 and 55 record their review by architectural domain
jschoubben2026-11-03 10:50:27 +01:00
0cd0cfd778
Design 25 names the signed caller and what the watchman newly hears; design 55 checks the database at every start before the drop
jschoubben2026-11-03 10:49:43 +01:00
c033592509
Design 25's bus module is unhealthy only on a verdict left unanswered; design 55 keeps its sent events in a state of its own
jschoubben2026-11-03 10:49:10 +01:00
221165c712
Designs 25 and 55 answer the review by architectural domain: the bus module's events on its old sections, overdue creation raised by the watchman, the proven author, events and the database caught up after a restart, the bus module's integration test
jschoubben2026-11-03 10:47:44 +01:00
ed67d1f84f
Bus state by template, no readers, and the ledger: designs 25, 32 and 55 and the glossary follow ADR 0595-0597
jschoubben2026-11-03 10:42:58 +01:00
08b968fd80
Merge pull request 'Design 47: the bus module is wanted like any module; only a warranted want replaces its server (ADR 0594)' (#505) from docs/774-bus-want into main
mesh-tools2026-11-03 01:09:31 +00:00
b01f867345
Design 47: the bus module's want follows ADR 0594
jschoubben2026-11-03 02:02:39 +01:00
92fa66f4e7
Merge pull request 'A research effort's reading tasks run on one agent definition, research-reader' (#504) from docs/research-reader into main
mesh-tools2026-11-03 00:51:58 +00:00
6bc1f7cc10
research-reader cites no path, as playbook 01 asks; AGENTS.md rewrapped
jschoubben2026-11-03 01:45:29 +01:00
402ac3bfda
Design 47: the assigner writes the bus module's want only to a node agent that keeps the server, and the test says so
jschoubben2026-11-03 01:44:38 +01:00
ae4c90f990
Design 47: the bus module is wanted like any module, and only a put replaces its server (issue 774, the operator 2026-11-03)
jschoubben2026-11-03 01:37:31 +01:00
4d4524cda3
Merge pull request 'Design 55: the knowledge base keeps its records on the bus and is written and reviewed by section (ADR 0592, ADR 0593 §10)' (#502) from feat/kb-nats-native into main
mesh-tools2026-11-03 00:07:23 +00:00
5accd21320
Merge pull request 'Playbook 07 and design 47 after the controller left: run as the running checker, let the running parts judge, L2 delivered' (#503) from docs/1126-after-controller into main
mesh-tools2026-11-03 00:05:04 +00:00
3a3501d9f4
Playbook 07 and design 47: say how the two new rules are checked; glossary words; name where the bus module has no want
jschoubben2026-11-03 00:58:19 +01:00
8402a7d773
Design 47: L2 is built and delivered as release sdk1, done once a check composes on every machine; L3 names what the controller's leaving left unwritten (issue 1126, issue 774)
jschoubben2026-11-03 00:57:29 +01:00
5d9a654767
Playbook 07: run every suite as the running checker places it, and let the running parts judge a release that changes them (issue 1126, release sdk1)
jschoubben2026-11-03 00:52:28 +01:00
1a389be090
A research effort's reading tasks run on one agent definition, research-reader, instead of a prompt written by hand each time
jschoubben2026-11-03 00:28:06 +01:00
c2b162a9e8
Design 55: readers by grant, the take-over refused while an Approve waits, the grants part's own test, §30 for nesting, the glossary's word in the review table
jschoubben2026-11-02 19:58:01 +01:00
3122e8be84
Design 55: follow ADR 0593: the mesh-sdk release sdk1 does the controller's part (the grants part creates, grants and warns; the indexer's judge checks the forms)
jschoubben2026-11-02 19:55:39 +01:00
36517018d3
Design 55: one more use of the chosen word
jschoubben2026-11-02 19:21:58 +01:00
b8ad9da784
Design 55: the review section uses the word the operator chose, architectural domain
jschoubben2026-11-02 19:21:51 +01:00
eaa98758b9
Design 55: follow ADR 0592's tenth version: submit commits when its version is stored, and the tests for the rollback's double write and the Approve bound to its sections
jschoubben2026-11-02 17:17:45 +01:00
b9a42eaf90
Design 55: follow ADR 0592's eighth version: readers by ADR 0363's grant, extended to the object bucket; each cap within its form's bound; clause numbers after the splits
jschoubben2026-11-02 17:15:00 +01:00
6256fc8e3b
Design 55: follow ADR 0592's sixth version and the review by aspect: whole-or-refused writes, caps, the move's window and rollback, the delivery order, the judge's judged event, events with what they carry, a test per failure path, and a section Reviewed by aspect
jschoubben2026-11-02 17:10:53 +01:00
012d276dcc
Design 55: follow ADR 0592's revision: a stream that keeps its history, a module's own object bucket, the frame's bound and the move's full check
jschoubben2026-11-02 17:03:18 +01:00
5a9a5d8d1d
Design 55: the knowledge base keeps its records on the bus and is written and reviewed by section (ADR 0592), so a long record is judged whole and a draft lives only in the knowledge base
jschoubben2026-11-02 17:00:57 +01:00
2731c796f0
Merge pull request 'hq's words test reads .claude/, so agent and skill definitions use the glossary's words' (#501) from docs/agent-roles-defined into main
mesh-tools2026-11-02 18:48:16 +00:00
7470927a07
Playbook 07 keeps to feature work: the rule on agent definitions goes to an instruction section for every session (the operator, 2026-11-02)
jschoubben2026-11-02 19:45:17 +01:00
6c395cc206
Playbook 07: say how the agent-definition rule is checked
jschoubben2026-11-02 19:42:08 +01:00
594a0871dd
Playbook 07: a role started more than once is an agent definition in the repository it serves; hq's words test reads .claude/
jschoubben2026-11-02 19:41:34 +01:00
7021d0cf5a
Merge pull request 'Four reviewer agents carry playbook 01's review by architectural domain, two architectural domains each' (#500) from docs/domain-reviewers into main
mesh-tools2026-11-02 18:41:15 +00:00
4037bc1fb0
Reviewer agents: catalog, the glossary's word
jschoubben2026-11-02 19:39:19 +01:00
121b582ebc
Four reviewer agents carry playbook 01's review by architectural domain, two architectural domains each, so every review asks the same questions
jschoubben2026-11-02 19:38:35 +01:00
fa3d8aaeec
Merge pull request 'Playbooks 01 and 02: review by architectural domain, sections named by title with no file references, and storage forms that fit (the operator, 2026-11-02)' (#499) from docs/review-by-aspect into main
mesh-tools2026-11-02 18:27:14 +00:00
633c587a1e
Glossary: bare domain keeps the mesh-domain sense; only the review's sense is always qualified, so the homonym rule holds without rewriting every use
jschoubben2026-11-02 19:22:45 +01:00
6f2bacf6c4
Architectural domain for the review's eight concerns, and the glossary's domain qualified as mesh domain in the homonyms, as the operator chose on 2026-11-02
jschoubben2026-11-02 19:21:48 +01:00
f5624e7d9f
Review fixes: the research skill names sections by title, the drawn overview's order and bounds follow the playbooks, an amended design is reviewed by aspect, and storage forms use glossary words
jschoubben2026-11-02 18:20:12 +01:00
b861b3ae36
Glossary: review aspect; playbook 01: a piece of state takes the bus storage form that fits it, and a form added to mesh-sdk is named to the operator with its cost
jschoubben2026-11-02 18:19:01 +01:00
0ac621e03f
Playbooks 01 and 02: review a direction and a design by aspect before proposing or merging, and name a record's sections by title with no file references, as the operator asked on 2026-11-02
jschoubben2026-11-02 16:42:33 +01:00
f312e7cd0e
Merge pull request 'Playbook 07: the prepare step reads what exists today before any code' (#498) from docs/pb07-what-exists into main
mesh-tools2026-11-02 15:16:21 +00:00
2b9e6b256b
Read what exists before writing code, in the prepare step
jschoubben2026-11-02 16:14:17 +01:00
e91e65b5ab
Playbook 07: the reproduction runs the change's integration tests by name on an embedded bus, as the rule above says
pb/reproduce-the-checker
jschoubben2026-11-01 06:13:47 +01:00
393f6443a2
Playbook 07: reproduce the checker locally before a group's one push, so faults a local run shows do not cost check rounds
jschoubben2026-11-01 06:12:56 +01:00
1747485cb3
Merge pull request 'Design 47 and the glossary follow what L3 to L7 built (issues 774, 1952, 1953, 1954, 1955)' (#496) from feat/774-l3-reland into main
mesh-tools2026-10-30 11:01:45 +00:00
0c450cad25
Design 47: the L4 row cites ADR 0572, the self-check probes kept and dropped
jschoubben2026-10-30 01:16:33 +01:00
2e235286b1
Glossary: cite ADR 0571's accepted insight for the artifact sweep's seat name
jschoubben2026-10-30 00:03:39 +01:00
a35c7ed6d0
Glossary and design 47: the release's new words and the L3-L7 homes as decided (ADR 0563-0571), so readers find where each controller job now lives
jschoubben2026-10-29 23:58:11 +01:00
e65f897a1f
Merge pull request 'Playbooks 07 and 08 name the checker's try beside the controller's (issue 774, ADR 0561), rebased onto L2' (#495) from feat/774-vault-mints-l2 into main
mesh-tools2026-10-29 07:44:15 +00:00
f4fdbde558
Playbook 07: rules for a delivery group's mesh-sdk pins, learned on 2026-10-28, so the next group does not meet the same refusals
jschoubben2026-10-29 00:42:23 +01:00
6f54a162e9
Playbook 07: rules for a delivery group's mesh-sdk pins, learned on 2026-10-28, so the next group does not meet the same refusals
jschoubben2026-10-29 00:42:23 +01:00
7d022710b3
Playbooks 07 and 08: name the controller's try too while its verb exists (issue 774)
jschoubben2026-10-27 23:01:25 +01:00
f89b8599c6
Playbooks 07 and 08 name the try by the checker's seat: mesh-delivery-checker.try replaces mesh-controller.try (ADR 0547 §10, issue 774)
jschoubben2026-10-27 22:50:43 +01:00
eec73b8af0
Merge pull request 'Design 47 and the glossary: placement is bus state of the seat mesh-placement (issue 1126, delivery 2 of 2)' (#494) from feat/1126-placement-seat into main
mesh-tools2026-10-28 18:32:58 +00:00
1aa887dd28
Glossary: placement, mesh-placement, placement proposal, candidate and hand-back replace the placement file
jschoubben2026-10-28 18:25:31 +01:00
aa4c2fe7ef
Design 47: placement is bus state of the seat mesh-placement, changed by a proposal (ADR 0567)
jschoubben2026-10-28 18:25:19 +01:00
292232dad2
Merge pull request 'Playbooks 07 and 08: every review asks where each piece of state lives and whether a repository holds mesh setup' (#493) from pb/state-and-seams into main
mesh-tools2026-10-28 16:46:35 +00:00
a9830f5110
Playbooks 07 and 08: the review asks where state lives and how seams travel, and whether a repository holds mesh setup
jschoubben2026-10-28 17:43:44 +01:00
02a18c9aa8
Merge pull request 'Design 47's L5 row and the glossary follow ADR 0565' (#492) from docs/0565-homing into main
mesh-tools2026-10-28 13:08:30 +00:00
606956da97
Design 47 L5 and the glossary: add clause 8 and the lease-write gate, both readers of kept, upgrade answered side by side
jschoubben2026-10-28 13:29:42 +01:00
d088f17cd2
Design 47 L5 and the glossary follow ADR 0565: say which parts leave the controller and which seat takes each
jschoubben2026-10-28 13:28:11 +01:00
dd03229ea8
Merge pull request 'Playbook 07 follows report-cadence: the short report every five minutes, the full one every thirty' (#491) from pb/report-cadence into main
mesh-tools2026-10-28 11:35:44 +00:00
781392b121
Playbook 07: the report follows the report-cadence section (short every 5 min, detailed every 30 min)
jschoubben2026-10-28 12:32:05 +01:00
c2f4bb2d48
Merge pull request 'The glossary's word is catalog, not catalogue (group words/catalog)' (#490) from words/catalog into main
mesh-tools2026-10-28 11:31:29 +00:00
ea0c62355c
The glossary's word is catalog: replace the spelling catalogue in running prose
jschoubben2026-10-28 11:18:49 +01:00
8f8393fa93
Merge pull request 'Playbooks 07 and 08: lessons of 2026-10-28 (the report's tree, its cadence, named local integration tests, member repositories during a check, delivered means what the nodes run, real-shaped fixtures)' (#489) from pb/lessons-2026-10-28 into main
mesh-tools2026-10-28 10:15:18 +00:00
dd36b7557a
Playbooks 07 and 08: the local integration run is the named tests that exercise the change; the report's tree is drawn from the verb
jschoubben2026-10-28 11:12:23 +01:00
d348256090
Playbooks 07 and 08: lessons of 2026-10-28 (progress tree, report cadence, local integration run, group members, delivered, fixtures)
jschoubben2026-10-28 11:10:26 +01:00
2ea3368b76
Merge pull request 'Design 47: ADR 0564 homes health (L4), and milestones L5 to L7 give the controller's other jobs their homes before L3's lease write' (#488) from docs/47-adr-0564 into main
mesh-tools2026-10-28 09:46:31 +00:00
3c2d5af436
Design 47: milestones L5 to L7 join L4 as the homes of the controller's other jobs
jschoubben2026-10-28 10:42:35 +01:00
bcad1e363a
Design 47 and the glossary home ADR 0564: health leaves the controller in milestone L4
jschoubben2026-10-28 10:41:29 +01:00
edbb53bb78
Design 47: milestones L4 to L7 give the controller's other jobs their homes before L3's lease write
jschoubben2026-10-28 09:40:05 +01:00
6808125e1d
Playbooks 07 and 08 name the try by the checker's seat: mesh-delivery-checker.try replaces mesh-controller.try (ADR 0547 §10, issue 774)
jschoubben2026-10-27 22:50:43 +01:00
32da464794
Merge pull request 'How-we-build: a bus permission is proven under the real permission (ADR 0560); playbook 07 notes the 2026-10-27 failure' (#486) from pb/seed-lessons-2026-10-27 into main
mesh-tools2026-10-27 21:19:59 +00:00
10bc8d396c
Merge pull request 'Design 47: R4d says what it became, three image reworks done and n8n left by ADR 0506' (#487) from design/47-r4d-done into main
mesh-tools2026-10-27 21:16:02 +00:00
8e732e22ae
Design 47: R4d is done; record the three reworks, n8n's exit and the issues (ADR 0480, 0487, 0497, 0506)
jschoubben2026-10-27 22:14:06 +01:00
6ef40bbcc7
How-we-build: a bus permission is proven under the real permission (ADR 0560); playbook 07 keeps only the failure note, as the operator asked
jschoubben2026-10-27 20:36:54 +01:00
7ff4c7ce68
Playbook 07: the developer runs the node-permission test locally as a named exception to step 1
jschoubben2026-10-27 20:29:11 +01:00
0d1aa93e37
Playbook 07: keep only the node-agent permission lesson; the operator keeps merging before the check by choice (2026-10-27)
jschoubben2026-10-27 20:28:16 +01:00
1afab9739e
Playbook 07: a node-agent change runs under the node's real permissions before review approves, and a pull request whose safety is its check is approved only on its passing verdict (issue 1126, 2026-10-27)
jschoubben2026-10-27 20:27:41 +01:00
420751b214
Merge pull request 'Design 47: a placement change is answered by the nodes it places before it merges (ADR 0559, issue 1126)' (#485) from feat/1126-l2b into main
mesh-tools2026-10-27 07:21:07 +00:00
043f8ecf9c
Design 47 and the glossary: a placement change is answered by the nodes it places before it merges (ADR 0559, issue 1126)
jschoubben2026-10-27 02:14:09 +01:00
132aae8433
Merge pull request 'Design 47 says what a node composes from: placement, its config layers, and the node record (issue 1126)' (#482) from feat/1126-nodes-compose into main
mesh-tools2026-10-26 21:11:12 +00:00
28d84f31bf
Merge remote-tracking branch 'origin/main' into feat/1126-nodes-compose
jschoubben2026-10-26 21:56:52 +01:00
278ca42b3d
Merge pull request 'Playbooks 07 and 08: one release, one check, no try, push once after the review (ADR 0548)' (#484) from pb/one-check-per-release into main
mesh-tools2026-10-26 19:55:30 +00:00
1dab64134a
Playbooks 07 and 08: the one check is one status, mesh/check; drop the leftover try wording (review fixes)
jschoubben2026-10-26 20:52:36 +01:00
a0e4c1fe17
Playbooks 07 and 08: one release, one check, no try, push once after the review (ADR 0548)
jschoubben2026-10-26 20:50:37 +01:00
7c88f297fc
Design 47: a settings-form module's values in the placement file, the vault's own, both sources' readers, the switch when placed, and the order of the delivery and the seed (issue 1126)
jschoubben2026-10-26 19:45:32 +01:00