codeassembly-guidance 0.5.0 โ†’ 0.7.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.
Files changed (110) hide show
  1. package/.meta/changelog.json +491 -0
  2. package/CHANGELOG.md +118 -0
  3. package/README.md +33 -4
  4. package/content/_partials/finding-grades.md +4 -0
  5. package/content/_partials/kb-unsearched-private-stores.md +6 -0
  6. package/content/codeassembly-content.yaml +4 -0
  7. package/content/collections/recommended.md +5 -2
  8. package/content/guidance/_harnesses/rovo/AGENTS.md +0 -1
  9. package/content/guidance/rulebooks/accessibility-conventions.md +26 -6
  10. package/content/guidance/rulebooks/cli-conventions.md +17 -2
  11. package/content/guidance/rulebooks/codeassembly-content-specification.md +11 -11
  12. package/content/guidance/rulebooks/live-worktree-policy.md +2 -2
  13. package/content/guidance/rulebooks/machine-readable-output-conventions.md +85 -0
  14. package/content/guidance/rulebooks/ui-copy-conventions.md +2 -2
  15. package/content/guidance/rulebooks/williamthorsen-collaboration-preferences.md +10 -10
  16. package/content/guidance/rulebooks/williamthorsen-ticketing-preferences.md +3 -1
  17. package/content/guidance/rulebooks/williamthorsen-typescript-preferences.md +7 -3
  18. package/content/guidance/rulebooks/williamthorsen-workflow-preferences.md +3 -1
  19. package/content/guidance/rulebooks/williamthorsen-writing-preferences.md +5 -5
  20. package/content/guidance/shared/AGENTS.md +1 -1
  21. package/content/scripts/check-prose.mjs +1 -1
  22. package/content/scripts/describe-change.mjs +88 -88
  23. package/content/scripts/manage-jira-ticket.mjs +113 -113
  24. package/content/scripts/select-lede-exemplars.mjs +85 -85
  25. package/content/scripts/validate-preferences.mjs +38 -38
  26. package/content/skills/_data/action-items.md +2 -2
  27. package/content/skills/_data/artifact-conventions.md +20 -10
  28. package/content/skills/_data/concision.md +1 -1
  29. package/content/skills/_data/entry-points.md +37 -0
  30. package/content/skills/_data/project-stage.md +9 -5
  31. package/content/skills/_data/recommendation-gradient.md +6 -6
  32. package/content/skills/_data/spike-conventions.md +20 -7
  33. package/content/skills/_data/ticket-source-resolution.md +21 -4
  34. package/content/skills/_data/title-templates.md +4 -4
  35. package/content/skills/_partials/commit-title-rendering.md +2 -1
  36. package/content/skills/_partials/implementation-order-list.md +27 -0
  37. package/content/skills/_partials/next-steps-after-plan.md +6 -5
  38. package/content/skills/_partials/option-format.md +8 -8
  39. package/content/skills/_partials/plan-template.md +5 -1
  40. package/content/skills/_partials/resolve-plan-and-ticket.md +22 -0
  41. package/content/skills/_partials/split-launch-prompts.md +2 -2
  42. package/content/skills/_partials/ticket-criteria-conventions.md +2 -0
  43. package/content/skills/align-ticket-with-implementation/SKILL.md +1 -1
  44. package/content/skills/analyze-performance/SKILL.md +102 -0
  45. package/content/skills/analyze-performance/analyze-performance.mjs +70 -0
  46. package/content/skills/assess-code-health/SKILL.md +16 -14
  47. package/content/skills/assess-code-health/assess-code-health.mjs +29 -28
  48. package/content/skills/assess-usability/SKILL.md +5 -3
  49. package/content/skills/capture-event/SKILL.md +20 -11
  50. package/content/skills/capture-event/capture-event.mjs +122 -122
  51. package/content/skills/capture-feedback/SKILL.md +2 -1
  52. package/content/skills/capture-lede-decision/capture-lede-decision.mjs +97 -97
  53. package/content/skills/convert-agent-prompt/SKILL.md +60 -0
  54. package/content/skills/create-commit/SKILL.md +10 -5
  55. package/content/skills/create-pr/SKILL.md +11 -11
  56. package/content/skills/create-ticket/SKILL.md +1 -0
  57. package/content/skills/create-ticket/resolve-ticket-target.mjs +92 -92
  58. package/content/skills/curate-feedback/curate-feedback.mjs +82 -82
  59. package/content/skills/derive-session-context/derive-session-context.mjs +107 -107
  60. package/content/skills/design-and-plan/SKILL.md +6 -4
  61. package/content/skills/implement-plan/SKILL.md +4 -29
  62. package/content/skills/implementation-order/implementation-order.mjs +67 -0
  63. package/content/skills/index-prototypes/SKILL.md +36 -17
  64. package/content/skills/index-prototypes/index-prototypes.mjs +14 -14
  65. package/content/skills/investigate-spike/SKILL.md +48 -0
  66. package/content/skills/kb-add/SKILL.md +12 -3
  67. package/content/skills/kb-add/kb-add.mjs +88 -88
  68. package/content/skills/kb-curate/kb-curate.mjs +88 -88
  69. package/content/skills/kb-edit/kb-edit.mjs +90 -90
  70. package/content/skills/kb-retrieve/SKILL.md +8 -3
  71. package/content/skills/kb-retrieve/kb-retrieve.mjs +104 -104
  72. package/content/skills/kb-retrieve-events/SKILL.md +8 -3
  73. package/content/skills/kb-retrieve-events/kb-retrieve-events.mjs +113 -113
  74. package/content/skills/kb-update-events/kb-update-events.mjs +92 -92
  75. package/content/skills/lesson-clusters/lesson-clusters.mjs +102 -102
  76. package/content/skills/list-implementation-order/SKILL.md +23 -0
  77. package/content/skills/merge-bb-pr/SKILL.md +31 -8
  78. package/content/skills/merge-gh-pr/SKILL.md +25 -12
  79. package/content/skills/merge-gh-pr/merge-gh-pr.mjs +13 -8
  80. package/content/skills/merge-pr/SKILL.md +55 -20
  81. package/content/skills/migrate-feedback-memories/SKILL.md +1 -0
  82. package/content/skills/plan/SKILL.md +3 -1
  83. package/content/skills/prepare-prototype-brief/SKILL.md +20 -14
  84. package/content/skills/refine-plan/SKILL.md +9 -4
  85. package/content/skills/refine-prototype/SKILL.md +5 -5
  86. package/content/skills/review-branch/SKILL.md +8 -8
  87. package/content/skills/review-criteria/SKILL.md +4 -4
  88. package/content/skills/review-gh-pr/SKILL.md +1 -1
  89. package/content/skills/revise-prose/SKILL.md +9 -8
  90. package/content/skills/revise-prose/revise-prose.mjs +111 -111
  91. package/content/skills/save-plan/SKILL.md +2 -0
  92. package/content/skills/start-ticket/SKILL.md +27 -0
  93. package/content/skills/streamline-guidance/streamline-guidance.mjs +76 -76
  94. package/content/skills/summarize-change/SKILL.md +27 -9
  95. package/content/skills/testing-conventions/SKILL.md +14 -3
  96. package/content/skills/triage-feedback/SKILL.md +4 -0
  97. package/content/skills/triage-spike-findings/SKILL.md +36 -12
  98. package/content/skills/typescript-testing-conventions/SKILL.md +40 -0
  99. package/content/skills/wrap-up/SKILL.md +4 -0
  100. package/content/subagents/_data/claude.yaml +3 -0
  101. package/content/subagents/code-health-assessor.md +4 -4
  102. package/content/subagents/disposition-challenger.md +3 -4
  103. package/content/subagents/entry-drafter.md +2 -2
  104. package/content/subagents/handoff-reviewer.md +1 -1
  105. package/content/subagents/prototype-builder.md +69 -0
  106. package/content/subagents/usability-assessor.md +1 -1
  107. package/package.json +11 -10
  108. package/schemas/preferences.v1.json +74 -8
  109. package/schemas/work-types.v1.json +1 -1
  110. package/content/guidance/_harnesses/rovo/codeassembly-guidance.md +0 -4
