codeassembly-guidance 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,53 @@
1
1
  [
2
+ {
3
+ "version": "0.5.0",
4
+ "date": "2026-11-02",
5
+ "sections": [
6
+ {
7
+ "title": "🎉 Features",
8
+ "audience": "all",
9
+ "items": [
10
+ {
11
+ "description": "Adds rules to the `shared-data-conventions` rulebook stating that an agent's verdict that decides a write to shared state includes evidence that a script checks before the write, and that a skill writing to shared state runs against the real data before merge, stopping at its approval checkpoint or in a dry run. (#2245)",
12
+ "hash": "05e2c9c62b8063400c3c8bef63e6e7a072df88d0",
13
+ "entry": 1
14
+ },
15
+ {
16
+ "description": "Extends the data-change guidance in `create-ticket`, `design-and-plan`, `plan`, and `align-ticket-with-implementation` to require an acceptance criterion for the evidence check and a `## Verification` step that runs the skill against the real data without writing. (#2245)",
17
+ "hash": "05e2c9c62b8063400c3c8bef63e6e7a072df88d0",
18
+ "entry": 2
19
+ },
20
+ {
21
+ "description": "Adds a \"Judged writes\" check to `plan-reviewer`, which reports a plan for a skill that writes to shared state when the plan does not run the skill against the real data before merge or does not name the script that checks a verdict's evidence. (#2245)",
22
+ "hash": "05e2c9c62b8063400c3c8bef63e6e7a072df88d0",
23
+ "entry": 3
24
+ }
25
+ ]
26
+ },
27
+ {
28
+ "title": "📦 Dependencies",
29
+ "audience": "dev",
30
+ "items": [
31
+ {
32
+ "description": "Pins `codeassembly` and `@williamthorsen/kb` in guidance to their published releases `0.20.0` and `0.11.1` in place of `workspace:*`, and exempts both from the 24-hour `minimumReleaseAge` in `pnpm-workspace.yaml` so that guidance can install a release as soon as this repository's CI publishes it. (#2246)",
33
+ "hash": "0d592f8bb7f6479a966f943e2123b3949c044a36",
34
+ "entry": 1
35
+ }
36
+ ]
37
+ },
38
+ {
39
+ "title": "📚 Documentation",
40
+ "audience": "dev",
41
+ "items": [
42
+ {
43
+ "description": "Moves the `run-index.json`, `run-log.jsonl`, and `status.json` specification from guidance's `artifact-conventions.md` to `packages/run-core/docs/run-data-format.md`, beside the Zod schemas that implement it. (#2246)",
44
+ "hash": "0d592f8bb7f6479a966f943e2123b3949c044a36",
45
+ "entry": 2
46
+ }
47
+ ]
48
+ }
49
+ ]
50
+ },
2
51
  {
3
52
  "version": "0.4.0",
4
53
  "date": "2026-11-02",
@@ -9,12 +58,12 @@
9
58
  "items": [
10
59
  {
11
60
  "description": "Adds the `curate-feedback` skill, which has `feedback-coverage-judge` subagents sort each open feedback event into covered, duplicate, obsolete, or kept against guidance pinned at a commit, and then, after approval or under `--apply`, marks every event that is not kept through `kb-update-events` and records the run in a `feedback-curation` artifact. (#2231)",
12
- "hash": "6bb5907a3426bb91a6f1a4a340b3a4180576a503",
61
+ "hash": "3fed12c9e6aabf2537985d5a02616052b1adf5d0",
13
62
  "entry": 1
14
63
  },
15
64
  {
16
65
  "description": "Adds each covered entry's quote to the `feedback-curation` artifact's events table and to the approval table that `curate-feedback --list` presents, so that the developer can check every covered verdict against its stating sentence before approving the marks. (#2236)",
17
- "hash": "73c4bd7e28cccf9b4875a18c491993ac371869df",
66
+ "hash": "bc6a0a108bcfa39a69a2e89fd616ffd14438af1b",
18
67
  "entry": 2
19
68
  }
20
69
  ]
@@ -26,7 +75,7 @@
26
75
  {
27
76
  "description": "Remove the factory and the demos (#2234)",
28
77
  "body": "Removes the dormant factory visualization package and the catwalk demos, together with the docs, repo-local skills, dependencies, and configuration that only they used. Adds to `docs/repository-split.md` the command that finds the last commit containing the factory, which is the commit from which a revival restores it.",
29
- "hash": "a2715300691038525090dd8299b4c6602fbba607"
78
+ "hash": "f5e18c8da37c9e87e1f663aa5eaf50e824b91f5e"
30
79
  }
31
80
  ]
32
81
  },
@@ -36,28 +85,28 @@
36
85
  "items": [
37
86
  {
38
87
  "description": "Fixes the issue that the `feedback-coverage-judge` subagent of `curate-feedback` marked a feedback event `obsolete` when the change that removed the event's target had renamed or moved it, or had named a replacement for it. (#2233)",
39
- "hash": "628e9f86e2b47f4b63922468157f31e4da5c2155",
88
+ "hash": "3748903ac0475d33295c27b06f5ba53bff9b6e86",
40
89
  "entry": 1
41
90
  },
42
91
  {
43
92
  "description": "Fixes the issue that `curate-feedback validate` accepted a `covered` entry after checking only that the cited guidance file existed, by requiring a verbatim `quote` of the stating sentence and rejecting the entry when the file at the pin does not contain it, ignoring differences in whitespace and in `*`, `_`, and backtick markers. (#2236)",
44
- "hash": "73c4bd7e28cccf9b4875a18c491993ac371869df",
93
+ "hash": "bc6a0a108bcfa39a69a2e89fd616ffd14438af1b",
45
94
  "entry": 1
46
95
  },
47
96
  {
48
97
  "description": "Fixes the issue that `triage-feedback` ranked a feedback cluster by its events even when all of them predated a change to the guidance that governs its lesson, and directs the skill and its `feedback-triage-challenger` subagent to check that guidance's commit history and set such a cluster to `low` unless evidence shows the failure recurring under the changed guidance. (#2243)",
49
- "hash": "4d16db28a5e06835ecee87bd6d07c758d9ce00b4",
98
+ "hash": "fd79dc7471d7c982375d45872f9e65da32cb9bda",
50
99
  "entry": 1
51
100
  },
52
101
  {
53
102
  "description": "Fixes the issue that `triage-feedback` and `triage-spike-findings` accepted a defense against the challenger that rested on grounds other than the evidence named by the challenger's argument. (#2243)",
54
- "hash": "4d16db28a5e06835ecee87bd6d07c758d9ce00b4",
103
+ "hash": "fd79dc7471d7c982375d45872f9e65da32cb9bda",
55
104
  "entry": 2
56
105
  },
57
106
  {
58
107
  "description": "Remove the unshipped `source` export condition from the published packages (#2244)",
59
108
  "body": "Removes the `source` export condition from `codeassembly`, `@williamthorsen/kb`, and `codeassembly-run-core`, because it pointed at TypeScript files that their tarballs don't contain, so that a consumer that enables the condition resolves the shipped `dist/` output instead of failing.",
60
- "hash": "1e1dfc9f376b90956f1c769e0d439a142d43a84b"
109
+ "hash": "de1adc534b07b58be33b354dfa4a4179a7be7e2a"
61
110
  }
62
111
  ]
63
112
  }
@@ -73,142 +122,142 @@
73
122
  "items": [
74
123
  {
75
124
  "description": "Adds a \"Who applies the change\" section to `design-priorities.md`, which ranks a design that the agent applies and verifies itself above one that needs a person to run a step on each machine, orders three ways to shape a step that stays (reach the machine through its existing access, route the step through its existing provisioning, or leave one self-checking script per machine), and is cited by `design-and-plan` and `plan` when they rank approaches. (#2175)",
76
- "hash": "ce936e76d019c1eeba400a8a191e05600a4f0c3b",
125
+ "hash": "f49c73b060ed7335ac84a4e59d3cf10d23a4f811",
77
126
  "entry": 1
78
127
  },
79
128
  {
80
129
  "description": "Changes the plan template's `**Residue:**` rule so that a step that a person must run on each machine is written as one script per machine that checks its own result, and so that a record of the work, such as a log entry or a ticket comment, is never residue, which `implement-plan` also states. (#2175)",
81
- "hash": "ce936e76d019c1eeba400a8a191e05600a4f0c3b",
130
+ "hash": "f49c73b060ed7335ac84a4e59d3cf10d23a4f811",
82
131
  "entry": 2
83
132
  },
84
133
  {
85
134
  "description": "Adds a rule to the `williamthorsen-collaboration-preferences` rulebook and the `collaborate` skill that directs the agent to answer a question from the developer rather than hand over a procedure to run, to run any check that the answer needs, and to count the commands that it hands over across the session. (#2175)",
86
- "hash": "ce936e76d019c1eeba400a8a191e05600a4f0c3b",
135
+ "hash": "f49c73b060ed7335ac84a4e59d3cf10d23a4f811",
87
136
  "entry": 3
88
137
  },
89
138
  {
90
139
  "description": "Adds a rule to the `williamthorsen-collaboration-preferences` rulebook that directs the agent, once the developer signals overload, to stop adding asks and to end each turn without an action-items block until the developer asks for something, and points `action-items.md` and the `collaborate` skill to it. (#2175)",
91
- "hash": "ce936e76d019c1eeba400a8a191e05600a4f0c3b",
140
+ "hash": "f49c73b060ed7335ac84a4e59d3cf10d23a4f811",
92
141
  "entry": 4
93
142
  },
94
143
  {
95
144
  "description": "Adds a \"Check results\" section to the `cli-conventions` rulebook, which requires a `check` or `verify` mode, a health probe, or a pre-flight to state on each item's line what it checked and the state that it found, to show a failure's evidence (a diff or the actual state) without `--verbose`, and to probe end to end the function that a configuration-only check serves. (#2178)",
96
- "hash": "50524b6f50c43baf9a9831d84c6db40e3039e139",
145
+ "hash": "440f483a7b51b446582b34fd16c3914e25c3b8c3",
97
146
  "entry": 1
98
147
  },
99
148
  {
100
149
  "description": "Adds a \"Documentation placement\" section to the shared `AGENTS.md` guidance, which directs an agent that writes a guidance or documentation file to point to the config, code, README section, or rulebook that defines a fact and to add only what that source does not state. (#2181)",
101
- "hash": "ca4381616aa1f033c4ff84dd0ceba58b39dbf6eb",
150
+ "hash": "d176a097a6c1c994672700513baf829eb779bc14",
102
151
  "entry": 1
103
152
  },
104
153
  {
105
154
  "description": "Directs the plan template used by `plan` and `design-and-plan` to name, in the key decisions of each task that writes guidance or documentation, the source that defines each documented fact. (#2181)",
106
- "hash": "ca4381616aa1f033c4ff84dd0ceba58b39dbf6eb",
155
+ "hash": "d176a097a6c1c994672700513baf829eb779bc14",
107
156
  "entry": 2
108
157
  },
109
158
  {
110
159
  "description": "Adds a placement item to the diff audit run by `implement-plan`, `respond-to-review`, and `revise-comments`, which checks that each guidance or documentation hunk points to a fact's source rather than copying the fact. (#2181)",
111
- "hash": "ca4381616aa1f033c4ff84dd0ceba58b39dbf6eb",
160
+ "hash": "d176a097a6c1c994672700513baf829eb779bc14",
112
161
  "entry": 3
113
162
  },
114
163
  {
115
164
  "description": "Extends the duplication check in `update-project-guidance` from the global guidance file to rulebooks loaded into the session and to repository files, so that the skill omits what loaded guidance already states and points to a repository file that defines a fact. (#2181)",
116
- "hash": "ca4381616aa1f033c4ff84dd0ceba58b39dbf6eb",
165
+ "hash": "d176a097a6c1c994672700513baf829eb779bc14",
117
166
  "entry": 4
118
167
  },
119
168
  {
120
169
  "description": "Changes the marker that the `williamthorsen-collaboration-preferences` rulebook and the plan and option-format templates prescribe for a decision awaiting the developer's checkpoint from ⏳ to 🔲, an unchecked box that reads as an item still to approve rather than as work in progress. (#2185)",
121
- "hash": "9e34f69741792807f5a2e96fa14e0859afe0fea6",
170
+ "hash": "7b26a2eae38ccc8da0bed7ac55d1a37b78ff68e2",
122
171
  "entry": 1
123
172
  },
124
173
  {
125
174
  "description": "Adds a `defects` field to the JSON output of `consolidate-entries`, which lists each entry whose breaking marker violates its type's policy or whose type the taxonomy does not declare, naming the entry by its 0-based index with the same `policy-violation` and `undeclared-type` kinds that `resolve-merge` reports. (#2186)",
126
- "hash": "619b29d634352c19777eb04639d328f52ad7c1e3",
175
+ "hash": "b745929354adb7b6398ca7d71a0c01f9345ba3c4",
127
176
  "entry": 1
128
177
  },
129
178
  {
130
179
  "description": "Directs `summarize-change` to report each entry defect that `consolidate-entries` returns, naming the entry by its `text`, and to continue without changing anything. (#2186)",
131
- "hash": "619b29d634352c19777eb04639d328f52ad7c1e3",
180
+ "hash": "b745929354adb7b6398ca7d71a0c01f9345ba3c4",
132
181
  "entry": 2
133
182
  },
134
183
  {
135
184
  "description": "Adds the closing post to `spike-conventions.md`, a ticket comment that contains the answers to the ticket's questions, the recommendations on its decisions, and links to the findings artifact and, when the spike published one, to its page, and names the post in the deliverables of the spike ticket and plan templates. (#2196)",
136
- "hash": "d3ecb9b8b52ee6e8fc358d596a7c8caf3911769a",
185
+ "hash": "ad15b107b0f912bb546114126cb5e6c8db9f74af",
137
186
  "entry": 1
138
187
  },
139
188
  {
140
189
  "description": "Adds an offer of the closing post to the action-items block of the `assess-usability` report step, and replaces the skill's statement that it writes nothing remote with one that names this post, made on consent, as its one remote write. (#2196)",
141
- "hash": "d3ecb9b8b52ee6e8fc358d596a7c8caf3911769a",
190
+ "hash": "ad15b107b0f912bb546114126cb5e6c8db9f74af",
142
191
  "entry": 2
143
192
  },
144
193
  {
145
194
  "description": "Extends the 🔬 Investigate option for a spike plan, shown in the next-steps menu of `design-and-plan`, `plan`, `refine-plan`, and `save-plan`, to end the run with the plan's `## Deliverable`, which includes the offer of the closing post. (#2196)",
146
- "hash": "d3ecb9b8b52ee6e8fc358d596a7c8caf3911769a",
195
+ "hash": "ad15b107b0f912bb546114126cb5e6c8db9f74af",
147
196
  "entry": 3
148
197
  },
149
198
  {
150
199
  "description": "Adds a rule to `artifact-conventions.md` that a conclusion needed by a reader of the ticket is posted on the ticket, while the artifact keeps the evidence. (#2196)",
151
- "hash": "d3ecb9b8b52ee6e8fc358d596a7c8caf3911769a",
200
+ "hash": "ad15b107b0f912bb546114126cb5e6c8db9f74af",
152
201
  "entry": 4
153
202
  },
154
203
  {
155
204
  "description": "Adds the `pr.initial_state` preference (`draft` or `ready`, default `draft`), which `create-pr` reads from the project or global preferences file to open a pull request as a draft or ready for review, and makes `pr.title_format` optional so that a `pr` section can set only the state. (#2198)",
156
- "hash": "bd2088a0b09c9767138ab1226ba684a666f3a9ca",
205
+ "hash": "f30540f894d5b81a5c49c4e06c161544ac5b2ba2",
157
206
  "entry": 1
158
207
  },
159
208
  {
160
209
  "description": "Adds the `--add-tag` operation to `kb-update-events`, which appends the given tags, canonicalized through the store's alias map, to each named event's tags and leaves an event that already has all of them untouched, unlike `--retag`, which replaces the whole set. (#2208)",
161
- "hash": "420d2b3f78bc56293cef181579b94fafcfed5197",
210
+ "hash": "d91bf36062db925db935a0bb87212d55fb0aa8e9",
162
211
  "entry": 1
163
212
  },
164
213
  {
165
214
  "description": "Adds `--help` to the `kb-update-events` helper, which prints usage describing every operation and exits without updating any event. (#2208)",
166
- "hash": "420d2b3f78bc56293cef181579b94fafcfed5197",
215
+ "hash": "d91bf36062db925db935a0bb87212d55fb0aa8e9",
167
216
  "entry": 2
168
217
  },
169
218
  {
170
219
  "description": "Adds an `--exclude-tag` flag to `kb-retrieve-events` that takes a comma-separated list of tags, matched in canonical or alias form, and drops every event that has any of them; a repeated flag adds to the list. (#2209)",
171
- "hash": "0c30f1befb520f3698d7016e092e3680b479e4e3",
220
+ "hash": "eae9c860e656ffed43ffa1e353887e78ca6c84ab",
172
221
  "entry": 1
173
222
  },
174
223
  {
175
224
  "description": "Adds a \"Standard tags\" section, generated from `STANDARD_TAGS`, to the skills that write or filter knowledge-base tags, such as `capture-event` and `kb-update-events`, which directs the agent to tag a record's disposition by a standard name rather than a variant spelling. (#2212)",
176
- "hash": "2c1413e55ca6061c6133c6ed74ddcae6809923e6",
225
+ "hash": "939302c35685e87867ef5dbabb8442533dfb7f6e",
177
226
  "entry": 2
178
227
  },
179
228
  {
180
229
  "description": "Adds an optional `evidence` field (a stable `key` and the `paths` that it covers) to each item of the `triage-spike-findings` record and an optional `commit` field to the record, which `validate` requires once any item has evidence, and adds to the end of the dispositions comment a hidden, versioned JSON block that the exported `parseEvidenceBlock` function reads back. (#2213)",
181
- "hash": "03cb1f7b2538d8bf0c9c43824a68c4b1f4ae6d7a",
230
+ "hash": "ded5694aaa9c5616294d07852668e3ec92e2244c",
182
231
  "entry": 1
183
232
  },
184
233
  {
185
234
  "description": "Has the `triage-spike-findings` skill copy each item's evidence key and paths from the findings into the inventory and the record, and set the record's `commit` to the HEAD at which the developer approved the dispositions. (#2213)",
186
- "hash": "03cb1f7b2538d8bf0c9c43824a68c4b1f4ae6d7a",
235
+ "hash": "ded5694aaa9c5616294d07852668e3ec92e2244c",
187
236
  "entry": 2
188
237
  },
189
238
  {
190
239
  "description": "Adds the `assess-code-health` skill, which measures git hotspots and test coverage for one package or subtree, dispatches five `code-health-assessor` subagents (conventions, structure, extraction, error handling, and tests), and ranks the proposals whose cited evidence resolves against the tree in a `code-health-findings` artifact that `triage-spike-findings` now accepts as input. (#2216)",
191
- "hash": "45388be8981d097f6851d70c99212c27a4497b87",
240
+ "hash": "72491778e752fa5c3d3352382cddeefeef451909",
192
241
  "entry": 1
193
242
  },
194
243
  {
195
244
  "description": "Adds the `triage-feedback` skill, which groups the open events of a feedback store by lesson, shows the top `--limit` clusters with each one's recurrence, impact, and latest capture, has a subagent without session context challenge every priority, and after one approval files a ticket, comments on an open issue that already covers the lesson, defers the cluster, or changes its impact rating. (#2217)",
196
- "hash": "fe3c3febce8753d879729b34a2cbce26d245cb06",
245
+ "hash": "83de2e165b44b40dd86317e5d852784ce7340dde",
197
246
  "entry": 1
198
247
  },
199
248
  {
200
249
  "description": "Adds the `triage_feedback.defer_days` preference, which sets the number of days for which `triage-feedback` leaves a deferred cluster out of a triage unless the cluster gains a new event, 30 by default. (#2217)",
201
- "hash": "fe3c3febce8753d879729b34a2cbce26d245cb06",
250
+ "hash": "83de2e165b44b40dd86317e5d852784ce7340dde",
202
251
  "entry": 2
203
252
  },
204
253
  {
205
254
  "description": "Adds the `refine-guidance` skill, which finds the rule that already states a lesson or places a new artifact, drafts the edits for approval, opens a pull request, and marks the lesson's feedback events as addressed by it. (#2227)",
206
- "hash": "255356fab78972974cd632ee3f7b373e699382e0",
255
+ "hash": "1e595021b52d8d1282567c7098910fe2ec664688",
207
256
  "entry": 1
208
257
  },
209
258
  {
210
259
  "description": "Adds a \"Choosing a kind\" section to the `codeassembly-content-specification` rulebook, which states the kind of artifact and the content root in which a lesson belongs, and when to change an existing rule rather than add a parallel one. (#2227)",
211
- "hash": "255356fab78972974cd632ee3f7b373e699382e0",
260
+ "hash": "1e595021b52d8d1282567c7098910fe2ec664688",
212
261
  "entry": 2
213
262
  }
214
263
  ]
