codeassembly-guidance 0.0.0 โ†’ 0.1.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 (204) hide show
  1. package/.meta/changelog.json +563 -0
  2. package/CHANGELOG.md +134 -0
  3. package/LICENSE +7 -0
  4. package/README.md +165 -1
  5. package/content/_partials/README.md +192 -0
  6. package/content/_partials/code-descriptions.md +4 -0
  7. package/content/_partials/code-style.md +7 -0
  8. package/content/_partials/comment-discipline.md +89 -0
  9. package/content/_partials/concision.md +3 -0
  10. package/content/_partials/diff-audit-checklist.md +9 -0
  11. package/content/_partials/file-access.md +4 -0
  12. package/content/_partials/live-repo-writes.md +13 -0
  13. package/content/_partials/plain-speech-calibration.md +66 -0
  14. package/content/_partials/plain-speech.md +13 -0
  15. package/content/_partials/prose-line-breaks.md +3 -0
  16. package/content/_partials/record-marker.md +1 -0
  17. package/content/_partials/reduced-object-relative.md +28 -0
  18. package/content/_partials/shell-commands.md +3 -0
  19. package/content/_partials/target-file-set-resolution.md +22 -0
  20. package/content/_partials/technical-recommendations.md +5 -0
  21. package/content/_partials/test-structure-audit-checklist.md +7 -0
  22. package/content/_partials/ticket-assessment-baseline.md +12 -0
  23. package/content/_partials/ticket-assessment.md +202 -0
  24. package/content/_partials/work-type-choice.md +13 -0
  25. package/content/codeassembly-content.yaml +49 -0
  26. package/content/collections/all.md +11 -0
  27. package/content/collections/atlassian.md +16 -0
  28. package/content/collections/recommended.md +34 -0
  29. package/content/collections/triage.md +77 -0
  30. package/content/collections/williamthorsen.md +25 -0
  31. package/content/guidance/README.md +22 -0
  32. package/content/guidance/_harnesses/claude/CLAUDE.md +6 -0
  33. package/content/guidance/_harnesses/rovo/AGENTS.md +5 -0
  34. package/content/guidance/_harnesses/rovo/codeassembly-guidance.md +4 -0
  35. package/content/guidance/rulebooks/accessibility-conventions.md +20 -0
  36. package/content/guidance/rulebooks/codeassembly-content-specification.md +161 -0
  37. package/content/guidance/rulebooks/command-output-conventions.md +14 -0
  38. package/content/guidance/rulebooks/commit-conventions.md +72 -0
  39. package/content/guidance/rulebooks/generated-content-policy.md +10 -0
  40. package/content/guidance/rulebooks/live-worktree-policy.md +18 -0
  41. package/content/guidance/rulebooks/readme-conventions.md +74 -0
  42. package/content/guidance/rulebooks/shared-data-conventions.md +14 -0
  43. package/content/guidance/rulebooks/shell-conventions.md +279 -0
  44. package/content/guidance/rulebooks/williamthorsen-code-layout-preferences.md +102 -0
  45. package/content/guidance/rulebooks/williamthorsen-collaboration-preferences.md +58 -0
  46. package/content/guidance/rulebooks/williamthorsen-comment-preferences.md +30 -0
  47. package/content/guidance/rulebooks/williamthorsen-subagent-model-preferences.md +15 -0
  48. package/content/guidance/rulebooks/williamthorsen-ticketing-preferences.md +22 -0
  49. package/content/guidance/rulebooks/williamthorsen-tooling-preferences.md +36 -0
  50. package/content/guidance/rulebooks/williamthorsen-typescript-preferences.md +90 -0
  51. package/content/guidance/rulebooks/williamthorsen-workflow-preferences.md +58 -0
  52. package/content/guidance/rulebooks/williamthorsen-writing-preferences.md +80 -0
  53. package/content/guidance/shared/AGENTS.md +43 -0
  54. package/content/scripts/README.md +41 -0
  55. package/content/scripts/describe-change.mjs +165 -0
  56. package/content/scripts/get-ticket-id.sh +131 -0
  57. package/content/scripts/manage-jira-ticket.mjs +209 -0
  58. package/content/scripts/resolve-frontmatter.sh +540 -0
  59. package/content/scripts/resolve-review-run.mjs +12 -0
  60. package/content/scripts/select-lede-exemplars.mjs +208 -0
  61. package/content/skills/_data/action-items.md +83 -0
  62. package/content/skills/_data/artifact-conventions.md +969 -0
  63. package/content/skills/_data/bitbucket-pr-access.md +89 -0
  64. package/content/skills/_data/branch-format.md +34 -0
  65. package/content/skills/_data/change-record.md +163 -0
  66. package/content/skills/_data/complexity-classification.md +58 -0
  67. package/content/skills/_data/concision.md +23 -0
  68. package/content/skills/_data/deployed-file-provenance.md +46 -0
  69. package/content/skills/_data/design-priorities.md +76 -0
  70. package/content/skills/_data/gh-body-file.md +30 -0
  71. package/content/skills/_data/git-commands.md +39 -0
  72. package/content/skills/_data/naming-conventions.md +50 -0
  73. package/content/skills/_data/pr-resolution.md +25 -0
  74. package/content/skills/_data/pr-source-resolution.md +36 -0
  75. package/content/skills/_data/recommendation-gradient.md +90 -0
  76. package/content/skills/_data/scope-and-deferral.md +83 -0
  77. package/content/skills/_data/spike-conventions.md +89 -0
  78. package/content/skills/_data/ticket-evaluation.md +13 -0
  79. package/content/skills/_data/ticket-id-extraction.md +43 -0
  80. package/content/skills/_data/ticket-source-resolution.md +147 -0
  81. package/content/skills/_data/title-templates.md +624 -0
  82. package/content/skills/_data/title-voice.md +17 -0
  83. package/content/skills/_data/work-types.json +168 -0
  84. package/content/skills/_partials/acceptance-criteria-scaffold.md +15 -0
  85. package/content/skills/_partials/action-items.md +22 -0
  86. package/content/skills/_partials/bitbucket-delete-both-refusal.md +3 -0
  87. package/content/skills/_partials/commit-title-rendering.md +14 -0
  88. package/content/skills/_partials/gh-body-file.md +22 -0
  89. package/content/skills/_partials/nested-list-indent.md +9 -0
  90. package/content/skills/_partials/next-steps-after-plan.md +99 -0
  91. package/content/skills/_partials/next-steps-after-review.md +350 -0
  92. package/content/skills/_partials/option-format.md +84 -0
  93. package/content/skills/_partials/plan-template.md +97 -0
  94. package/content/skills/_partials/split-launch-prompts.md +5 -0
  95. package/content/skills/_partials/split-ticket-compose.md +5 -0
  96. package/content/skills/_partials/split-ticket-create.md +3 -0
  97. package/content/skills/_partials/ticket-and-plan-completeness.md +33 -0
  98. package/content/skills/_partials/ticket-concision.md +18 -0
  99. package/content/skills/_partials/ticket-criteria-conventions.md +7 -0
  100. package/content/skills/_partials/ticket-placement.md +14 -0
  101. package/content/skills/_partials/ticket-skeleton-tiers.md +6 -0
  102. package/content/skills/_partials/ticket-skeleton.md +13 -0
  103. package/content/skills/add-change-record/SKILL.md +136 -0
  104. package/content/skills/add-test-ids/SKILL.md +51 -0
  105. package/content/skills/align-ticket-with-implementation/SKILL.md +115 -0
  106. package/content/skills/anti-patterns/SKILL.md +57 -0
  107. package/content/skills/assess-ticket/SKILL.md +46 -0
  108. package/content/skills/assess-ticket/next-steps-after-assessment.md +98 -0
  109. package/content/skills/brainstorming/SKILL.md +107 -0
  110. package/content/skills/capture-event/SKILL.md +108 -0
  111. package/content/skills/capture-event/capture-event.mjs +216 -0
  112. package/content/skills/capture-feedback/SKILL.md +71 -0
  113. package/content/skills/capture-lede-decision/SKILL.md +163 -0
  114. package/content/skills/capture-lede-decision/capture-lede-decision.mjs +231 -0
  115. package/content/skills/classify-complexity/SKILL.md +92 -0
  116. package/content/skills/collaborate/SKILL.md +86 -0
  117. package/content/skills/condense-branch/SKILL.md +83 -0
  118. package/content/skills/create-bitbucket-pr/SKILL.md +87 -0
  119. package/content/skills/create-commit/SKILL.md +65 -0
  120. package/content/skills/create-devlog/SKILL.md +108 -0
  121. package/content/skills/create-gh-pr/SKILL.md +106 -0
  122. package/content/skills/create-pr/SKILL.md +150 -0
  123. package/content/skills/create-ticket/SKILL.md +350 -0
  124. package/content/skills/derive-session-context/derive-session-context.mjs +148 -0
  125. package/content/skills/design-and-plan/SKILL.md +194 -0
  126. package/content/skills/development-workflows/SKILL.md +41 -0
  127. package/content/skills/get-ticket-id/SKILL.md +67 -0
  128. package/content/skills/groom-backlog/SKILL.md +245 -0
  129. package/content/skills/groom-backlog/groom-backlog.mjs +106 -0
  130. package/content/skills/implement-plan/SKILL.md +164 -0
  131. package/content/skills/index-prototypes/SKILL.md +145 -0
  132. package/content/skills/index-prototypes/index-prototypes.mjs +328 -0
  133. package/content/skills/kb-add/SKILL.md +156 -0
  134. package/content/skills/kb-add/kb-add.mjs +216 -0
  135. package/content/skills/kb-curate/SKILL.md +117 -0
  136. package/content/skills/kb-curate/kb-curate.mjs +213 -0
  137. package/content/skills/kb-edit/SKILL.md +128 -0
  138. package/content/skills/kb-edit/kb-edit.mjs +219 -0
  139. package/content/skills/kb-retrieve/SKILL.md +100 -0
  140. package/content/skills/kb-retrieve/kb-retrieve.mjs +206 -0
  141. package/content/skills/kb-retrieve-events/SKILL.md +98 -0
  142. package/content/skills/kb-retrieve-events/kb-retrieve-events.mjs +206 -0
  143. package/content/skills/kb-update-events/SKILL.md +77 -0
  144. package/content/skills/kb-update-events/kb-update-events.mjs +215 -0
  145. package/content/skills/merge-bb-pr/SKILL.md +136 -0
  146. package/content/skills/merge-gh-pr/SKILL.md +167 -0
  147. package/content/skills/merge-gh-pr/merge-gh-pr.mjs +10 -0
  148. package/content/skills/merge-pr/SKILL.md +368 -0
  149. package/content/skills/migrate-feedback-memories/SKILL.md +136 -0
  150. package/content/skills/migrate-feedback-memories/feedback-memories.mjs +161 -0
  151. package/content/skills/people-report/SKILL.md +208 -0
  152. package/content/skills/plan/SKILL.md +87 -0
  153. package/content/skills/prepare-prototype-brief/SKILL.md +126 -0
  154. package/content/skills/pull-from-backlog/SKILL.md +83 -0
  155. package/content/skills/pull-from-backlog/pull-from-backlog.mjs +208 -0
  156. package/content/skills/refine-plan/SKILL.md +259 -0
  157. package/content/skills/respond-to-review/SKILL.md +292 -0
  158. package/content/skills/review-bb-pr/SKILL.md +161 -0
  159. package/content/skills/review-branch/SKILL.md +301 -0
  160. package/content/skills/review-criteria/SKILL.md +108 -0
  161. package/content/skills/review-gh-pr/SKILL.md +155 -0
  162. package/content/skills/review-gh-pr/select-pr-ticket.mjs +8 -0
  163. package/content/skills/review-permissions/SKILL.md +39 -0
  164. package/content/skills/review-pr/SKILL.md +123 -0
  165. package/content/skills/revise-comments/SKILL.md +115 -0
  166. package/content/skills/revise-prose/SKILL.md +197 -0
  167. package/content/skills/revise-prose/revise-prose.mjs +229 -0
  168. package/content/skills/save-artifact/SKILL.md +69 -0
  169. package/content/skills/save-plan/SKILL.md +55 -0
  170. package/content/skills/software-engineering/SKILL.md +74 -0
  171. package/content/skills/streamline-guidance/SKILL.md +174 -0
  172. package/content/skills/streamline-guidance/streamline-guidance.mjs +211 -0
  173. package/content/skills/summarize-change/SKILL.md +308 -0
  174. package/content/skills/summarize-chat/SKILL.md +100 -0
  175. package/content/skills/systematic-debugging/SKILL.md +308 -0
  176. package/content/skills/systematic-debugging/condition-based-waiting-example.ts +160 -0
  177. package/content/skills/systematic-debugging/condition-based-waiting.md +122 -0
  178. package/content/skills/systematic-debugging/defense-in-depth.md +130 -0
  179. package/content/skills/systematic-debugging/find-polluter.sh +68 -0
  180. package/content/skills/systematic-debugging/root-cause-tracing.md +185 -0
  181. package/content/skills/systematic-debugging/test-academic.md +16 -0
  182. package/content/skills/systematic-debugging/test-pressure-1.md +67 -0
  183. package/content/skills/systematic-debugging/test-pressure-2.md +77 -0
  184. package/content/skills/systematic-debugging/test-pressure-3.md +77 -0
  185. package/content/skills/testing-conventions/SKILL.md +168 -0
  186. package/content/skills/testing-conventions/mistakes.md +1 -0
  187. package/content/skills/typescript-testing-conventions/SKILL.md +129 -0
  188. package/content/skills/update-jira-ticket/SKILL.md +245 -0
  189. package/content/skills/update-jira-ticket/update-jira-ticket.mjs +9 -0
  190. package/content/skills/update-project-guidance/SKILL.md +300 -0
  191. package/content/skills/upgrade-dependencies/SKILL.md +139 -0
  192. package/content/skills/wrap-up/SKILL.md +431 -0
  193. package/content/subagents/_data/claude.yaml +19 -0
  194. package/content/subagents/_data/rovo.yaml +31 -0
  195. package/content/subagents/canary.md +11 -0
  196. package/content/subagents/entry-drafter.md +187 -0
  197. package/content/subagents/handoff-reviewer.md +75 -0
  198. package/content/subagents/plan-reviewer.md +184 -0
  199. package/content/subagents/plan-reviser.md +88 -0
  200. package/content/subagents/prose-reviser.md +130 -0
  201. package/content/subagents/ticket-assessor.md +139 -0
  202. package/package.json +70 -2
  203. package/schemas/preferences.v1.json +294 -0
  204. package/schemas/work-types.v1.json +142 -0