@@ -1,4 +1,495 @@
1
1
  [
2
+ {
3
+ "version": "0.7.0",
4
+ "date": "2026-11-14",
5
+ "sections": [
6
+ {
7
+ "title": "๐ŸŽ‰ Features",
8
+ "audience": "all",
9
+ "items": [
10
+ {
11
+ "description": "Makes `prepare-prototype-brief` post the approved brief on the ticket as a comment without asking a second time, with a summary line that names the lenses and the brief artifact and the full brief in a collapsed `<details>` block, and skips the post when an earlier run already posted it. (#145)",
12
+ "hash": "9eb2448bac820d79aadbfa4e850aef84400bd73f",
13
+ "entry": 1
14
+ },
15
+ {
16
+ "description": "Adds the `merge.approval` preference, whose value `auto` makes `merge-pr` merge without its approval gate when the pull request is on GitHub and not breaking, its merge state is `CLEAN` or `HAS_HOOKS`, and the run neither reports a notice nor makes a decision of its own. (#147)",
17
+ "hash": "0b28b368b2a11bbc2f74ad338440e0591a3d19c8",
18
+ "entry": 1
19
+ },
20
+ {
21
+ "description": "Adds the `--confirm` option to `merge-pr`, which shows the approval gate for one run when `merge.approval` is `auto`. (#147)",
22
+ "hash": "0b28b368b2a11bbc2f74ad338440e0591a3d19c8",
23
+ "entry": 2
24
+ },
25
+ {
26
+ "description": "Adds the `project.stages` key to `.agents/preferences.yaml`, which declares the maturity, sensitivity, or audience of one subdirectory, and which `derive-session-context` reports as `project_stages` with each inherited value filled in, so that `plan` and `design-and-plan` apply the stage of the subdirectory that contains the work. (#150)",
27
+ "hash": "9a10fc06593714a8a62003fbe86c9026962b07bc",
28
+ "entry": 1
29
+ },
30
+ {
31
+ "description": "Adds `exploration` as a `project.maturity` value, below `hobby`, for work whose output is still taking shape and that nothing depends on yet. (#150)",
32
+ "hash": "9a10fc06593714a8a62003fbe86c9026962b07bc",
33
+ "entry": 2
34
+ },
35
+ {
36
+ "description": "Directs `plan` and `design-and-plan` to verify unsettled output, such as output at the `exploration` maturity or from a prototype, through a round in which the developer reads it on real inputs, and to plan golden references, answer keys, and evals only as tasks that follow the developer's approval of an output. (#150)",
37
+ "hash": "9a10fc06593714a8a62003fbe86c9026962b07bc",
38
+ "entry": 3
39
+ },
40
+ {
41
+ "description": "Adds an optional `## Notes for reviewers` section to the change summary written by `summarize-change`, along with a reader test that each line of that section, `## Why`, and `## How to test` must pass by changing what a reviewer who hasn't read the ticket checks or decides. (#151)",
42
+ "hash": "b9c0250bd7f77e68327503aa0e38d2097bb8ee19",
43
+ "entry": 1
44
+ },
45
+ {
46
+ "description": "Directs `create-pr` to include `## Notes for reviewers` in the pull-request body and not to add a section, a note, or a test plan of its own. (#151)",
47
+ "hash": "b9c0250bd7f77e68327503aa0e38d2097bb8ee19",
48
+ "entry": 2
49
+ },
50
+ {
51
+ "description": "Narrows the instruction in the shared `AGENTS.md`, `align-ticket-with-implementation`, and `review-branch` that had an agent report every divergence from the ticket's proposal in the pull-request description: It now names `## Notes for reviewers` and applies only to a divergence that changes what a reviewer checks. (#151)",
52
+ "hash": "b9c0250bd7f77e68327503aa0e38d2097bb8ee19",
53
+ "entry": 3
54
+ },
55
+ {
56
+ "description": "Replaces the key-value completion lines at the end of `merge-pr`, `merge-gh-pr`, and `merge-bb-pr` replies with an outcome summary under a heading that states whether the PR was merged. (#158)",
57
+ "hash": "dc266c99aabac894c44e23f76db8e007842ca01a",
58
+ "entry": 1
59
+ },
60
+ {
61
+ "description": "Adds a `summary` field to the JSON that `merge-gh-pr.mjs` prints after a confirmed merge, and changes the script to print a JSON object containing only `summary` on stdout when the merge is refused, fails, or cannot be confirmed. (#158)",
62
+ "hash": "dc266c99aabac894c44e23f76db8e007842ca01a",
63
+ "entry": 2
64
+ },
65
+ {
66
+ "description": "Adds the ticket's close to the closing-post offer that ends a spike, so that one consent from the developer posts the conclusion and closes the ticket as completed, and a rerun skips whichever of the two writes is already done. (#159)",
67
+ "hash": "5a6a9d5abde6d88e133edbc192d9517adff57fca",
68
+ "entry": 1
69
+ },
70
+ {
71
+ "description": "Makes `merge-pr` take its merge strategy and branch deletion from the `merge.strategy` (`squash`, `merge`, or `rebase`) and `merge.deletion_strategy` (`both`, `remote`, or `none`) preferences, which `derive-session-context` reports as `merge_strategy` and `merge_deletion_strategy` and which the `--strategy` and `--delete` flags override for one run. (#160)",
72
+ "hash": "9558074a0a732ee1a1fb9da2055d99d260a844fc",
73
+ "entry": 1
74
+ },
75
+ {
76
+ "description": "Makes `derive-session-context` name the preferences file that contains an invalid value when it rejects one, in addition to the key and the accepted values. (#160)",
77
+ "hash": "9558074a0a732ee1a1fb9da2055d99d260a844fc",
78
+ "entry": 2
79
+ },
80
+ {
81
+ "description": "Adds the `list-implementation-order` skill, which prints the conversation's open tickets as a tree in implementation order for a narrow column, with each ticket indented under its blocker, the blockers that the indent does not show, and a line for each change that must be published and upgraded in a consuming repository before a blocked ticket can start. (#163)",
82
+ "hash": "66e04b50774064ffde90d4cacb5953e844db2998",
83
+ "entry": 1
84
+ },
85
+ {
86
+ "description": "Changes the merged summary of `merge-gh-pr` and `merge-bb-pr` to a heading that names the target branch, the strategy, and the short merge commit hash, followed by labelled lines for the commit title, the PR link, and the remote branch deletion, with `merge-gh-pr` reading the commit title from GitHub after the merge and falling back to the submitted title, or to `unavailable`, when the read fails. (#164)",
87
+ "hash": "989582e827c11847401acac06a0cd5922d8e1a2e",
88
+ "entry": 1
89
+ },
90
+ {
91
+ "description": "Changes the refusal summary of `merge-pr`, `merge-gh-pr`, and `merge-bb-pr` to a `## โŒ Not merged` heading followed by `PR:` and `Reason:` lines, and gives the unconfirmed-merge summary of `merge-gh-pr` the same layout under `## โš ๏ธ Merge not confirmed`. (#164)",
92
+ "hash": "989582e827c11847401acac06a0cd5922d8e1a2e",
93
+ "entry": 2
94
+ },
95
+ {
96
+ "description": "Adds the implementation-order list, which shows the order, the blockers, and the publish gates of the tickets, to the output of a split's launch prompts and of the `triage-spike-findings`, `triage-feedback`, and `wrap-up` reports whenever the run creates two or more tickets. (#165)",
97
+ "hash": "13a37aa75d729ac2149179527f3b00eec0f80a4e",
98
+ "entry": 1
99
+ },
100
+ {
101
+ "description": "Adds each `kb.yaml` registry entry that declares `in_default_scope: true` to the default scope of `kb-retrieve` and `kb-retrieve-events`, which previously searched only the discovered `.kb/` and the registry's `default_kb` unless `--all-kbs` was passed. (#172)",
102
+ "hash": "00f754ca492fe002ee2e1209c2b709b6a88c832c",
103
+ "entry": 1
104
+ },
105
+ {
106
+ "description": "Makes `kb-add` refuse a write into a KB whose `visibility` is `shared` with a `shared-kb` error unless the invocation passes the new `--shared` flag, refuse a write with `invalid-config` when the KB's `.kb/config.yaml` is malformed, and report the KB's `visibility` in the `--survey` result. (#173)",
107
+ "hash": "d2e4c808664af6d56deaff05e4b92b628e46b5f5",
108
+ "entry": 1
109
+ },
110
+ {
111
+ "description": "Makes `capture-event` refuse a fresh capture into a store whose `visibility` is `shared` with a `shared-store` error unless the invocation passes the new `--shared` flag, and with `invalid-config` when the store's `.kb/config.yaml` is malformed, while leaving `--amend` exempt. (#173)",
112
+ "hash": "d2e4c808664af6d56deaff05e4b92b628e46b5f5",
113
+ "entry": 2
114
+ },
115
+ {
116
+ "description": "Adds a rule to the `capture-feedback` and `migrate-feedback-memories` skills that permits `--shared` only on a retry after a `shared-store` refusal and only for a record that contains nothing unfit for the store's collaborators, and that leaves any other record uncaptured rather than redirected to another store. (#173)",
117
+ "hash": "d2e4c808664af6d56deaff05e4b92b628e46b5f5",
118
+ "entry": 3
119
+ },
120
+ {
121
+ "description": "Adds `unsearchedPrivateStores` to the output of the `kb-retrieve` and `kb-retrieve-events` helpers, listing each registered store whose visibility is `private` and that the recall did not search, and directs the agent in both skills to report such a recall as partial and to name, for each store, the `--store` or `--all-kbs` flag that would include it, or that its path needs fixing. (#174)",
122
+ "hash": "366eda24a1e21cece6fe71fd8574053e720a4ded",
123
+ "entry": 1
124
+ },
125
+ {
126
+ "description": "Adds a rule to the `williamthorsen-ticketing-preferences` rulebook that limits a ticket to work in one repository and directs that a change needing two or more repositories get one ticket per repository, with the merge order, upstream first, recorded as blocked-by relations. (#179)",
127
+ "hash": "76a86b687a1853eeb3004535da128bc6e17e839f",
128
+ "entry": 1
129
+ },
130
+ {
131
+ "description": "Makes `triage-spike-findings`, on a run given a batch, close the follow-up triage ticket as completed without a closing post once it posts the dispositions comment, and lists that close in the run's single confirmation and in its report. (#180)",
132
+ "hash": "13a8dc0a27360593b4f1d5bc0b3fe2cac2158c81",
133
+ "entry": 1
134
+ }
135
+ ]
136
+ },
137
+ {
138
+ "title": "๐Ÿ› Bug fixes",
139
+ "audience": "all",
140
+ "items": [
141
+ {
142
+ "description": "Fixes the issue that the `live-worktree-policy` rulebook's example of the `{path}.live` naming gave `~/repos/projects/codeassembly` paths, when the repository is cloned under `~/repos/oss/`. (#157)",
143
+ "hash": "05a744df3c6188420203c7f3d5df232deade32b4",
144
+ "entry": 1
145
+ },
146
+ {
147
+ "description": "Fixes the issue that `--store` in `kb-retrieve` and `kb-retrieve-events` resolved a name against the user-level `kb.yaml` alone and did not find a store registered only in the project's `kb.yaml`. (#174)",
148
+ "hash": "366eda24a1e21cece6fe71fd8574053e720a4ded",
149
+ "entry": 2
150
+ },
151
+ {
152
+ "description": "Fixes the issue that the Split rule in the `next-steps-after-plan` partial never recommended splitting a small plan that touches two or more repositories, because the rule required every plan to be too large for one implement-and-review pass. (#179)",
153
+ "hash": "76a86b687a1853eeb3004535da128bc6e17e839f",
154
+ "entry": 2
155
+ }
156
+ ]
157
+ },
158
+ {
159
+ "title": "โ™ป๏ธ Refactoring",
160
+ "audience": "dev",
161
+ "items": [
162
+ {
163
+ "description": "Moves the implementation-order helper out of the `list-implementation-order` skill's directory into its own `skills/implementation-order/` directory as `implementation-order.mjs`, so that each skill that prints the implementation-order list runs it from one shared path. (#165)",
164
+ "hash": "13a37aa75d729ac2149179527f3b00eec0f80a4e",
165
+ "entry": 2
166
+ }
167
+ ]
168
+ },
169
+ {
170
+ "title": "๐Ÿงช Tests",
171
+ "audience": "dev",
172
+ "items": [
173
+ {
174
+ "description": "Moves the URL-construction tests from `compose-manifest.unit.test.ts` into a new `compose-manifest.urls.unit.test.ts`, which brings the original file under the 500-line limit set by the `max-lines` rule. (#149)",
175
+ "hash": "2cbdf9075faf803153cf6f5048619ba77ec3cb4a",
176
+ "entry": 1
177
+ },
178
+ {
179
+ "description": "Rewrites the skill-name regex in `entry-points.unit.test.ts` as a `String.raw` template, as the `prefer-string-raw` rule requires, without changing the resulting regex. (#149)",
180
+ "hash": "2cbdf9075faf803153cf6f5048619ba77ec3cb4a",
181
+ "entry": 2
182
+ }
183
+ ]
184
+ }
185
+ ]
186
+ },
187
+ {
188
+ "version": "0.6.0",
189
+ "date": "2026-11-09",
190
+ "sections": [
191
+ {
192
+ "title": "๐ŸŽ‰ Features",
193
+ "audience": "all",
194
+ "items": [
195
+ {
196
+ "description": "Adds the `analyze-performance` skill, which measures each page of a site for mobile and desktop through the PageSpeed Insights API or the Lighthouse CLI, reports field data from real users apart from lab data, and writes a `performance-findings` artifact that ranks improvements by expected effect, with the evidence, the metric, and the effort of each. (#5)",
197
+ "hash": "ebcf89f2442d1f44cc5de53aea0b31fa3efaf54e",
198
+ "entry": 1
199
+ },
200
+ {
201
+ "description": "Lets `triage-spike-findings` take a `performance-findings` artifact as input, so that it can create tickets for the improvements that `analyze-performance` ranks. (#5)",
202
+ "hash": "ebcf89f2442d1f44cc5de53aea0b31fa3efaf54e",
203
+ "entry": 2
204
+ },
205
+ {
206
+ "description": "Adds the `dead-code`, `duplication`, and `dependency-graph` sensors to `assess-code-health`'s `sense` command, which runs knip, jscpd, and dependency-cruiser on every invocation and limits their rows to the unit's tracked, non-excluded files. (#92)",
207
+ "hash": "0ff4ae50d9a9bce4cdac85e7d4f0dc6bdb7c67c3",
208
+ "entry": 1
209
+ },
210
+ {
211
+ "description": "Adds an `importers` count to each hotspot row in the sense document, taken from the dependency graph and null when the graph does not list the file. (#92)",
212
+ "hash": "0ff4ae50d9a9bce4cdac85e7d4f0dc6bdb7c67c3",
213
+ "entry": 2
214
+ },
215
+ {
216
+ "description": "Adds an \"Unexpected crashes\" section to the `cli-conventions` rulebook, which directs a tool to report a crash as `<bin>: internal error: <message>` followed by the stack frames, printed without a debug flag, and to exit 1, so that a reader can tell a bug in the tool from a handled error. (#94)",
217
+ "hash": "8503764bac043917d2556a8fef220a94ee3897f0",
218
+ "entry": 1
219
+ },
220
+ {
221
+ "description": "Adds the `machine-readable-output-conventions` rulebook, delivered as the `consult-machine-readable-output-conventions` skill, which requires a result shown to a person to be available as structured data rendered from the same object and states rules for canonical values, data embedded in a page, redaction of sensitive fields, and a journal of domain events. (#103)",
222
+ "hash": "69e953bbdb62cff9260ef19601300ce8f98310b9",
223
+ "entry": 1
224
+ },
225
+ {
226
+ "description": "Adds `machine-readable-output-conventions` to the `recommended` collection, which deploys it to every project that declares the collection. (#103)",
227
+ "hash": "69e953bbdb62cff9260ef19601300ce8f98310b9",
228
+ "entry": 2
229
+ },
230
+ {
231
+ "description": "Adds a \"Time-driven behavior\" section to the `testing-conventions` skill, which directs a test author to fake the clock and advance it explicitly, to wait on a condition with a deadline when the timer runs in another process, and to run a changed test repeatedly under CPU load before committing it. (#107)",
232
+ "hash": "3fc483b3011481c0dd099991d90f63a7d54b196c",
233
+ "entry": 1
234
+ },
235
+ {
236
+ "description": "Adds a matching \"Time-driven behavior\" section to `typescript-testing-conventions`, which shows a fake-timer Vitest test that moves time with `vi.advanceTimersByTimeAsync` and describes how to run several copies of `vitest run <file> --repeats <n>` at once to put the machine under CPU load. (#107)",
237
+ "hash": "3fc483b3011481c0dd099991d90f63a7d54b196c",
238
+ "entry": 2
239
+ },
240
+ {
241
+ "description": "Adds a \"Findings batches\" section to `spike-conventions.md`, which caps a triage batch at 10 items, gives each batch a ticket of its own, and shapes an assessment of several units as an umbrella with one child per unit, each blocked by the one before it. (#108)",
242
+ "hash": "eeb7aa01958ab2f763d2e9b4efc9a520c8b42310",
243
+ "entry": 1
244
+ },
245
+ {
246
+ "description": "Limits `triage-spike-findings` to one batch per triage ticket and has it create a follow-up triage ticket for each later batch, each blocked by the one before it and linked back to the triage ticket, so that every item still receives a disposition. (#108)",
247
+ "hash": "eeb7aa01958ab2f763d2e9b4efc9a520c8b42310",
248
+ "entry": 2
249
+ },
250
+ {
251
+ "description": "Lowers the default per-lens proposal cap of `assess-code-health` from 10 to 2, so that its five lenses produce at most 10 proposals for one unit. (#108)",
252
+ "hash": "eeb7aa01958ab2f763d2e9b4efc9a520c8b42310",
253
+ "entry": 3
254
+ },
255
+ {
256
+ "description": "Directs `plan`, `design-and-plan`, and `create-ticket` to scope a ticket or task that schedules an assessment or a triage of findings to one batch. (#108)",
257
+ "hash": "eeb7aa01958ab2f763d2e9b4efc9a520c8b42310",
258
+ "entry": 4
259
+ },
260
+ {
261
+ "description": "Changes the grade definitions shared by `triage-spike-findings` and `disposition-challenger` to grade an item from `assess-code-health` by the code that the change leaves, so that the one-time cost of the change no longer lowers the item's confidence or value. (#109)",
262
+ "hash": "0c1125ecd3660586c7341971cb4e1a04ec6a8228",
263
+ "entry": 1
264
+ },
265
+ {
266
+ "description": "Adds a working-directory argument to `create-commit`, which runs every git call, the ticket-ref lookup, and the title rendering against that worktree. (#110)",
267
+ "hash": "8b60780756d5a14cf70049ced34be9a45400a0eb",
268
+ "entry": 2
269
+ },
270
+ {
271
+ "description": "Adds a rule to `williamthorsen-workflow-preferences` that directs a session working in a worktree other than its cwd to pass that worktree to every skill that takes a working directory, or to commit inline with `git -C`. (#110)",
272
+ "hash": "8b60780756d5a14cf70049ced34be9a45400a0eb",
273
+ "entry": 3
274
+ },
275
+ {
276
+ "description": "Adds a \"TypeScript packages\" section to the `machine-readable-output-conventions` rulebook that names `@williamthorsen/readout`, `@williamthorsen/readout-journal`, and `@williamthorsen/readout-react` and the rules that each one implements, and states that the rules remain the contract whether or not an implementation uses them. (#113)",
277
+ "hash": "94412886b892a3a88828a718036fc1dc95dba60e",
278
+ "entry": 1
279
+ },
280
+ {
281
+ "description": "Adds a \"Machine-readable results\" section to the `williamthorsen-typescript-preferences` rulebook that directs an agent to build a result or a journal on the readout packages rather than by hand. (#113)",
282
+ "hash": "94412886b892a3a88828a718036fc1dc95dba60e",
283
+ "entry": 2
284
+ },
285
+ {
286
+ "description": "Adds a `--resweep` flag to `revise-prose`, which dispatches every versioned rule to every file whatever coverage `.agents/revise-prose.yaml` records, while recorded rejections still suppress their sites. (#114)",
287
+ "hash": "3a381d5f95de6d0792d40b995f723922fc52ac43",
288
+ "entry": 1
289
+ },
290
+ {
291
+ "description": "Adds the optional `provenance.parent` field to plan provenance, which `refine-plan` sets on every revised plan to the file name, without its directory, of the plan that it revised. (#117)",
292
+ "hash": "c0feb049f62fc602e2acfab801941ab1408dff14",
293
+ "entry": 1
294
+ },
295
+ {
296
+ "description": "Adds rules to `accessibility-conventions` that have an agent follow the established model that a feature resembles, place a control that opens or closes a region at that region's edge or in a persistent toolbar, and give a toggle a visible on state, an `aria-expanded` or `aria-pressed` attribute, and one label for both states, and adds toggling each toggle to the rulebook's browser check. (#118)",
297
+ "hash": "16d8c010485f374b372390ed149542adf1d11cc6",
298
+ "entry": 1
299
+ },
300
+ {
301
+ "description": "Exempts a toggle from the `ui-copy-conventions` rule that buttons are verbs, since a toggle's label names what it governs and stays the same in both states. (#118)",
302
+ "hash": "16d8c010485f374b372390ed149542adf1d11cc6",
303
+ "entry": 2
304
+ },
305
+ {
306
+ "description": "Has `design-and-plan`, `prepare-prototype-brief`, `refine-prototype`, and the shared plan template apply the new control rules when a design is chosen or a control is added or moved, with any departure from the named model recorded together with its reason. (#118)",
307
+ "hash": "16d8c010485f374b372390ed149542adf1d11cc6",
308
+ "entry": 3
309
+ },
310
+ {
311
+ "description": "Adds a \"Glanceable state\" section to the `accessibility-conventions` rulebook, which requires that a state for which a reader scans a list or table be marked by colour with a second cue, a symbol, grouping, or sort order rather than by text alone, and which states that a restraint on colour never excuses hiding such a state. (#120)",
312
+ "hash": "6d7ecb7fe02aa9c1ca475eb54eaf37c6cf56de8f",
313
+ "entry": 1
314
+ },
315
+ {
316
+ "description": "Adds a rule to `accessibility-conventions` that a button outside a toolbar has a border or fill at rest that meets 3:1 contrast against its surface, and extends the rulebook's browser check to cover this rule and the glanceable-state rule. (#120)",
317
+ "hash": "6d7ecb7fe02aa9c1ca475eb54eaf37c6cf56de8f",
318
+ "entry": 2
319
+ },
320
+ {
321
+ "description": "Names both rules in `prepare-prototype-brief`, `refine-prototype`, and the `usability-assessor` subagent, names the glanceable-state rule in `review-criteria` and the plan template's interface guidance, and adds a criterion to the judging section of every prototype brief that treats a list whose items must each be read to find a scanned state as a defect. (#120)",
322
+ "hash": "6d7ecb7fe02aa9c1ca475eb54eaf37c6cf56de8f",
323
+ "entry": 3
324
+ },
325
+ {
326
+ "description": "Adds the `prototype-builder` subagent, which builds one prototype for one lens of a brief and checks its page in a headless Playwright browser apart from the dispatching session's, and makes `prepare-prototype-brief` and `index-prototypes` dispatch it for each prototype that a subagent builds. (#126)",
327
+ "hash": "d66d565798e91ed3e6db2984022c92a9452165df",
328
+ "entry": 1
329
+ },
330
+ {
331
+ "description": "Adds the `index-prototypes probe-targets --endpoint <url>` command, which closes each page target of a browser's DevTools endpoint that does not answer a probe within 5 seconds, and directs `index-prototypes` to run it when a Playwright call times out and to report each closed page's prototype as defective. (#126)",
332
+ "hash": "d66d565798e91ed3e6db2984022c92a9452165df",
333
+ "entry": 3
334
+ },
335
+ {
336
+ "description": "Makes the brief composed by `prepare-prototype-brief` require every iterative loop in a prototype, such as an animation or a retry, to stop after a fixed number of iterations or a time limit, because a loop that does not end hangs the page's renderer. (#126)",
337
+ "hash": "d66d565798e91ed3e6db2984022c92a9452165df",
338
+ "entry": 4
339
+ },
340
+ {
341
+ "description": "Sets the browser title of the index page to `{set title} - Prototypes` and directs `prototype-builder` and `/refine-prototype` to title each prototype page `{set title} - {id} {title}`, so that a developer judging a round can tell its tabs apart. (#130)",
342
+ "hash": "560c8be1dcc6b9aa0f12c9566eb0388d052aef56",
343
+ "entry": 1
344
+ },
345
+ {
346
+ "description": "Makes the `index-prototypes` helper's `register` command fail with `title-mismatch` when the `--source` page's `<title>` is missing or differs from `{set title} - {id} {title}`, and with `source-not-found` when the source is not a readable file. (#130)",
347
+ "hash": "560c8be1dcc6b9aa0f12c9566eb0388d052aef56",
348
+ "entry": 2
349
+ },
350
+ {
351
+ "description": "Adds the `investigate-spike` skill, which works a spike plan's investigation steps within its timebox, saves the answers and recommendations as a `spike-findings` artifact that `triage-spike-findings` accepts, and offers the closing post on the ticket. (#132)",
352
+ "hash": "5e37d0d5f6007091f076337bf9628d1a12809881",
353
+ "entry": 1
354
+ },
355
+ {
356
+ "description": "Changes the post-plan menu's ๐Ÿ”ฌ Investigate option, which previously left the agent to work a spike plan without a skill, to invoke `investigate-spike` with the plan and the ticket. (#132)",
357
+ "hash": "5e37d0d5f6007091f076337bf9628d1a12809881",
358
+ "entry": 2
359
+ },
360
+ {
361
+ "description": "Adds the `start-ticket` skill, which chooses the skill that opens the work in a ticket's worktree (such as `design-and-plan`, `plan`, `refine-plan`, `implement-plan`, `investigate-spike`, or `triage-spike-findings`) from the ticket's state, its pull request, and its saved artifacts, and then invokes that skill. (#134)",
362
+ "hash": "5068d3fb2d372d13d5a883d5b6fe6c28fd9223b0",
363
+ "entry": 1
364
+ },
365
+ {
366
+ "description": "Changes the launch prompts of a plan-time split to invoke `start-ticket` without arguments instead of naming an entry-point skill chosen at split time, so that the choice reflects the piece's artifacts when its session starts. (#134)",
367
+ "hash": "5068d3fb2d372d13d5a883d5b6fe6c28fd9223b0",
368
+ "entry": 2
369
+ },
370
+ {
371
+ "description": "Adds a `start-ticket` line to the completion output of `create-ticket` to show how to start the new ticket in its worktree, and omits the line for a ticket created in another repository. (#134)",
372
+ "hash": "5068d3fb2d372d13d5a883d5b6fe6c28fd9223b0",
373
+ "entry": 3
374
+ },
375
+ {
376
+ "description": "Adds a `## How to test` section to the change summary, in which `summarize-change` lists the steps that a reviewer follows to exercise a changed page, UI component, or command output by hand, and has `create-pr` include that section in the pull-request body. (#140)",
377
+ "hash": "95b535e732b4c7bd50a69f162be1455af808ad0b",
378
+ "entry": 1
379
+ },
380
+ {
381
+ "description": "Adds the `convert-agent-prompt` skill, which converts an agent's prompt file into an agent-logic file, an XState v5 machine config that an agent-logic viewer renders as a statechart, by running version 0.1.0 of the `codeassembly-agent-logic` package through `pnpm dlx`. (#141)",
382
+ "hash": "6549396c7db0e6f7ba2efe9bce1c997b4872066f",
383
+ "entry": 1
384
+ }
385
+ ]
386
+ },
387
+ {
388
+ "title": "๐Ÿ› Bug fixes",
389
+ "audience": "all",
390
+ "items": [
391
+ {
392
+ "description": "Fixes the issue that `create-commit` wrote the change itself, in the wrong checkout, when the checkout in which it ran did not contain the change, and makes the skill stop without staging and report the directory and its `git status --short` output instead. (#110)",
393
+ "hash": "8b60780756d5a14cf70049ced34be9a45400a0eb",
394
+ "entry": 1
395
+ },
396
+ {
397
+ "description": "Fixes the issue that `resolve-scopes` resolved every path in a root package (`packages: ['.']` in `pnpm-workspace.yaml`) to the checkout directory's name, such as `app` or `app.106`, rather than to `root`, while nested packages keep their own scopes. (#111)",
398
+ "hash": "949cd390c6a84eb0c54219443faa218ce257ed05",
399
+ "entry": 1
400
+ },
401
+ {
402
+ "description": "Fixes the issue that a `project.scopes` entry naming the repository root without a `name` took the checkout directory's name as its scope, by making `resolve-scopes` skip such an entry with a warning and keep reading one that declares a `name`. (#111)",
403
+ "hash": "949cd390c6a84eb0c54219443faa218ce257ed05",
404
+ "entry": 2
405
+ },
406
+ {
407
+ "description": "Fixes the issue that rulebooks and skills such as the collaboration preferences, the writing preferences, the content specification, `review-branch`, and `action-items.md` still contained cleft constructions, figurative verbs, and overused words forbidden by the plain-speech rule, and bumps the three rulebooks to versions 17, 12, and 33 without changing what they direct. (#114)",
408
+ "hash": "3a381d5f95de6d0792d40b995f723922fc52ac43",
409
+ "entry": 2
410
+ },
411
+ {
412
+ "description": "Fixes the issue that skills and subagents that resolved a ticket read its body and skipped its comments, on GitHub, on Jira, and for a ticket artifact whose frontmatter names a `ticket_ref`. (#121)",
413
+ "hash": "3d2438ea27a1e00e36a4a15d7fbea250db9f98f2",
414
+ "entry": 1
415
+ },
416
+ {
417
+ "description": "Fixes the issue that `prepare-prototype-brief` dispatched every builder at once, so that one page that hung its renderer stalled the browser calls of every builder; the skill now dispatches builders one at a time and stops a builder that has not replied 30 minutes after its dispatch. (#126)",
418
+ "hash": "d66d565798e91ed3e6db2984022c92a9452165df",
419
+ "entry": 2
420
+ },
421
+ {
422
+ "description": "Fixes the issue that `assess-code-health` dropped each proposal whose change creates a file, by limiting `paths` in `code-health-assessor` to files that exist at assessment time and directing the assessor to name a created file in `change`. (#131)",
423
+ "hash": "057967a61ca0b1cd25fd1e39ae7a02082ab5184f",
424
+ "entry": 1
425
+ },
426
+ {
427
+ "description": "Fixes the issue that `assess-code-health`, `assess-usability`, and `investigate-spike` offered a spike's closing post before the `triage-spike-findings` round, when the post could not yet answer the ticket's decisions to enable. (#133)",
428
+ "hash": "8e77b7c4de59a0010fe8991d930fde247eb6ba62",
429
+ "entry": 1
430
+ },
431
+ {
432
+ "description": "Fixes the issue that `triage-spike-findings` never offered the closing post, although its round ends the spike when the findings leave items to triage. (#133)",
433
+ "hash": "8e77b7c4de59a0010fe8991d930fde247eb6ba62",
434
+ "entry": 2
435
+ },
436
+ {
437
+ "description": "Fixes the issue that the Rovo harness's `AGENTS.md` included a personal interaction preference, which forbade `ask_user_questions`, in the guidance that every Rovo user received. (#136)",
438
+ "hash": "a2d9af1de691ec1acff5c5f05a8d7b9e59c814b5",
439
+ "entry": 1
440
+ },
441
+ {
442
+ "description": "Fixes the issue that the rule against interactive selectors in `williamthorsen-collaboration-preferences` did not name the tools that present those selectors, by naming Claude Code's `AskUserQuestion` and Rovo's `ask_user_questions`. (#136)",
443
+ "hash": "a2d9af1de691ec1acff5c5f05a8d7b9e59c814b5",
444
+ "entry": 2
445
+ },
446
+ {
447
+ "description": "Fixes the issue that `assess-code-health.mjs sense` reported a `dead-code` unused-dependency row for a `package.json` matched by an `--exclude` glob, although every other sensor drops the paths that an `--exclude` glob matches. (#138)",
448
+ "hash": "9500a54327a69f09be08525c1f3e5709ce99c73d",
449
+ "entry": 1
450
+ }
451
+ ]
452
+ },
453
+ {
454
+ "title": "โ™ป๏ธ Refactoring",
455
+ "audience": "dev",
456
+ "items": [
457
+ {
458
+ "description": "Moves the CrUX field-data logic of the `analyze-performance` helper (`collectField` and the CrUX API queries that it makes) from `collect.ts` into a new `field.ts` module, which brings `collect.ts` under the 300-line `max-lines` limit. (#91)",
459
+ "hash": "c8da606ebe9e908d5f54f119b4d06f391d21d1a3",
460
+ "entry": 1
461
+ }
462
+ ]
463
+ },
464
+ {
465
+ "title": "๐Ÿงช Tests",
466
+ "audience": "dev",
467
+ "items": [
468
+ {
469
+ "description": "Adds the `makeScratchDir` test helper and replaces the direct `mkdtemp` calls and hand-written teardown in the tests of `packages/guidance` and in the repo-root `codeassembly-sync-live` test with it or with `createTempTree` and `disposeOnTestFinished`, which remove each scratch directory when its test finishes, failure included. (#123)",
470
+ "hash": "c6ab9113eded09aea72ce8affad9e26e090d2d88",
471
+ "entry": 1
472
+ },
473
+ {
474
+ "description": "Makes the smoke-test runner in `scripts/__tests__/smoke-test-skill-helpers.ts` remove the fixture directories that its builders create through the new `makeSmokeScratchDir`, whether the smoke tests pass, fail, or a builder throws. (#123)",
475
+ "hash": "c6ab9113eded09aea72ce8affad9e26e090d2d88",
476
+ "entry": 2
477
+ }
478
+ ]
479
+ },
480
+ {
481
+ "title": "๐Ÿ“ฆ Dependencies",
482
+ "audience": "dev",
483
+ "items": [
484
+ {
485
+ "description": "Upgrade eslint-config-typescript to 20.2.0 (#98)",
486
+ "body": "Upgrades `@williamthorsen/eslint-config-typescript` from 20.1.3 to 20.2.0, which updates `eslint-plugin-unicorn` from 78 to 79, and edits the guidance package's sources and tests to pass the two rules that now report code accepted by 20.1.3: `unicorn/numeric-separators-style`, which no longer allows a separator in a number of fewer than 5 digits, and `unicorn/prefer-smaller-scope`.",
487
+ "hash": "24084122b518b38df84c7f063d49193b66669efc"
488
+ }
489
+ ]
490
+ }
491
+ ]
492
+ },
2
493
  {
3
494
  "version": "0.5.0",
4
495
  "date": "2026-11-02",