@@ -219,27 +268,27 @@
219
268
  "items": [
220
269
  {
221
270
  "description": "Fixes the issue that the commit guidance did not say which source sets a commit title's format, by stating in `commit-conventions` that `commit.title_format` alone sets it and by directing agents in `create-commit` and the shared `AGENTS.md` not to change a rendered title to match other commits or comment on whether it contains a ticket reference. (#2172)",
222
- "hash": "31c4f2f65fe8bc6b739c8e4ed5a355f8fa961e6f",
271
+ "hash": "e28047ca8f7662ea5cde856cc7ae831965797ba6",
223
272
  "entry": 1
224
273
  },
225
274
  {
226
275
  "description": "Fixes the issue that `create-commit` and `condense-branch` did not give agents a title to use when `commit.title_format` is empty or unset and the renderer printed an empty title; both now fall back to the bare title. (#2172)",
227
- "hash": "31c4f2f65fe8bc6b739c8e4ed5a355f8fa961e6f",
276
+ "hash": "e28047ca8f7662ea5cde856cc7ae831965797ba6",
228
277
  "entry": 2
229
278
  },
230
279
  {
231
280
  "description": "Fixes the issue that `index-prototypes` had the agent ask the developer to run `chrome-debug`, which is no longer installed, on a refused Playwright connection, rather than run `thor-chrome` itself and ask only when `thor-chrome` refuses the launch with `session-unavailable`. (#2192)",
232
- "hash": "648c64452d4fb11077e30427c3b18a1eb9e001f2",
281
+ "hash": "673171f0d96edaee750e078598f388fa4d79e09a",
233
282
  "entry": 1
234
283
  },
235
284
  {
236
285
  "description": "Fixes the issue that a section in the project `.agents/preferences.yaml` hid every global key of the same section, such as a `ticket.base_url` set only in `~/.agents/preferences.yaml`, which made `derive-session-context` report `ticket_base_url: null` and leave a Jira ticket ID without a URL. (#2199)",
237
- "hash": "01f8ae785329378a0efa269b8d2561c265027291",
286
+ "hash": "63ee1a158e0ffe3db24824c18ba8ed1aea6c882c",
238
287
  "entry": 1
239
288
  },
240
289
  {
241
290
  "description": "Fixes the issue that the `--tag` filter of `kb-retrieve` and `kb-retrieve-events` compared tags literally and missed a note tagged with an alias of the requested tag, although both skills document a match on the canonical or alias form. (#2209)",
242
- "hash": "0c30f1befb520f3698d7016e092e3680b479e4e3",
291
+ "hash": "eae9c860e656ffed43ffa1e353887e78ca6c84ab",
243
292
  "entry": 2
244
293
  }
245
294
  ]
@@ -250,7 +299,7 @@
250
299
  "items": [
251
300
  {
252
301
  "description": "Adds a section to `_partials/README.md` that states when content becomes a partial and when partials merge, and adds `partial-consumers.unit.test.ts`, which fails when fewer than two files include a partial or when partials with the same includers are neither merged nor listed in that section. (#2183)",
253
- "hash": "c6375bb111421af6e711323427be379169710dca",
302
+ "hash": "04fceff396a01ead1ca8481e9c69a5cc2bd3681b",
254
303
  "entry": 2
255
304
  }
256
305
  ]
@@ -261,7 +310,7 @@
261
310
  "items": [
262
311
  {
263
312
  "description": "Inlines the partials that only one file includes into that file, and merges the five ticket partials into `ticket-skeleton` and `ticket-composition`. (#2183)",
264
- "hash": "c6375bb111421af6e711323427be379169710dca",
313
+ "hash": "04fceff396a01ead1ca8481e9c69a5cc2bd3681b",
265
314
  "entry": 1
266
315
  }
267
316
  ]
@@ -272,7 +321,7 @@
272
321
  "items": [
273
322
  {
274
323
  "description": "Replaces six per-doctrine reach test files with `doctrine-reach.unit.test.ts`, which runs the same checks for each entry in the `DOCTRINE_REACH` table in `test-utils/doctrine-reach.ts`. (#2183)",
275
- "hash": "c6375bb111421af6e711323427be379169710dca",
324
+ "hash": "04fceff396a01ead1ca8481e9c69a5cc2bd3681b",
276
325
  "entry": 3
277
326
  }
278
327
  ]
@@ -284,7 +333,7 @@
284
333
  {
285
334
  "description": "Move the test runner to Vitest 5 (#2193)",
286
335
  "body": "Upgrades `vitest` and `@vitest/coverage-v8` from v4 to 5.0.5, and lowers from 7 days to pnpm's 24-hour `minimumReleaseAge` the age at which `nmr upgrade` proposes a third-party release.",
287
- "hash": "15fb4f9908aaf7da9e1552e6a2a9cd626ee3daa2"
336
+ "hash": "6687dc161e99cb1b019a56496fbc1c0d59881c00"
288
337
  }
289
338
  ]
290
339
  }
