codeassembly-guidance 0.6.0 โ 0.8.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.
- package/.meta/changelog.json +446 -0
- package/CHANGELOG.md +107 -0
- package/README.md +47 -51
- package/bin/codeassembly-validate-preferences.js +2 -8
- package/content/_partials/diff-audit-checklist.md +1 -0
- package/content/_partials/kb-unsearched-private-stores.md +6 -0
- package/content/_partials/plain-speech.md +2 -2
- package/content/_partials/ticket-assessment.md +3 -3
- package/content/codeassembly-content.yaml +8 -0
- package/content/collections/recommended.md +6 -0
- package/content/collections/williamthorsen.md +2 -1
- package/content/guidance/rulebooks/accessibility-conventions.md +6 -3
- package/content/guidance/rulebooks/cross-repo-migration-conventions.md +27 -0
- package/content/guidance/rulebooks/live-worktree-policy.md +2 -2
- package/content/guidance/rulebooks/ui-copy-conventions.md +2 -2
- package/content/guidance/rulebooks/visual-design-conventions.md +58 -0
- package/content/guidance/rulebooks/williamthorsen-collaboration-preferences.md +3 -18
- package/content/guidance/rulebooks/williamthorsen-ticketing-preferences.md +7 -1
- package/content/guidance/rulebooks/williamthorsen-visual-design-preferences.md +14 -0
- package/content/guidance/rulebooks/williamthorsen-workflow-preferences.md +5 -3
- package/content/guidance/rulebooks/williamthorsen-writing-preferences.md +5 -20
- package/content/guidance/shared/AGENTS.md +3 -4
- package/content/scripts/README.md +1 -1
- package/content/scripts/check-branch-currency.mjs +7 -7
- package/content/scripts/check-prose.mjs +38 -38
- package/content/scripts/describe-change.mjs +89 -89
- package/content/scripts/manage-jira-ticket.mjs +162 -160
- package/content/scripts/select-lede-exemplars.mjs +85 -85
- package/content/scripts/validate-preferences.mjs +41 -41
- package/content/skills/_data/artifact-conventions.md +3 -3
- package/content/skills/_data/entry-points.md +1 -1
- package/content/skills/_data/project-stage.md +9 -5
- package/content/skills/_data/reduced-object-relatives.md +15 -0
- package/content/skills/_data/spike-conventions.md +16 -6
- package/content/skills/_data/ticket-evaluation.md +3 -0
- package/content/skills/_partials/implementation-order-list.md +27 -0
- package/content/skills/_partials/merge-settled-criterion.md +1 -0
- package/content/skills/_partials/next-steps-after-plan.md +2 -2
- package/content/skills/_partials/plan-template.md +3 -1
- package/content/skills/_partials/resolve-plan-and-ticket.md +2 -2
- package/content/skills/_partials/split-launch-prompts.md +1 -1
- package/content/skills/_partials/split-ticket-create.md +1 -1
- package/content/skills/_partials/ticket-criteria-conventions.md +2 -0
- package/content/skills/align-ticket-with-implementation/SKILL.md +3 -3
- package/content/skills/analyze-performance/SKILL.md +1 -1
- package/content/skills/assess-code-health/SKILL.md +4 -4
- package/content/skills/assess-code-health/assess-code-health.mjs +20 -20
- package/content/skills/assess-ticket/SKILL.md +3 -1
- package/content/skills/assess-ticket/next-steps-after-assessment.md +11 -14
- package/content/skills/assess-usability/SKILL.md +4 -4
- package/content/skills/capture-event/SKILL.md +20 -11
- package/content/skills/capture-event/capture-event.mjs +123 -123
- package/content/skills/capture-feedback/SKILL.md +2 -1
- package/content/skills/capture-lede-decision/SKILL.md +1 -1
- package/content/skills/capture-lede-decision/capture-lede-decision.mjs +97 -97
- package/content/skills/collaborate/SKILL.md +1 -1
- package/content/skills/condense-branch/SKILL.md +18 -36
- package/content/skills/condense-branch/condense-branch.mjs +17 -0
- package/content/skills/create-bitbucket-pr/SKILL.md +9 -11
- package/content/skills/create-commit/SKILL.md +1 -1
- package/content/skills/create-devlog/SKILL.md +4 -4
- package/content/skills/create-gh-pr/SKILL.md +9 -11
- package/content/skills/create-pr/SKILL.md +10 -12
- package/content/skills/create-ticket/SKILL.md +22 -15
- package/content/skills/create-ticket/resolve-ticket-target.mjs +92 -92
- package/content/skills/curate-feedback/SKILL.md +2 -2
- package/content/skills/curate-feedback/curate-feedback.mjs +82 -82
- package/content/skills/derive-session-context/derive-session-context.mjs +120 -120
- package/content/skills/design-and-plan/SKILL.md +10 -8
- package/content/skills/groom-backlog/groom-backlog.mjs +15 -15
- package/content/skills/implement-plan/SKILL.md +4 -2
- package/content/skills/implementation-order/implementation-order.mjs +67 -0
- package/content/skills/index-prototypes/SKILL.md +2 -2
- package/content/skills/investigate-spike/SKILL.md +3 -3
- package/content/skills/kb-add/SKILL.md +12 -3
- package/content/skills/kb-add/kb-add.mjs +88 -88
- package/content/skills/kb-curate/kb-curate.mjs +88 -88
- package/content/skills/kb-edit/kb-edit.mjs +90 -90
- package/content/skills/kb-retrieve/SKILL.md +8 -3
- package/content/skills/kb-retrieve/kb-retrieve.mjs +104 -104
- package/content/skills/kb-retrieve-events/SKILL.md +8 -3
- package/content/skills/kb-retrieve-events/kb-retrieve-events.mjs +113 -113
- package/content/skills/kb-update-events/kb-update-events.mjs +92 -92
- package/content/skills/lesson-clusters/lesson-clusters.mjs +102 -102
- package/content/skills/list-gh-progress-items/SKILL.md +36 -0
- package/content/skills/list-gh-progress-items/list-gh-progress-items.mjs +68 -0
- package/content/skills/list-implementation-order/SKILL.md +23 -0
- package/content/skills/merge-bb-pr/SKILL.md +40 -19
- package/content/skills/merge-gh-pr/SKILL.md +34 -23
- package/content/skills/merge-gh-pr/merge-gh-pr.mjs +13 -8
- package/content/skills/merge-pr/SKILL.md +64 -31
- package/content/skills/migrate-feedback-memories/SKILL.md +1 -0
- package/content/skills/plan/SKILL.md +5 -3
- package/content/skills/prepare-prototype-brief/SKILL.md +5 -3
- package/content/skills/pull-from-backlog/pull-from-backlog.mjs +22 -22
- package/content/skills/refine-plan/SKILL.md +5 -3
- package/content/skills/refine-prototype/SKILL.md +2 -1
- package/content/skills/respond-to-review/SKILL.md +4 -4
- package/content/skills/review-bb-pr/SKILL.md +1 -2
- package/content/skills/review-branch/SKILL.md +19 -14
- package/content/skills/review-criteria/SKILL.md +2 -2
- package/content/skills/review-gh-pr/SKILL.md +1 -2
- package/content/skills/review-pr/SKILL.md +2 -3
- package/content/skills/revise-prose/revise-prose.mjs +109 -109
- package/content/skills/save-artifact/SKILL.md +4 -6
- package/content/skills/save-plan/SKILL.md +4 -2
- package/content/skills/start-ticket/SKILL.md +1 -1
- package/content/skills/streamline-guidance/streamline-guidance.mjs +80 -80
- package/content/skills/summarize-change/SKILL.md +20 -9
- package/content/skills/summarize-chat/SKILL.md +2 -2
- package/content/skills/testing-conventions/SKILL.md +2 -2
- package/content/skills/triage-feedback/SKILL.md +6 -2
- package/content/skills/triage-spike-findings/SKILL.md +33 -24
- package/content/skills/triage-spike-findings/triage-spike-findings.mjs +19 -19
- package/content/skills/update-project-guidance/SKILL.md +1 -1
- package/content/skills/wrap-up/SKILL.md +8 -4
- package/content/skills/write-progress-report/SKILL.md +111 -0
- package/content/skills/write-progress-report/write-progress-report.mjs +150 -0
- package/content/subagents/disposition-challenger.md +7 -6
- package/content/subagents/entry-drafter.md +2 -0
- package/content/subagents/usability-assessor.md +3 -2
- package/package.json +13 -12
- package/schemas/preferences.v1.json +82 -8
- package/schemas/work-types.v1.json +1 -1
package/.meta/changelog.json
CHANGED
|
@@ -1,4 +1,450 @@
|
|
|
1
1
|
[
|
|
2
|
+
{
|
|
3
|
+
"version": "0.8.0",
|
|
4
|
+
"date": "2026-11-20",
|
|
5
|
+
"sections": [
|
|
6
|
+
{
|
|
7
|
+
"title": "๐ Features",
|
|
8
|
+
"audience": "all",
|
|
9
|
+
"items": [
|
|
10
|
+
{
|
|
11
|
+
"description": "Changes `review-branch` to reflow each comment line that the diff adds or modifies and that exceeds the `max_line_length` set by `.editorconfig`, commit the reflow with `create-commit`, and list it in a new \"Applied reflows\" section of the review, rather than report it as a finding; a review of a pull request, or of a file with uncommitted changes, still reports the line as a finding. (#196)",
|
|
12
|
+
"hash": "8a5c2a662f539e576aed2da1034bab779cfa6b77",
|
|
13
|
+
"entry": 1
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
"description": "Adds a width item to the diff-audit checklist used by `implement-plan`, `respond-to-review`, and `revise-comments`, which directs the agent to reflow each comment line in its own hunks that exceeds the `.editorconfig` `max_line_length`, changing only whitespace. (#196)",
|
|
17
|
+
"hash": "8a5c2a662f539e576aed2da1034bab779cfa6b77",
|
|
18
|
+
"entry": 2
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"description": "Adds to the `recommended` collection the `cross-repo-migration-conventions` rulebook, which covers the umbrella ticket and its one child per repository, shared runtimes moved before the repositories that use them, contract changes decided before any child acts, and a comment on the umbrella that each child posts before merge. (#197)",
|
|
22
|
+
"hash": "5e8a4d7f278cf5b61c87741fbf9d8452e220ba91",
|
|
23
|
+
"entry": 1
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"description": "Adds to `williamthorsen-ticketing-preferences` a reference to `cross-repo-migration-conventions` for a change that migrates many repositories to a new version or convention. (#197)",
|
|
27
|
+
"hash": "5e8a4d7f278cf5b61c87741fbf9d8452e220ba91",
|
|
28
|
+
"entry": 2
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"description": "Adds a requirement to the `williamthorsen-ticketing-preferences` rulebook to estimate the layers, subsystems, and approximate source and test lines of work that spans several layers or adds a new subsystem before its ticket count is decided, and to recommend the split when each piece can be merged and verified on its own, and has the `design-and-plan` ticket checkpoint present that split as the recommended option of a menu. (#202)",
|
|
32
|
+
"hash": "576597d420cc994035242d478d1af6bab3cdffb3",
|
|
33
|
+
"entry": 1
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"description": "Directs `list-implementation-order` to pass the repository in which a ticket outside GitHub is implemented, through the helper's new `--external \"[REPOSITORY:]KEY=Title\"` form, which the helper uses to label that ticket with the repository's prefix, such as `mc.MAC-7`. (#206)",
|
|
37
|
+
"hash": "ac868de813bcc018619ed68c3b3d0947ddb18515",
|
|
38
|
+
"entry": 1
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"description": "Lower-cases the repository prefixes in the implementation-order list, such as `cg.12` in place of `CG.12`, to set them apart from an upper-case Jira key. (#206)",
|
|
42
|
+
"hash": "ac868de813bcc018619ed68c3b3d0947ddb18515",
|
|
43
|
+
"entry": 2
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"description": "Adds a durability check to `summarize-change` that rejects a lede, entry, or migration stating the change's delivery state in a main or subordinate clause, and adds a step that the change needs in order to take effect, such as a deploy or a sync, to the facts that `## Notes for reviewers` contains. (#207)",
|
|
47
|
+
"hash": "67476f398e10c9936af78dca7bef03492c6b7ef6",
|
|
48
|
+
"entry": 2
|
|
49
|
+
},
|
|
50
|
+
{
|
|
51
|
+
"description": "Adds a convention to `create-ticket`, `design-and-plan`, and `align-ticket-with-implementation` that limits a code ticket's acceptance criteria to those that its pull request's tests, checks, or review can show to hold or fail at merge, and directs the agent to move a criterion that depends on elapsed time, deployed state, or a run against shared data to the ticket that consumes the change. (#208)",
|
|
52
|
+
"hash": "0af73fb2285962ad29ae43315926613ab2c7d6ea",
|
|
53
|
+
"entry": 1
|
|
54
|
+
},
|
|
55
|
+
{
|
|
56
|
+
"description": "Adds a criterion-settleability facet to the ticket evaluation used by `design-and-plan` and by the advisability dimension of `assess-ticket`, which reports each acceptance criterion of a code ticket that its pull request cannot show to hold or fail at merge, together with the ticket to which the criterion moves. (#208)",
|
|
57
|
+
"hash": "0af73fb2285962ad29ae43315926613ab2c7d6ea",
|
|
58
|
+
"entry": 2
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
"description": "Adds the `write-progress-report` skill, which writes a customer-facing progress report from a tracker or an `--items` file, with one section per workstream that states its health and lists the items that need the customer's input, are done, are in progress, or are planned. (#213)",
|
|
62
|
+
"hash": "57e86c0026c03c7cc0aaf7910cefcea5e0e11968",
|
|
63
|
+
"entry": 1
|
|
64
|
+
},
|
|
65
|
+
{
|
|
66
|
+
"description": "Adds `list-gh-progress-items`, which `write-progress-report` calls for `--source github` to read a repository's GitHub issues as report items, treating each parent issue as a workstream and each issue labeled `needs-input` as an ask of the customer. (#213)",
|
|
67
|
+
"hash": "57e86c0026c03c7cc0aaf7910cefcea5e0e11968",
|
|
68
|
+
"entry": 2
|
|
69
|
+
},
|
|
70
|
+
{
|
|
71
|
+
"description": "Adds `confluence` to the values of the `write-progress-report` skill's `--format` argument, which renders the report in Confluence storage format (the XML that Confluence stores as a page body), with health and statuses as status lozenges and dates as date elements that Confluence shows in the reader's locale. (#215)",
|
|
72
|
+
"hash": "b5ab073bc60964f3f312a9c7b21fb567475fda46",
|
|
73
|
+
"entry": 1
|
|
74
|
+
},
|
|
75
|
+
{
|
|
76
|
+
"description": "Adds `project_artifact_dir` (`{artifact_base_dir}/projects/{project_slug}`) and `ticket_dir` (`{project_artifact_dir}/tickets/{ticket_id}`, or `null` when the branch does not name a ticket) to the session-context manifest that `derive-session-context` emits. (#219)",
|
|
77
|
+
"hash": "34edc29acdf9512685e7f0a5744d7fc38a43e17c",
|
|
78
|
+
"entry": 1
|
|
79
|
+
},
|
|
80
|
+
{
|
|
81
|
+
"description": "Changes `save-artifact` and every other skill that saves or reads artifacts to take the artifact directories from the manifest, with `save-artifact` stating the fallback for a `null` `ticket_dir`, which generates a ticket ID and saves under `{project_artifact_dir}/tickets/{generated id}`. (#219)",
|
|
82
|
+
"hash": "34edc29acdf9512685e7f0a5744d7fc38a43e17c",
|
|
83
|
+
"entry": 2
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
"description": "Adds to the `recommended` collection the `visual-design-conventions` rulebook, which states the visual-design rules that hold whatever the style: padding inside a bordered or filled container, alignment with another block, marks only on the exception, colour as a way to tell kinds and states apart, an appearance that follows each element's role, the product's own name and favicon, and a browser check of each changed view. (#220)",
|
|
87
|
+
"hash": "017980bb12b8013681740e866e26e73606e5e686",
|
|
88
|
+
"entry": 1
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
"description": "Adds to the `williamthorsen` collection the `williamthorsen-visual-design-preferences` rulebook, which prefers a quiet colour scheme, with muted hues on neutral surfaces that each encode a kind or a state, to a monochrome one. (#220)",
|
|
92
|
+
"hash": "017980bb12b8013681740e866e26e73606e5e686",
|
|
93
|
+
"entry": 2
|
|
94
|
+
},
|
|
95
|
+
{
|
|
96
|
+
"description": "Adds `visual-design-conventions` beside `accessibility-conventions` to the floor that the planning, building, assessment, and review skills and the `usability-assessor` subagent set for an interface, including the rulebook's browser check of each changed view. (#220)",
|
|
97
|
+
"hash": "017980bb12b8013681740e866e26e73606e5e686",
|
|
98
|
+
"entry": 3
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"description": "Adds the \"Consequence at the control\" rule to `accessibility-conventions`, which requires the explanation of an action that cannot be undone to be visible at rest, allows a toggletip for one that can be undone, and never accepts a hover-only tooltip as the only explanation. (#221)",
|
|
102
|
+
"hash": "1eda2181589f8ba6e19b955ded94b4e150db44e2",
|
|
103
|
+
"entry": 1
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
"description": "Opens `accessibility-conventions` with a statement that its rules are floors, and directs agents to aim beyond them by following an established model, as the named-model rule describes. (#221)",
|
|
107
|
+
"hash": "1eda2181589f8ba6e19b955ded94b4e150db44e2",
|
|
108
|
+
"entry": 2
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
"description": "Extends the helper-text rule of `ui-copy-conventions` to say what an action's consequence explanation states, and counts that explanation toward the copy budget's one line of helper text. (#221)",
|
|
112
|
+
"hash": "1eda2181589f8ba6e19b955ded94b4e150db44e2",
|
|
113
|
+
"entry": 3
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
"description": "Adds the consequence-at-the-control rule to the skills and the subagent that list the accessibility rules that they apply, among them `review-criteria`, `prepare-prototype-brief`, and the `usability-assessor` per-screen checklist. (#221)",
|
|
117
|
+
"hash": "1eda2181589f8ba6e19b955ded94b4e150db44e2",
|
|
118
|
+
"entry": 4
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
"description": "Adds a `close` subcommand to `manage-jira-ticket.mjs`, which posts a Markdown body as a comment unless an existing comment opens with the body's first line, then transitions the work item to the status that the new `integrations.jira.done_status` preference names (default `Done`) unless its status category is already done. (#225)",
|
|
122
|
+
"hash": "c9dad124c542ea2dc9206866e594c6730fa3c3fd",
|
|
123
|
+
"entry": 1
|
|
124
|
+
},
|
|
125
|
+
{
|
|
126
|
+
"description": "Extends the closing post of the spike skills and the close of the triage ticket in `triage-spike-findings` to Jira tickets through `manage-jira-ticket.mjs close`; the guidance previously named only `gh issue close`, which does not close a Jira ticket. (#225)",
|
|
127
|
+
"hash": "c9dad124c542ea2dc9206866e594c6730fa3c3fd",
|
|
128
|
+
"entry": 2
|
|
129
|
+
},
|
|
130
|
+
{
|
|
131
|
+
"description": "Extends `triage-spike-findings` to run on Jira as well as GitHub, adding a `platform` field to the dispositions record so that the record accepts work item keys such as `PROJ-123`, and creating each Jira ticket under the triage ticket's parent in place of an umbrella. (#227)",
|
|
132
|
+
"hash": "73f7d6f6f790f8c1127a8b8b3937ac6e9099ed6f",
|
|
133
|
+
"entry": 1
|
|
134
|
+
},
|
|
135
|
+
{
|
|
136
|
+
"description": "Makes `analyze-performance`, `assess-code-health`, `assess-usability`, and `investigate-spike` name `triage-spike-findings` as the next step only for a ticket on GitHub or Jira, and name the findings left for disposal by hand for a ticket on any other platform. (#227)",
|
|
137
|
+
"hash": "73f7d6f6f790f8c1127a8b8b3937ac6e9099ed6f",
|
|
138
|
+
"entry": 2
|
|
139
|
+
},
|
|
140
|
+
{
|
|
141
|
+
"description": "Adds a rule to the `williamthorsen-ticketing-preferences` rulebook that splits adding a package to a monorepo into two tickets: an empty scaffold with its documentation and package references that passes the repository's checks on its own, and the package's functionality, blocked by the scaffold. (#229)",
|
|
142
|
+
"hash": "a098104295002a9eba5773e7810b80533eb03451",
|
|
143
|
+
"entry": 1
|
|
144
|
+
},
|
|
145
|
+
{
|
|
146
|
+
"description": "Changes `create-commit` to record a scaffold that passes the repository's checks and is fully wired as a commit of its own, while a scaffold that a later change fills in still goes into that change. (#229)",
|
|
147
|
+
"hash": "a098104295002a9eba5773e7810b80533eb03451",
|
|
148
|
+
"entry": 2
|
|
149
|
+
},
|
|
150
|
+
{
|
|
151
|
+
"description": "Requires in the `visual-design-conventions` rulebook that text and elements within a block be start-aligned and a column of numbers end-aligned, limits centring to a viewport-centred dialog, a single-line label in a button or a tag, and an icon in a square control, and adds a matching item to the rulebook's browser check. (#231)",
|
|
152
|
+
"hash": "20fe892fe4444395510fe4cc3f0c5c6df874d78d",
|
|
153
|
+
"entry": 1
|
|
154
|
+
},
|
|
155
|
+
{
|
|
156
|
+
"description": "Adds the `--umbrella` flag to `create-ticket`, which on Jira creates the ticket at the issue type that the new `integrations.jira.umbrella_issue_type` preference sets, `Epic` by default, so that Jira accepts it as the parent of its child tickets. (#232)",
|
|
157
|
+
"hash": "7adea702846e20e626db2b7dd60e5ffe334242a2",
|
|
158
|
+
"entry": 2
|
|
159
|
+
}
|
|
160
|
+
]
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
"title": "๐ Bug fixes",
|
|
164
|
+
"audience": "all",
|
|
165
|
+
"items": [
|
|
166
|
+
{
|
|
167
|
+
"description": "Fixes the issue that `assess-ticket` prescribed a plain numbered list of next-step actions, which the ambient option format overrode on every run, by including the shared option format and marking each action at the strength that the evidence behind its verdict supports. (#193)",
|
|
168
|
+
"hash": "a86f92f7f832c43f80087150da2a50dcfff978e6",
|
|
169
|
+
"entry": 1
|
|
170
|
+
},
|
|
171
|
+
{
|
|
172
|
+
"description": "Fixes the issue that `condense-branch` left uncommitted changes in a stash shared by every worktree of the repository, or folded them into the condensed commit through `git add --all` when the stash was skipped. (#195)",
|
|
173
|
+
"hash": "e9f5f9b3e0086fb406a3bcdcaec9b72f0419a3c2",
|
|
174
|
+
"entry": 1
|
|
175
|
+
},
|
|
176
|
+
{
|
|
177
|
+
"description": "Fixes the issue that `review-pr` passed its session-context values only to `review-branch`'s steps 4โ9, which left out the step that saves the review. (#196)",
|
|
178
|
+
"hash": "8a5c2a662f539e576aed2da1034bab779cfa6b77",
|
|
179
|
+
"entry": 3
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
"description": "Fixes the issue that `list-implementation-order` listed an umbrella ticket, one that has sub-issues, as a ticket to implement, although its children do its work. (#199)",
|
|
183
|
+
"hash": "7db2b098233dddb213ec4cf4bcc45346ce44935e",
|
|
184
|
+
"entry": 1
|
|
185
|
+
},
|
|
186
|
+
{
|
|
187
|
+
"description": "Fixes the issue that `entry-drafter` could write a change's delivery state, such as \"takes effect once deployed\", into the lede or an entry, which the merge commit keeps after the statement becomes false. (#207)",
|
|
188
|
+
"hash": "67476f398e10c9936af78dca7bef03492c6b7ef6",
|
|
189
|
+
"entry": 1
|
|
190
|
+
},
|
|
191
|
+
{
|
|
192
|
+
"description": "Fixes the issue that `williamthorsen-workflow-preferences` did not stop a session from creating a branch, a worktree, or commits in a repository or ticket other than its own, and that its cross-repo sequencing rule told the session to make the upstream change itself. (#214)",
|
|
193
|
+
"hash": "38817a1523f1ccb3a58023dc4a0c5cb125eb104e",
|
|
194
|
+
"entry": 1
|
|
195
|
+
},
|
|
196
|
+
{
|
|
197
|
+
"description": "Fixes the issue that `create-ticket` reversed a Jira blocked-by link by putting the blocker in the `--out` option of `acli jira workitem link create`, when `--in` is the option that names the blocker. (#227)",
|
|
198
|
+
"hash": "73f7d6f6f790f8c1127a8b8b3937ac6e9099ed6f",
|
|
199
|
+
"entry": 3
|
|
200
|
+
},
|
|
201
|
+
{
|
|
202
|
+
"description": "Fixes the issue that `triage-spike-findings` did not create an umbrella on Jira and parented each new ticket to the triage ticket's parent, by having it create the umbrella on Jira as on GitHub and parent each child ticket to it. (#232)",
|
|
203
|
+
"hash": "7adea702846e20e626db2b7dd60e5ffe334242a2",
|
|
204
|
+
"entry": 1
|
|
205
|
+
},
|
|
206
|
+
{
|
|
207
|
+
"description": "Fixes the issue that `create-ticket` gave a Jira child of a level-0 parent, such as a `Task`, the child's own issue type, which Jira rejects under that parent, and makes `create-ticket` create the child as a subtask at the type that the new `integrations.jira.subtask_issue_type` setting declares (`Subtask` by default). (#233)",
|
|
208
|
+
"hash": "c7d89d68a51daaa5187df82f9676918733f35d1f",
|
|
209
|
+
"entry": 1
|
|
210
|
+
}
|
|
211
|
+
]
|
|
212
|
+
},
|
|
213
|
+
{
|
|
214
|
+
"title": "โก Performance",
|
|
215
|
+
"audience": "all",
|
|
216
|
+
"items": [
|
|
217
|
+
{
|
|
218
|
+
"description": "Cuts about 110 words from the shared `AGENTS.md` and the plain-speech partial, both loaded into every session, by removing a redundant example, a sentence of rationale, a repeated repair, and three sentences that describe skills or tickets without directing the agent. (#190)",
|
|
219
|
+
"hash": "c7776a100d7c8bd092d85302109cd9e57b9ecb6f",
|
|
220
|
+
"entry": 1
|
|
221
|
+
},
|
|
222
|
+
{
|
|
223
|
+
"description": "Cuts the prompt-formatting rules that the option-format and action-items guidance already states from the ambient `williamthorsen-collaboration-preferences` rulebook, which shrinks from 11,919 to 6,031 bytes in every session that loads it. (#191)",
|
|
224
|
+
"hash": "34a5760788c19ad9f96604f1e9b164156384d990",
|
|
225
|
+
"entry": 1
|
|
226
|
+
},
|
|
227
|
+
{
|
|
228
|
+
"description": "Removes the note \"(Reinforces the rule in `AGENTS.md`: intentional redundancy.)\" from the option-format directive in the skills that link to the option format, because the rulebook no longer states that rule. (#191)",
|
|
229
|
+
"hash": "34a5760788c19ad9f96604f1e9b164156384d990",
|
|
230
|
+
"entry": 2
|
|
231
|
+
},
|
|
232
|
+
{
|
|
233
|
+
"description": "Cuts the `williamthorsen-writing-preferences` rulebook from 9,234 to 7,246 bytes by moving three rarely needed reduced-object-relative cases into `skills/_data/reduced-object-relatives.md`, which the rule links to, and by removing passages that the remaining rules already direct. (#192)",
|
|
234
|
+
"hash": "1b5fc588292711ce63d38af5a7e8509eb01ea6db",
|
|
235
|
+
"entry": 1
|
|
236
|
+
}
|
|
237
|
+
]
|
|
238
|
+
},
|
|
239
|
+
{
|
|
240
|
+
"title": "โป๏ธ Refactoring",
|
|
241
|
+
"audience": "dev",
|
|
242
|
+
"items": [
|
|
243
|
+
{
|
|
244
|
+
"description": "Replaces the inline `error instanceof Error ? error.message : String(error)` expression in the guidance helpers with `describeError` from `@williamthorsen/toolbelt.errors`, and moves the error report of the `codeassembly-validate-preferences` bin into a new `runValidatePreferencesCommand` function, which the bin and the helper's entry point both call. (#201)",
|
|
245
|
+
"hash": "32e94300de37e89f9ae13f24a038d36c6e6564c4",
|
|
246
|
+
"entry": 2
|
|
247
|
+
}
|
|
248
|
+
]
|
|
249
|
+
},
|
|
250
|
+
{
|
|
251
|
+
"title": "โ๏ธ Tooling",
|
|
252
|
+
"audience": "dev",
|
|
253
|
+
"items": [
|
|
254
|
+
{
|
|
255
|
+
"description": "Regenerates the tracked `revise-prose.mjs` bundle from its current source, a rebuild that changes only identifiers renamed by the minifier. (#219)",
|
|
256
|
+
"hash": "34edc29acdf9512685e7f0a5744d7fc38a43e17c",
|
|
257
|
+
"entry": 3
|
|
258
|
+
}
|
|
259
|
+
]
|
|
260
|
+
}
|
|
261
|
+
]
|
|
262
|
+
},
|
|
263
|
+
{
|
|
264
|
+
"version": "0.7.0",
|
|
265
|
+
"date": "2026-11-14",
|
|
266
|
+
"sections": [
|
|
267
|
+
{
|
|
268
|
+
"title": "๐ Features",
|
|
269
|
+
"audience": "all",
|
|
270
|
+
"items": [
|
|
271
|
+
{
|
|
272
|
+
"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)",
|
|
273
|
+
"hash": "9eb2448bac820d79aadbfa4e850aef84400bd73f",
|
|
274
|
+
"entry": 1
|
|
275
|
+
},
|
|
276
|
+
{
|
|
277
|
+
"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)",
|
|
278
|
+
"hash": "0b28b368b2a11bbc2f74ad338440e0591a3d19c8",
|
|
279
|
+
"entry": 1
|
|
280
|
+
},
|
|
281
|
+
{
|
|
282
|
+
"description": "Adds the `--confirm` option to `merge-pr`, which shows the approval gate for one run when `merge.approval` is `auto`. (#147)",
|
|
283
|
+
"hash": "0b28b368b2a11bbc2f74ad338440e0591a3d19c8",
|
|
284
|
+
"entry": 2
|
|
285
|
+
},
|
|
286
|
+
{
|
|
287
|
+
"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)",
|
|
288
|
+
"hash": "9a10fc06593714a8a62003fbe86c9026962b07bc",
|
|
289
|
+
"entry": 1
|
|
290
|
+
},
|
|
291
|
+
{
|
|
292
|
+
"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)",
|
|
293
|
+
"hash": "9a10fc06593714a8a62003fbe86c9026962b07bc",
|
|
294
|
+
"entry": 2
|
|
295
|
+
},
|
|
296
|
+
{
|
|
297
|
+
"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)",
|
|
298
|
+
"hash": "9a10fc06593714a8a62003fbe86c9026962b07bc",
|
|
299
|
+
"entry": 3
|
|
300
|
+
},
|
|
301
|
+
{
|
|
302
|
+
"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)",
|
|
303
|
+
"hash": "b9c0250bd7f77e68327503aa0e38d2097bb8ee19",
|
|
304
|
+
"entry": 1
|
|
305
|
+
},
|
|
306
|
+
{
|
|
307
|
+
"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)",
|
|
308
|
+
"hash": "b9c0250bd7f77e68327503aa0e38d2097bb8ee19",
|
|
309
|
+
"entry": 2
|
|
310
|
+
},
|
|
311
|
+
{
|
|
312
|
+
"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)",
|
|
313
|
+
"hash": "b9c0250bd7f77e68327503aa0e38d2097bb8ee19",
|
|
314
|
+
"entry": 3
|
|
315
|
+
},
|
|
316
|
+
{
|
|
317
|
+
"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)",
|
|
318
|
+
"hash": "dc266c99aabac894c44e23f76db8e007842ca01a",
|
|
319
|
+
"entry": 1
|
|
320
|
+
},
|
|
321
|
+
{
|
|
322
|
+
"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)",
|
|
323
|
+
"hash": "dc266c99aabac894c44e23f76db8e007842ca01a",
|
|
324
|
+
"entry": 2
|
|
325
|
+
},
|
|
326
|
+
{
|
|
327
|
+
"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)",
|
|
328
|
+
"hash": "5a6a9d5abde6d88e133edbc192d9517adff57fca",
|
|
329
|
+
"entry": 1
|
|
330
|
+
},
|
|
331
|
+
{
|
|
332
|
+
"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)",
|
|
333
|
+
"hash": "9558074a0a732ee1a1fb9da2055d99d260a844fc",
|
|
334
|
+
"entry": 1
|
|
335
|
+
},
|
|
336
|
+
{
|
|
337
|
+
"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)",
|
|
338
|
+
"hash": "9558074a0a732ee1a1fb9da2055d99d260a844fc",
|
|
339
|
+
"entry": 2
|
|
340
|
+
},
|
|
341
|
+
{
|
|
342
|
+
"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)",
|
|
343
|
+
"hash": "66e04b50774064ffde90d4cacb5953e844db2998",
|
|
344
|
+
"entry": 1
|
|
345
|
+
},
|
|
346
|
+
{
|
|
347
|
+
"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)",
|
|
348
|
+
"hash": "989582e827c11847401acac06a0cd5922d8e1a2e",
|
|
349
|
+
"entry": 1
|
|
350
|
+
},
|
|
351
|
+
{
|
|
352
|
+
"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)",
|
|
353
|
+
"hash": "989582e827c11847401acac06a0cd5922d8e1a2e",
|
|
354
|
+
"entry": 2
|
|
355
|
+
},
|
|
356
|
+
{
|
|
357
|
+
"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)",
|
|
358
|
+
"hash": "13a37aa75d729ac2149179527f3b00eec0f80a4e",
|
|
359
|
+
"entry": 1
|
|
360
|
+
},
|
|
361
|
+
{
|
|
362
|
+
"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)",
|
|
363
|
+
"hash": "00f754ca492fe002ee2e1209c2b709b6a88c832c",
|
|
364
|
+
"entry": 1
|
|
365
|
+
},
|
|
366
|
+
{
|
|
367
|
+
"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)",
|
|
368
|
+
"hash": "d2e4c808664af6d56deaff05e4b92b628e46b5f5",
|
|
369
|
+
"entry": 1
|
|
370
|
+
},
|
|
371
|
+
{
|
|
372
|
+
"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)",
|
|
373
|
+
"hash": "d2e4c808664af6d56deaff05e4b92b628e46b5f5",
|
|
374
|
+
"entry": 2
|
|
375
|
+
},
|
|
376
|
+
{
|
|
377
|
+
"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)",
|
|
378
|
+
"hash": "d2e4c808664af6d56deaff05e4b92b628e46b5f5",
|
|
379
|
+
"entry": 3
|
|
380
|
+
},
|
|
381
|
+
{
|
|
382
|
+
"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)",
|
|
383
|
+
"hash": "366eda24a1e21cece6fe71fd8574053e720a4ded",
|
|
384
|
+
"entry": 1
|
|
385
|
+
},
|
|
386
|
+
{
|
|
387
|
+
"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)",
|
|
388
|
+
"hash": "76a86b687a1853eeb3004535da128bc6e17e839f",
|
|
389
|
+
"entry": 1
|
|
390
|
+
},
|
|
391
|
+
{
|
|
392
|
+
"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)",
|
|
393
|
+
"hash": "13a8dc0a27360593b4f1d5bc0b3fe2cac2158c81",
|
|
394
|
+
"entry": 1
|
|
395
|
+
}
|
|
396
|
+
]
|
|
397
|
+
},
|
|
398
|
+
{
|
|
399
|
+
"title": "๐ Bug fixes",
|
|
400
|
+
"audience": "all",
|
|
401
|
+
"items": [
|
|
402
|
+
{
|
|
403
|
+
"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)",
|
|
404
|
+
"hash": "05a744df3c6188420203c7f3d5df232deade32b4",
|
|
405
|
+
"entry": 1
|
|
406
|
+
},
|
|
407
|
+
{
|
|
408
|
+
"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)",
|
|
409
|
+
"hash": "366eda24a1e21cece6fe71fd8574053e720a4ded",
|
|
410
|
+
"entry": 2
|
|
411
|
+
},
|
|
412
|
+
{
|
|
413
|
+
"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)",
|
|
414
|
+
"hash": "76a86b687a1853eeb3004535da128bc6e17e839f",
|
|
415
|
+
"entry": 2
|
|
416
|
+
}
|
|
417
|
+
]
|
|
418
|
+
},
|
|
419
|
+
{
|
|
420
|
+
"title": "โป๏ธ Refactoring",
|
|
421
|
+
"audience": "dev",
|
|
422
|
+
"items": [
|
|
423
|
+
{
|
|
424
|
+
"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)",
|
|
425
|
+
"hash": "13a37aa75d729ac2149179527f3b00eec0f80a4e",
|
|
426
|
+
"entry": 2
|
|
427
|
+
}
|
|
428
|
+
]
|
|
429
|
+
},
|
|
430
|
+
{
|
|
431
|
+
"title": "๐งช Tests",
|
|
432
|
+
"audience": "dev",
|
|
433
|
+
"items": [
|
|
434
|
+
{
|
|
435
|
+
"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)",
|
|
436
|
+
"hash": "2cbdf9075faf803153cf6f5048619ba77ec3cb4a",
|
|
437
|
+
"entry": 1
|
|
438
|
+
},
|
|
439
|
+
{
|
|
440
|
+
"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)",
|
|
441
|
+
"hash": "2cbdf9075faf803153cf6f5048619ba77ec3cb4a",
|
|
442
|
+
"entry": 2
|
|
443
|
+
}
|
|
444
|
+
]
|
|
445
|
+
}
|
|
446
|
+
]
|
|
447
|
+
},
|
|
2
448
|
{
|
|
3
449
|
"version": "0.6.0",
|
|
4
450
|
"date": "2026-11-09",
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,113 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
|
|
5
|
+
## 0.8.0 โ 2026-11-20
|
|
6
|
+
|
|
7
|
+
### ๐ Features
|
|
8
|
+
|
|
9
|
+
- Changes `review-branch` to reflow each comment line that the diff adds or modifies and that exceeds the `max_line_length` set by `.editorconfig`, commit the reflow with `create-commit`, and list it in a new "Applied reflows" section of the review, rather than report it as a finding; a review of a pull request, or of a file with uncommitted changes, still reports the line as a finding. (#196)
|
|
10
|
+
- Adds a width item to the diff-audit checklist used by `implement-plan`, `respond-to-review`, and `revise-comments`, which directs the agent to reflow each comment line in its own hunks that exceeds the `.editorconfig` `max_line_length`, changing only whitespace. (#196)
|
|
11
|
+
- Adds to the `recommended` collection the `cross-repo-migration-conventions` rulebook, which covers the umbrella ticket and its one child per repository, shared runtimes moved before the repositories that use them, contract changes decided before any child acts, and a comment on the umbrella that each child posts before merge. (#197)
|
|
12
|
+
- Adds to `williamthorsen-ticketing-preferences` a reference to `cross-repo-migration-conventions` for a change that migrates many repositories to a new version or convention. (#197)
|
|
13
|
+
- Adds a requirement to the `williamthorsen-ticketing-preferences` rulebook to estimate the layers, subsystems, and approximate source and test lines of work that spans several layers or adds a new subsystem before its ticket count is decided, and to recommend the split when each piece can be merged and verified on its own, and has the `design-and-plan` ticket checkpoint present that split as the recommended option of a menu. (#202)
|
|
14
|
+
- Directs `list-implementation-order` to pass the repository in which a ticket outside GitHub is implemented, through the helper's new `--external "[REPOSITORY:]KEY=Title"` form, which the helper uses to label that ticket with the repository's prefix, such as `mc.MAC-7`. (#206)
|
|
15
|
+
- Lower-cases the repository prefixes in the implementation-order list, such as `cg.12` in place of `CG.12`, to set them apart from an upper-case Jira key. (#206)
|
|
16
|
+
- Adds a durability check to `summarize-change` that rejects a lede, entry, or migration stating the change's delivery state in a main or subordinate clause, and adds a step that the change needs in order to take effect, such as a deploy or a sync, to the facts that `## Notes for reviewers` contains. (#207)
|
|
17
|
+
- Adds a convention to `create-ticket`, `design-and-plan`, and `align-ticket-with-implementation` that limits a code ticket's acceptance criteria to those that its pull request's tests, checks, or review can show to hold or fail at merge, and directs the agent to move a criterion that depends on elapsed time, deployed state, or a run against shared data to the ticket that consumes the change. (#208)
|
|
18
|
+
- Adds a criterion-settleability facet to the ticket evaluation used by `design-and-plan` and by the advisability dimension of `assess-ticket`, which reports each acceptance criterion of a code ticket that its pull request cannot show to hold or fail at merge, together with the ticket to which the criterion moves. (#208)
|
|
19
|
+
- Adds the `write-progress-report` skill, which writes a customer-facing progress report from a tracker or an `--items` file, with one section per workstream that states its health and lists the items that need the customer's input, are done, are in progress, or are planned. (#213)
|
|
20
|
+
- Adds `list-gh-progress-items`, which `write-progress-report` calls for `--source github` to read a repository's GitHub issues as report items, treating each parent issue as a workstream and each issue labeled `needs-input` as an ask of the customer. (#213)
|
|
21
|
+
- Adds `confluence` to the values of the `write-progress-report` skill's `--format` argument, which renders the report in Confluence storage format (the XML that Confluence stores as a page body), with health and statuses as status lozenges and dates as date elements that Confluence shows in the reader's locale. (#215)
|
|
22
|
+
- Adds `project_artifact_dir` (`{artifact_base_dir}/projects/{project_slug}`) and `ticket_dir` (`{project_artifact_dir}/tickets/{ticket_id}`, or `null` when the branch does not name a ticket) to the session-context manifest that `derive-session-context` emits. (#219)
|
|
23
|
+
- Changes `save-artifact` and every other skill that saves or reads artifacts to take the artifact directories from the manifest, with `save-artifact` stating the fallback for a `null` `ticket_dir`, which generates a ticket ID and saves under `{project_artifact_dir}/tickets/{generated id}`. (#219)
|
|
24
|
+
- Adds to the `recommended` collection the `visual-design-conventions` rulebook, which states the visual-design rules that hold whatever the style: padding inside a bordered or filled container, alignment with another block, marks only on the exception, colour as a way to tell kinds and states apart, an appearance that follows each element's role, the product's own name and favicon, and a browser check of each changed view. (#220)
|
|
25
|
+
- Adds to the `williamthorsen` collection the `williamthorsen-visual-design-preferences` rulebook, which prefers a quiet colour scheme, with muted hues on neutral surfaces that each encode a kind or a state, to a monochrome one. (#220)
|
|
26
|
+
- Adds `visual-design-conventions` beside `accessibility-conventions` to the floor that the planning, building, assessment, and review skills and the `usability-assessor` subagent set for an interface, including the rulebook's browser check of each changed view. (#220)
|
|
27
|
+
- Adds the "Consequence at the control" rule to `accessibility-conventions`, which requires the explanation of an action that cannot be undone to be visible at rest, allows a toggletip for one that can be undone, and never accepts a hover-only tooltip as the only explanation. (#221)
|
|
28
|
+
- Opens `accessibility-conventions` with a statement that its rules are floors, and directs agents to aim beyond them by following an established model, as the named-model rule describes. (#221)
|
|
29
|
+
- Extends the helper-text rule of `ui-copy-conventions` to say what an action's consequence explanation states, and counts that explanation toward the copy budget's one line of helper text. (#221)
|
|
30
|
+
- Adds the consequence-at-the-control rule to the skills and the subagent that list the accessibility rules that they apply, among them `review-criteria`, `prepare-prototype-brief`, and the `usability-assessor` per-screen checklist. (#221)
|
|
31
|
+
- Adds a `close` subcommand to `manage-jira-ticket.mjs`, which posts a Markdown body as a comment unless an existing comment opens with the body's first line, then transitions the work item to the status that the new `integrations.jira.done_status` preference names (default `Done`) unless its status category is already done. (#225)
|
|
32
|
+
- Extends the closing post of the spike skills and the close of the triage ticket in `triage-spike-findings` to Jira tickets through `manage-jira-ticket.mjs close`; the guidance previously named only `gh issue close`, which does not close a Jira ticket. (#225)
|
|
33
|
+
- Extends `triage-spike-findings` to run on Jira as well as GitHub, adding a `platform` field to the dispositions record so that the record accepts work item keys such as `PROJ-123`, and creating each Jira ticket under the triage ticket's parent in place of an umbrella. (#227)
|
|
34
|
+
- Makes `analyze-performance`, `assess-code-health`, `assess-usability`, and `investigate-spike` name `triage-spike-findings` as the next step only for a ticket on GitHub or Jira, and name the findings left for disposal by hand for a ticket on any other platform. (#227)
|
|
35
|
+
- Adds a rule to the `williamthorsen-ticketing-preferences` rulebook that splits adding a package to a monorepo into two tickets: an empty scaffold with its documentation and package references that passes the repository's checks on its own, and the package's functionality, blocked by the scaffold. (#229)
|
|
36
|
+
- Changes `create-commit` to record a scaffold that passes the repository's checks and is fully wired as a commit of its own, while a scaffold that a later change fills in still goes into that change. (#229)
|
|
37
|
+
- Requires in the `visual-design-conventions` rulebook that text and elements within a block be start-aligned and a column of numbers end-aligned, limits centring to a viewport-centred dialog, a single-line label in a button or a tag, and an icon in a square control, and adds a matching item to the rulebook's browser check. (#231)
|
|
38
|
+
- Adds the `--umbrella` flag to `create-ticket`, which on Jira creates the ticket at the issue type that the new `integrations.jira.umbrella_issue_type` preference sets, `Epic` by default, so that Jira accepts it as the parent of its child tickets. (#232)
|
|
39
|
+
|
|
40
|
+
### ๐ Bug fixes
|
|
41
|
+
|
|
42
|
+
- Fixes the issue that `assess-ticket` prescribed a plain numbered list of next-step actions, which the ambient option format overrode on every run, by including the shared option format and marking each action at the strength that the evidence behind its verdict supports. (#193)
|
|
43
|
+
- Fixes the issue that `condense-branch` left uncommitted changes in a stash shared by every worktree of the repository, or folded them into the condensed commit through `git add --all` when the stash was skipped. (#195)
|
|
44
|
+
- Fixes the issue that `review-pr` passed its session-context values only to `review-branch`'s steps 4โ9, which left out the step that saves the review. (#196)
|
|
45
|
+
- Fixes the issue that `list-implementation-order` listed an umbrella ticket, one that has sub-issues, as a ticket to implement, although its children do its work. (#199)
|
|
46
|
+
- Fixes the issue that `entry-drafter` could write a change's delivery state, such as "takes effect once deployed", into the lede or an entry, which the merge commit keeps after the statement becomes false. (#207)
|
|
47
|
+
- Fixes the issue that `williamthorsen-workflow-preferences` did not stop a session from creating a branch, a worktree, or commits in a repository or ticket other than its own, and that its cross-repo sequencing rule told the session to make the upstream change itself. (#214)
|
|
48
|
+
- Fixes the issue that `create-ticket` reversed a Jira blocked-by link by putting the blocker in the `--out` option of `acli jira workitem link create`, when `--in` is the option that names the blocker. (#227)
|
|
49
|
+
- Fixes the issue that `triage-spike-findings` did not create an umbrella on Jira and parented each new ticket to the triage ticket's parent, by having it create the umbrella on Jira as on GitHub and parent each child ticket to it. (#232)
|
|
50
|
+
- Fixes the issue that `create-ticket` gave a Jira child of a level-0 parent, such as a `Task`, the child's own issue type, which Jira rejects under that parent, and makes `create-ticket` create the child as a subtask at the type that the new `integrations.jira.subtask_issue_type` setting declares (`Subtask` by default). (#233)
|
|
51
|
+
|
|
52
|
+
### โก Performance
|
|
53
|
+
|
|
54
|
+
- Cuts about 110 words from the shared `AGENTS.md` and the plain-speech partial, both loaded into every session, by removing a redundant example, a sentence of rationale, a repeated repair, and three sentences that describe skills or tickets without directing the agent. (#190)
|
|
55
|
+
- Cuts the prompt-formatting rules that the option-format and action-items guidance already states from the ambient `williamthorsen-collaboration-preferences` rulebook, which shrinks from 11,919 to 6,031 bytes in every session that loads it. (#191)
|
|
56
|
+
- Removes the note "(Reinforces the rule in `AGENTS.md`: intentional redundancy.)" from the option-format directive in the skills that link to the option format, because the rulebook no longer states that rule. (#191)
|
|
57
|
+
- Cuts the `williamthorsen-writing-preferences` rulebook from 9,234 to 7,246 bytes by moving three rarely needed reduced-object-relative cases into `skills/_data/reduced-object-relatives.md`, which the rule links to, and by removing passages that the remaining rules already direct. (#192)
|
|
58
|
+
|
|
59
|
+
### โป๏ธ Refactoring
|
|
60
|
+
|
|
61
|
+
- Replaces the inline `error instanceof Error ? error.message : String(error)` expression in the guidance helpers with `describeError` from `@williamthorsen/toolbelt.errors`, and moves the error report of the `codeassembly-validate-preferences` bin into a new `runValidatePreferencesCommand` function, which the bin and the helper's entry point both call. (#201)
|
|
62
|
+
|
|
63
|
+
### โ๏ธ Tooling
|
|
64
|
+
|
|
65
|
+
- Regenerates the tracked `revise-prose.mjs` bundle from its current source, a rebuild that changes only identifiers renamed by the minifier. (#219)
|
|
66
|
+
|
|
67
|
+
## 0.7.0 โ 2026-11-14
|
|
68
|
+
|
|
69
|
+
### ๐ Features
|
|
70
|
+
|
|
71
|
+
- 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)
|
|
72
|
+
- 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)
|
|
73
|
+
- Adds the `--confirm` option to `merge-pr`, which shows the approval gate for one run when `merge.approval` is `auto`. (#147)
|
|
74
|
+
- 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)
|
|
75
|
+
- Adds `exploration` as a `project.maturity` value, below `hobby`, for work whose output is still taking shape and that nothing depends on yet. (#150)
|
|
76
|
+
- 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)
|
|
77
|
+
- 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)
|
|
78
|
+
- 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)
|
|
79
|
+
- 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)
|
|
80
|
+
- 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)
|
|
81
|
+
- 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)
|
|
82
|
+
- 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)
|
|
83
|
+
- 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)
|
|
84
|
+
- 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)
|
|
85
|
+
- 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)
|
|
86
|
+
- 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
|
+
- 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)
|
|
88
|
+
- 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)
|
|
89
|
+
- 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)
|
|
90
|
+
- 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)
|
|
91
|
+
- 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)
|
|
92
|
+
- 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)
|
|
93
|
+
- 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)
|
|
94
|
+
- 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)
|
|
95
|
+
- 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)
|
|
96
|
+
|
|
97
|
+
### ๐ Bug fixes
|
|
98
|
+
|
|
99
|
+
- 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)
|
|
100
|
+
- 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)
|
|
101
|
+
- 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)
|
|
102
|
+
|
|
103
|
+
### โป๏ธ Refactoring
|
|
104
|
+
|
|
105
|
+
- 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)
|
|
106
|
+
|
|
107
|
+
### ๐งช Tests
|
|
108
|
+
|
|
109
|
+
- 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)
|
|
110
|
+
- 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)
|
|
111
|
+
|
|
5
112
|
## 0.6.0 โ 2026-11-09
|
|
6
113
|
|
|
7
114
|
### ๐ Features
|