@@ -0,0 +1,563 @@
1
+ [
2
+ {
3
+ "version": "0.1.0",
4
+ "date": "2026-10-10",
5
+ "sections": [
6
+ {
7
+ "title": "๐ŸŽ‰ Features",
8
+ "audience": "all",
9
+ "items": [
10
+ {
11
+ "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)",
12
+ "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.",
13
+ "hash": "04c9f0b68f9d30f51c37203449047c88e1615d38",
14
+ "entry": 1
15
+ },
16
+ {
17
+ "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)",
18
+ "hash": "81fd3b2e2c482bf107bdfa65b4e9eb2c535997d2",
19
+ "entry": 1
20
+ },
21
+ {
22
+ "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)",
23
+ "hash": "10b538a3c952705a78208813e05a24c3f7193da3",
24
+ "entry": 1
25
+ },
26
+ {
27
+ "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)",
28
+ "hash": "28182c90d98edfc249fb0dedb9334cb4a11bbada",
29
+ "entry": 1
30
+ },
31
+ {
32
+ "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)",
33
+ "hash": "28182c90d98edfc249fb0dedb9334cb4a11bbada",
34
+ "entry": 2
35
+ },
36
+ {
37
+ "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)",
38
+ "hash": "7f5788c508fbebba277159b25d191aca8609b41a",
39
+ "entry": 1
40
+ },
41
+ {
42
+ "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)",
43
+ "hash": "7f5788c508fbebba277159b25d191aca8609b41a",
44
+ "entry": 2
45
+ },
46
+ {
47
+ "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)",
48
+ "hash": "c36c228fe73008ea6cc8920e340ae645a28832c9",
49
+ "entry": 2
50
+ },
51
+ {
52
+ "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)",
53
+ "hash": "bb8d6dc0fb033ee4d8ae8052c263728d0c4606da",
54
+ "entry": 1
55
+ },
56
+ {
57
+ "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)",
58
+ "hash": "bb8d6dc0fb033ee4d8ae8052c263728d0c4606da",
59
+ "entry": 2
60
+ },
61
+ {
62
+ "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)",
63
+ "hash": "e445c642679312607af15a84d2a5929b38663d1b",
64
+ "entry": 1
65
+ },
66
+ {
67
+ "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)",
68
+ "hash": "e445c642679312607af15a84d2a5929b38663d1b",
69
+ "entry": 2
70
+ },
71
+ {
72
+ "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)",
73
+ "hash": "e445c642679312607af15a84d2a5929b38663d1b",
74
+ "entry": 3
75
+ },
76
+ {
77
+ "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)",
78
+ "hash": "e445c642679312607af15a84d2a5929b38663d1b",
79
+ "entry": 4
80
+ },
81
+ {
82
+ "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)",
83
+ "hash": "e445c642679312607af15a84d2a5929b38663d1b",
84
+ "entry": 5
85
+ },
86
+ {
87
+ "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)",
88
+ "hash": "1e832094930e9f9d3b835ddc37b4d6efd9c39acd",
89
+ "entry": 1
90
+ },
91
+ {
92
+ "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)",
93
+ "hash": "1e832094930e9f9d3b835ddc37b4d6efd9c39acd",
94
+ "entry": 2
95
+ },
96
+ {
97
+ "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)",
98
+ "hash": "7b103316dab9e9257debb59724af1af7d2eef36b",
99
+ "entry": 1
100
+ },
101
+ {
102
+ "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)",
103
+ "hash": "7b103316dab9e9257debb59724af1af7d2eef36b",
104
+ "entry": 2
105
+ },
106
+ {
107
+ "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)",
108
+ "hash": "79e116429e9c1762d03d86da9039471fd02b9dbd",
109
+ "entry": 1
110
+ },
111
+ {
112
+ "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)",
113
+ "hash": "79e116429e9c1762d03d86da9039471fd02b9dbd",
114
+ "entry": 2
115
+ },
116
+ {
117
+ "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)",
118
+ "hash": "79e116429e9c1762d03d86da9039471fd02b9dbd",
119
+ "entry": 3
120
+ },
121
+ {
122
+ "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)",
123
+ "hash": "80002d52e4026884b6afa9389189476852176e89",
124
+ "entry": 2
125
+ },
126
+ {
127
+ "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)",
128
+ "hash": "80002d52e4026884b6afa9389189476852176e89",
129
+ "entry": 3
130
+ },
131
+ {
132
+ "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)",
133
+ "hash": "d560bee7c0c845e4a7b5476ae4aba282b811f881",
134
+ "entry": 2
135
+ },
136
+ {
137
+ "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)",
138
+ "hash": "32aedb168733d4408171511629ff1aceba16832a",
139
+ "entry": 1
140
+ },
141
+ {
142
+ "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)",
143
+ "hash": "26999a5c9977ee9a6425e527ca0e26a2f44ff034",
144
+ "entry": 1
145
+ },
146
+ {
147
+ "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)",
148
+ "hash": "26999a5c9977ee9a6425e527ca0e26a2f44ff034",
149
+ "entry": 2
150
+ },
151
+ {
152
+ "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)",
153
+ "hash": "26999a5c9977ee9a6425e527ca0e26a2f44ff034",
154
+ "entry": 3
155
+ },
156
+ {
157
+ "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)",
158
+ "hash": "9c435ac2fd7e4cd9e69bb7f06669f983e0a3ccd6",
159
+ "entry": 1
160
+ },
161
+ {
162
+ "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)",
163
+ "hash": "9c435ac2fd7e4cd9e69bb7f06669f983e0a3ccd6",
164
+ "entry": 2
165
+ },
166
+ {
167
+ "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)",
168
+ "hash": "9c435ac2fd7e4cd9e69bb7f06669f983e0a3ccd6",
169
+ "entry": 3
170
+ },
171
+ {
172
+ "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)",
173
+ "hash": "719da292375d0a2d529584b3b42bdd0b3b3f88fa",
174
+ "entry": 1
175
+ },
176
+ {
177
+ "description": "Adds an instruction to the `williamthorsen-workflow-preferences` rulebook to create every iteration's sub-issue when the epic is created. (#1987)",
178
+ "hash": "719da292375d0a2d529584b3b42bdd0b3b3f88fa",
179
+ "entry": 2
180
+ },
181
+ {
182
+ "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)",
183
+ "hash": "0864719f359c8bc3bac29af98f0f96198287645c",
184
+ "entry": 1
185
+ },
186
+ {
187
+ "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)",
188
+ "hash": "9d65e47f8ee12dae1dcb990ce5ac030e316c58db",
189
+ "entry": 1
190
+ },
191
+ {
192
+ "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)",
193
+ "hash": "9d65e47f8ee12dae1dcb990ce5ac030e316c58db",
194
+ "entry": 2
195
+ },
196
+ {
197
+ "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)",
198
+ "hash": "ad3e14265ddb7c9fa579cb6adb292f52b4207fe8",
199
+ "entry": 1
200
+ },
201
+ {
202
+ "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)",
203
+ "hash": "ad3e14265ddb7c9fa579cb6adb292f52b4207fe8",
204
+ "entry": 2
205
+ },
206
+ {
207
+ "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)",
208
+ "hash": "ad3e14265ddb7c9fa579cb6adb292f52b4207fe8",
209
+ "entry": 3
210
+ },
211
+ {
212
+ "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)",
213
+ "hash": "ad3e14265ddb7c9fa579cb6adb292f52b4207fe8",
214
+ "entry": 4
215
+ },
216
+ {
217
+ "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)",
218
+ "hash": "e24422a9eeab2e4afd5c390cc3558d4b748bb3d6",
219
+ "entry": 1
220
+ },
221
+ {
222
+ "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)",
223
+ "hash": "e24422a9eeab2e4afd5c390cc3558d4b748bb3d6",
224
+ "entry": 2
225
+ },
226
+ {
227
+ "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)",
228
+ "breaking": true,
229
+ "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.",
230
+ "hash": "7ed2a6916631341810cf8e262c32b3a6ebc606fc",
231
+ "entry": 1
232
+ },
233
+ {
234
+ "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)",
235
+ "hash": "c3bb3b27ab5bbc7dbcf1d0f91313ecc047a5fefa",
236
+ "entry": 1
237
+ },
238
+ {
239
+ "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)",
240
+ "hash": "c3bb3b27ab5bbc7dbcf1d0f91313ecc047a5fefa",
241
+ "entry": 4
242
+ },
243
+ {
244
+ "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)",
245
+ "hash": "5d4522db61b236028f1964c2e65581ca675bf1a6",
246
+ "entry": 1
247
+ },
248
+ {
249
+ "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)",
250
+ "hash": "b4bf0df89157a4f534455d4a9cd15d814fe0051a",
251
+ "entry": 1
252
+ },
253
+ {
254
+ "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)",
255
+ "migration": "To keep receiving the subagent-model guidance on Claude, declare the `williamthorsen` collection.",
256
+ "hash": "c7b047e0bf56fdef7c5eaf3b3da29ba1c7f9ec4c",
257
+ "entry": 1
258
+ },
259
+ {
260
+ "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)",
261
+ "hash": "ec6d02b45973e1e6aa8846ee6ab319bd8c9415b2",
262
+ "entry": 1
263
+ },
264
+ {
265
+ "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)",
266
+ "hash": "ec6d02b45973e1e6aa8846ee6ab319bd8c9415b2",
267
+ "entry": 2
268
+ },
269
+ {
270
+ "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)",
271
+ "hash": "ec6d02b45973e1e6aa8846ee6ab319bd8c9415b2",
272
+ "entry": 3
273
+ },
274
+ {
275
+ "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)",
276
+ "hash": "ec6d02b45973e1e6aa8846ee6ab319bd8c9415b2",
277
+ "entry": 4
278
+ },
279
+ {
280
+ "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)",
281
+ "hash": "019e690e5c166e7b1111ee17ec16ed4abeec6050",
282
+ "entry": 1
283
+ },
284
+ {
285
+ "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)",
286
+ "hash": "63d1093f48e503ab9104ea981ef5244acefeb9b5",
287
+ "entry": 1
288
+ },
289
+ {
290
+ "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)",
291
+ "hash": "63d1093f48e503ab9104ea981ef5244acefeb9b5",
292
+ "entry": 2
293
+ },
294
+ {
295
+ "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)",
296
+ "hash": "63d1093f48e503ab9104ea981ef5244acefeb9b5",
297
+ "entry": 3
298
+ },
299
+ {
300
+ "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)",
301
+ "hash": "63d1093f48e503ab9104ea981ef5244acefeb9b5",
302
+ "entry": 4
303
+ },
304
+ {
305
+ "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)",
306
+ "hash": "63d1093f48e503ab9104ea981ef5244acefeb9b5",
307
+ "entry": 5
308
+ }
309
+ ]
310
+ },
311
+ {
312
+ "title": "๐Ÿชฆ Removed",
313
+ "audience": "all",
314
+ "items": [
315
+ {
316
+ "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)",
317
+ "breaking": true,
318
+ "migration": "Replace `orchestrate-dev` with `plan`, `implement-plan`, and `review-branch`, and replace `orchestrate-review` with `review-branch` followed by `respond-to-review`.",
319
+ "hash": "2d926535c2f21f9db95e7314e26ef1613071b71c",
320
+ "entry": 1
321
+ },
322
+ {
323
+ "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)",
324
+ "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.",
325
+ "hash": "2d926535c2f21f9db95e7314e26ef1613071b71c",
326
+ "entry": 2
327
+ },
328
+ {
329
+ "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)",
330
+ "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.",
331
+ "hash": "2d926535c2f21f9db95e7314e26ef1613071b71c",
332
+ "entry": 3
333
+ },
334
+ {
335
+ "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)",
336
+ "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.",
337
+ "hash": "d560bee7c0c845e4a7b5476ae4aba282b811f881",
338
+ "entry": 1
339
+ }
340
+ ]
341
+ },
342
+ {
343
+ "title": "๐Ÿ› Bug fixes",
344
+ "audience": "all",
345
+ "items": [
346
+ {
347
+ "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)",
348
+ "hash": "f00b19af18ef0d21d161232bea30ec4aa1fabfb5",
349
+ "entry": 1
350
+ },
351
+ {
352
+ "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)",
353
+ "hash": "f00b19af18ef0d21d161232bea30ec4aa1fabfb5",
354
+ "entry": 2
355
+ },
356
+ {
357
+ "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)",
358
+ "hash": "45d231be59d79d3d0d6f2291ab9de0074e44e84a",
359
+ "entry": 1
360
+ },
361
+ {
362
+ "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)",
363
+ "hash": "64954d519c4e121517dfbecebe30f197955bbbf3",
364
+ "entry": 1
365
+ },
366
+ {
367
+ "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)",
368
+ "hash": "64954d519c4e121517dfbecebe30f197955bbbf3",
369
+ "entry": 2
370
+ },
371
+ {
372
+ "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)",
373
+ "hash": "64954d519c4e121517dfbecebe30f197955bbbf3",
374
+ "entry": 3
375
+ },
376
+ {
377
+ "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)",
378
+ "hash": "64954d519c4e121517dfbecebe30f197955bbbf3",
379
+ "entry": 4
380
+ },
381
+ {
382
+ "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)",
383
+ "hash": "64954d519c4e121517dfbecebe30f197955bbbf3",
384
+ "entry": 5
385
+ },
386
+ {
387
+ "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)",
388
+ "hash": "c36c228fe73008ea6cc8920e340ae645a28832c9",
389
+ "entry": 1
390
+ },
391
+ {
392
+ "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)",
393
+ "hash": "d28c6d23c0c99f7d712cab45dd12c3e0863cd5ff",
394
+ "entry": 1
395
+ },
396
+ {
397
+ "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)",
398
+ "hash": "d28c6d23c0c99f7d712cab45dd12c3e0863cd5ff",
399
+ "entry": 2
400
+ },
401
+ {
402
+ "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)",
403
+ "hash": "9ee3e7c23aa42cf2a3f0d9474578f9d38caf1e8e",
404
+ "entry": 1
405
+ },
406
+ {
407
+ "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)",
408
+ "hash": "79e116429e9c1762d03d86da9039471fd02b9dbd",
409
+ "entry": 4
410
+ },
411
+ {
412
+ "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)",
413
+ "hash": "5a429827e0935869d3af5a2316d996c89c48cba6",
414
+ "entry": 1
415
+ },
416
+ {
417
+ "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)",
418
+ "hash": "5a429827e0935869d3af5a2316d996c89c48cba6",
419
+ "entry": 2
420
+ },
421
+ {
422
+ "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)",
423
+ "hash": "d8e4fa5ab707c3549bc67881e98d43227dc4fe58",
424
+ "entry": 1
425
+ },
426
+ {
427
+ "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)",
428
+ "hash": "d8e4fa5ab707c3549bc67881e98d43227dc4fe58",
429
+ "entry": 2
430
+ },
431
+ {
432
+ "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)",
433
+ "hash": "b0ce855e63a8702415d5516103e01dfef80c250e",
434
+ "entry": 1
435
+ },
436
+ {
437
+ "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)",
438
+ "hash": "b0ce855e63a8702415d5516103e01dfef80c250e",
439
+ "entry": 2
440
+ },
441
+ {
442
+ "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)",
443
+ "hash": "c3bb3b27ab5bbc7dbcf1d0f91313ecc047a5fefa",
444
+ "entry": 2
445
+ },
446
+ {
447
+ "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)",
448
+ "hash": "c3bb3b27ab5bbc7dbcf1d0f91313ecc047a5fefa",
449
+ "entry": 3
450
+ },
451
+ {
452
+ "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)",
453
+ "hash": "c1b6030a22948e69674479503ca393fb97de5830",
454
+ "entry": 1
455
+ },
456
+ {
457
+ "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)",
458
+ "hash": "019e690e5c166e7b1111ee17ec16ed4abeec6050",
459
+ "entry": 2
460
+ },
461
+ {
462
+ "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)",
463
+ "hash": "fca8841da2a8df7c8d7e983ca0509bc409331265",
464
+ "entry": 1
465
+ }
466
+ ]
467
+ },
468
+ {
469
+ "title": "โšก Performance",
470
+ "audience": "all",
471
+ "items": [
472
+ {
473
+ "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)",
474
+ "hash": "80002d52e4026884b6afa9389189476852176e89",
475
+ "entry": 1
476
+ }
477
+ ]
478
+ },
479
+ {
480
+ "title": "๐Ÿ—๏ธ Internal features",
481
+ "audience": "dev",
482
+ "items": [
483
+ {
484
+ "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)",
485
+ "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.",
486
+ "hash": "d28c6d23c0c99f7d712cab45dd12c3e0863cd5ff",
487
+ "entry": 3
488
+ }
489
+ ]
490
+ },
491
+ {
492
+ "title": "โ™ป๏ธ Refactoring",
493
+ "audience": "dev",
494
+ "items": [
495
+ {
496
+ "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)",
497
+ "hash": "15d739ea9cfdf35003477ce764373c60adbabe2f",
498
+ "entry": 1
499
+ },
500
+ {
501
+ "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)",
502
+ "hash": "14fc1b8c3c1c54968967880cc1021f1541daf597",
503
+ "entry": 1
504
+ },
505
+ {
506
+ "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)",
507
+ "hash": "29fa77bfa44d0444b150669cb58b921a99567f8c",
508
+ "entry": 1
509
+ }
510
+ ]
511
+ },
512
+ {
513
+ "title": "๐Ÿงช Tests",
514
+ "audience": "dev",
515
+ "items": [
516
+ {
517
+ "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)",
518
+ "hash": "8b207257e1c1fbaed9467677ee84dc04717c01cd",
519
+ "entry": 1
520
+ }
521
+ ]
522
+ },
523
+ {
524
+ "title": "โš™๏ธ Tooling",
525
+ "audience": "dev",
526
+ "items": [
527
+ {
528
+ "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)",
529
+ "hash": "29fa77bfa44d0444b150669cb58b921a99567f8c",
530
+ "entry": 2
531
+ }
532
+ ]
533
+ },
534
+ {
535
+ "title": "๐Ÿค– Agentic support",
536
+ "audience": "dev",
537
+ "items": [
538
+ {
539
+ "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)",
540
+ "hash": "e24422a9eeab2e4afd5c390cc3558d4b748bb3d6",
541
+ "entry": 3
542
+ }
543
+ ]
544
+ },
545
+ {
546
+ "title": "๐Ÿ“š Documentation",
547
+ "audience": "dev",
548
+ "items": [
549
+ {
550
+ "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)",
551
+ "hash": "7ed2a6916631341810cf8e262c32b3a6ebc606fc",
552
+ "entry": 4
553
+ },
554
+ {
555
+ "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)",
556
+ "hash": "5d4522db61b236028f1964c2e65581ca675bf1a6",
557
+ "entry": 2
558
+ }
559
+ ]
560
+ }
561
+ ]
562
+ }
563
+ ]