@@ -300,457 +349,457 @@
300
349
  "items": [
301
350
  {
302
351
  "description": "Replaces the list of ideas to adopt in the `comparison` artifact written by `prepare-prototype-brief` with an idea table that lists every distinctive idea of the round, those of rejected and losing prototypes included, with the prototypes that have it and the requirement that it answers. (#2027)",
303
- "hash": "b0f7d13ce779d98288bdfaf5e48ba9483a3a80fa",
352
+ "hash": "8752911ef9a1f567bdb27e124ac606d9043818c2",
304
353
  "entry": 1
305
354
  },
306
355
  {
307
356
  "description": "Adds a step to `prepare-prototype-brief`, reached also from the verdict read-back of `index-prototypes`, which takes the developer through a keep, adapt, defer, or drop decision on each row of the idea table, accepts new ideas that the developer states while judging, and saves the result as a ticket-level `idea-decisions` artifact. (#2027)",
308
- "hash": "b0f7d13ce779d98288bdfaf5e48ba9483a3a80fa",
357
+ "hash": "8752911ef9a1f567bdb27e124ac606d9043818c2",
309
358
  "entry": 2
310
359
  },
311
360
  {
312
361
  "description": "Requires, in the product-development stages of the `williamthorsen-workflow-preferences` rulebook, a decision on every prototype idea before the end vision, which cites the `idea-decisions` artifact, and a record of each decision in the design doc. (#2027)",
313
- "hash": "b0f7d13ce779d98288bdfaf5e48ba9483a3a80fa",
362
+ "hash": "8752911ef9a1f567bdb27e124ac606d9043818c2",
314
363
  "entry": 3
315
364
  },
316
365
  {
317
366
  "description": "Adds a `number` to each `index-prototypes` manifest entry, assigned at a slug's first registration and kept by its later versions, and leads each index card title and the winner summary with it, as in \"3. Catalog first\". (#2030)",
318
- "hash": "76a73f8ef9702e6aecba6541648bfd42c7e2b6f4",
367
+ "hash": "faba871a8e621f11707699307bbe26f1e875da4a",
319
368
  "entry": 1
320
369
  },
321
370
  {
322
371
  "description": "Numbers a manifest written before this change in order of each slug's first registration when it is read, and writes those numbers to it at the next registration. (#2030)",
323
- "hash": "76a73f8ef9702e6aecba6541648bfd42c7e2b6f4",
372
+ "hash": "faba871a8e621f11707699307bbe26f1e875da4a",
324
373
  "entry": 2
325
374
  },
326
375
  {
327
376
  "description": "Updates `index-prototypes` and `prepare-prototype-brief` to name each prototype to the developer as `{number}. {title}` in reports, the comparison, the idea table, and the idea decisions, and to accept a bare number as a reference to a prototype, asking when no prototype has that number. (#2030)",
328
- "hash": "76a73f8ef9702e6aecba6541648bfd42c7e2b6f4",
377
+ "hash": "faba871a8e621f11707699307bbe26f1e875da4a",
329
378
  "entry": 3
330
379
  },
331
380
  {
332
381
  "description": "Adds the `ui-copy-conventions` rulebook, delivered as the `consult-ui-copy-conventions` skill, which sets rules for labels, buttons, helper text, errors, register, and case, and a copy budget for each page, and which defers to a project's own content guidelines where the two conflict. (#2032)",
333
- "hash": "6738deb17bb389dc386fd15dd5eff4efeac3f35f",
382
+ "hash": "895a271546ff30cc6f59fe22d6c37440837328db",
334
383
  "entry": 1
335
384
  },
336
385
  {
337
386
  "description": "Adds `ui-copy-conventions` to the `recommended` collection, and directs plans to name its copy rules and copy budget in the key decisions of any task that writes interface text or builds a page, a prototype, or a UI component. (#2032)",
338
- "hash": "6738deb17bb389dc386fd15dd5eff4efeac3f35f",
387
+ "hash": "895a271546ff30cc6f59fe22d6c37440837328db",
339
388
  "entry": 2
340
389
  },
341
390
  {
342
391
  "description": "Changes `prepare-prototype-brief` to forbid builders from quoting the brief into the page, to require the demo chrome inside an element marked `data-demo`, and to judge each prototype's product copy against `ui-copy-conventions`. (#2032)",
343
- "hash": "6738deb17bb389dc386fd15dd5eff4efeac3f35f",
392
+ "hash": "895a271546ff30cc6f59fe22d6c37440837328db",
344
393
  "entry": 3
345
394
  },
346
395
  {
347
396
  "description": "Adds the `copy-probe` command to the `index-prototypes` helper, which prints a function for the Playwright MCP's `browser_evaluate` that lists a page's strings of four or more words and skips everything inside `data-demo`. (#2032)",
348
- "hash": "6738deb17bb389dc386fd15dd5eff4efeac3f35f",
397
+ "hash": "895a271546ff30cc6f59fe22d6c37440837328db",
349
398
  "entry": 4
350
399
  },
351
400
  {
352
401
  "description": "Adds the `index-prototypes describe-set` command, which reads a set summary (`shared`, `changes`, `try`) from a JSON file into the manifest; the index page shows that summary below its title, with `try` as a numbered list. (#2034)",
353
- "hash": "3ce17cc46c4810cecaba118737ddb7651c95ea76",
402
+ "hash": "4d451407c5b1823f9af4710c564af24619d1a648",
354
403
  "entry": 1
355
404
  },
356
405
  {
357
406
  "description": "Adds a repeatable `--note \"<label>: <value>\"` flag to `index-prototypes register`, which stores each note on the prototype's entry and shows the notes on its card as a definition list in the order given. (#2034)",
358
- "hash": "3ce17cc46c4810cecaba118737ddb7651c95ea76",
407
+ "hash": "4d451407c5b1823f9af4710c564af24619d1a648",
359
408
  "entry": 2
360
409
  },
361
410
  {
362
411
  "description": "Directs the agent in the `index-prototypes` and `prepare-prototype-brief` skills to choose one list of note labels for the set, to collect a value for each label from every builder, and to write the set summary in a new \"Describe the set\" step each round. (#2034)",
363
- "hash": "3ce17cc46c4810cecaba118737ddb7651c95ea76",
412
+ "hash": "4d451407c5b1823f9af4710c564af24619d1a648",
364
413
  "entry": 3
365
414
  },
366
415
  {
367
416
  "description": "Adds drafted titles to `groom-backlog`, which shows a replacement title from the `ticket-assessor` subagent in the digest, applies it with `gh issue edit --title`, and lists \"Title\" among the parts that the ticket comment reports as revised. (#2038)",
368
- "hash": "e038dd4a3c8853b4b4a3c4867f3018a1c46e2130",
417
+ "hash": "3a110aad915117302e8071381b7284e5cbde2c8e",
369
418
  "entry": 1
370
419
  },
371
420
  {
372
421
  "description": "Adds the `project.maturity` (`hobby`, `early`, `production`), `project.sensitivity` (`low`, `personal`, `confidential`), and `project.audience` (`owner`, `team`, `public`) keys to `.agents/preferences.yaml`, which `derive-session-context` reports as `project_maturity`, `project_sensitivity`, and `project_audience`, or as `null` for a key that the project file does not declare. (#2044)",
373
- "hash": "ab45fcb37ab48f272a842e06239221590ae3691f",
422
+ "hash": "c675f5189d78ef951b8021a8264eb8f270151f7f",
374
423
  "entry": 1
375
424
  },
376
425
  {
377
426
  "description": "Directs `design-and-plan` and `plan` to treat the declared project stage as the premise of every security, availability, and infrastructure decision, to add machinery beyond that stage only for a named asset or need, and to ask for each undeclared value and then declare it in the project's preferences file. (#2044)",
378
- "hash": "ab45fcb37ab48f272a842e06239221590ae3691f",
427
+ "hash": "c675f5189d78ef951b8021a8264eb8f270151f7f",
379
428
  "entry": 2
380
429
  },
381
430
  {
382
431
  "description": "Adds the project's declared stage to the design-doc contents that the `williamthorsen-workflow-preferences` rulebook lists for a product's end vision. (#2044)",
383
- "hash": "ab45fcb37ab48f272a842e06239221590ae3691f",
432
+ "hash": "c675f5189d78ef951b8021a8264eb8f270151f7f",
384
433
  "entry": 3
385
434
  },
386
435
  {
387
436
  "description": "Adds the `check-preferences.mjs` script, which validates a preferences file against the bundled schema, prints its findings as JSON, and exits 1 on an invalid value or a missing required key, reporting an unrecognized key as a warning that names the nearest known key. (#2044)",
388
- "hash": "ab45fcb37ab48f272a842e06239221590ae3691f",
437
+ "hash": "c675f5189d78ef951b8021a8264eb8f270151f7f",
389
438
  "entry": 4
390
439
  },
391
440
  {
392
441
  "description": "Adds the `refine-prototype` skill, which applies the developer's commands to one prototype page with the development gates off, carries the round's kept and adapted ideas onto it, snapshots each accepted version into the ticket's prototype set, and records every accepted change in a `refinement-log` artifact that the end vision reads. (#2040)",
393
- "hash": "73fcfed401b20ee4a49a45c7ee91993547a11a36",
442
+ "hash": "df2e6b997c554e840508f1b5ab5f8e14d4fe2423",
394
443
  "entry": 1
395
444
  },
396
445
  {
397
446
  "description": "Gives each prototype version an id, `{number}.{version}`, that leads the index card and the first line of the page's `data-demo` band, with a `resolve-ids` command on the `index-prototypes` helper that resolves the ids before the prototypes are built and a `--number` flag on `register` that refuses a registration whose number disagrees with the manifest. (#2040)",
398
- "hash": "73fcfed401b20ee4a49a45c7ee91993547a11a36",
447
+ "hash": "df2e6b997c554e840508f1b5ab5f8e14d4fe2423",
399
448
  "entry": 2
400
449
  },
401
450
  {
402
451
  "description": "Adds the `assess-usability` skill, available on the Claude harness only, which dispatches a `usability-assessor` subagent for each of three to five lenses in turn and merges their reports into a `usability-findings` artifact that ranks the findings by effect and reach and that `triage-spike-findings` takes as input. (#2045)",
403
- "hash": "db44782da0c9ac095525dba80b050e054e6864a9",
452
+ "hash": "21f31815a8676a4029d9b24dd18d3d905b4dc04b",
404
453
  "entry": 1
405
454
  },
406
455
  {
407
456
  "description": "Adds the `triage-spike-findings` skill, which grades the confidence and value of every item that a findings artifact leaves undisposed, has the new `disposition-challenger` subagent argue against each grade, and then creates the `confidence:`- and `value:`-labelled child tickets under an umbrella ticket and posts every disposition on the triage ticket, on GitHub repositories that have both label families. (#2049)",
408
- "hash": "5d2238d1cb0a11aa15a645dae467112e5316c260",
457
+ "hash": "d5dff2d2e364b3e00fd1fa6477c52bf8ee7321d6",
409
458
  "entry": 1
410
459
  },
411
460
  {
412
461
  "description": "Adds a `--label` argument to `create-ticket`, which applies the given labels on GitHub in addition to the resolved scope and type labels and reports them as skipped on Jira. (#2049)",
413
- "hash": "5d2238d1cb0a11aa15a645dae467112e5316c260",
462
+ "hash": "d5dff2d2e364b3e00fd1fa6477c52bf8ee7321d6",
414
463
  "entry": 2
415
464
  },
416
465
  {
417
466
  "description": "Stops `create-ticket` from asking for confirmation of a relationship supplied through `--parent`, `--blocked-by`, or `--blocking`, and lists that relationship in the completion output. (#2049)",
418
- "hash": "5d2238d1cb0a11aa15a645dae467112e5316c260",
467
+ "hash": "d5dff2d2e364b3e00fd1fa6477c52bf8ee7321d6",
419
468
  "entry": 3
420
469
  },
421
470
  {
422
471
  "description": "Adds the `check-site --target <url-or-host>` subcommand to `manage-jira-ticket.mjs`, which prints `acli`'s active site and the ticket's site as JSON and, when they differ, exits non-zero and names the `acli jira auth switch` command that makes the ticket's site active. (#2052)",
423
- "hash": "37dd890748ec052db2b13ce8b5d9393df03748c2",
472
+ "hash": "daa9572db09fbb640ca2423304631dc5ec615cc7",
424
473
  "entry": 3
425
474
  },
426
475
  {
427
476
  "description": "Adds the `jira-clients` guidance hook to `update-jira-ticket`, through which a machine adds its own Jira client, with the sites that it reaches and its rank, to the clients that the Jira skills read and create through. (#2052)",
428
- "hash": "37dd890748ec052db2b13ce8b5d9393df03748c2",
477
+ "hash": "daa9572db09fbb640ca2423304631dc5ec615cc7",
429
478
  "entry": 4
430
479
  },
431
480
  {
432
481
  "description": "Adds an \"External programs\" section to the `testing-conventions` skill, which directs that code reach git or another external program through an adapter received as a dependency, that tests of that code pass a fake adapter, and that only the adapter's own test run the real program. (#2055)",
433
- "hash": "948de718d2f7a8a59f736deb43070a8436009fee",
482
+ "hash": "74fe86181cb11eec1db9b3617ea3b54133e80e03",
434
483
  "entry": 1
435
484
  },
436
485
  {
437
486
  "description": "Adds an \"External programs\" section to the `typescript-testing-conventions` skill, with an example of an adapter type, a real adapter used as a parameter default, and a test that passes an object literal as the fake, and states a preference for that parameter over `vi.mock`. (#2055)",
438
- "hash": "948de718d2f7a8a59f736deb43070a8436009fee",
487
+ "hash": "74fe86181cb11eec1db9b3617ea3b54133e80e03",
439
488
  "entry": 2
440
489
  },
441
490
  {
442
491
  "description": "Rewrites the description of the `testing-conventions` skill to name how a test reaches git and other external programs, and to direct agents to consult the skill before writing or changing a test. (#2055)",
443
- "hash": "948de718d2f7a8a59f736deb43070a8436009fee",
492
+ "hash": "74fe86181cb11eec1db9b3617ea3b54133e80e03",
444
493
  "entry": 3
445
494
  },
446
495
  {
447
496
  "description": "Move kb's git calls behind an injectable adapter (#2077)",
448
497
  "body": "Adds an optional `git` parameter to `check`, `enumerateNotes`, and `enumerateNotePaths` in `@williamthorsen/kb/check`, which takes a `KbGit` adapter so that a consumer's tests can run these functions without a real git repository. The change also routes every git call inside kb through one such adapter and replaces the repositories that kb's tests built with a fake adapter.",
449
- "hash": "e1242949ad8654b3c3bba3b5bccd8acf7abed0a2"
498
+ "hash": "4c2637a467d3a9788e2d326062a1c995cb1c38e5"
450
499
  },
451
500
  {
452
501
  "description": "Changes the next-steps menus of the planning, implementation, and review skills to name each skill in the harness's own invocation syntax, such as `/refine-plan` on Claude Code and `!refine-plan` on Rovo, so that a user can paste an option line without retyping it. (#2084)",
453
- "hash": "013c2993c883b7feac1491404110ad8a92fa8293",
502
+ "hash": "26c87cf79f23df24e4c248e1cdeaa6cd4ba00e90",
454
503
  "entry": 1
455
504
  },
456
505
  {
457
506
  "description": "Adds a \"Where a test goes\" section to the `testing-conventions` skill, which directs each case to the cheapest tier that can observe it, limits an expensive tier (one that spawns a process, starts a runtime, or builds a full fixture) to one smoke example per entry or verb, and requires a change to delete the higher-tier examples that its cheaper coverage supersedes and to justify each expensive-tier example that it adds. (#2086)",
458
- "hash": "0b2d76aa829af16c2154ab1097ac78865bc2a615",
507
+ "hash": "7f2486ed92a1a3bd9e0fa70e0b13263ad81a720a",
459
508
  "entry": 1
460
509
  },
461
510
  {
462
511
  "description": "Adds a \"Test placement\" section to the `review-criteria` skill, which classes as a Warning an added expensive-tier example that a cheaper tier could observe, and also a higher-tier suite that the change superseded but kept. (#2086)",
463
- "hash": "0b2d76aa829af16c2154ab1097ac78865bc2a615",
512
+ "hash": "7f2486ed92a1a3bd9e0fa70e0b13263ad81a720a",
464
513
  "entry": 2
465
514
  },
466
515
  {
467
516
  "description": "Changes the test criterion in `ticket-criteria-conventions` and `plan-template` to ask for coverage at the cheapest tier that observes the behavior, rather than for coverage by tests alone. (#2086)",
468
- "hash": "0b2d76aa829af16c2154ab1097ac78865bc2a615",
517
+ "hash": "7f2486ed92a1a3bd9e0fa70e0b13263ad81a720a",
469
518
  "entry": 3
470
519
  },
471
520
  {
472
521
  "description": "Changes the `accessibility-conventions` and `shared-data-conventions` rulebooks to `skill` delivery alone, so that they no longer appear in every session's guidance file and are reached through `consult-accessibility-conventions` and `consult-shared-data-conventions`, and adds an \"Interfaces\" criterion to `review-criteria` that points a review of colour tokens, text styles, pages, or UI components to `accessibility-conventions`. (#2087)",
473
- "hash": "893150e0dea901c3e178565092511dae45ed41bf",
522
+ "hash": "9633a853a8f0ec005a047bc409593397d4801b8a",
474
523
  "entry": 2
475
524
  },
476
525
  {
477
526
  "description": "Adds an \"Always-loaded context\" section to `review-criteria`, which classifies a change as a Warning when it makes a rulebook ambient or grows an `AGENTS.md`, a `CLAUDE.md`, or another file loaded at session start, unless nearly every session needs the content. (#2087)",
478
- "hash": "893150e0dea901c3e178565092511dae45ed41bf",
527
+ "hash": "9633a853a8f0ec005a047bc409593397d4801b8a",
479
528
  "entry": 3
480
529
  },
481
530
  {
482
531
  "description": "Updates `codeassembly-content-specification` to version 30, which states that `delivery` is required and that `ambient` fits only content that nearly every session needs. (#2087)",
483
- "hash": "893150e0dea901c3e178565092511dae45ed41bf",
532
+ "hash": "9633a853a8f0ec005a047bc409593397d4801b8a",
484
533
  "entry": 4
485
534
  },
486
535
  {
487
536
  "description": "Adds a rule to `prepare-prototype-brief` that directs the brief's author to describe an audience-facing view by what the audience sees, and adds a line to the brief check that has the author rewrite phrases such as \"mystery\" and \"unknown to\" without the withheld information. (#2089)",
488
- "hash": "2476b7e8b2b1f554ff17050cc40bd025159d479b",
537
+ "hash": "b1eef342ff03e6c76c0d223f4290b4a010a03d33",
489
538
  "entry": 1
490
539
  },
491
540
  {
492
541
  "description": "Makes `create-gh-pr` assign each pull request that it creates to the authenticated `gh` user, record the applied assignee in the `pull-request` artifact, and report the assignee as skipped when GitHub does not apply it. (#2090)",
493
- "hash": "b5cb6b98f2d0c9c41a0d149b412c48143df74365",
542
+ "hash": "9ed40caa1fc1f4f5a8a531129d5aed50708ca0f6",
494
543
  "entry": 1
495
544
  },
496
545
  {
497
546
  "description": "Adds setup rules to the `testing-conventions` skill that count a database engine as an expensive tier, call for the cheapest setup that fits the time budget, keep setup cost independent of the number of test files, and reject a raised hook timeout as a fix. (#2092)",
498
- "hash": "5996a4e6b8a74a1a521894f6d0b9129ceb692dba",
547
+ "hash": "08182c99d1ca2a3cc344b122ebcd3d5fb930c2a9",
499
548
  "entry": 1
500
549
  },
501
550
  {
502
551
  "description": "Adds a \"Code that uses a database\" section to the `testing-conventions` skill, which limits database tests to code whose subject is SQL, directs logic that only passes through SQL to a fake client or a mocked module boundary, and rules out a test per constraint. (#2092)",
503
- "hash": "5996a4e6b8a74a1a521894f6d0b9129ceb692dba",
552
+ "hash": "08182c99d1ca2a3cc344b122ebcd3d5fb930c2a9",
504
553
  "entry": 2
505
554
  },
506
555
  {
507
556
  "description": "Adds four Warnings to the `review-criteria` skill for database and setup defects in tests that the change adds, splits, or modifies, and changes the split that it proposes for a grown test file to share the file's expensive setup first. (#2092)",
508
- "hash": "5996a4e6b8a74a1a521894f6d0b9129ceb692dba",
557
+ "hash": "08182c99d1ca2a3cc344b122ebcd3d5fb930c2a9",
509
558
  "entry": 3
510
559
  },
511
560
  {
512
561
  "description": "Adds the `cli-conventions` rulebook, delivered as the `consult-cli-conventions` skill, which states that a CLI printing a doc as a help topic renders a link to another topic as the `<bin> help <topic>` command, renders any other link as its absolute URL, and accepts the doc's file stem as a name for the topic. (#2093)",
513
- "hash": "7359ac9f9fd07a3f30d8fbc99bf8aac6b6abcfb1",
562
+ "hash": "af974d90725f0ceceb3275c1e7c59fe49fb012a6",
514
563
  "entry": 1
515
564
  },
516
565
  {
517
566
  "description": "Adds `cli-conventions` to the `recommended` collection, so that a project declaring that collection receives the rulebook. (#2093)",
518
- "hash": "7359ac9f9fd07a3f30d8fbc99bf8aac6b6abcfb1",
567
+ "hash": "af974d90725f0ceceb3275c1e7c59fe49fb012a6",
519
568
  "entry": 2
520
569
  },
521
570
  {
522
571
  "description": "Adds `--repo OWNER/REPO` to `/create-ticket`, which files the ticket in that GitHub repository and resolves its title format, reference prefix, scope, and labels from the configuration on that repository's default branch. (#2094)",
523
- "hash": "7f327716ac0207ad0eaa6a93393351267eeff56b",
572
+ "hash": "32ec24a53b2a4e189caa0d02faaa6cc12d70c4b3",
524
573
  "entry": 1
525
574
  },
526
575
  {
527
576
  "description": "Adds `--project-root <dir>` to `describe-change render-titles` and `resolve-labels`, which then read `.agents/preferences.yaml` and `.meta/label-map.json` from that directory in place of the invoking repository's root. (#2094)",
528
- "hash": "7f327716ac0207ad0eaa6a93393351267eeff56b",
577
+ "hash": "32ec24a53b2a4e189caa0d02faaa6cc12d70c4b3",
529
578
  "entry": 2
530
579
  },
531
580
  {
532
581
  "description": "Makes `describe-change resolve-labels` warn on stderr about each type or scope that a configured label map does not define, where it previously omitted the label without a message. (#2094)",
533
- "hash": "7f327716ac0207ad0eaa6a93393351267eeff56b",
582
+ "hash": "32ec24a53b2a4e189caa0d02faaa6cc12d70c4b3",
534
583
  "entry": 3
535
584
  },
536
585
  {
537
586
  "description": "Adds a `medium` input to `assess-usability`. When set to `cli`, each `usability-assessor` lens runs the built binary in its own scratch git repository and saves text transcripts as evidence, and the styling-and-access lens is replaced by an output-and-access lens that checks `NO_COLOR`, piped output, 80-column width, and help and error text. (#2095)",
538
- "hash": "9e4e90216060497d93b7f0d07ff443be3e788234",
587
+ "hash": "5021f49057360ef70488372549663aeca944a9ea",
539
588
  "entry": 1
540
589
  },
541
590
  {
542
591
  "description": "Orders the `ticket` items of `triage-spike-findings` by value, then confidence, with record order breaking ties, when the skill creates the child tickets and when it lists them in the checkpoint table, the dispositions comment, and the report, so that the children's issue numbers follow that order. (#2096)",
543
- "hash": "ad6433f473dc31513dfe12e878bd6a380a8a08af",
592
+ "hash": "8206f0ea41bf6e8bb17a6660ccfd62a410ba14c7",
544
593
  "entry": 1
545
594
  },
546
595
  {
547
596
  "description": "Adds a rule to the \"Technical recommendations\" guidance that directs an agent to name the best-practice solutions to a design problem and the conditions under which each one fits before it weighs options, to label an option that departs from all of them as non-standard with the reason that none fits, and to recommend revising an existing API rather than an addition that works around its contract. (#2098)",
548
- "hash": "493531b336569d90b1b404212a51840f552950ce",
597
+ "hash": "8a98a220317c1d0c3bafdd512e3b7b34d3fad599",
549
598
  "entry": 1
550
599
  },
551
600
  {
552
601
  "description": "Includes the \"Technical recommendations\" guidance in the `ticket-assessor` subagent, which validates a ticket's proposed approach. (#2098)",
553
- "hash": "493531b336569d90b1b404212a51840f552950ce",
602
+ "hash": "8a98a220317c1d0c3bafdd512e3b7b34d3fad599",
554
603
  "entry": 2
555
604
  },
556
605
  {
557
606
  "description": "Extends the `cli-conventions` rulebook from help topics to the whole interface of a command-line tool in any language, adding rules for `--help` on every command and subcommand, an exit-code table, error messages that name the fix, and step and outcome reports for commands that change state. (#2099)",
558
- "hash": "762196014eb70f6fc71313240e342d4b163e4c91",
607
+ "hash": "1fef09d00b6d34938204f40cae8f17d9d7ddf5a9",
559
608
  "entry": 1
560
609
  },
561
610
  {
562
611
  "description": "Reduces the `shell-conventions` rulebook to how a bash script implements the `cli-conventions` rules, and changes its `show_usage` template to write requested help to stdout and to exit 2 on an unknown command. (#2099)",
563
- "hash": "762196014eb70f6fc71313240e342d4b163e4c91",
612
+ "hash": "1fef09d00b6d34938204f40cae8f17d9d7ddf5a9",
564
613
  "entry": 2
565
614
  },
566
615
  {
567
616
  "description": "Adds a \"DOM environment\" section to the `typescript-testing-conventions` skill, which directs a TypeScript test that renders into a DOM to run under happy-dom and allows jsdom only at an opt-in whose comment names the behavior that happy-dom lacks. (#2101)",
568
- "hash": "f4c7fa57b639bc377fdbbbd6a06c2299478ef5c5",
617
+ "hash": "d090aaaec23ff1f195458d7bdfecfb3def68a592",
569
618
  "entry": 1
570
619
  },
571
620
  {
572
621
  "description": "Adds the `codeassembly-validate-preferences` bin to `codeassembly-guidance`, which validates each named preferences file against the bundled schema without network access, reports a missing or unparsable file as an error, prints text or one JSON object per file under `--json`, and treats warnings such as an unrecognized key as failures under `--strict`. (#2103)",
573
- "hash": "701db9b590b93d2d279ce6206fe273910563fcee",
622
+ "hash": "67ea7f93cd96e2d9b8cd94ee4c7ffe52ecd827ea",
574
623
  "entry": 1
575
624
  },
576
625
  {
577
626
  "description": "Renames the deployed `check-preferences.mjs` helper to `validate-preferences.mjs` and gives it the bin's behavior: several files per run, text output by default, and the `--json`, `--strict`, and `--help` options. (#2103)",
578
- "hash": "701db9b590b93d2d279ce6206fe273910563fcee",
627
+ "hash": "67ea7f93cd96e2d9b8cd94ee4c7ffe52ecd827ea",
579
628
  "entry": 2
580
629
  },
581
630
  {
582
631
  "description": "Directs the agent, in the `williamthorsen-collaboration-preferences` rulebook and the option-format rule, to start each line that states a decision awaiting the checkpoint with ⏳, in a turn's narrative as well as in the plan and spike templates' `## Decisions taken` section, where the marker replaces the `(provisional)` parenthetical. (#2104)",
583
- "hash": "96712f87340a4ab1d8e097528d0550d3d46197c8",
632
+ "hash": "d5f5aff58121ab535efe73d0f1788d5df09a44f0",
584
633
  "entry": 1
585
634
  },
586
635
  {
587
636
  "description": "Extends `triage-spike-findings` to have the agent decide the blockers of each ticket that it creates, create every blocker before the tickets that it blocks, link them through `create-ticket --blocked-by`, and list them in a \"Blocked by\" column of the dispositions comment. (#2105)",
588
- "hash": "634b2e817907b2622e6569504c9d9a01c6e68112",
637
+ "hash": "d8824600e3a68ae4cf2f3965e0b229736738d291",
589
638
  "entry": 1
590
639
  },
591
640
  {
592
641
  "description": "Adds to `williamthorsen-ticketing-preferences` a rule to record a blocker whenever there is some probability that one ticket affects another and should land first, including when one ticket's design takes another ticket's outcome as an input. (#2105)",
593
- "hash": "634b2e817907b2622e6569504c9d9a01c6e68112",
642
+ "hash": "d8824600e3a68ae4cf2f3965e0b229736738d291",
594
643
  "entry": 2
595
644
  },
596
645
  {
597
646
  "description": "Adds a directive to the \"Handoffs\" section of `williamthorsen-collaboration-preferences` that tells the agent to hand over a check of more than one command as one paste-ready script, which cleans up after itself and prints only the facts that the agent needs, and to confirm which machine its commands run on, such as by comparing `hostname`, before it runs or hands over a check of a GUI application. (#2106)",
598
- "hash": "be68ed4a0a2de8e3efb907683fe19f5bf181c001",
647
+ "hash": "515f2285006d0014361116cef18cda0c0d500b51",
599
648
  "entry": 1
600
649
  },
601
650
  {
602
651
  "description": "Adds to `accessibility-conventions` the states that every clickable element shows (a pointer cursor, a hover change, and a focus indicator that meets 3:1 non-text contrast), and requires a browser check of each change to a visible component, with a report that the check did not run when a browser is unavailable. (#2109)",
603
- "hash": "e971dc4f7fc476119af7d2f0e69bc2dfb73b8a2a",
652
+ "hash": "d930345815a94eb46cb744660106def32c2a38f4",
604
653
  "entry": 1
605
654
  },
606
655
  {
607
656
  "description": "Directs `implement-plan` to run that browser check for any change to a visible component, whether or not the plan lists it, and to report what the check found, and adds the interaction states and the check to the plan template's interface guidance. (#2109)",
608
- "hash": "e971dc4f7fc476119af7d2f0e69bc2dfb73b8a2a",
657
+ "hash": "d930345815a94eb46cb744660106def32c2a38f4",
609
658
  "entry": 2
610
659
  },
611
660
  {
612
661
  "description": "Directs `review-criteria` to check each new or changed interactive element in a browser rather than by reading the diff alone, and adds the outcome of that check to the technical assessment in both `review-branch` report templates. (#2109)",
613
- "hash": "e971dc4f7fc476119af7d2f0e69bc2dfb73b8a2a",
662
+ "hash": "d930345815a94eb46cb744660106def32c2a38f4",
614
663
  "entry": 3
615
664
  },
616
665
  {
617
666
  "description": "Makes `design-and-plan`, `plan`, and `refine-plan` report each open blocker of the resolved GitHub or Jira ticket by reference and title, and then continue. (#2113)",
618
- "hash": "aa7e93fc88f9e8992d291af996ddefad0534b184",
667
+ "hash": "fc5199f3aafdbb0de4527f69df176baed586ae00",
619
668
  "entry": 1
620
669
  },
621
670
  {
622
671
  "description": "Makes `implement-plan` ask the user to confirm before it starts the first task when the governing ticket has an open blocker. (#2113)",
623
- "hash": "aa7e93fc88f9e8992d291af996ddefad0534b184",
672
+ "hash": "fc5199f3aafdbb0de4527f69df176baed586ae00",
624
673
  "entry": 2
625
674
  },
626
675
  {
627
676
  "description": "Extends the blocker check to a ticket artifact, which the skills check against the remote ticket named by its `ticket_ref` frontmatter. (#2113)",
628
- "hash": "aa7e93fc88f9e8992d291af996ddefad0534b184",
677
+ "hash": "fc5199f3aafdbb0de4527f69df176baed586ae00",
629
678
  "entry": 3
630
679
  },
631
680
  {
632
681
  "description": "Lets `refine-plan` resolve a Jira ticket by URL or key through the Jira clients that the ticket source resolution ranks, where it previously fetched a Jira URL as a web page. (#2113)",
633
- "hash": "aa7e93fc88f9e8992d291af996ddefad0534b184",
682
+ "hash": "fc5199f3aafdbb0de4527f69df176baed586ae00",
634
683
  "entry": 4
635
684
  },
636
685
  {
637
686
  "description": "Adds a rule to `williamthorsen-tooling-preferences` that directs an agent to log into a local instance of the app under work without asking the developer, and to set a development credential in an untracked local config file when the app needs one, which the rulebook does not count as minting a credential. (#2115)",
638
- "hash": "71cc729b660333533339dce2d1f266bc1076dde7",
687
+ "hash": "704e55708cf23d9aecfe2f243579516aeff14f4e",
639
688
  "entry": 1
640
689
  },
641
690
  {
642
691
  "description": "Limits the login that the handoff ladder in `williamthorsen-collaboration-preferences` names among the resources that an agent asks the developer to supply to a login to a remote service, which excludes an app's local development login. (#2115)",
643
- "hash": "71cc729b660333533339dce2d1f266bc1076dde7",
692
+ "hash": "704e55708cf23d9aecfe2f243579516aeff14f4e",
644
693
  "entry": 2
645
694
  },
646
695
  {
647
696
  "description": "Adds a step to `design-and-plan`, `plan`, `refine-plan`, and `implement-plan` that checks the branch against the remote's default branch before the work starts, fast-forwarding a branch that lacks commits and uncommitted changes of its own and otherwise listing the gained commits and asking whether to bring them in. (#2119)",
648
- "hash": "10c4b363a10fa7ba137a9e617f425c312e6e6711",
697
+ "hash": "bec34ff5e2dec88a2fb85b3904c8d3b7d1111178",
649
698
  "entry": 1
650
699
  },
651
700
  {
652
701
  "description": "Adds the `check-branch-currency.mjs` script, which fetches the remote's default branch and reports as JSON how far the checked-out branch is behind and ahead of it, whether its tree is clean, and which gained commits touch the paths passed with `--path`. (#2119)",
653
- "hash": "10c4b363a10fa7ba137a9e617f425c312e6e6711",
702
+ "hash": "bec34ff5e2dec88a2fb85b3904c8d3b7d1111178",
654
703
  "entry": 2
655
704
  },
656
705
  {
657
706
  "description": "Adds an \"Authorship\" section to the shared `AGENTS.md`, which states that a creator, reporter, or author field shows the account that made an item rather than who wrote it, and forbids inferring from that field that the developer wrote the item. (#2120)",
658
- "hash": "94e9a6bed185ce6ac995873d4e0015e138a82989",
707
+ "hash": "512d07ed365c49ea174569e3d5fa7472d6ba0d4c",
659
708
  "entry": 1
660
709
  },
661
710
  {
662
711
  "description": "Changes `ticket-evaluation.md` to tell the agent to treat a ticket's content as unsourced, whichever account created the ticket, until the agent traces the content to a source. (#2120)",
663
- "hash": "94e9a6bed185ce6ac995873d4e0015e138a82989",
712
+ "hash": "512d07ed365c49ea174569e3d5fa7472d6ba0d4c",
664
713
  "entry": 2
665
714
  },
666
715
  {
667
716
  "description": "Adds a \"Subcommand names\" section to the `cli-conventions` rulebook, which requires a subcommand that acts to name its action and its object, prescribes a flat verb-object name such as `show-instance-page` while the object has one action and a noun group such as `instance-page show` once it has several, and rejects an existing name that breaks these rules as precedent. (#2121)",
668
- "hash": "1b313fc011d539f280e50b2bc6f193839cb28c4e",
717
+ "hash": "eb9c98973538cf573341f7769607e2b3f3b36c13",
669
718
  "entry": 1
670
719
  },
671
720
  {
672
721
  "description": "Makes `kb-curate` report `missing-destination` when `--kb` is absent and no `.kb/` is discoverable, and `no-default` when `--kb @default` is given without a configured `default_kb`, where both cases previously returned `no-kb-resolvable`. (#2122)",
673
- "hash": "6b6eb6c9dfdefe4c3e6ef5500150a4b8f3bf771d",
722
+ "hash": "2e4b41c48e30b33fe22bc1b56cd0f6641409de03",
674
723
  "entry": 1
675
724
  },
676
725
  {
677
726
  "description": "Makes `kb-edit` report a note outside any discoverable `.kb/` as `missing-destination` instead of `no-kb-resolvable`, the code that `kb-add` uses for the same condition. (#2122)",
678
- "hash": "6b6eb6c9dfdefe4c3e6ef5500150a4b8f3bf771d",
727
+ "hash": "2e4b41c48e30b33fe22bc1b56cd0f6641409de03",
679
728
  "entry": 2
680
729
  },
681
730
  {
682
731
  "description": "Rewrites the `.editorconfig` bullet in the shared \"Style\" guidance to direct agents to follow `.editorconfig` and to fill new comments to the `max_line_length` that it sets. (#2123)",
683
- "hash": "ee4486dd01ecccb71b9c37871fcd525e4431157b",
732
+ "hash": "884d70715e962afc6f7693d15865716f9741a9d3",
684
733
  "entry": 1
685
734
  },
686
735
  {
687
736
  "description": "Adds rules to `cli-conventions`, each with an example, on when a behavior is a subcommand rather than an option, standard option names such as `--config`, `--dry-run`, and `--write`, the order in which settings resolve, which commands write by default, `--json` output, color, error messages that suggest the nearest valid name and never take a secret as an argument, and keeping a command's logic apart from its presentation. (#2134)",
688
- "hash": "f4e728365ae58c60a2f6dad5e1b3511c7ac154b4",
737
+ "hash": "6a2690f7fb0d3ae828198f0ada600b30aabfe699",
689
738
  "entry": 1
690
739
  },
691
740
  {
692
741
  "description": "Changes the exit code that `cli-conventions` assigns to a usage error, such as bad input or an unknown command or option, from 1 to 2, and adds exit code 1 for a check that ran and found problems. (#2134)",
693
- "hash": "f4e728365ae58c60a2f6dad5e1b3511c7ac154b4",
742
+ "hash": "6a2690f7fb0d3ae828198f0ada600b30aabfe699",
694
743
  "entry": 2
695
744
  },
696
745
  {
697
746
  "description": "Changes the default exit code of the `show_usage` template in `shell-conventions` from 1 to 2, so that a bare `show_usage` call covers every usage error, including an unknown command. (#2134)",
698
- "hash": "f4e728365ae58c60a2f6dad5e1b3511c7ac154b4",
747
+ "hash": "6a2690f7fb0d3ae828198f0ada600b30aabfe699",
699
748
  "entry": 3
700
749
  },
701
750
  {
702
751
  "description": "Makes `select-lede-exemplars.mjs` act on the breaking marker, which it previously discarded: An unmarked request no longer returns a breaking record, and a request marked by a `!` on `--type` returns breaking records before non-breaking ones within each widening step. (#2136)",
703
- "hash": "c754ec4cf4853a9497538a75e755ba2b56e95048",
752
+ "hash": "930c539755b68b221c68fb5f26985b9d6307b7e3",
704
753
  "entry": 1
705
754
  },
706
755
  {
707
756
  "description": "Adds a `--breaking` flag to `select-lede-exemplars.mjs`, which marks a `--type` or `--tier` request as breaking, and adds a `breaking` field to the JSON output, which reports whether the request was marked. (#2136)",
708
- "hash": "c754ec4cf4853a9497538a75e755ba2b56e95048",
757
+ "hash": "930c539755b68b221c68fb5f26985b9d6307b7e3",
709
758
  "entry": 2
710
759
  },
711
760
  {
712
761
  "description": "Changes the `entry-drafter` subagent to request exemplars once per pair of work type and breaking marker, passing `--breaking` for a breaking entry, rather than once per work type. (#2136)",
713
- "hash": "c754ec4cf4853a9497538a75e755ba2b56e95048",
762
+ "hash": "930c539755b68b221c68fb5f26985b9d6307b7e3",
714
763
  "entry": 3
715
764
  },
716
765
  {
717
766
  "description": "Defines the members of the `triage` collection with `'@unclaimed'`, so that `codeassembly` deploys a newly added library artifact through `triage` until the artifact is promoted to another collection or declares `standalone:`. (#2137)",
718
- "hash": "a2690848e3e61e8a04b0b63177afd1161f6c60ad",
767
+ "hash": "d454eb40df476d3f4be95335ae64600d5875290c",
719
768
  "entry": 3
720
769
  },
721
770
  {
722
771
  "description": "Adds the `overused-word` rule to the `revise-prose` sweep, which reports one candidate per sentence that contains a word from the plain-speech calibration's \"Words to look for\" list or an inflection of one, lists the matched words, and leaves `prose-reviser` to repair the site or reject a use in a sense that the list keeps. (#2139)",
723
- "hash": "79686104a2b46cb903b3cd907fe19ee5ebb1d580",
772
+ "hash": "aef4000974a0e52ceb966d1d31decd381f540a47",
724
773
  "entry": 1
725
774
  },
726
775
  {
727
776
  "description": "Adds the `check-prose.mjs` script, which runs every `revise-prose` detector over one Markdown file at any path without reading or writing the sweep record, and exits 1 when it reports candidates and 2 when it cannot read the file. (#2141)",
728
- "hash": "2421e7b485b0782753533881ec336f4d4edef55b",
777
+ "hash": "16392d1d28225b6f206b35e8b634a2b4d9ff0784",
729
778
  "entry": 1
730
779
  },
731
780
  {
732
781
  "description": "Adds a writing-rules check to step 6 of `summarize-change`, which runs `check-prose.mjs` over the lede, each entry's `text` and `migration`, and the \"Why\" section, and directs the session to redispatch the `entry-drafter` with the new `writing-rule` rejection code for a confirmed violation in a drafted passage. (#2141)",
733
- "hash": "2421e7b485b0782753533881ec336f4d4edef55b",
782
+ "hash": "16392d1d28225b6f206b35e8b634a2b4d9ff0784",
734
783
  "entry": 2
735
784
  },
736
785
  {
737
786
  "description": "Extends `revise-comments` to add a missing description to each function, method, class, and component, test helpers included, and to rewrite a description that misstates its code, with an instruction to ask the user first when the code rather than the description could be wrong. (#2146)",
738
- "hash": "f33f03e09140676b853d4abe6e23728e455a533c",
787
+ "hash": "d227d67255035baa60dd7290a364674dee3cf179",
739
788
  "entry": 1
740
789
  },
741
790
  {
742
791
  "description": "Adds a \"Test data\" section to the `testing-conventions` skill, which requires each test to use the smallest data that proves its behavior and requires code that reads data from a module-level singleton to take it as a parameter or from a context whose default is the real value. (#2167)",
743
- "hash": "584433dfb8531bff50dee4876097352ddc02ae15",
792
+ "hash": "fcbe0271f858a81ee844eb0d435cd1d5a2a675bd",
744
793
  "entry": 1
745
794
  },
746
795
  {
747
796
  "description": "Extends the \"Fix the design, not the timeout\" rule in `testing-conventions` from a hook's timeout to a test's and a tier's timeout, set in a test or in config, and permits a raise only when smaller data, injection, and shared setup do not apply and the plan or the pull-request description states why. (#2167)",
748
- "hash": "584433dfb8531bff50dee4876097352ddc02ae15",
797
+ "hash": "fcbe0271f858a81ee844eb0d435cd1d5a2a675bd",
749
798
  "entry": 2
750
799
  },
751
800
  {
752
801
  "description": "Adds a Warning to `review-criteria` for a raised hook, test, or tier timeout, which a stated reason does not exempt, and a Warning for a test that renders or builds production-scale data, replacing the narrower \"A raised hook timeout\" item. (#2167)",
753
- "hash": "584433dfb8531bff50dee4876097352ddc02ae15",
802
+ "hash": "fcbe0271f858a81ee844eb0d435cd1d5a2a675bd",
754
803
  "entry": 3
755
804
  }
756
805
  ]
@@ -761,107 +810,107 @@
761
810
  "items": [
762
811
  {
763
812
  "description": "Fixes the issue that `summarize-change` reported a branch's own steps and a ticket's backstory as what the change did, by having the `entry-drafter` subagent and the summary's audit accept only the diff against the default branch as evidence of what changed. (#2029)",
764
- "hash": "a4c00c139c0183644820cfe5ee1e82109de99d48",
813
+ "hash": "2e64924dad1aed9540f4b8ff52678ba18cd8febd",
765
814
  "entry": 1
766
815
  },
767
816
  {
768
817
  "description": "Fixes the issue that the `## Why` section of a `summarize-change` summary retold how the need for a change arose, by defining that section as the purpose that the change serves. (#2029)",
769
- "hash": "a4c00c139c0183644820cfe5ee1e82109de99d48",
818
+ "hash": "2e64924dad1aed9540f4b8ff52678ba18cd8febd",
770
819
  "entry": 2
771
820
  },
772
821
  {
773
822
  "description": "Fixes the issue that `entry-drafter` wrote where code or values were copied from, or why the work is split across pull requests, into the lede and the entries, including when a ticket's `## Problem` section stated it. (#2031)",
774
- "hash": "5fe9e0da64f8f85f439dfc31d780fab6c652bae8",
823
+ "hash": "c96f24b169945ff5ca2ff1f3f9006b4c00c0796e",
775
824
  "entry": 1
776
825
  },
777
826
  {
778
827
  "description": "Fixes the issue that `summarize-change` accepted how the work is staged across pull requests as the purpose stated in a change summary's `## Why` section. (#2031)",
779
- "hash": "5fe9e0da64f8f85f439dfc31d780fab6c652bae8",
828
+ "hash": "c96f24b169945ff5ca2ff1f3f9006b4c00c0796e",
780
829
  "entry": 2
781
830
  },
782
831
  {
783
832
  "description": "Fixes the issue that `groom-backlog collect` selected a ticket again when its only update was the decision that the sweep itself had applied, because GitHub records that update a moment after the sweep's comment. (#2038)",
784
- "hash": "e038dd4a3c8853b4b4a3c4867f3018a1c46e2130",
833
+ "hash": "3a110aad915117302e8071381b7284e5cbde2c8e",
785
834
  "entry": 2
786
835
  },
787
836
  {
788
837
  "description": "Fixes the issue that `create-ticket` and `design-and-plan`'s Jira write did not direct the agent to flatten task-list syntax before submitting through a Markdown or HTML Jira client, which Jira stores as bullets reading `\\[ \\]`, on any deployment without `update-jira-ticket`. (#2050)",
789
- "hash": "e8c08b17720a786407fbe8dbb45bd7c1c3f3f64b",
838
+ "hash": "0896437b162df324e98199f9287195cf9c4bcb33",
790
839
  "entry": 1
791
840
  },
792
841
  {
793
842
  "description": "Fixes the issue that `manage-jira-ticket.mjs create` created a Jira work item on `acli`'s active site when that site differed from the host of `ticket.base_url`, and makes it exit with the fallback `wrong-site` or `site-unreadable` without writing to Jira, reading `ticket.base_url` from the repository's preferences or the global file. (#2052)",
794
- "hash": "37dd890748ec052db2b13ce8b5d9393df03748c2",
843
+ "hash": "daa9572db09fbb640ca2423304631dc5ec615cc7",
795
844
  "entry": 1
796
845
  },
797
846
  {
798
847
  "description": "Fixes the issue that ticket resolution, `update-jira-ticket`, and `create-ticket` reported a Jira ticket on another site as missing, by directing each to run `manage-jira-ticket.mjs check-site` before calling `acli` and to report the wrong site and the `acli jira auth switch` command instead. (#2052)",
799
- "hash": "37dd890748ec052db2b13ce8b5d9393df03748c2",
848
+ "hash": "daa9572db09fbb640ca2423304631dc5ec615cc7",
800
849
  "entry": 2
801
850
  },
802
851
  {
803
852
  "description": "Fixes the issue that the `live-worktree-policy` rulebook named the removed `list-repos --tag live` command for listing the repos tagged `live`, and replaces it with `thor-repo list --tag live`. (#2053)",
804
- "hash": "336e4641efe6058c00fc77ae4c8f585435ef36f7",
853
+ "hash": "5986668816981b8551329248e1fbe37803474b0e",
805
854
  "entry": 1
806
855
  },
807
856
  {
808
857
  "description": "Fixes the issue that a `summarize-change` redispatch did not send `entry-drafter` the type corrected by the audit, which left the drafter to rewrite the entry in the form of the old type. (#2058)",
809
- "hash": "8acd2cf486acc270437d798cdf109261e7601a89",
858
+ "hash": "276e768e3c42215e905e63fbcd5a4e4c3655c719",
810
859
  "entry": 1
811
860
  },
812
861
  {
813
862
  "description": "Fixes the issue that the artifact guidance never stated what the artifact directory is for, by stating that it is the developer's audit trail rather than a source of truth, directing durable instructions to the repository or to a skill or rulebook, and telling the agent to verify what a search of artifacts returns against the repository, the tickets, and the pull requests. (#2070)",
814
- "hash": "dd5b8e19d53d66d9c169022507e6b3d40fb40cc6",
863
+ "hash": "4f1ac27cbc1f5eb09c849208ec8723969e9110f1",
815
864
  "entry": 1
816
865
  },
817
866
  {
818
867
  "description": "Fixes the issue that `williamthorsen-workflow-preferences` did not say that the branch and worktree for a ticket's work are settled, which left agents asking the developer which one to use. (#2082)",
819
- "hash": "e51e167cf6a31e0b16e1f84f58d5c169708d343b",
868
+ "hash": "4c009b8f26b8d0da96cdd3a3caffebbf52cc1a38",
820
869
  "entry": 1
821
870
  },
822
871
  {
823
872
  "description": "Fixes the issue that `design-and-plan` ended a session that split a ticket without a launch prompt for each resulting ticket, and that its `Next action` menu could offer to implement an umbrella's child in the umbrella's worktree. (#2083)",
824
- "hash": "4eae3f57a2be999d34e1337cefd4b391e7c45ffa",
873
+ "hash": "2161b854097599caf37e60bf3855957db3ec5fcf",
825
874
  "entry": 1
826
875
  },
827
876
  {
828
877
  "description": "Fixes the issue that the `triage-spike-findings` helper's `check-labels` command crashed with \"e is not a function\" instead of running `gh label list`, which stopped the skill before triage began. (#2085)",
829
- "hash": "f4f342e568c6bd428adaf20b726b8f1e80da6e4f",
878
+ "hash": "a5531f50ba839b4793a215671da8ccd97ba65778",
830
879
  "entry": 1
831
880
  },
832
881
  {
833
882
  "description": "Fixes the issue that `williamthorsen-collaboration-preferences` and the `action-items` and `option-format` partials stated many directives in the indicative, which hid whether the agent was to act, by restating them as imperatives addressed to the agent. (#2106)",
834
- "hash": "be68ed4a0a2de8e3efb907683fe19f5bf181c001",
883
+ "hash": "515f2285006d0014361116cef18cda0c0d500b51",
835
884
  "entry": 2
836
885
  },
837
886
  {
838
887
  "description": "Documents in the `kb-add` skill the `readonly-kb` error code, which its helper already returned, and tells the agent to have the user choose a writable KB. (#2122)",
839
- "hash": "6b6eb6c9dfdefe4c3e6ef5500150a4b8f3bf771d",
888
+ "hash": "2e4b41c48e30b33fe22bc1b56cd0f6641409de03",
840
889
  "entry": 3
841
890
  },
842
891
  {
843
892
  "description": "Fixes the issue that the rulebooks, skills, subagents, and partials in `codeassembly-guidance` contained sentences that the library's own current writing rules flag, such as figurative verbs, \"no\" used as a determiner, and reduced object relatives, and keeps each rulebook's `version` because the repairs do not change what it asks. (#2130)",
844
- "hash": "2994cf92898d06091137cc327f5c927faa81a3e8",
893
+ "hash": "bfcd6b431eb92d5edb309a384eaa02ce4f445f70",
845
894
  "entry": 1
846
895
  },
847
896
  {
848
897
  "description": "Fixes the issue that messages printed by `describe-change`, `index-prototypes`, `resolve-review-run`, `revise-prose`, and `triage-spike-findings` broke the writing rules, for example by saying `no manifest in` a directory rather than that the directory does not contain a manifest, and keeps each message's error code. (#2132)",
849
- "hash": "62f2c0a5859c798e87dc428eb45355ddf399c47e",
898
+ "hash": "ea0d2f777bac430550cc4c61e9da6fc21055933d",
850
899
  "entry": 1
851
900
  },
852
901
  {
853
902
  "description": "Fixes the issue that the artifact conventions told agents to run `export-ai-artifacts.sh`, which has been deleted, and called a git-ignored `base_dir` the default when the documented default is `~/ai-artifacts`. (#2135)",
854
- "hash": "209ddf557a4d1a612d93fed7e1ca0efea948d9ed",
903
+ "hash": "bcc0a920370c3d323a015d13469cea5597dc546b",
855
904
  "entry": 1
856
905
  },
857
906
  {
858
907
  "description": "Fixes the issue that `revise-prose` reported a file as swept after its prose was edited, by recording a hash of each file's extracted prose in `.agents/revise-prose.yaml` and reporting the file as unswept when the current hash differs. (#2143)",
859
- "hash": "9618430493196836710972c5cd6bde02d1b6ee74",
908
+ "hash": "9c0c72d3f3574a562efb8d9ce7bb84e34dafc936",
860
909
  "entry": 1
861
910
  },
862
911
  {
863
912
  "description": "Fixes the issue that the leader check in the option-format contract and the `williamthorsen-collaboration-preferences` rulebook did not cover gated decisions, and adds a first step that searches each alternative for a disqualifying cost, including one that follows from the work's constraints and acceptance criteria. (#2145)",
864
- "hash": "329fcf6383fc3bb1eed78f5b328d0295954a6234",
913
+ "hash": "77e1afc09bc7d336055427328fdd566bc9a6e47b",
865
914
  "entry": 1
866
915
  }
867
916
  ]
@@ -872,7 +921,7 @@
872
921
  "items": [
873
922
  {
874
923
  "description": "Shortens the `index-prototypes` skill by 675 bytes, cutting explanations that a neighboring sentence restated, and leaves its behavior unchanged. (#2040)",
875
- "hash": "73fcfed401b20ee4a49a45c7ee91993547a11a36",
924
+ "hash": "df2e6b997c554e840508f1b5ab5f8e14d4fe2423",
876
925
  "entry": 3
877
926
  }
878
927
  ]
@@ -883,7 +932,7 @@
883
932
  "items": [
884
933
  {
885
934
  "description": "Replaces the per-CLI entry-point checks in the helper CLIs, `derive-session-context`'s `isMain` among them, with one shared `isEntryPoint(moduleUrl, programName)`, which writes a warning to stderr naming the program and returns `true` when it cannot resolve the real paths, so that a helper CLI invoked through a stale link runs instead of doing nothing. (#2144)",
886
- "hash": "f1d8fc7b82572fdc330cb5e8112f86e2d8c5f77b",
935
+ "hash": "fa4d2bce36faceb6b9ff5c277f8d0a3f0a605e9e",
887
936
  "entry": 1
888
937
  }
889
938
  ]
@@ -894,47 +943,47 @@
894
943
  "items": [
895
944
  {
896
945
  "description": "Moves every git invocation in the streamline-guidance helper into the `StreamlineGit` adapter in `git.ts`, which the `runCheck`, `runRecord`, `runResolve`, and `runCommand` entry points take as a parameter that defaults to the real adapter. (#2069)",
897
- "hash": "f581814abed52de80a76598a3ea004b7c8c3092b",
946
+ "hash": "423aacad8c41d9b7d52824968313567e0a9425d3",
898
947
  "entry": 1
899
948
  },
900
949
  {
901
950
  "description": "Adds the `SharedGit` adapter in `packages/guidance/src/shared/git.ts` and routes the shared helpers' and `derive-session-context`'s git calls through it, which lets the helpers' tests and the CLI tests of `derive-session-context`, `capture-event`, and `capture-lede-decision` use the fake adapter from `makeFakeGit` and move from the `tool` tier to the `unit` tier. (#2072)",
902
- "hash": "546b5f6ed24119be862b61a725cb363b3dc6dddd",
951
+ "hash": "a78193d996149787eef5a838ac47592c1db32bae",
903
952
  "entry": 1
904
953
  },
905
954
  {
906
955
  "description": "Moves the `describe-change` helper's git calls (the commit-existence check, the commit listing, and the working-tree root lookup) into a `DescribeChangeGit` adapter in `describe-change/git.ts`, which `runDescribe` reads from an optional `DescribeInput.git` that defaults to the adapter that runs git. (#2073)",
907
- "hash": "bf7e8b296a05e6169d6b407812b6d3a62ff298dc",
956
+ "hash": "49e7bb7041928b87fb9f1830b3b0bbafeac452e3",
908
957
  "entry": 1
909
958
  },
910
959
  {
911
960
  "description": "Routes the git queries of the `revise-prose`, `groom-backlog`, and `pull-from-backlog` helpers through typed git adapters and narrows `CommandRunner` to `gh`, which lets those helpers' in-progress, ledger-path, file-listing, and CLI tests run in the unit tier against a fake adapter rather than against real repositories. (#2075)",
912
- "hash": "b1d0feee1d2f07bda94196900ef8f58b4e5af12e",
961
+ "hash": "fdafc8ceca72cf8e8793b5f541e055ab2e21eec1",
913
962
  "entry": 1
914
963
  },
915
964
  {
916
965
  "description": "Derives the KB-resolution error codes and messages of `kb-add`, `kb-curate`, and `kb-edit` from one shared resolver and formatter in `kb-shared`, with a discovery-only resolver for `kb-edit`. (#2122)",
917
- "hash": "6b6eb6c9dfdefe4c3e6ef5500150a4b8f3bf771d",
966
+ "hash": "2e4b41c48e30b33fe22bc1b56cd0f6641409de03",
918
967
  "entry": 4
919
968
  },
920
969
  {
921
970
  "description": "Restructures code across the packages and the catwalk demo to satisfy the new `unicorn` rules, mostly by turning trailing `if` blocks into early returns and `continue` guards, and adds `ESNext.Array` to the root `tsconfig.json` `lib` so that `Array.fromAsync` typechecks. (#2152)",
922
- "hash": "844d21ccdf4ed85436de9cfcd358af2f34651f09",
971
+ "hash": "00fa9125376b0e57a4193535c331e961923057f0",
923
972
  "entry": 2
924
973
  },
925
974
  {
926
975
  "description": "Converts property accesses on index signatures to bracket notation in every package, as `noPropertyAccessFromIndexSignature` requires. (#2153)",
927
- "hash": "e09ca0e224178ce34444160ac80477d2e884b677",
976
+ "hash": "93942838783d7dbbadf1a4c8784150e2c5a93cb4",
928
977
  "entry": 3
929
978
  },
930
979
  {
931
980
  "description": "Splits the `describe-change` and `revise-prose` source files that exceeded the `max-lines` ceiling into modules by concern, such as argument parsing, merge-message composition, record parsing, prose extraction, and the object-relative detector's word lists and head analysis. (#2164)",
932
- "hash": "d20b084f6112524eba880d6708576224c6843697",
981
+ "hash": "e39d97a0fa0935f07b39f4ce72e7062849fa0624",
933
982
  "entry": 1
934
983
  },
935
984
  {
936
985
  "description": "Splits `groom-backlog/cli.ts`, `index-prototypes/cli.ts`, `kb-edit/cli.ts`, and `streamline-guidance/resolve.ts` into modules for argument parsing, subcommand runners, and their other separate concerns, which brings each file under the `max-lines` ceiling and leaves the helpers' behavior as it was. (#2165)",
937
- "hash": "d0e26a298441a9545e27f80654ff59e38f87ceb4",
986
+ "hash": "04afaae45c5c7eb60fcde7312092331a88d0fbe6",
938
987
  "entry": 1
939
988
  }
940
989
  ]
@@ -945,37 +994,37 @@
945
994
  "items": [
946
995
  {
947
996
  "description": "Runs the streamline-guidance `resolve`, `check`, `record`, and working-tree listing tests against a fake git adapter in the unit tier, leaving `git.tool.test.ts` and the bundle smoke test as the only ones that build real repositories. (#2069)",
948
- "hash": "f581814abed52de80a76598a3ea004b7c8c3092b",
997
+ "hash": "423aacad8c41d9b7d52824968313567e0a9425d3",
949
998
  "entry": 2
950
999
  },
951
1000
  {
952
1001
  "description": "Moves the in-process CLI tests and the commit-reading tests of `describe-change` to the unit tier on a fake git adapter, `make-fake-git`, and keeps real repositories only for the adapter's own tests and the bundle smoke test. (#2073)",
953
- "hash": "bf7e8b296a05e6169d6b407812b6d3a62ff298dc",
1002
+ "hash": "49e7bb7041928b87fb9f1830b3b0bbafeac452e3",
954
1003
  "entry": 2
955
1004
  },
956
1005
  {
957
1006
  "description": "Adds `ambient-delivery-pins.unit.test.ts`, which fails when a library rulebook declares `ambient` delivery without an entry in `AMBIENT_PINS` stating why nearly every session needs it. (#2087)",
958
- "hash": "893150e0dea901c3e178565092511dae45ed41bf",
1007
+ "hash": "9633a853a8f0ec005a047bc409593397d4801b8a",
959
1008
  "entry": 5
960
1009
  },
961
1010
  {
962
1011
  "description": "Moves the `factory` DOM tests and the `index-prototypes` page-script tests in `guidance` from jsdom to happy-dom, and removes the `ResizeObserver` stub that the `factory` setup file installed for jsdom. (#2101)",
963
- "hash": "f4c7fa57b639bc377fdbbbd6a06c2299478ef5c5",
1012
+ "hash": "d090aaaec23ff1f195458d7bdfecfb3def68a592",
964
1013
  "entry": 2
965
1014
  },
966
1015
  {
967
1016
  "description": "Rewords the test titles, assertion messages, and comments in the `codeassembly-guidance` content tests against the current writing rules, and re-pins the body hashes in `rulebook-version-pins.unit.test.ts` to the reworded rulebooks. (#2130)",
968
- "hash": "2994cf92898d06091137cc327f5c927faa81a3e8",
1017
+ "hash": "bfcd6b431eb92d5edb309a384eaa02ce4f445f70",
969
1018
  "entry": 2
970
1019
  },
971
1020
  {
972
1021
  "description": "Splits the oversized test files of both helpers by subcommand or aspect, and moves the fixtures shared by several of the new files into `test-utils`. (#2164)",
973
- "hash": "d20b084f6112524eba880d6708576224c6843697",
1022
+ "hash": "e39d97a0fa0935f07b39f4ce72e7062849fa0624",
974
1023
  "entry": 2
975
1024
  },
976
1025
  {
977
1026
  "description": "Splits the CLI tests of `capture-event`, `groom-backlog`, `kb-add`, and `kb-edit` by subcommand or aspect, moves their shared fixtures into each helper's `test-utils`, and runs the in-process `kb-add` cases under the unit tier instead of the tool tier, which leaves `cli.tool.test.ts` with only the subprocess smoke test. (#2165)",
978
- "hash": "d0e26a298441a9545e27f80654ff59e38f87ceb4",
1027
+ "hash": "04afaae45c5c7eb60fcde7312092331a88d0fbe6",
979
1028
  "entry": 2
980
1029
  }
981
1030
  ]
@@ -986,12 +1035,12 @@
986
1035
  "items": [
987
1036
  {
988
1037
  "description": "Makes `install-launchers.sh` exit 2 on a usage error and print requested help to stdout rather than stderr. (#2134)",
989
- "hash": "f4e728365ae58c60a2f6dad5e1b3511c7ac154b4",
1038
+ "hash": "6a2690f7fb0d3ae828198f0ada600b30aabfe699",
990
1039
  "entry": 4
991
1040
  },
992
1041
  {
993
1042
  "description": "Deletes the `extract-plugin-skills.sh` script, which failed on every run because it sourced a `functions/colors.sh` file that the repository does not contain. (#2134)",
994
- "hash": "f4e728365ae58c60a2f6dad5e1b3511c7ac154b4",
1043
+ "hash": "6a2690f7fb0d3ae828198f0ada600b30aabfe699",
995
1044
  "entry": 5
996
1045
  }
997
1046
  ]
@@ -1002,12 +1051,12 @@
1002
1051
  "items": [
1003
1052
  {
1004
1053
  "description": "Replaces `jsdom` 30.1.1 with `happy-dom` 21.0.1 in the workspace catalog and the `factory` and `guidance` manifests, drops `@types/jsdom`, and prunes the jsdom package tree from `pnpm-lock.yaml`. (#2101)",
1005
- "hash": "f4c7fa57b639bc377fdbbbd6a06c2299478ef5c5",
1054
+ "hash": "d090aaaec23ff1f195458d7bdfecfb3def68a592",
1006
1055
  "entry": 3
1007
1056
  },
1008
1057
  {
1009
1058
  "description": "Applies patch and minor upgrades to the root and `factory` dependencies, among them `react` and `react-dom` 19.3.1, `zod` 4.6.7, and pnpm 12.13.0, and rebuilds the `guidance` helper bundles that bundle `zod`. (#2163)",
1010
- "hash": "394ecd3f317959edfba110efac5f6bd2f4c50541",
1059
+ "hash": "177b5a3c705f6453c2054161dd897628be06a609",
1011
1060
  "entry": 2
1012
1061
  }
1013
1062
  ]
@@ -1019,7 +1068,7 @@
1019
1068
  {
1020
1069
  "description": "Sweep kb, run-core, and root files against the current writing rules (#2127)",
1021
1070
  "body": "Repairs prose in `packages/kb`, `packages/run-core`, and the repository files outside `packages/` against the current versions of the writing rules, covering READMEs, design docs, code comments, test titles, and the repository's agent guidance.",
1022
- "hash": "0d1b6546d5daf93e044a71e702f7b49e93dcbe45"
1071
+ "hash": "1b04fdc4614eba3a2e425957525b853cb5e154fe"
1023
1072
  }
1024
1073
  ]
1025
1074
  },
@@ -1030,11 +1079,11 @@
1030
1079
  {
1031
1080
  "description": "Revise the agents package's prose against the current writing rules (#2128)",
1032
1081
  "body": "Revises the comments, docs, test names, and printed messages of `packages/agents` against the current writing rules, which completes the `revise-prose` sweep of the package. The CLI's warnings now say that a guidance template or a script \"is provided by more than one content root\" instead of \"is shipped by more than one content root\".",
1033
- "hash": "0a26701f3713fc430be0a104361bbcf7ab51881f"
1082
+ "hash": "477a84daf43b156dbe6c5e852ae00b4518b94c64"
1034
1083
  },
1035
1084
  {
1036
1085
  "description": "Rewrites the comments, test titles, `README.md`, and `docs/` helper guides of `packages/guidance` to follow the current writing rules. (#2132)",
1037
- "hash": "62f2c0a5859c798e87dc428eb45355ddf399c47e",
1086
+ "hash": "ea0d2f777bac430550cc4c61e9da6fc21055933d",
1038
1087
  "entry": 2
1039
1088
  }
1040
1089
  ]
@@ -1052,300 +1101,300 @@
1052
1101
  {
1053
1102
  "description": "Moves the CodeAssembly library and its helpers from the `codeassembly` package into the new `codeassembly-guidance` package at `packages/guidance`, whose support files deploy under `_sources/codeassembly-guidance/`. (#1933)",
1054
1103
  "migration": "In the `sources:` entry that declares a clone of the library, change `path` to the clone's `packages/guidance/content` and `name` to `codeassembly-guidance`, and update any hard-coded reference to `_sources/codeassembly/`, a tree that `sync` then retracts.",
1055
- "hash": "04c9f0b68f9d30f51c37203449047c88e1615d38",
1104
+ "hash": "027f0c262d4c2285d0f662cc656dc140a91b1dd0",
1056
1105
  "entry": 1
1057
1106
  },
1058
1107
  {
1059
1108
  "description": "Adds the Claude-only `prepare-prototype-brief` skill, which composes and checks the shared brief for a round of competing prototypes, dispatches one builder per lens, and writes a comparison of the prototypes after `index-prototypes` builds the index page. (#1936)",
1060
- "hash": "81fd3b2e2c482bf107bdfa65b4e9eb2c535997d2",
1109
+ "hash": "11c16f7ddc2d7572d7e50049aa9551c855d94689",
1061
1110
  "entry": 1
1062
1111
  },
1063
1112
  {
1064
1113
  "description": "Adds the ambient rulebook `command-output-conventions` to the `recommended` collection, which directs an agent to print only the fact that a step needs from a large or repeated command's output, and, for a repeated evaluation, to print one line per case from a single scorer. (#1938)",
1065
- "hash": "10b538a3c952705a78208813e05a24c3f7193da3",
1114
+ "hash": "b176590547bed59cc63c1fa073d9f3ac6340c034",
1066
1115
  "entry": 1
1067
1116
  },
1068
1117
  {
1069
1118
  "description": "Adds a \"Procedures in helpers\" section to the `codeassembly-content-specification` rulebook, which directs an author who edits a skill or subagent to move a step whose result is fixed by its inputs into a helper that emits JSON, extending an existing helper when one already performs the step. (#1952)",
1070
- "hash": "28182c90d98edfc249fb0dedb9334cb4a11bbada",
1119
+ "hash": "97f798f3a42e7c922f69963c54fe5b54db8ed9c5",
1071
1120
  "entry": 1
1072
1121
  },
1073
1122
  {
1074
1123
  "description": "Makes `create-ticket` resolve a new ticket's labels by running `describe-change.mjs resolve-labels`, which now accepts a call without `--body-file` and labels the record from `--type`, `--scope`, and `--breaking` alone. (#1952)",
1075
- "hash": "28182c90d98edfc249fb0dedb9334cb4a11bbada",
1124
+ "hash": "97f798f3a42e7c922f69963c54fe5b54db8ed9c5",
1076
1125
  "entry": 2
1077
1126
  },
1078
1127
  {
1079
1128
  "description": "Adds the `manage-jira-ticket.mjs` helper, which `create-ticket` now runs to resolve the project key and issue type from the repository's `.agents/preferences.yaml`, check a parent reference, and run `acli jira workitem create` exactly once. (#1955)",
1080
- "hash": "7f5788c508fbebba277159b25d191aca8609b41a",
1129
+ "hash": "dd8e0d7dc854a2569c9d0ef08303de56a834dffa",
1081
1130
  "entry": 1
1082
1131
  },
1083
1132
  {
1084
1133
  "description": "Directs the `acli` path of `update-jira-ticket` to convert a Markdown body to ADF with the helper's `convert-body` subcommand, which turns GFM task lists into Jira task items. (#1955)",
1085
- "hash": "7f5788c508fbebba277159b25d191aca8609b41a",
1134
+ "hash": "dd8e0d7dc854a2569c9d0ef08303de56a834dffa",
1086
1135
  "entry": 2
1087
1136
  },
1088
1137
  {
1089
1138
  "description": "Adds the `describe-change render-details` subcommand, which renders a change summary's `## Details` body from an entries file, with its headings, subsection order, and breaking prefix taken from `work-types.json`. (#1957)",
1090
- "hash": "c36c228fe73008ea6cc8920e340ae645a28832c9",
1139
+ "hash": "169b72b099c845545059130cb4abb4abea5f27e0",
1091
1140
  "entry": 2
1092
1141
  },
1093
1142
  {
1094
1143
  "description": "Adds a launch prompt for each ticket that keeps work to the \"Split the ticket\" report of `design-and-plan`, `plan`, `refine-plan`, and `save-plan`, which starts the session at `design-and-plan`, `plan`, `refine-plan`, or `implement-plan`, depending on how much of the ticket's design and plan is already settled, and lists the ticket's plan path, scope notes, and blockers. (#1961)",
1095
- "hash": "bb8d6dc0fb033ee4d8ae8052c263728d0c4606da",
1144
+ "hash": "25fff568df3605b7f98cf92a96135379e4c3a309",
1096
1145
  "entry": 1
1097
1146
  },
1098
1147
  {
1099
1148
  "description": "Adds a launch prompt for each piece to the \"Split the branch\" report of `implement-plan`, which starts the session at `review-branch` with the piece's diff base, names the piece's branch and worktree, and shows each later piece as blocked until its predecessor merges. (#1961)",
1100
- "hash": "bb8d6dc0fb033ee4d8ae8052c263728d0c4606da",
1149
+ "hash": "25fff568df3605b7f98cf92a96135379e4c3a309",
1101
1150
  "entry": 2
1102
1151
  },
1103
1152
  {
1104
1153
  "description": "Adds the `--related-to <#>` option to the `groom-backlog` skill, which assesses the open tickets related to a closed ticket in place of the backlog: the tickets that mention it or its closing pull request, the tickets that it blocked, its parent and the parent's other open children, and the tickets that name a file touched by the closing pull request. (#1966)",
1105
- "hash": "e445c642679312607af15a84d2a5929b38663d1b",
1154
+ "hash": "3d0f189da7e83dbff4b5e8178ff5810779471b94",
1106
1155
  "entry": 1
1107
1156
  },
1108
1157
  {
1109
1158
  "description": "Adds the `pending-ripples` command to the `groom-backlog` helper, which lists the closed tickets that a ripple has not yet assessed, since a given date or else since the last pull or the last groom that was not a dry run. (#1966)",
1110
- "hash": "e445c642679312607af15a84d2a5929b38663d1b",
1159
+ "hash": "3d0f189da7e83dbff4b5e8178ff5810779471b94",
1111
1160
  "entry": 2
1112
1161
  },
1113
1162
  {
1114
1163
  "description": "Adds the `related` command to the `groom-backlog` helper, which returns a ripple's related set with its counts by tier without writing anything. (#1966)",
1115
- "hash": "e445c642679312607af15a84d2a5929b38663d1b",
1164
+ "hash": "3d0f189da7e83dbff4b5e8178ff5810779471b94",
1116
1165
  "entry": 3
1117
1166
  },
1118
1167
  {
1119
1168
  "description": "Directs the `ticket-assessor` subagent to examine a ripple's closed ticket and pull request first, and to recommend `close-complete` when the pull request met the ticket's motivation or when the ticket is a parent whose children are all closed. (#1966)",
1120
- "hash": "e445c642679312607af15a84d2a5929b38663d1b",
1169
+ "hash": "3d0f189da7e83dbff4b5e8178ff5810779471b94",
1121
1170
  "entry": 4
1122
1171
  },
1123
1172
  {
1124
1173
  "description": "Extends the `groom-backlog` issue fetch to request each ticket's parent, blockers, sub-issue counts, assignees, and milestone, which requires `gh` 2.100 or later. (#1966)",
1125
- "hash": "e445c642679312607af15a84d2a5929b38663d1b",
1174
+ "hash": "3d0f189da7e83dbff4b5e8178ff5810779471b94",
1126
1175
  "entry": 5
1127
1176
  },
1128
1177
  {
1129
1178
  "description": "Adds a final step to `merge-pr` that reads the open tickets related to the ticket that the merge commit closes and asks for consent before running `groom-backlog --related-to` on them, or records an empty ripple when the merged ticket does not have any related tickets. (#1967)",
1130
- "hash": "1e832094930e9f9d3b835ddc37b4d6efd9c39acd",
1179
+ "hash": "038abbc83e0006a209584e5a8154acc3190514bb",
1131
1180
  "entry": 1
1132
1181
  },
1133
1182
  {
1134
1183
  "description": "Adds a \"Ripple merged ticket #N\" action to `wrap-up`, which it offers for a ticket closed by a PR merged in the session when `pending-ripples` reports that the ticket has not been rippled yet. (#1967)",
1135
- "hash": "1e832094930e9f9d3b835ddc37b4d6efd9c39acd",
1184
+ "hash": "038abbc83e0006a209584e5a8154acc3190514bb",
1136
1185
  "entry": 2
1137
1186
  },
1138
1187
  {
1139
1188
  "description": "Adds the `pull-from-backlog` skill, which presents the current milestone's umbrellas, in-progress tickets, and blocked tickets with the backlog's warnings, offers the unblocked and unassigned tickets as a ranked menu with the reasons for each rank, and assigns the picked ticket to the user on consent. (#1969)",
1140
- "hash": "7b103316dab9e9257debb59724af1af7d2eef36b",
1189
+ "hash": "2b93df0c691fc1ee26c6de1761012a68c9d63196",
1141
1190
  "entry": 1
1142
1191
  },
1143
1192
  {
1144
1193
  "description": "Adds the `ticket.pull` project preferences, which set the milestone that `pull-from-backlog` treats as current, the prefix of the priority labels, the thresholds at which a branch or a groom counts as stale, and whether a pick assigns the user without asking. (#1969)",
1145
- "hash": "7b103316dab9e9257debb59724af1af7d2eef36b",
1194
+ "hash": "2b93df0c691fc1ee26c6de1761012a68c9d63196",
1146
1195
  "entry": 2
1147
1196
  },
1148
1197
  {
1149
1198
  "description": "Adds a \"Product development\" section to the `williamthorsen-workflow-preferences` rulebook, which states the stages from idea to increments, with a usable MVP before further features, and the shape to propose once the developer approves the end vision: an epic whose iterations are its sub-issues, with only the current one specified in detail. (#1973)",
1150
- "hash": "79e116429e9c1762d03d86da9039471fd02b9dbd",
1199
+ "hash": "f2cb0949c0ffffd259d5625d13c22c7e828ea7a2",
1151
1200
  "entry": 1
1152
1201
  },
1153
1202
  {
1154
1203
  "description": "States which artifact holds what: a design doc in the repo holds the vision, the epic points to it and lists the iterations in order, the milestone marks the current iteration, and each later iteration stays a one-line outcome until its work starts. (#1973)",
1155
- "hash": "79e116429e9c1762d03d86da9039471fd02b9dbd",
1204
+ "hash": "f2cb0949c0ffffd259d5625d13c22c7e828ea7a2",
1156
1205
  "entry": 2
1157
1206
  },
1158
1207
  {
1159
1208
  "description": "Names the winning prototype as the baseline for the finished product, the floor on quality and feel against which it is judged, with a feature reduced in one iteration recorded as a one-line sub-issue and a feature settled below that bar recorded in the design doc with its reason. (#1973)",
1160
- "hash": "79e116429e9c1762d03d86da9039471fd02b9dbd",
1209
+ "hash": "f2cb0949c0ffffd259d5625d13c22c7e828ea7a2",
1161
1210
  "entry": 3
1162
1211
  },
1163
1212
  {
1164
1213
  "description": "Makes `create-commit` take the paths to stage and a one-line purpose as arguments, compose the body from the diff alone when no purpose is passed, and report the new commit's short SHA and title or the reason that nothing was committed. (#1979)",
1165
- "hash": "80002d52e4026884b6afa9389189476852176e89",
1214
+ "hash": "eb023656b54db313bbf54f4d6ac7bf53355ab1de",
1166
1215
  "entry": 2
1167
1216
  },
1168
1217
  {
1169
1218
  "description": "States in `codeassembly-content-specification` that the deploy writes every skill frontmatter key other than `supported-harnesses` to every harness unchanged, so a key that only one harness reads, such as Claude's `context` or `model`, reaches the others, which ignore it. (#1979)",
1170
- "hash": "80002d52e4026884b6afa9389189476852176e89",
1219
+ "hash": "eb023656b54db313bbf54f4d6ac7bf53355ab1de",
1171
1220
  "entry": 3
1172
1221
  },
1173
1222
  {
1174
1223
  "description": "Adds a step to `merge-pr` that offers to close the parent ticket when the merge closed its last open child, and lists any of the parent's own unchecked acceptance criteria beneath the question. (#1980)",
1175
- "hash": "d560bee7c0c845e4a7b5476ae4aba282b811f881",
1224
+ "hash": "21c08b299068f941908ee325c4cef471e286d8d2",
1176
1225
  "entry": 2
1177
1226
  },
1178
1227
  {
1179
1228
  "description": "Names `clients/<library>/` in place of `integrations/` in the `williamthorsen-code-layout-preferences` rulebook as the directory for code that talks to a third-party service or library or maps to its data shapes, and directs code that uses a client to a directory named for its domain. (#1982)",
1180
- "hash": "32aedb168733d4408171511629ff1aceba16832a",
1229
+ "hash": "ff978e51770cc2187cf5d0eea18f90e5875ba8c6",
1181
1230
  "entry": 1
1182
1231
  },
1183
1232
  {
1184
1233
  "description": "Changes `groom-backlog` to keep an in-progress ticket open without commenting on it or presenting it in a digest when its assessment is a `keep` whose verdicts are all baseline; previously, `groom-backlog` presented every in-progress ticket to the user for a decision. (#1983)",
1185
- "hash": "26999a5c9977ee9a6425e527ca0e26a2f44ff034",
1234
+ "hash": "2218ae927ef1c091b70831bc6bbb06c6769e27ce",
1186
1235
  "entry": 1
1187
1236
  },
1188
1237
  {
1189
1238
  "description": "Counts `partial` progress as baseline for an umbrella ticket, which is a ticket that has open children and whose only unchecked criterion is \"Every child is closed\", so that `groom-backlog` keeps such a ticket silently when its assessment is a `keep` and its other verdicts are baseline, and does not post a comment when the user decides to keep it. (#1983)",
1190
- "hash": "26999a5c9977ee9a6425e527ca0e26a2f44ff034",
1239
+ "hash": "2218ae927ef1c091b70831bc6bbb06c6769e27ce",
1191
1240
  "entry": 2
1192
1241
  },
1193
1242
  {
1194
1243
  "description": "Adds a `post` field to the result of the `groom-backlog` helper's `comment` command, which states whether the decision's comment is posted and leaves `--out` unwritten when it is `false`, replacing the skill's own check of the verdicts. (#1983)",
1195
- "hash": "26999a5c9977ee9a6425e527ca0e26a2f44ff034",
1244
+ "hash": "2218ae927ef1c091b70831bc6bbb06c6769e27ce",
1196
1245
  "entry": 3
1197
1246
  },
1198
1247
  {
1199
1248
  "description": "Replaces the per-group bulk question and the per-entry decision in `groom-backlog` with one proposed action per digest entry, which the skill applies to the whole page after one confirmation, with overrides named per entry. (#1984)",
1200
- "hash": "9c435ac2fd7e4cd9e69bb7f06669f983e0a3ccd6",
1249
+ "hash": "317570ab805b73219772b398c72d8fc02a7ad6f0",
1201
1250
  "entry": 1
1202
1251
  },
1203
1252
  {
1204
1253
  "description": "Adds the `--close-not-planned <reason>` option to `groom-backlog`, which closes the selected tickets as not planned without assessing them, requires `--scope` or `--older-than`, and lists the tickets in one confirmation before it closes any. (#1984)",
1205
- "hash": "9c435ac2fd7e4cd9e69bb7f06669f983e0a3ccd6",
1254
+ "hash": "317570ab805b73219772b398c72d8fc02a7ad6f0",
1206
1255
  "entry": 2
1207
1256
  },
1208
1257
  {
1209
1258
  "description": "Makes `groom-backlog` apply the edit that `ticket-assessor` drafts for a confirmed `update`, `revise`, or `split`, replacing the rewritten body sections, creating and linking a split's child tickets, and naming the rewritten sections in its comment, and skipping a draft when the ticket changed after its assessment or when the draft would rewrite the Problem, Context, or Proposed solution of an in-progress ticket. (#1984)",
1210
- "hash": "9c435ac2fd7e4cd9e69bb7f06669f983e0a3ccd6",
1259
+ "hash": "317570ab805b73219772b398c72d8fc02a7ad6f0",
1211
1260
  "entry": 3
1212
1261
  },
1213
1262
  {
1214
1263
  "description": "Adds an instruction to the umbrella criterion convention, which `create-ticket`, `design-and-plan`, and `align-ticket-with-implementation` include, to create a child ticket for every planned piece once the split is decided and to defer a piece by closing its child as not planned, so that the criterion \"Every child is closed\" cannot hold while a planned piece lacks a ticket. (#1987)",
1215
- "hash": "719da292375d0a2d529584b3b42bdd0b3b3f88fa",
1264
+ "hash": "dbd8e1b37408ea3bdcb0dd5bd8bfb56aa7ae50fc",
1216
1265
  "entry": 1
1217
1266
  },
1218
1267
  {
1219
1268
  "description": "Adds an instruction to the `williamthorsen-workflow-preferences` rulebook to create every iteration's sub-issue when the epic is created. (#1987)",
1220
- "hash": "719da292375d0a2d529584b3b42bdd0b3b3f88fa",
1269
+ "hash": "dbd8e1b37408ea3bdcb0dd5bd8bfb56aa7ae50fc",
1221
1270
  "entry": 2
1222
1271
  },
1223
1272
  {
1224
1273
  "description": "Directs `assess-ticket` to count the `partial` progress of an umbrella (a ticket that has open children and whose only unchecked criterion is \"Every child is closed\") as baseline, recognized from the ticket's child counts, and not to offer an update or close action for it. (#1989)",
1225
- "hash": "0864719f359c8bc3bac29af98f0f96198287645c",
1274
+ "hash": "f7bdbe6195919d45d8ccc9b8a728af9b33bdab27",
1226
1275
  "entry": 1
1227
1276
  },
1228
1277
  {
1229
1278
  "description": "Adds a test-file length rule to the `testing-conventions` skill, which directs an agent to split a test file by aspect before adding tests that would leave it past the project's `max-lines` setting for test files, or past 500 lines when the lint does not set one, and to move shared fixture builders into a `test-utils/` module beside the tests. (#1991)",
1230
- "hash": "9d65e47f8ee12dae1dcb990ce5ac030e316c58db",
1279
+ "hash": "2319b845f5c337475ece595ac8fb08420739931c",
1231
1280
  "entry": 1
1232
1281
  },
1233
1282
  {
1234
1283
  "description": "Adds a rule to the `review-criteria` skill that classifies a test file that the change adds to and leaves past that ceiling as a Warning, except in a project whose lint already applies `max-lines` to test files. (#1991)",
1235
- "hash": "9d65e47f8ee12dae1dcb990ce5ac030e316c58db",
1284
+ "hash": "2319b845f5c337475ece595ac8fb08420739931c",
1236
1285
  "entry": 2
1237
1286
  },
1238
1287
  {
1239
1288
  "description": "Adds the `shared-data-conventions` rulebook, which forbids writes to shared state from unmerged code and requires each expand, migrate, or contract step of a data-shape change to be merged and deployed before the next begins, to the `recommended` collection. (#1992)",
1240
- "hash": "ad3e14265ddb7c9fa579cb6adb292f52b4207fe8",
1289
+ "hash": "33c2101c37f2a202ac7185ee2f3fad03e3ba1428",
1241
1290
  "entry": 1
1242
1291
  },
1243
1292
  {
1244
1293
  "description": "Directs `create-ticket`, `design-and-plan`, and `plan` to scope a ticket or plan that changes the shape of persisted data to one step of that sequence, and bars every planned task and verification check from writing to shared state before merge. (#1992)",
1245
- "hash": "ad3e14265ddb7c9fa579cb6adb292f52b4207fe8",
1294
+ "hash": "33c2101c37f2a202ac7185ee2f3fad03e3ba1428",
1246
1295
  "entry": 2
1247
1296
  },
1248
1297
  {
1249
1298
  "description": "Directs `implement-plan` to treat a step or verification check that writes to shared state from the branch as material divergence, to be reported rather than run even when the plan directs it. (#1992)",
1250
- "hash": "ad3e14265ddb7c9fa579cb6adb292f52b4207fe8",
1299
+ "hash": "33c2101c37f2a202ac7185ee2f3fad03e3ba1428",
1251
1300
  "entry": 3
1252
1301
  },
1253
1302
  {
1254
1303
  "description": "Adds a \"Data changes\" item to `review-criteria`, which flags a change that removes or renames data still read by deployed code, or that depends on a migration run before merge. (#1992)",
1255
- "hash": "ad3e14265ddb7c9fa579cb6adb292f52b4207fe8",
1304
+ "hash": "33c2101c37f2a202ac7185ee2f3fad03e3ba1428",
1256
1305
  "entry": 4
1257
1306
  },
1258
1307
  {
1259
1308
  "description": "Adds a \"Subagent models\" section to the Claude harness `CLAUDE.md`, which directs a session to pass `haiku` to a subagent that only searches for files or code, to pass `sonnet` to one that only reads, runs checks, or reports, and to leave the model unset for one that writes code or prose. (#1996)",
1260
- "hash": "e24422a9eeab2e4afd5c390cc3558d4b748bb3d6",
1309
+ "hash": "41674cb076f55a46dc970204a9b5dfc785ebd387",
1261
1310
  "entry": 1
1262
1311
  },
1263
1312
  {
1264
1313
  "description": "Changes the model declared for the `plan-reviser` subagent from `sonnet` to `inherit`, so that the subagent, which rewrites plans, runs on the session's model. (#1996)",
1265
- "hash": "e24422a9eeab2e4afd5c390cc3558d4b748bb3d6",
1314
+ "hash": "41674cb076f55a46dc970204a9b5dfc785ebd387",
1266
1315
  "entry": 2
1267
1316
  },
1268
1317
  {
1269
1318
  "description": "Publishes the `preferences` and `work-types` JSON Schemas in `codeassembly-guidance` as `schemas/preferences.v1.json` and `schemas/work-types.v1.json`, each with an `$id` of the form `https://unpkg.com/codeassembly-guidance@<version>/schemas/<name>.v<N>.json`, so that one `$id` always names the same schema. (#2000)",
1270
1319
  "breaking": true,
1271
1320
  "migration": "Replace a reference to `https://github.com/williamthorsen/codeassembly/raw/main/packages/guidance/schemas/preferences.json` or `work-types.schema.json` with the `$id` of the installed release or with the installed file under `codeassembly-guidance/schemas/`, and update a versioned URL when upgrading the package, because unlike the `raw/main` URL it does not follow new releases.",
1272
- "hash": "7ed2a6916631341810cf8e262c32b3a6ebc606fc",
1321
+ "hash": "f378066ebaafd5722ee6a908c6172e4694c76343",
1273
1322
  "entry": 1
1274
1323
  },
1275
1324
  {
1276
1325
  "description": "Adds the `ticket.pull.excludeLabels` preference, which lists the labels that make a ticket ineligible for `pull-from-backlog`, matches them without regard to case, and defaults to `[\"status:blocked\", \"status:on-hold\"]`. (#2002)",
1277
- "hash": "c3bb3b27ab5bbc7dbcf1d0f91313ecc047a5fefa",
1326
+ "hash": "b4cdb310877a7e5ce93b9ea381f00ebb474aa252",
1278
1327
  "entry": 1
1279
1328
  },
1280
1329
  {
1281
1330
  "description": "Makes `pull-from-backlog` report when the Now milestone has no eligible open tickets left, with a suggestion to close it or plan a new one, and state how many open tickets an excluded label kept off the menu. (#2002)",
1282
- "hash": "c3bb3b27ab5bbc7dbcf1d0f91313ecc047a5fefa",
1331
+ "hash": "b4cdb310877a7e5ce93b9ea381f00ebb474aa252",
1283
1332
  "entry": 4
1284
1333
  },
1285
1334
  {
1286
1335
  "description": "Adds a stderr warning from `describe-change.mjs`, issued when preferences load, for each configured `title_format` that loses a token for some record shape, such as a flat `[{scope}|{type}: ]` group that drops the type when the scope is absent or `*`, while the run still renders. (#2006)",
1287
- "hash": "5d4522db61b236028f1964c2e65581ca675bf1a6",
1336
+ "hash": "1e73ea6a9823247aa4d91b60fd8f22d09895a3ad",
1288
1337
  "entry": 1
1289
1338
  },
1290
1339
  {
1291
1340
  "description": "Adds the `supported-harnesses:` rulebook frontmatter field, which restricts the rulebook's ambient region, rulebook skill, and hook fill to the named harnesses under both `sync` and content-root rendering, and makes `sync` retract what it previously deployed to a harness that the rulebook now excludes. (#2009)",
1292
- "hash": "b4bf0df89157a4f534455d4a9cd15d814fe0051a",
1341
+ "hash": "88d4ab4e051e8d8e95e751094365fafcdb7dfb56",
1293
1342
  "entry": 1
1294
1343
  },
1295
1344
  {
1296
1345
  "description": "Moves the subagent-model guidance from the Claude harness `CLAUDE.md` into the new ambient rulebook `williamthorsen-subagent-model-preferences`, which declares `claude` as its only supported harness and is added to the `williamthorsen` collection. (#2010)",
1297
1346
  "migration": "To keep receiving the subagent-model guidance on Claude, declare the `williamthorsen` collection.",
1298
- "hash": "c7b047e0bf56fdef7c5eaf3b3da29ba1c7f9ec4c",
1347
+ "hash": "8d43a7ee0735dd17614504a299ebcab1f37b7770",
1299
1348
  "entry": 1
1300
1349
  },
1301
1350
  {
1302
1351
  "description": "Adds a rule to `testing-conventions` that a passing test prints nothing beyond the runner's report, directing each test to capture output that is the behavior, silence output that is incidental, and intercept only the channels that it expects to fire. (#2015)",
1303
- "hash": "ec6d02b45973e1e6aa8846ee6ab319bd8c9415b2",
1352
+ "hash": "7b22006563331b23b29588359a38acf837e79a9b",
1304
1353
  "entry": 1
1305
1354
  },
1306
1355
  {
1307
1356
  "description": "Adds a section to `typescript-testing-conventions` that names `silenceConsole` and `listConsoleLines` from `@williamthorsen/toolbelt.vitest/candidate` and `captureStdio` from `@williamthorsen/toolbelt.testing/candidate` for applying that rule, with a `vi.spyOn` or `jest.spyOn` fallback for a project that does not depend on those packages. (#2015)",
1308
- "hash": "ec6d02b45973e1e6aa8846ee6ab319bd8c9415b2",
1357
+ "hash": "7b22006563331b23b29588359a38acf837e79a9b",
1309
1358
  "entry": 2
1310
1359
  },
1311
1360
  {
1312
1361
  "description": "Widens the description of `typescript-testing-conventions` from Jest-based projects to Vitest- and Jest-based projects, so that the skill is also selected in a Vitest project. (#2015)",
1313
- "hash": "ec6d02b45973e1e6aa8846ee6ab319bd8c9415b2",
1362
+ "hash": "7b22006563331b23b29588359a38acf837e79a9b",
1314
1363
  "entry": 3
1315
1364
  },
1316
1365
  {
1317
1366
  "description": "Adds a \"Noisy tests\" section to `review-criteria`, which classifies a test that the change adds and that writes output on a passing run as a Suggestion whose proposed change is the interception described in `testing-conventions`. (#2015)",
1318
- "hash": "ec6d02b45973e1e6aa8846ee6ab319bd8c9415b2",
1367
+ "hash": "7b22006563331b23b29588359a38acf837e79a9b",
1319
1368
  "entry": 4
1320
1369
  },
1321
1370
  {
1322
1371
  "description": "Makes the builders' write allowance in `prepare-prototype-brief` a default of the output file alone, which the developer's ask can extend to a repository directory that keeps the prototypes or to a dependency install, and directs the agent to state the allowance in the brief's rules of engagement. (#2018)",
1323
- "hash": "019e690e5c166e7b1111ee17ec16ed4abeec6050",
1372
+ "hash": "b155e33c4d8172ef85bc6da39a8b659d4c1335e9",
1324
1373
  "entry": 1
1325
1374
  },
1326
1375
  {
1327
1376
  "description": "Adds an assessment step to `upgrade-dependencies` that checks the working tree for uncommitted manifest or lockfile changes, because the outdated report omits an upgrade already applied there, and that requires verifying those changes through the quality gate before planning new upgrades. (#2019)",
1328
- "hash": "63d1093f48e503ab9104ea981ef5244acefeb9b5",
1377
+ "hash": "40730cf8d01c32bbd7483e3946aa4270ed7c0f87",
1329
1378
  "entry": 1
1330
1379
  },
1331
1380
  {
1332
1381
  "description": "Sets the `@types/node` target in `upgrade-dependencies` to the major of the project's Node floor rather than the latest major listed by the outdated report. (#2019)",
1333
- "hash": "63d1093f48e503ab9104ea981ef5244acefeb9b5",
1382
+ "hash": "40730cf8d01c32bbd7483e3946aa4270ed7c0f87",
1334
1383
  "entry": 2
1335
1384
  },
1336
1385
  {
1337
1386
  "description": "Limits the security fast-track in `upgrade-dependencies` to actionable advisories, and directs the agent to check whether re-resolving a transitive package within its parent's range, or upgrading the direct dependency that pulls it in, resolves the advisory, and to record one without an upstream fix as a known issue in the PR body rather than force a version with an override. (#2019)",
1338
- "hash": "63d1093f48e503ab9104ea981ef5244acefeb9b5",
1387
+ "hash": "40730cf8d01c32bbd7483e3946aa4270ed7c0f87",
1339
1388
  "entry": 3
1340
1389
  },
1341
1390
  {
1342
1391
  "description": "Extends the downstream-support check that `upgrade-dependencies` runs before a major upgrade to shared configs and the plugins that they pull in transitively, and directs holding the upgrade at its ceiling when one of them does not support the new major and a maintained fork does not exist. (#2019)",
1343
- "hash": "63d1093f48e503ab9104ea981ef5244acefeb9b5",
1392
+ "hash": "40730cf8d01c32bbd7483e3946aa4270ed7c0f87",
1344
1393
  "entry": 4
1345
1394
  },
1346
1395
  {
1347
1396
  "description": "Defines a major upgrade together with the code and config adaptations that it requires as one logical change in the commit guidance of `upgrade-dependencies`. (#2019)",
1348
- "hash": "63d1093f48e503ab9104ea981ef5244acefeb9b5",
1397
+ "hash": "40730cf8d01c32bbd7483e3946aa4270ed7c0f87",
1349
1398
  "entry": 5
1350
1399
  }
1351
1400
  ]
@@ -1358,31 +1407,31 @@
1358
1407
  "description": "Removes the skills `orchestrate`, `orchestrate-dev`, `orchestrate-review`, `plan-orchestrable-steps`, and `find-orchestration-savings`, together with the subagents that only those skills dispatched, such as `orchestrated-coder`, `planner`, and the `aspect-*` reviewers. (#1943)",
1359
1408
  "breaking": true,
1360
1409
  "migration": "Replace `orchestrate-dev` with `plan`, `implement-plan`, and `review-branch`, and replace `orchestrate-review` with `review-branch` followed by `respond-to-review`.",
1361
- "hash": "2d926535c2f21f9db95e7314e26ef1613071b71c",
1410
+ "hash": "c8853e8664658c63bb64018800dac771b033750c",
1362
1411
  "entry": 1
1363
1412
  },
1364
1413
  {
1365
1414
  "description": "Removes the `orchestration` block (review rounds, severity thresholds, MCP policy, and per-role model overrides) from the `preferences.yaml` schema, which sets `additionalProperties: false`, so an editor that validates the file now reports an `orchestration` key as unknown. (#1943)",
1366
1415
  "migration": "Delete the `orchestration` key from `.agents/preferences.yaml` and `~/.agents/preferences.yaml`; the skills already ignore it at runtime, but schema validation rejects it.",
1367
- "hash": "2d926535c2f21f9db95e7314e26ef1613071b71c",
1416
+ "hash": "c8853e8664658c63bb64018800dac771b033750c",
1368
1417
  "entry": 2
1369
1418
  },
1370
1419
  {
1371
1420
  "description": "Removes the parts of the surviving skills that served only engine runs: the `--run-id` argument of `create-devlog`, the `--role` argument and run-artifact path of `plan`, the orchestrated session type of `wrap-up`, the JSON-companion plan format of `refine-plan`, and the reuse of an active run directory by `review-branch`, which now always creates a new `{timestamp}-interactive` run directory. (#1943)",
1372
1421
  "migration": "Drop `--run-id` from `create-devlog` calls and `--role` from `plan` calls, and give `refine-plan` a prose plan, because it no longer reads a JSON companion file.",
1373
- "hash": "2d926535c2f21f9db95e7314e26ef1613071b71c",
1422
+ "hash": "c8853e8664658c63bb64018800dac771b033750c",
1374
1423
  "entry": 3
1375
1424
  },
1376
1425
  {
1377
1426
  "description": "Remove the codeassembly-mcp server (#1945)",
1378
1427
  "body": "Removes the `codeassembly-mcp` server and its `codeassembly` registration in `.claude/settings.json`, because its five run-management tools served only the orchestration engine, which has been retired. Keeps the v3 run format in `codeassembly-run-core` as a read-only format, so that existing v3 runs stay readable after the removal of the only tool that wrote them.",
1379
1428
  "breaking": true,
1380
- "hash": "9021da623524864946b3f389ffd24b89dbb146ee"
1429
+ "hash": "d13b2cb077a415a1fc8719b4bdd2f590542b8dc7"
1381
1430
  },
1382
1431
  {
1383
1432
  "description": "Removes the post-merge ripple, `groom-backlog --related-to`, which assessed the open tickets related to a merged ticket, along with the offers to run it from `merge-pr`, `wrap-up`, and `pull-from-backlog`. (#1980)",
1384
1433
  "migration": "Remove `--related-to` from any `groom-backlog` invocation. To update or close related tickets, rely on the drift check that `design-and-plan` and `plan` run when a ticket is taken up, or on an ordinary `groom-backlog` run.",
1385
- "hash": "d560bee7c0c845e4a7b5476ae4aba282b811f881",
1434
+ "hash": "21c08b299068f941908ee325c4cef471e286d8d2",
1386
1435
  "entry": 1
1387
1436
  }
1388
1437
  ]
@@ -1393,122 +1442,122 @@
1393
1442
  "items": [
1394
1443
  {
1395
1444
  "description": "Fixes the issue that a next-steps menu could recommend an option by what the session holds, such as a table \"already in context\": `option-format` now names any pro or con that cites the conversation as one to cut, and `next-steps-after-plan` states that the saved ticket and plan are the complete handoff, with a fact found only in the session added to the artifact instead. (#1939)",
1396
- "hash": "f00b19af18ef0d21d161232bea30ec4aa1fabfb5",
1445
+ "hash": "989dcd4f295243cf2923b7f8dacd56a292af98f8",
1397
1446
  "entry": 1
1398
1447
  },
1399
1448
  {
1400
1449
  "description": "Corrects the context-clearing rationales in `implement-plan`, `next-steps-after-plan`, and `next-steps-after-review` that justified staying in the session by what the session remembers, so that each names the branch's commits and diff, the saved plan, or the saved review as its source. (#1939)",
1401
- "hash": "f00b19af18ef0d21d161232bea30ec4aa1fabfb5",
1450
+ "hash": "989dcd4f295243cf2923b7f8dacd56a292af98f8",
1402
1451
  "entry": 2
1403
1452
  },
1404
1453
  {
1405
1454
  "description": "Fixes the issue that `review-gh-pr` could select a different ticket on each run when a pull request body referenced several issues, by adding a `select-pr-ticket` helper that takes the first `closingIssuesReferences` entry or else the earliest reference in the body outside code. (#1954)",
1406
- "hash": "45d231be59d79d3d0d6f2291ab9de0074e44e84a",
1455
+ "hash": "2d8d308a50f9dc081480d2fbf15fa715573aaa82",
1407
1456
  "entry": 1
1408
1457
  },
1409
1458
  {
1410
1459
  "description": "Fixes the issue that `williamthorsen-collaboration-preferences` did not state when an agent may hand a step to the developer, by adding a \"Handoffs\" section that directs the agent to perform every step, verification included, and to hand over only the part that it cannot perform, with the reason. (#1956)",
1411
- "hash": "64954d519c4e121517dfbecebe30f197955bbbf3",
1460
+ "hash": "1eff262c53f32389654cf8b7a32f647cb7989057",
1412
1461
  "entry": 1
1413
1462
  },
1414
1463
  {
1415
1464
  "description": "Fixes the issue that `williamthorsen-tooling-preferences` read as licence to hand a sandbox-refused command to the developer, by rewriting the rule to direct the agent to retry the command through the permission gate or to ask once for the grant that clears it. (#1956)",
1416
- "hash": "64954d519c4e121517dfbecebe30f197955bbbf3",
1465
+ "hash": "1eff262c53f32389654cf8b7a32f647cb7989057",
1417
1466
  "entry": 2
1418
1467
  },
1419
1468
  {
1420
1469
  "description": "Fixes the issue that the plan template let a plan name the developer as the actor of a task or verification check: Every step now names the agent, a part that only the developer can perform is written as a `**Residue:**` line with its reason, and `plan-reviewer` and `handoff-reviewer` report a developer-assigned step that lacks one. (#1956)",
1421
- "hash": "64954d519c4e121517dfbecebe30f197955bbbf3",
1470
+ "hash": "1eff262c53f32389654cf8b7a32f647cb7989057",
1422
1471
  "entry": 3
1423
1472
  },
1424
1473
  {
1425
1474
  "description": "Fixes the issue that `implement-plan` turned a plan's developer-assigned verification step into a request for the developer to run it, by revising its steps to direct the agent to run every check itself, through a debug browser where one is provided, and to raise only the ask that a `**Residue:**` line states. (#1956)",
1426
- "hash": "64954d519c4e121517dfbecebe30f197955bbbf3",
1475
+ "hash": "1eff262c53f32389654cf8b7a32f647cb7989057",
1427
1476
  "entry": 4
1428
1477
  },
1429
1478
  {
1430
1479
  "description": "Fixes the issue that the action-items sweep let an agent fill the block with checks and commands that it could resolve itself, by naming those forms in the sweep and directing the agent to run such an item rather than ask it. (#1956)",
1431
- "hash": "64954d519c4e121517dfbecebe30f197955bbbf3",
1480
+ "hash": "1eff262c53f32389654cf8b7a32f647cb7989057",
1432
1481
  "entry": 5
1433
1482
  },
1434
1483
  {
1435
1484
  "description": "Fixes the issue that `summarize-change` headed the `## Details` subsections with labels of the agent's own, such as `🔧 Tooling` for `⚙️ Tooling`, rather than with the headings declared in `work-types.json`. (#1957)",
1436
- "hash": "c36c228fe73008ea6cc8920e340ae645a28832c9",
1485
+ "hash": "169b72b099c845545059130cb4abb4abea5f27e0",
1437
1486
  "entry": 1
1438
1487
  },
1439
1488
  {
1440
1489
  "description": "Fixes the issue that `review-branch` and `review-pr` created a new run directory for every review, so a re-review neither read nor joined the run that holds the earlier review and the author's response. (#1958)",
1441
- "hash": "d28c6d23c0c99f7d712cab45dd12c3e0863cd5ff",
1490
+ "hash": "0ad52e2b8837124d532f73a0ca13cfcbfd58b230",
1442
1491
  "entry": 1
1443
1492
  },
1444
1493
  {
1445
1494
  "description": "Fixes the issue that `respond-to-review` could select a run directory written by the retired orchestration engine when it looked for the newest review. (#1958)",
1446
- "hash": "d28c6d23c0c99f7d712cab45dd12c3e0863cd5ff",
1495
+ "hash": "0ad52e2b8837124d532f73a0ca13cfcbfd58b230",
1447
1496
  "entry": 2
1448
1497
  },
1449
1498
  {
1450
1499
  "description": "Addresses the issue that commit titles composed with `create-commit` contained backticks, which `title-voice.md` forbids, by directing step 3 of the skill to strip any backticks from the title text. (#1970)",
1451
- "hash": "9ee3e7c23aa42cf2a3f0d9474578f9d38caf1e8e",
1500
+ "hash": "f18a8c5381819bdf6e217f47a644050970a723e0",
1452
1501
  "entry": 1
1453
1502
  },
1454
1503
  {
1455
1504
  "description": "Fixes the issue that the rulebook's existing rules read as claims about the world rather than as instructions, by opening each with an imperative addressed to the agent. (#1973)",
1456
- "hash": "79e116429e9c1762d03d86da9039471fd02b9dbd",
1505
+ "hash": "f2cb0949c0ffffd259d5625d13c22c7e828ea7a2",
1457
1506
  "entry": 4
1458
1507
  },
1459
1508
  {
1460
1509
  "description": "Fixes the issue that `derive-session-context` returned a cached branch manifest after a preference change, which left `ticket_id`, `ticket_ref`, `artifact_base_dir`, and the other preference-derived fields at their original values until the file was deleted by hand. (#1993)",
1461
- "hash": "5a429827e0935869d3af5a2316d996c89c48cba6",
1510
+ "hash": "3aa11455992d4a4246ec6b223bda60ac17d3d68e",
1462
1511
  "entry": 1
1463
1512
  },
1464
1513
  {
1465
1514
  "description": "Fixes the issue that `resolve-frontmatter.sh` read the manifest file directly and stamped artifacts with a stale `ticket_id` and `ticket_ref`, by taking the manifest from the deriver on every call. (#1993)",
1466
- "hash": "5a429827e0935869d3af5a2316d996c89c48cba6",
1515
+ "hash": "3aa11455992d4a4246ec6b223bda60ac17d3d68e",
1467
1516
  "entry": 2
1468
1517
  },
1469
1518
  {
1470
1519
  "description": "Fixes the issue that `artifact-conventions.md` did not state that a `ticket_ref_prefix` other than `#` is part of `ticket_id` and names the artifact directory, such as `tickets/ABC-100/` for branch `100` under `ABC-`, and that changing the prefix sends later artifacts to a different directory. (#1994)",
1471
- "hash": "d8e4fa5ab707c3549bc67881e98d43227dc4fe58",
1520
+ "hash": "2af362197934af0e2cf08ef7f7e675d9729953f0",
1472
1521
  "entry": 1
1473
1522
  },
1474
1523
  {
1475
1524
  "description": "Fixes the issue that `ticket-source-resolution.md` told the agent to join a numeric `ticket_id` to a Jira-style prefix read from `.agents/preferences.yaml`, a case that the session-context deriver never produces because it already includes that prefix in `ticket_id`. (#1994)",
1476
- "hash": "d8e4fa5ab707c3549bc67881e98d43227dc4fe58",
1525
+ "hash": "2af362197934af0e2cf08ef7f7e675d9729953f0",
1477
1526
  "entry": 2
1478
1527
  },
1479
1528
  {
1480
1529
  "description": "Fixes the issue that `resolve-frontmatter.sh` looked for the `derive-session-context` helper in `skills/derive-session-context/`, where `sync` does not deploy it, by making the script search every source namespace under `skills/_sources/` and exit non-zero with the searched path when it finds no match or several. (#1999)",
1481
- "hash": "b0ce855e63a8702415d5516103e01dfef80c250e",
1530
+ "hash": "34467ea7a166dd26f04726e30475843b6d409040",
1482
1531
  "entry": 1
1483
1532
  },
1484
1533
  {
1485
1534
  "description": "Fixes the issue that `resolve-frontmatter.sh` reported a missing bundled helper when the path set by `RESOLVE_FRONTMATTER_BUNDLE_PATH` was not readable. (#1999)",
1486
- "hash": "b0ce855e63a8702415d5516103e01dfef80c250e",
1535
+ "hash": "34467ea7a166dd26f04726e30475843b6d409040",
1487
1536
  "entry": 2
1488
1537
  },
1489
1538
  {
1490
1539
  "description": "Fixes the issue that `pull-from-backlog` offered shelved tickets as candidates and counted them when choosing the Now milestone, which could produce a Now set made up only of shelved work. (#2002)",
1491
- "hash": "c3bb3b27ab5bbc7dbcf1d0f91313ecc047a5fefa",
1540
+ "hash": "b4cdb310877a7e5ce93b9ea381f00ebb474aa252",
1492
1541
  "entry": 2
1493
1542
  },
1494
1543
  {
1495
1544
  "description": "Fixes the issue that `pull-from-backlog` showed a short or empty menu when the Now milestone held fewer eligible tickets than the menu limit, by filling the remaining slots with the highest-ranked eligible tickets from outside Now and marking each one `(outside Now)`. (#2002)",
1496
- "hash": "c3bb3b27ab5bbc7dbcf1d0f91313ecc047a5fefa",
1545
+ "hash": "b4cdb310877a7e5ce93b9ea381f00ebb474aa252",
1497
1546
  "entry": 3
1498
1547
  },
1499
1548
  {
1500
1549
  "description": "Fixes the issue that `entry-drafter` and `title-voice.md` stated their doctrine in figures forbidden by the plain-speech rule, such as \"earns its place\", \"the count is the tell\", and \"a ceiling, not a target\", by replacing each with a literal statement. (#2005)",
1501
- "hash": "c1b6030a22948e69674479503ca393fb97de5830",
1550
+ "hash": "5db7e700d86d2dbfd80d68ddbc2acf6132e2d28d",
1502
1551
  "entry": 1
1503
1552
  },
1504
1553
  {
1505
1554
  "description": "Fixes the issue that `prepare-prototype-brief` stated its instructions as aphorisms and agentless statements, such as \"Settled intent stays settled\", rather than as imperatives that name the action. (#2018)",
1506
- "hash": "019e690e5c166e7b1111ee17ec16ed4abeec6050",
1555
+ "hash": "b155e33c4d8172ef85bc6da39a8b659d4c1335e9",
1507
1556
  "entry": 2
1508
1557
  },
1509
1558
  {
1510
1559
  "description": "Fixes the issue that `entry-drafter` and `summarize-change` stated that the lede reaches the changelog and the release notes, which `release-kit` renders from the change entries without the lede. (#2023)",
1511
- "hash": "fca8841da2a8df7c8d7e983ca0509bc409331265",
1560
+ "hash": "6e18e5867579f706378fda5ab29e070dfef76e5c",
1512
1561
  "entry": 1
1513
1562
  }
1514
1563
  ]
@@ -1519,7 +1568,7 @@
1519
1568
  "items": [
1520
1569
  {
1521
1570
  "description": "Declares `context: fork`, `model: sonnet`, and `background: false` on `create-commit`, so that Claude runs each commit in a fresh Sonnet subagent and waits for it, instead of running every commit step against the invoking session's whole context on the session's model. (#1979)",
1522
- "hash": "80002d52e4026884b6afa9389189476852176e89",
1571
+ "hash": "eb023656b54db313bbf54f4d6ac7bf53355ab1de",
1523
1572
  "entry": 1
1524
1573
  }
1525
1574
  ]
@@ -1531,7 +1580,7 @@
1531
1580
  {
1532
1581
  "description": "Replaces the `create` subcommand of `resolve-review-run.mjs` with `open`, which returns the ticket's active run and creates a `{timestamp}-interactive` run directory only when the ticket directory does not contain one. (#1958)",
1533
1582
  "migration": "Replace `resolve-review-run.mjs create` with `resolve-review-run.mjs open`, which takes the same `--ticket-dir` and `--timestamp` flags but returns an existing `interactive` run instead of always creating a new one.",
1534
- "hash": "d28c6d23c0c99f7d712cab45dd12c3e0863cd5ff",
1583
+ "hash": "0ad52e2b8837124d532f73a0ca13cfcbfd58b230",
1535
1584
  "entry": 3
1536
1585
  }
1537
1586
  ]
@@ -1542,17 +1591,17 @@
1542
1591
  "items": [
1543
1592
  {
1544
1593
  "description": "Moves review run-directory creation and lookup from the `review-branch` and `respond-to-review` instructions into the `resolve-review-run` helper so that every run follows one procedure, which selects the newest run and review by the timestamps in their names. (#1953)",
1545
- "hash": "15d739ea9cfdf35003477ce764373c60adbabe2f",
1594
+ "hash": "d4dd563863309aa4911eb7c9ed130cebc62ea75e",
1546
1595
  "entry": 1
1547
1596
  },
1548
1597
  {
1549
1598
  "description": "Replaces the inline `ENOENT` checks in `run-core`'s `resolve-base-dir.ts` and in `read-dir-entries.ts` and `list-markdown-files.ts` under `packages/guidance/content/test-utils/` with each package's existing `isEnoent`, and removes the private copy of the guard from the test utilities. (#2004)",
1550
- "hash": "14fc1b8c3c1c54968967880cc1021f1541daf597",
1599
+ "hash": "578985cb1f4c1a15fd79f93292337e1452d47757",
1551
1600
  "entry": 1
1552
1601
  },
1553
1602
  {
1554
1603
  "description": "Moves `describe-change`, `capture-lede-decision`, and the work-types reader onto `@williamthorsen/change-grammar` and deletes the local engine in `packages/guidance/src/change-grammar/`, together with its release-kit parity test and its ESLint boundary rules. (#2007)",
1555
- "hash": "29fa77bfa44d0444b150669cb58b921a99567f8c",
1604
+ "hash": "58ca1df779c9d211ced1dd138064d5fc1ed994a1",
1556
1605
  "entry": 1
1557
1606
  }
1558
1607
  ]
@@ -1563,7 +1612,7 @@
1563
1612
  "items": [
1564
1613
  {
1565
1614
  "description": "Replaces the hand-rolled `process.stderr` spies and the console output rebuilt from spy call records in the repo's tests with `captureStdio` from `@williamthorsen/toolbelt.testing`, which restores the stream when the test scope exits and buffers console output into `stdout` and `stderr`. (#2003)",
1566
- "hash": "8b207257e1c1fbaed9467677ee84dc04717c01cd",
1615
+ "hash": "041951d8b843fc8c28e906c5ed51278a31cb6d31",
1567
1616
  "entry": 1
1568
1617
  }
1569
1618
  ]
@@ -1574,7 +1623,7 @@
1574
1623
  "items": [
1575
1624
  {
1576
1625
  "description": "Makes the `guidance` build generate `content/skills/_data/work-types.json` from the package's `CANONICAL_TAXONOMY`, and makes `check:content` fail when the committed copy differs from the generated one. (#2007)",
1577
- "hash": "29fa77bfa44d0444b150669cb58b921a99567f8c",
1626
+ "hash": "58ca1df779c9d211ced1dd138064d5fc1ed994a1",
1578
1627
  "entry": 2
1579
1628
  }
1580
1629
  ]
@@ -1585,7 +1634,7 @@
1585
1634
  "items": [
1586
1635
  {
1587
1636
  "description": "Adds a \"Model declarations\" section to the `codeassembly-repo-conventions` rulebook, which permits a skill to declare `model` only together with `context: fork` and limits every declared model to a Claude Code alias or a full `claude-` model ID, and adds `model-declarations.unit.test.ts`, which fails on a declaration that breaks either rule. (#1996)",
1588
- "hash": "e24422a9eeab2e4afd5c390cc3558d4b748bb3d6",
1637
+ "hash": "41674cb076f55a46dc970204a9b5dfc785ebd387",
1589
1638
  "entry": 3
1590
1639
  }
1591
1640
  ]
@@ -1596,12 +1645,12 @@
1596
1645
  "items": [
1597
1646
  {
1598
1647
  "description": "Adds `docs/schemas.md` to `codeassembly-guidance`, which lists the published schemas with their import paths and states which schema changes bump a schema's major version. (#2000)",
1599
- "hash": "7ed2a6916631341810cf8e262c32b3a6ebc606fc",
1648
+ "hash": "f378066ebaafd5722ee6a908c6172e4694c76343",
1600
1649
  "entry": 4
1601
1650
  },
1602
1651
  {
1603
1652
  "description": "Changes the example template in `packages/guidance/docs/preferences.md` to the nested `[[{scope}|]{type}: ]` form, so that the example output for a change without a scope keeps the type. (#2006)",
1604
- "hash": "5d4522db61b236028f1964c2e65581ca675bf1a6",
1653
+ "hash": "1e73ea6a9823247aa4d91b60fd8f22d09895a3ad",
1605
1654
  "entry": 2
1606
1655
  }
1607
1656
  ]