codeassembly-guidance 0.1.0 โ 0.3.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 +984 -0
- package/CHANGELOG.md +240 -0
- package/README.md +45 -99
- package/bin/codeassembly-validate-preferences.js +18 -0
- package/content/_partials/README.md +21 -5
- package/content/_partials/comment-discipline.md +1 -1
- package/content/_partials/diff-audit-checklist.md +1 -0
- package/content/_partials/kb-standard-tags.md +7 -0
- package/content/_partials/plain-speech-calibration.md +4 -0
- package/content/_partials/technical-recommendations.md +1 -0
- package/content/codeassembly-content.yaml +17 -1
- package/content/collections/all.md +2 -2
- package/content/collections/atlassian.md +2 -1
- package/content/collections/recommended.md +9 -2
- package/content/collections/triage.md +3 -67
- package/content/collections/williamthorsen.md +2 -1
- package/content/guidance/README.md +1 -1
- package/content/guidance/rulebooks/accessibility-conventions.md +23 -5
- package/content/guidance/rulebooks/cli-conventions.md +206 -0
- package/content/guidance/rulebooks/codeassembly-content-specification.md +50 -10
- package/content/guidance/rulebooks/commit-conventions.md +5 -4
- package/content/guidance/rulebooks/live-worktree-policy.md +3 -2
- package/content/guidance/rulebooks/readme-conventions.md +3 -3
- package/content/guidance/rulebooks/shared-data-conventions.md +2 -2
- package/content/guidance/rulebooks/shell-conventions.md +17 -23
- package/content/guidance/rulebooks/ui-copy-conventions.md +34 -0
- package/content/guidance/rulebooks/williamthorsen-collaboration-preferences.md +18 -12
- package/content/guidance/rulebooks/williamthorsen-ticketing-preferences.md +3 -3
- package/content/guidance/rulebooks/williamthorsen-tooling-preferences.md +6 -6
- package/content/guidance/rulebooks/williamthorsen-typescript-preferences.md +1 -1
- package/content/guidance/rulebooks/williamthorsen-workflow-preferences.md +7 -7
- package/content/guidance/rulebooks/williamthorsen-writing-preferences.md +28 -1
- package/content/guidance/shared/AGENTS.md +39 -4
- package/content/scripts/README.md +5 -2
- package/content/scripts/check-branch-currency.mjs +11 -0
- package/content/scripts/check-prose.mjs +171 -0
- package/content/scripts/describe-change.mjs +98 -98
- package/content/scripts/manage-jira-ticket.mjs +99 -94
- package/content/scripts/resolve-frontmatter.sh +1 -1
- package/content/scripts/resolve-review-run.mjs +9 -9
- package/content/scripts/select-lede-exemplars.mjs +87 -87
- package/content/scripts/validate-preferences.mjs +146 -0
- package/content/skills/_data/action-items.md +2 -0
- package/content/skills/_data/artifact-conventions.md +64 -16
- package/content/skills/_data/branch-currency.md +36 -0
- package/content/skills/_data/change-record.md +2 -2
- package/content/skills/_data/complexity-classification.md +1 -1
- package/content/skills/_data/design-priorities.md +15 -4
- package/content/skills/_data/project-stage.md +32 -0
- package/content/skills/_data/recommendation-gradient.md +9 -7
- package/content/skills/_data/scope-and-deferral.md +1 -1
- package/content/skills/_data/spike-conventions.md +21 -6
- package/content/skills/_data/ticket-evaluation.md +2 -2
- package/content/skills/_data/ticket-source-resolution.md +36 -3
- package/content/skills/_data/title-templates.md +22 -12
- package/content/skills/_partials/action-items.md +2 -2
- package/content/skills/_partials/apply-guidance-edits.md +5 -0
- package/content/skills/_partials/commit-title-rendering.md +1 -1
- package/content/skills/_partials/jira-task-list-flattening.md +1 -0
- package/content/skills/_partials/next-steps-after-plan.md +11 -11
- package/content/skills/_partials/option-format.md +18 -17
- package/content/skills/_partials/plan-template.md +7 -5
- package/content/skills/_partials/split-ticket-compose.md +1 -1
- package/content/skills/_partials/split-ticket-create.md +1 -1
- package/content/skills/_partials/ticket-and-plan-completeness.md +2 -2
- package/content/skills/_partials/ticket-composition.md +40 -0
- package/content/skills/_partials/ticket-criteria-conventions.md +3 -3
- package/content/skills/_partials/ticket-skeleton.md +15 -1
- package/content/skills/add-change-record/SKILL.md +2 -2
- package/content/skills/align-ticket-with-implementation/SKILL.md +3 -7
- package/content/skills/anti-patterns/SKILL.md +1 -1
- package/content/skills/assess-code-health/SKILL.md +127 -0
- package/content/skills/assess-code-health/assess-code-health.mjs +77 -0
- package/content/skills/assess-usability/SKILL.md +98 -0
- package/content/skills/capture-event/SKILL.md +4 -2
- package/content/skills/capture-event/capture-event.mjs +89 -89
- package/content/skills/capture-feedback/SKILL.md +1 -1
- package/content/skills/capture-lede-decision/SKILL.md +4 -4
- package/content/skills/capture-lede-decision/capture-lede-decision.mjs +98 -98
- package/content/skills/collaborate/SKILL.md +3 -3
- package/content/skills/create-bitbucket-pr/SKILL.md +2 -1
- package/content/skills/create-commit/SKILL.md +1 -1
- package/content/skills/create-gh-pr/SKILL.md +28 -10
- package/content/skills/create-pr/SKILL.md +7 -6
- package/content/skills/create-ticket/SKILL.md +64 -23
- package/content/skills/create-ticket/resolve-ticket-target.mjs +143 -0
- package/content/skills/derive-session-context/derive-session-context.mjs +83 -82
- package/content/skills/design-and-plan/SKILL.md +17 -18
- package/content/skills/groom-backlog/SKILL.md +8 -6
- package/content/skills/groom-backlog/groom-backlog.mjs +64 -62
- package/content/skills/implement-plan/SKILL.md +27 -23
- package/content/skills/index-prototypes/SKILL.md +86 -31
- package/content/skills/index-prototypes/index-prototypes.mjs +76 -16
- package/content/skills/kb-add/SKILL.md +4 -1
- package/content/skills/kb-add/kb-add.mjs +128 -128
- package/content/skills/kb-curate/SKILL.md +9 -7
- package/content/skills/kb-curate/kb-curate.mjs +103 -103
- package/content/skills/kb-edit/SKILL.md +5 -3
- package/content/skills/kb-edit/kb-edit.mjs +94 -94
- package/content/skills/kb-retrieve/kb-retrieve.mjs +86 -85
- package/content/skills/kb-retrieve-events/SKILL.md +20 -11
- package/content/skills/kb-retrieve-events/kb-retrieve-events.mjs +86 -85
- package/content/skills/kb-update-events/SKILL.md +10 -7
- package/content/skills/kb-update-events/kb-update-events.mjs +110 -109
- package/content/skills/lesson-clusters/lesson-clusters.mjs +209 -0
- package/content/skills/merge-bb-pr/SKILL.md +1 -1
- package/content/skills/merge-gh-pr/merge-gh-pr.mjs +5 -5
- package/content/skills/merge-pr/SKILL.md +11 -11
- package/content/skills/migrate-feedback-memories/SKILL.md +3 -2
- package/content/skills/migrate-feedback-memories/feedback-memories.mjs +76 -76
- package/content/skills/plan/SKILL.md +2 -2
- package/content/skills/prepare-prototype-brief/SKILL.md +66 -14
- package/content/skills/pull-from-backlog/SKILL.md +3 -3
- package/content/skills/pull-from-backlog/pull-from-backlog.mjs +83 -82
- package/content/skills/refine-guidance/SKILL.md +97 -0
- package/content/skills/refine-plan/SKILL.md +7 -3
- package/content/skills/refine-prototype/SKILL.md +113 -0
- package/content/skills/respond-to-review/SKILL.md +1 -1
- package/content/skills/review-bb-pr/SKILL.md +1 -1
- package/content/skills/review-branch/SKILL.md +354 -3
- package/content/skills/review-criteria/SKILL.md +36 -3
- package/content/skills/review-gh-pr/select-pr-ticket.mjs +6 -6
- package/content/skills/revise-comments/SKILL.md +38 -5
- package/content/skills/revise-prose/SKILL.md +1 -1
- package/content/skills/revise-prose/revise-prose.mjs +119 -119
- package/content/skills/save-artifact/SKILL.md +3 -1
- package/content/skills/streamline-guidance/SKILL.md +11 -16
- package/content/skills/streamline-guidance/streamline-guidance.mjs +86 -86
- package/content/skills/summarize-change/SKILL.md +23 -14
- package/content/skills/testing-conventions/SKILL.md +81 -8
- package/content/skills/triage-feedback/SKILL.md +150 -0
- package/content/skills/triage-feedback/triage-feedback.mjs +70 -0
- package/content/skills/triage-spike-findings/SKILL.md +113 -0
- package/content/skills/triage-spike-findings/triage-spike-findings.mjs +73 -0
- package/content/skills/typescript-testing-conventions/SKILL.md +50 -1
- package/content/skills/update-jira-ticket/SKILL.md +20 -8
- package/content/skills/update-jira-ticket/update-jira-ticket.mjs +7 -7
- package/content/skills/update-project-guidance/SKILL.md +12 -12
- package/content/subagents/_data/claude.yaml +6 -0
- package/content/subagents/_data/rovo.yaml +12 -2
- package/content/subagents/canary.md +2 -1
- package/content/subagents/code-health-assessor.md +98 -0
- package/content/subagents/disposition-challenger.md +78 -0
- package/content/subagents/entry-drafter.md +14 -10
- package/content/subagents/feedback-triage-challenger.md +81 -0
- package/content/subagents/handoff-reviewer.md +2 -2
- package/content/subagents/lesson-clusterer.md +68 -0
- package/content/subagents/plan-reviewer.md +1 -1
- package/content/subagents/prose-reviser.md +4 -2
- package/content/subagents/ticket-assessor.md +9 -6
- package/content/subagents/usability-assessor.md +157 -0
- package/package.json +21 -17
- package/schemas/preferences.v1.json +50 -7
- package/schemas/work-types.v1.json +1 -1
- package/content/_partials/code-descriptions.md +0 -4
- package/content/_partials/code-style.md +0 -7
- package/content/_partials/live-repo-writes.md +0 -13
- package/content/_partials/reduced-object-relative.md +0 -28
- package/content/_partials/test-structure-audit-checklist.md +0 -7
- package/content/skills/_partials/acceptance-criteria-scaffold.md +0 -15
- package/content/skills/_partials/next-steps-after-review.md +0 -350
- package/content/skills/_partials/ticket-concision.md +0 -18
- package/content/skills/_partials/ticket-placement.md +0 -14
- package/content/skills/_partials/ticket-skeleton-tiers.md +0 -6
- package/content/skills/testing-conventions/mistakes.md +0 -1
package/.meta/changelog.json
CHANGED
|
@@ -1,4 +1,982 @@
|
|
|
1
1
|
[
|
|
2
|
+
{
|
|
3
|
+
"version": "0.3.0",
|
|
4
|
+
"date": "2026-11-01",
|
|
5
|
+
"sections": [
|
|
6
|
+
{
|
|
7
|
+
"title": "๐ Features",
|
|
8
|
+
"audience": "all",
|
|
9
|
+
"items": [
|
|
10
|
+
{
|
|
11
|
+
"description": "Adds a \"Who applies the change\" section to `design-priorities.md`, which ranks a design that the agent applies and verifies itself above one that needs a person to run a step on each machine, orders three ways to shape a step that stays (reach the machine through its existing access, route the step through its existing provisioning, or leave one self-checking script per machine), and is cited by `design-and-plan` and `plan` when they rank approaches. (#2175)",
|
|
12
|
+
"hash": "ce936e76d019c1eeba400a8a191e05600a4f0c3b",
|
|
13
|
+
"entry": 1
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
"description": "Changes the plan template's `**Residue:**` rule so that a step that a person must run on each machine is written as one script per machine that checks its own result, and so that a record of the work, such as a log entry or a ticket comment, is never residue, which `implement-plan` also states. (#2175)",
|
|
17
|
+
"hash": "ce936e76d019c1eeba400a8a191e05600a4f0c3b",
|
|
18
|
+
"entry": 2
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"description": "Adds a rule to the `williamthorsen-collaboration-preferences` rulebook and the `collaborate` skill that directs the agent to answer a question from the developer rather than hand over a procedure to run, to run any check that the answer needs, and to count the commands that it hands over across the session. (#2175)",
|
|
22
|
+
"hash": "ce936e76d019c1eeba400a8a191e05600a4f0c3b",
|
|
23
|
+
"entry": 3
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"description": "Adds a rule to the `williamthorsen-collaboration-preferences` rulebook that directs the agent, once the developer signals overload, to stop adding asks and to end each turn without an action-items block until the developer asks for something, and points `action-items.md` and the `collaborate` skill to it. (#2175)",
|
|
27
|
+
"hash": "ce936e76d019c1eeba400a8a191e05600a4f0c3b",
|
|
28
|
+
"entry": 4
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"description": "Adds a \"Check results\" section to the `cli-conventions` rulebook, which requires a `check` or `verify` mode, a health probe, or a pre-flight to state on each item's line what it checked and the state that it found, to show a failure's evidence (a diff or the actual state) without `--verbose`, and to probe end to end the function that a configuration-only check serves. (#2178)",
|
|
32
|
+
"hash": "50524b6f50c43baf9a9831d84c6db40e3039e139",
|
|
33
|
+
"entry": 1
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"description": "Adds a \"Documentation placement\" section to the shared `AGENTS.md` guidance, which directs an agent that writes a guidance or documentation file to point to the config, code, README section, or rulebook that defines a fact and to add only what that source does not state. (#2181)",
|
|
37
|
+
"hash": "ca4381616aa1f033c4ff84dd0ceba58b39dbf6eb",
|
|
38
|
+
"entry": 1
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"description": "Directs the plan template used by `plan` and `design-and-plan` to name, in the key decisions of each task that writes guidance or documentation, the source that defines each documented fact. (#2181)",
|
|
42
|
+
"hash": "ca4381616aa1f033c4ff84dd0ceba58b39dbf6eb",
|
|
43
|
+
"entry": 2
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"description": "Adds a placement item to the diff audit run by `implement-plan`, `respond-to-review`, and `revise-comments`, which checks that each guidance or documentation hunk points to a fact's source rather than copying the fact. (#2181)",
|
|
47
|
+
"hash": "ca4381616aa1f033c4ff84dd0ceba58b39dbf6eb",
|
|
48
|
+
"entry": 3
|
|
49
|
+
},
|
|
50
|
+
{
|
|
51
|
+
"description": "Extends the duplication check in `update-project-guidance` from the global guidance file to rulebooks loaded into the session and to repository files, so that the skill omits what loaded guidance already states and points to a repository file that defines a fact. (#2181)",
|
|
52
|
+
"hash": "ca4381616aa1f033c4ff84dd0ceba58b39dbf6eb",
|
|
53
|
+
"entry": 4
|
|
54
|
+
},
|
|
55
|
+
{
|
|
56
|
+
"description": "Changes the marker that the `williamthorsen-collaboration-preferences` rulebook and the plan and option-format templates prescribe for a decision awaiting the developer's checkpoint from โณ to ๐ฒ, an unchecked box that reads as an item still to approve rather than as work in progress. (#2185)",
|
|
57
|
+
"hash": "9e34f69741792807f5a2e96fa14e0859afe0fea6",
|
|
58
|
+
"entry": 1
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
"description": "Adds a `defects` field to the JSON output of `consolidate-entries`, which lists each entry whose breaking marker violates its type's policy or whose type the taxonomy does not declare, naming the entry by its 0-based index with the same `policy-violation` and `undeclared-type` kinds that `resolve-merge` reports. (#2186)",
|
|
62
|
+
"hash": "619b29d634352c19777eb04639d328f52ad7c1e3",
|
|
63
|
+
"entry": 1
|
|
64
|
+
},
|
|
65
|
+
{
|
|
66
|
+
"description": "Directs `summarize-change` to report each entry defect that `consolidate-entries` returns, naming the entry by its `text`, and to continue without changing anything. (#2186)",
|
|
67
|
+
"hash": "619b29d634352c19777eb04639d328f52ad7c1e3",
|
|
68
|
+
"entry": 2
|
|
69
|
+
},
|
|
70
|
+
{
|
|
71
|
+
"description": "Adds the closing post to `spike-conventions.md`, a ticket comment that contains the answers to the ticket's questions, the recommendations on its decisions, and links to the findings artifact and, when the spike published one, to its page, and names the post in the deliverables of the spike ticket and plan templates. (#2196)",
|
|
72
|
+
"hash": "d3ecb9b8b52ee6e8fc358d596a7c8caf3911769a",
|
|
73
|
+
"entry": 1
|
|
74
|
+
},
|
|
75
|
+
{
|
|
76
|
+
"description": "Adds an offer of the closing post to the action-items block of the `assess-usability` report step, and replaces the skill's statement that it writes nothing remote with one that names this post, made on consent, as its one remote write. (#2196)",
|
|
77
|
+
"hash": "d3ecb9b8b52ee6e8fc358d596a7c8caf3911769a",
|
|
78
|
+
"entry": 2
|
|
79
|
+
},
|
|
80
|
+
{
|
|
81
|
+
"description": "Extends the ๐ฌ Investigate option for a spike plan, shown in the next-steps menu of `design-and-plan`, `plan`, `refine-plan`, and `save-plan`, to end the run with the plan's `## Deliverable`, which includes the offer of the closing post. (#2196)",
|
|
82
|
+
"hash": "d3ecb9b8b52ee6e8fc358d596a7c8caf3911769a",
|
|
83
|
+
"entry": 3
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
"description": "Adds a rule to `artifact-conventions.md` that a conclusion needed by a reader of the ticket is posted on the ticket, while the artifact keeps the evidence. (#2196)",
|
|
87
|
+
"hash": "d3ecb9b8b52ee6e8fc358d596a7c8caf3911769a",
|
|
88
|
+
"entry": 4
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
"description": "Adds the `pr.initial_state` preference (`draft` or `ready`, default `draft`), which `create-pr` reads from the project or global preferences file to open a pull request as a draft or ready for review, and makes `pr.title_format` optional so that a `pr` section can set only the state. (#2198)",
|
|
92
|
+
"hash": "bd2088a0b09c9767138ab1226ba684a666f3a9ca",
|
|
93
|
+
"entry": 1
|
|
94
|
+
},
|
|
95
|
+
{
|
|
96
|
+
"description": "Adds the `--add-tag` operation to `kb-update-events`, which appends the given tags, canonicalized through the store's alias map, to each named event's tags and leaves an event that already has all of them untouched, unlike `--retag`, which replaces the whole set. (#2208)",
|
|
97
|
+
"hash": "420d2b3f78bc56293cef181579b94fafcfed5197",
|
|
98
|
+
"entry": 1
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"description": "Adds `--help` to the `kb-update-events` helper, which prints usage describing every operation and exits without updating any event. (#2208)",
|
|
102
|
+
"hash": "420d2b3f78bc56293cef181579b94fafcfed5197",
|
|
103
|
+
"entry": 2
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
"description": "Adds an `--exclude-tag` flag to `kb-retrieve-events` that takes a comma-separated list of tags, matched in canonical or alias form, and drops every event that has any of them; a repeated flag adds to the list. (#2209)",
|
|
107
|
+
"hash": "0c30f1befb520f3698d7016e092e3680b479e4e3",
|
|
108
|
+
"entry": 1
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
"description": "Adds a \"Standard tags\" section, generated from `STANDARD_TAGS`, to the skills that write or filter knowledge-base tags, such as `capture-event` and `kb-update-events`, which directs the agent to tag a record's disposition by a standard name rather than a variant spelling. (#2212)",
|
|
112
|
+
"hash": "2c1413e55ca6061c6133c6ed74ddcae6809923e6",
|
|
113
|
+
"entry": 2
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
"description": "Adds an optional `evidence` field (a stable `key` and the `paths` that it covers) to each item of the `triage-spike-findings` record and an optional `commit` field to the record, which `validate` requires once any item has evidence, and adds to the end of the dispositions comment a hidden, versioned JSON block that the exported `parseEvidenceBlock` function reads back. (#2213)",
|
|
117
|
+
"hash": "03cb1f7b2538d8bf0c9c43824a68c4b1f4ae6d7a",
|
|
118
|
+
"entry": 1
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
"description": "Has the `triage-spike-findings` skill copy each item's evidence key and paths from the findings into the inventory and the record, and set the record's `commit` to the HEAD at which the developer approved the dispositions. (#2213)",
|
|
122
|
+
"hash": "03cb1f7b2538d8bf0c9c43824a68c4b1f4ae6d7a",
|
|
123
|
+
"entry": 2
|
|
124
|
+
},
|
|
125
|
+
{
|
|
126
|
+
"description": "Adds the `assess-code-health` skill, which measures git hotspots and test coverage for one package or subtree, dispatches five `code-health-assessor` subagents (conventions, structure, extraction, error handling, and tests), and ranks the proposals whose cited evidence resolves against the tree in a `code-health-findings` artifact that `triage-spike-findings` now accepts as input. (#2216)",
|
|
127
|
+
"hash": "45388be8981d097f6851d70c99212c27a4497b87",
|
|
128
|
+
"entry": 1
|
|
129
|
+
},
|
|
130
|
+
{
|
|
131
|
+
"description": "Adds the `triage-feedback` skill, which groups the open events of a feedback store by lesson, shows the top `--limit` clusters with each one's recurrence, impact, and latest capture, has a subagent without session context challenge every priority, and after one approval files a ticket, comments on an open issue that already covers the lesson, defers the cluster, or changes its impact rating. (#2217)",
|
|
132
|
+
"hash": "fe3c3febce8753d879729b34a2cbce26d245cb06",
|
|
133
|
+
"entry": 1
|
|
134
|
+
},
|
|
135
|
+
{
|
|
136
|
+
"description": "Adds the `triage_feedback.defer_days` preference, which sets the number of days for which `triage-feedback` leaves a deferred cluster out of a triage unless the cluster gains a new event, 30 by default. (#2217)",
|
|
137
|
+
"hash": "fe3c3febce8753d879729b34a2cbce26d245cb06",
|
|
138
|
+
"entry": 2
|
|
139
|
+
},
|
|
140
|
+
{
|
|
141
|
+
"description": "Adds the `refine-guidance` skill, which finds the rule that already states a lesson or places a new artifact, drafts the edits for approval, opens a pull request, and marks the lesson's feedback events as addressed by it. (#2227)",
|
|
142
|
+
"hash": "255356fab78972974cd632ee3f7b373e699382e0",
|
|
143
|
+
"entry": 1
|
|
144
|
+
},
|
|
145
|
+
{
|
|
146
|
+
"description": "Adds a \"Choosing a kind\" section to the `codeassembly-content-specification` rulebook, which states the kind of artifact and the content root in which a lesson belongs, and when to change an existing rule rather than add a parallel one. (#2227)",
|
|
147
|
+
"hash": "255356fab78972974cd632ee3f7b373e699382e0",
|
|
148
|
+
"entry": 2
|
|
149
|
+
}
|
|
150
|
+
]
|
|
151
|
+
},
|
|
152
|
+
{
|
|
153
|
+
"title": "๐ Bug fixes",
|
|
154
|
+
"audience": "all",
|
|
155
|
+
"items": [
|
|
156
|
+
{
|
|
157
|
+
"description": "Fixes the issue that the commit guidance did not say which source sets a commit title's format, by stating in `commit-conventions` that `commit.title_format` alone sets it and by directing agents in `create-commit` and the shared `AGENTS.md` not to change a rendered title to match other commits or comment on whether it contains a ticket reference. (#2172)",
|
|
158
|
+
"hash": "31c4f2f65fe8bc6b739c8e4ed5a355f8fa961e6f",
|
|
159
|
+
"entry": 1
|
|
160
|
+
},
|
|
161
|
+
{
|
|
162
|
+
"description": "Fixes the issue that `create-commit` and `condense-branch` did not give agents a title to use when `commit.title_format` is empty or unset and the renderer printed an empty title; both now fall back to the bare title. (#2172)",
|
|
163
|
+
"hash": "31c4f2f65fe8bc6b739c8e4ed5a355f8fa961e6f",
|
|
164
|
+
"entry": 2
|
|
165
|
+
},
|
|
166
|
+
{
|
|
167
|
+
"description": "Fixes the issue that `index-prototypes` had the agent ask the developer to run `chrome-debug`, which is no longer installed, on a refused Playwright connection, rather than run `thor-chrome` itself and ask only when `thor-chrome` refuses the launch with `session-unavailable`. (#2192)",
|
|
168
|
+
"hash": "648c64452d4fb11077e30427c3b18a1eb9e001f2",
|
|
169
|
+
"entry": 1
|
|
170
|
+
},
|
|
171
|
+
{
|
|
172
|
+
"description": "Fixes the issue that a section in the project `.agents/preferences.yaml` hid every global key of the same section, such as a `ticket.base_url` set only in `~/.agents/preferences.yaml`, which made `derive-session-context` report `ticket_base_url: null` and leave a Jira ticket ID without a URL. (#2199)",
|
|
173
|
+
"hash": "01f8ae785329378a0efa269b8d2561c265027291",
|
|
174
|
+
"entry": 1
|
|
175
|
+
},
|
|
176
|
+
{
|
|
177
|
+
"description": "Fixes the issue that the `--tag` filter of `kb-retrieve` and `kb-retrieve-events` compared tags literally and missed a note tagged with an alias of the requested tag, although both skills document a match on the canonical or alias form. (#2209)",
|
|
178
|
+
"hash": "0c30f1befb520f3698d7016e092e3680b479e4e3",
|
|
179
|
+
"entry": 2
|
|
180
|
+
}
|
|
181
|
+
]
|
|
182
|
+
},
|
|
183
|
+
{
|
|
184
|
+
"title": "๐๏ธ Internal features",
|
|
185
|
+
"audience": "dev",
|
|
186
|
+
"items": [
|
|
187
|
+
{
|
|
188
|
+
"description": "Adds a section to `_partials/README.md` that states when content becomes a partial and when partials merge, and adds `partial-consumers.unit.test.ts`, which fails when fewer than two files include a partial or when partials with the same includers are neither merged nor listed in that section. (#2183)",
|
|
189
|
+
"hash": "c6375bb111421af6e711323427be379169710dca",
|
|
190
|
+
"entry": 2
|
|
191
|
+
}
|
|
192
|
+
]
|
|
193
|
+
},
|
|
194
|
+
{
|
|
195
|
+
"title": "โป๏ธ Refactoring",
|
|
196
|
+
"audience": "dev",
|
|
197
|
+
"items": [
|
|
198
|
+
{
|
|
199
|
+
"description": "Inlines the partials that only one file includes into that file, and merges the five ticket partials into `ticket-skeleton` and `ticket-composition`. (#2183)",
|
|
200
|
+
"hash": "c6375bb111421af6e711323427be379169710dca",
|
|
201
|
+
"entry": 1
|
|
202
|
+
}
|
|
203
|
+
]
|
|
204
|
+
},
|
|
205
|
+
{
|
|
206
|
+
"title": "๐งช Tests",
|
|
207
|
+
"audience": "dev",
|
|
208
|
+
"items": [
|
|
209
|
+
{
|
|
210
|
+
"description": "Replaces six per-doctrine reach test files with `doctrine-reach.unit.test.ts`, which runs the same checks for each entry in the `DOCTRINE_REACH` table in `test-utils/doctrine-reach.ts`. (#2183)",
|
|
211
|
+
"hash": "c6375bb111421af6e711323427be379169710dca",
|
|
212
|
+
"entry": 3
|
|
213
|
+
}
|
|
214
|
+
]
|
|
215
|
+
},
|
|
216
|
+
{
|
|
217
|
+
"title": "๐ฆ Dependencies",
|
|
218
|
+
"audience": "dev",
|
|
219
|
+
"items": [
|
|
220
|
+
{
|
|
221
|
+
"description": "Move the test runner to Vitest 5 (#2193)",
|
|
222
|
+
"body": "Upgrades `vitest` and `@vitest/coverage-v8` from v4 to 5.0.5, and lowers from 7 days to pnpm's 24-hour `minimumReleaseAge` the age at which `nmr upgrade` proposes a third-party release.",
|
|
223
|
+
"hash": "15fb4f9908aaf7da9e1552e6a2a9cd626ee3daa2"
|
|
224
|
+
}
|
|
225
|
+
]
|
|
226
|
+
}
|
|
227
|
+
]
|
|
228
|
+
},
|
|
229
|
+
{
|
|
230
|
+
"version": "0.2.0",
|
|
231
|
+
"date": "2026-10-23",
|
|
232
|
+
"sections": [
|
|
233
|
+
{
|
|
234
|
+
"title": "๐ Features",
|
|
235
|
+
"audience": "all",
|
|
236
|
+
"items": [
|
|
237
|
+
{
|
|
238
|
+
"description": "Replaces the list of ideas to adopt in the `comparison` artifact written by `prepare-prototype-brief` with an idea table that lists every distinctive idea of the round, those of rejected and losing prototypes included, with the prototypes that have it and the requirement that it answers. (#2027)",
|
|
239
|
+
"hash": "b0f7d13ce779d98288bdfaf5e48ba9483a3a80fa",
|
|
240
|
+
"entry": 1
|
|
241
|
+
},
|
|
242
|
+
{
|
|
243
|
+
"description": "Adds a step to `prepare-prototype-brief`, reached also from the verdict read-back of `index-prototypes`, which takes the developer through a keep, adapt, defer, or drop decision on each row of the idea table, accepts new ideas that the developer states while judging, and saves the result as a ticket-level `idea-decisions` artifact. (#2027)",
|
|
244
|
+
"hash": "b0f7d13ce779d98288bdfaf5e48ba9483a3a80fa",
|
|
245
|
+
"entry": 2
|
|
246
|
+
},
|
|
247
|
+
{
|
|
248
|
+
"description": "Requires, in the product-development stages of the `williamthorsen-workflow-preferences` rulebook, a decision on every prototype idea before the end vision, which cites the `idea-decisions` artifact, and a record of each decision in the design doc. (#2027)",
|
|
249
|
+
"hash": "b0f7d13ce779d98288bdfaf5e48ba9483a3a80fa",
|
|
250
|
+
"entry": 3
|
|
251
|
+
},
|
|
252
|
+
{
|
|
253
|
+
"description": "Adds a `number` to each `index-prototypes` manifest entry, assigned at a slug's first registration and kept by its later versions, and leads each index card title and the winner summary with it, as in \"3. Catalog first\". (#2030)",
|
|
254
|
+
"hash": "76a73f8ef9702e6aecba6541648bfd42c7e2b6f4",
|
|
255
|
+
"entry": 1
|
|
256
|
+
},
|
|
257
|
+
{
|
|
258
|
+
"description": "Numbers a manifest written before this change in order of each slug's first registration when it is read, and writes those numbers to it at the next registration. (#2030)",
|
|
259
|
+
"hash": "76a73f8ef9702e6aecba6541648bfd42c7e2b6f4",
|
|
260
|
+
"entry": 2
|
|
261
|
+
},
|
|
262
|
+
{
|
|
263
|
+
"description": "Updates `index-prototypes` and `prepare-prototype-brief` to name each prototype to the developer as `{number}. {title}` in reports, the comparison, the idea table, and the idea decisions, and to accept a bare number as a reference to a prototype, asking when no prototype has that number. (#2030)",
|
|
264
|
+
"hash": "76a73f8ef9702e6aecba6541648bfd42c7e2b6f4",
|
|
265
|
+
"entry": 3
|
|
266
|
+
},
|
|
267
|
+
{
|
|
268
|
+
"description": "Adds the `ui-copy-conventions` rulebook, delivered as the `consult-ui-copy-conventions` skill, which sets rules for labels, buttons, helper text, errors, register, and case, and a copy budget for each page, and which defers to a project's own content guidelines where the two conflict. (#2032)",
|
|
269
|
+
"hash": "6738deb17bb389dc386fd15dd5eff4efeac3f35f",
|
|
270
|
+
"entry": 1
|
|
271
|
+
},
|
|
272
|
+
{
|
|
273
|
+
"description": "Adds `ui-copy-conventions` to the `recommended` collection, and directs plans to name its copy rules and copy budget in the key decisions of any task that writes interface text or builds a page, a prototype, or a UI component. (#2032)",
|
|
274
|
+
"hash": "6738deb17bb389dc386fd15dd5eff4efeac3f35f",
|
|
275
|
+
"entry": 2
|
|
276
|
+
},
|
|
277
|
+
{
|
|
278
|
+
"description": "Changes `prepare-prototype-brief` to forbid builders from quoting the brief into the page, to require the demo chrome inside an element marked `data-demo`, and to judge each prototype's product copy against `ui-copy-conventions`. (#2032)",
|
|
279
|
+
"hash": "6738deb17bb389dc386fd15dd5eff4efeac3f35f",
|
|
280
|
+
"entry": 3
|
|
281
|
+
},
|
|
282
|
+
{
|
|
283
|
+
"description": "Adds the `copy-probe` command to the `index-prototypes` helper, which prints a function for the Playwright MCP's `browser_evaluate` that lists a page's strings of four or more words and skips everything inside `data-demo`. (#2032)",
|
|
284
|
+
"hash": "6738deb17bb389dc386fd15dd5eff4efeac3f35f",
|
|
285
|
+
"entry": 4
|
|
286
|
+
},
|
|
287
|
+
{
|
|
288
|
+
"description": "Adds the `index-prototypes describe-set` command, which reads a set summary (`shared`, `changes`, `try`) from a JSON file into the manifest; the index page shows that summary below its title, with `try` as a numbered list. (#2034)",
|
|
289
|
+
"hash": "3ce17cc46c4810cecaba118737ddb7651c95ea76",
|
|
290
|
+
"entry": 1
|
|
291
|
+
},
|
|
292
|
+
{
|
|
293
|
+
"description": "Adds a repeatable `--note \"<label>: <value>\"` flag to `index-prototypes register`, which stores each note on the prototype's entry and shows the notes on its card as a definition list in the order given. (#2034)",
|
|
294
|
+
"hash": "3ce17cc46c4810cecaba118737ddb7651c95ea76",
|
|
295
|
+
"entry": 2
|
|
296
|
+
},
|
|
297
|
+
{
|
|
298
|
+
"description": "Directs the agent in the `index-prototypes` and `prepare-prototype-brief` skills to choose one list of note labels for the set, to collect a value for each label from every builder, and to write the set summary in a new \"Describe the set\" step each round. (#2034)",
|
|
299
|
+
"hash": "3ce17cc46c4810cecaba118737ddb7651c95ea76",
|
|
300
|
+
"entry": 3
|
|
301
|
+
},
|
|
302
|
+
{
|
|
303
|
+
"description": "Adds drafted titles to `groom-backlog`, which shows a replacement title from the `ticket-assessor` subagent in the digest, applies it with `gh issue edit --title`, and lists \"Title\" among the parts that the ticket comment reports as revised. (#2038)",
|
|
304
|
+
"hash": "e038dd4a3c8853b4b4a3c4867f3018a1c46e2130",
|
|
305
|
+
"entry": 1
|
|
306
|
+
},
|
|
307
|
+
{
|
|
308
|
+
"description": "Adds the `project.maturity` (`hobby`, `early`, `production`), `project.sensitivity` (`low`, `personal`, `confidential`), and `project.audience` (`owner`, `team`, `public`) keys to `.agents/preferences.yaml`, which `derive-session-context` reports as `project_maturity`, `project_sensitivity`, and `project_audience`, or as `null` for a key that the project file does not declare. (#2044)",
|
|
309
|
+
"hash": "ab45fcb37ab48f272a842e06239221590ae3691f",
|
|
310
|
+
"entry": 1
|
|
311
|
+
},
|
|
312
|
+
{
|
|
313
|
+
"description": "Directs `design-and-plan` and `plan` to treat the declared project stage as the premise of every security, availability, and infrastructure decision, to add machinery beyond that stage only for a named asset or need, and to ask for each undeclared value and then declare it in the project's preferences file. (#2044)",
|
|
314
|
+
"hash": "ab45fcb37ab48f272a842e06239221590ae3691f",
|
|
315
|
+
"entry": 2
|
|
316
|
+
},
|
|
317
|
+
{
|
|
318
|
+
"description": "Adds the project's declared stage to the design-doc contents that the `williamthorsen-workflow-preferences` rulebook lists for a product's end vision. (#2044)",
|
|
319
|
+
"hash": "ab45fcb37ab48f272a842e06239221590ae3691f",
|
|
320
|
+
"entry": 3
|
|
321
|
+
},
|
|
322
|
+
{
|
|
323
|
+
"description": "Adds the `check-preferences.mjs` script, which validates a preferences file against the bundled schema, prints its findings as JSON, and exits 1 on an invalid value or a missing required key, reporting an unrecognized key as a warning that names the nearest known key. (#2044)",
|
|
324
|
+
"hash": "ab45fcb37ab48f272a842e06239221590ae3691f",
|
|
325
|
+
"entry": 4
|
|
326
|
+
},
|
|
327
|
+
{
|
|
328
|
+
"description": "Adds the `refine-prototype` skill, which applies the developer's commands to one prototype page with the development gates off, carries the round's kept and adapted ideas onto it, snapshots each accepted version into the ticket's prototype set, and records every accepted change in a `refinement-log` artifact that the end vision reads. (#2040)",
|
|
329
|
+
"hash": "73fcfed401b20ee4a49a45c7ee91993547a11a36",
|
|
330
|
+
"entry": 1
|
|
331
|
+
},
|
|
332
|
+
{
|
|
333
|
+
"description": "Gives each prototype version an id, `{number}.{version}`, that leads the index card and the first line of the page's `data-demo` band, with a `resolve-ids` command on the `index-prototypes` helper that resolves the ids before the prototypes are built and a `--number` flag on `register` that refuses a registration whose number disagrees with the manifest. (#2040)",
|
|
334
|
+
"hash": "73fcfed401b20ee4a49a45c7ee91993547a11a36",
|
|
335
|
+
"entry": 2
|
|
336
|
+
},
|
|
337
|
+
{
|
|
338
|
+
"description": "Adds the `assess-usability` skill, available on the Claude harness only, which dispatches a `usability-assessor` subagent for each of three to five lenses in turn and merges their reports into a `usability-findings` artifact that ranks the findings by effect and reach and that `triage-spike-findings` takes as input. (#2045)",
|
|
339
|
+
"hash": "db44782da0c9ac095525dba80b050e054e6864a9",
|
|
340
|
+
"entry": 1
|
|
341
|
+
},
|
|
342
|
+
{
|
|
343
|
+
"description": "Adds the `triage-spike-findings` skill, which grades the confidence and value of every item that a findings artifact leaves undisposed, has the new `disposition-challenger` subagent argue against each grade, and then creates the `confidence:`- and `value:`-labelled child tickets under an umbrella ticket and posts every disposition on the triage ticket, on GitHub repositories that have both label families. (#2049)",
|
|
344
|
+
"hash": "5d2238d1cb0a11aa15a645dae467112e5316c260",
|
|
345
|
+
"entry": 1
|
|
346
|
+
},
|
|
347
|
+
{
|
|
348
|
+
"description": "Adds a `--label` argument to `create-ticket`, which applies the given labels on GitHub in addition to the resolved scope and type labels and reports them as skipped on Jira. (#2049)",
|
|
349
|
+
"hash": "5d2238d1cb0a11aa15a645dae467112e5316c260",
|
|
350
|
+
"entry": 2
|
|
351
|
+
},
|
|
352
|
+
{
|
|
353
|
+
"description": "Stops `create-ticket` from asking for confirmation of a relationship supplied through `--parent`, `--blocked-by`, or `--blocking`, and lists that relationship in the completion output. (#2049)",
|
|
354
|
+
"hash": "5d2238d1cb0a11aa15a645dae467112e5316c260",
|
|
355
|
+
"entry": 3
|
|
356
|
+
},
|
|
357
|
+
{
|
|
358
|
+
"description": "Adds the `check-site --target <url-or-host>` subcommand to `manage-jira-ticket.mjs`, which prints `acli`'s active site and the ticket's site as JSON and, when they differ, exits non-zero and names the `acli jira auth switch` command that makes the ticket's site active. (#2052)",
|
|
359
|
+
"hash": "37dd890748ec052db2b13ce8b5d9393df03748c2",
|
|
360
|
+
"entry": 3
|
|
361
|
+
},
|
|
362
|
+
{
|
|
363
|
+
"description": "Adds the `jira-clients` guidance hook to `update-jira-ticket`, through which a machine adds its own Jira client, with the sites that it reaches and its rank, to the clients that the Jira skills read and create through. (#2052)",
|
|
364
|
+
"hash": "37dd890748ec052db2b13ce8b5d9393df03748c2",
|
|
365
|
+
"entry": 4
|
|
366
|
+
},
|
|
367
|
+
{
|
|
368
|
+
"description": "Adds an \"External programs\" section to the `testing-conventions` skill, which directs that code reach git or another external program through an adapter received as a dependency, that tests of that code pass a fake adapter, and that only the adapter's own test run the real program. (#2055)",
|
|
369
|
+
"hash": "948de718d2f7a8a59f736deb43070a8436009fee",
|
|
370
|
+
"entry": 1
|
|
371
|
+
},
|
|
372
|
+
{
|
|
373
|
+
"description": "Adds an \"External programs\" section to the `typescript-testing-conventions` skill, with an example of an adapter type, a real adapter used as a parameter default, and a test that passes an object literal as the fake, and states a preference for that parameter over `vi.mock`. (#2055)",
|
|
374
|
+
"hash": "948de718d2f7a8a59f736deb43070a8436009fee",
|
|
375
|
+
"entry": 2
|
|
376
|
+
},
|
|
377
|
+
{
|
|
378
|
+
"description": "Rewrites the description of the `testing-conventions` skill to name how a test reaches git and other external programs, and to direct agents to consult the skill before writing or changing a test. (#2055)",
|
|
379
|
+
"hash": "948de718d2f7a8a59f736deb43070a8436009fee",
|
|
380
|
+
"entry": 3
|
|
381
|
+
},
|
|
382
|
+
{
|
|
383
|
+
"description": "Move kb's git calls behind an injectable adapter (#2077)",
|
|
384
|
+
"body": "Adds an optional `git` parameter to `check`, `enumerateNotes`, and `enumerateNotePaths` in `@williamthorsen/kb/check`, which takes a `KbGit` adapter so that a consumer's tests can run these functions without a real git repository. The change also routes every git call inside kb through one such adapter and replaces the repositories that kb's tests built with a fake adapter.",
|
|
385
|
+
"hash": "e1242949ad8654b3c3bba3b5bccd8acf7abed0a2"
|
|
386
|
+
},
|
|
387
|
+
{
|
|
388
|
+
"description": "Changes the next-steps menus of the planning, implementation, and review skills to name each skill in the harness's own invocation syntax, such as `/refine-plan` on Claude Code and `!refine-plan` on Rovo, so that a user can paste an option line without retyping it. (#2084)",
|
|
389
|
+
"hash": "013c2993c883b7feac1491404110ad8a92fa8293",
|
|
390
|
+
"entry": 1
|
|
391
|
+
},
|
|
392
|
+
{
|
|
393
|
+
"description": "Adds a \"Where a test goes\" section to the `testing-conventions` skill, which directs each case to the cheapest tier that can observe it, limits an expensive tier (one that spawns a process, starts a runtime, or builds a full fixture) to one smoke example per entry or verb, and requires a change to delete the higher-tier examples that its cheaper coverage supersedes and to justify each expensive-tier example that it adds. (#2086)",
|
|
394
|
+
"hash": "0b2d76aa829af16c2154ab1097ac78865bc2a615",
|
|
395
|
+
"entry": 1
|
|
396
|
+
},
|
|
397
|
+
{
|
|
398
|
+
"description": "Adds a \"Test placement\" section to the `review-criteria` skill, which classes as a Warning an added expensive-tier example that a cheaper tier could observe, and also a higher-tier suite that the change superseded but kept. (#2086)",
|
|
399
|
+
"hash": "0b2d76aa829af16c2154ab1097ac78865bc2a615",
|
|
400
|
+
"entry": 2
|
|
401
|
+
},
|
|
402
|
+
{
|
|
403
|
+
"description": "Changes the test criterion in `ticket-criteria-conventions` and `plan-template` to ask for coverage at the cheapest tier that observes the behavior, rather than for coverage by tests alone. (#2086)",
|
|
404
|
+
"hash": "0b2d76aa829af16c2154ab1097ac78865bc2a615",
|
|
405
|
+
"entry": 3
|
|
406
|
+
},
|
|
407
|
+
{
|
|
408
|
+
"description": "Changes the `accessibility-conventions` and `shared-data-conventions` rulebooks to `skill` delivery alone, so that they no longer appear in every session's guidance file and are reached through `consult-accessibility-conventions` and `consult-shared-data-conventions`, and adds an \"Interfaces\" criterion to `review-criteria` that points a review of colour tokens, text styles, pages, or UI components to `accessibility-conventions`. (#2087)",
|
|
409
|
+
"hash": "893150e0dea901c3e178565092511dae45ed41bf",
|
|
410
|
+
"entry": 2
|
|
411
|
+
},
|
|
412
|
+
{
|
|
413
|
+
"description": "Adds an \"Always-loaded context\" section to `review-criteria`, which classifies a change as a Warning when it makes a rulebook ambient or grows an `AGENTS.md`, a `CLAUDE.md`, or another file loaded at session start, unless nearly every session needs the content. (#2087)",
|
|
414
|
+
"hash": "893150e0dea901c3e178565092511dae45ed41bf",
|
|
415
|
+
"entry": 3
|
|
416
|
+
},
|
|
417
|
+
{
|
|
418
|
+
"description": "Updates `codeassembly-content-specification` to version 30, which states that `delivery` is required and that `ambient` fits only content that nearly every session needs. (#2087)",
|
|
419
|
+
"hash": "893150e0dea901c3e178565092511dae45ed41bf",
|
|
420
|
+
"entry": 4
|
|
421
|
+
},
|
|
422
|
+
{
|
|
423
|
+
"description": "Adds a rule to `prepare-prototype-brief` that directs the brief's author to describe an audience-facing view by what the audience sees, and adds a line to the brief check that has the author rewrite phrases such as \"mystery\" and \"unknown to\" without the withheld information. (#2089)",
|
|
424
|
+
"hash": "2476b7e8b2b1f554ff17050cc40bd025159d479b",
|
|
425
|
+
"entry": 1
|
|
426
|
+
},
|
|
427
|
+
{
|
|
428
|
+
"description": "Makes `create-gh-pr` assign each pull request that it creates to the authenticated `gh` user, record the applied assignee in the `pull-request` artifact, and report the assignee as skipped when GitHub does not apply it. (#2090)",
|
|
429
|
+
"hash": "b5cb6b98f2d0c9c41a0d149b412c48143df74365",
|
|
430
|
+
"entry": 1
|
|
431
|
+
},
|
|
432
|
+
{
|
|
433
|
+
"description": "Adds setup rules to the `testing-conventions` skill that count a database engine as an expensive tier, call for the cheapest setup that fits the time budget, keep setup cost independent of the number of test files, and reject a raised hook timeout as a fix. (#2092)",
|
|
434
|
+
"hash": "5996a4e6b8a74a1a521894f6d0b9129ceb692dba",
|
|
435
|
+
"entry": 1
|
|
436
|
+
},
|
|
437
|
+
{
|
|
438
|
+
"description": "Adds a \"Code that uses a database\" section to the `testing-conventions` skill, which limits database tests to code whose subject is SQL, directs logic that only passes through SQL to a fake client or a mocked module boundary, and rules out a test per constraint. (#2092)",
|
|
439
|
+
"hash": "5996a4e6b8a74a1a521894f6d0b9129ceb692dba",
|
|
440
|
+
"entry": 2
|
|
441
|
+
},
|
|
442
|
+
{
|
|
443
|
+
"description": "Adds four Warnings to the `review-criteria` skill for database and setup defects in tests that the change adds, splits, or modifies, and changes the split that it proposes for a grown test file to share the file's expensive setup first. (#2092)",
|
|
444
|
+
"hash": "5996a4e6b8a74a1a521894f6d0b9129ceb692dba",
|
|
445
|
+
"entry": 3
|
|
446
|
+
},
|
|
447
|
+
{
|
|
448
|
+
"description": "Adds the `cli-conventions` rulebook, delivered as the `consult-cli-conventions` skill, which states that a CLI printing a doc as a help topic renders a link to another topic as the `<bin> help <topic>` command, renders any other link as its absolute URL, and accepts the doc's file stem as a name for the topic. (#2093)",
|
|
449
|
+
"hash": "7359ac9f9fd07a3f30d8fbc99bf8aac6b6abcfb1",
|
|
450
|
+
"entry": 1
|
|
451
|
+
},
|
|
452
|
+
{
|
|
453
|
+
"description": "Adds `cli-conventions` to the `recommended` collection, so that a project declaring that collection receives the rulebook. (#2093)",
|
|
454
|
+
"hash": "7359ac9f9fd07a3f30d8fbc99bf8aac6b6abcfb1",
|
|
455
|
+
"entry": 2
|
|
456
|
+
},
|
|
457
|
+
{
|
|
458
|
+
"description": "Adds `--repo OWNER/REPO` to `/create-ticket`, which files the ticket in that GitHub repository and resolves its title format, reference prefix, scope, and labels from the configuration on that repository's default branch. (#2094)",
|
|
459
|
+
"hash": "7f327716ac0207ad0eaa6a93393351267eeff56b",
|
|
460
|
+
"entry": 1
|
|
461
|
+
},
|
|
462
|
+
{
|
|
463
|
+
"description": "Adds `--project-root <dir>` to `describe-change render-titles` and `resolve-labels`, which then read `.agents/preferences.yaml` and `.meta/label-map.json` from that directory in place of the invoking repository's root. (#2094)",
|
|
464
|
+
"hash": "7f327716ac0207ad0eaa6a93393351267eeff56b",
|
|
465
|
+
"entry": 2
|
|
466
|
+
},
|
|
467
|
+
{
|
|
468
|
+
"description": "Makes `describe-change resolve-labels` warn on stderr about each type or scope that a configured label map does not define, where it previously omitted the label without a message. (#2094)",
|
|
469
|
+
"hash": "7f327716ac0207ad0eaa6a93393351267eeff56b",
|
|
470
|
+
"entry": 3
|
|
471
|
+
},
|
|
472
|
+
{
|
|
473
|
+
"description": "Adds a `medium` input to `assess-usability`. When set to `cli`, each `usability-assessor` lens runs the built binary in its own scratch git repository and saves text transcripts as evidence, and the styling-and-access lens is replaced by an output-and-access lens that checks `NO_COLOR`, piped output, 80-column width, and help and error text. (#2095)",
|
|
474
|
+
"hash": "9e4e90216060497d93b7f0d07ff443be3e788234",
|
|
475
|
+
"entry": 1
|
|
476
|
+
},
|
|
477
|
+
{
|
|
478
|
+
"description": "Orders the `ticket` items of `triage-spike-findings` by value, then confidence, with record order breaking ties, when the skill creates the child tickets and when it lists them in the checkpoint table, the dispositions comment, and the report, so that the children's issue numbers follow that order. (#2096)",
|
|
479
|
+
"hash": "ad6433f473dc31513dfe12e878bd6a380a8a08af",
|
|
480
|
+
"entry": 1
|
|
481
|
+
},
|
|
482
|
+
{
|
|
483
|
+
"description": "Adds a rule to the \"Technical recommendations\" guidance that directs an agent to name the best-practice solutions to a design problem and the conditions under which each one fits before it weighs options, to label an option that departs from all of them as non-standard with the reason that none fits, and to recommend revising an existing API rather than an addition that works around its contract. (#2098)",
|
|
484
|
+
"hash": "493531b336569d90b1b404212a51840f552950ce",
|
|
485
|
+
"entry": 1
|
|
486
|
+
},
|
|
487
|
+
{
|
|
488
|
+
"description": "Includes the \"Technical recommendations\" guidance in the `ticket-assessor` subagent, which validates a ticket's proposed approach. (#2098)",
|
|
489
|
+
"hash": "493531b336569d90b1b404212a51840f552950ce",
|
|
490
|
+
"entry": 2
|
|
491
|
+
},
|
|
492
|
+
{
|
|
493
|
+
"description": "Extends the `cli-conventions` rulebook from help topics to the whole interface of a command-line tool in any language, adding rules for `--help` on every command and subcommand, an exit-code table, error messages that name the fix, and step and outcome reports for commands that change state. (#2099)",
|
|
494
|
+
"hash": "762196014eb70f6fc71313240e342d4b163e4c91",
|
|
495
|
+
"entry": 1
|
|
496
|
+
},
|
|
497
|
+
{
|
|
498
|
+
"description": "Reduces the `shell-conventions` rulebook to how a bash script implements the `cli-conventions` rules, and changes its `show_usage` template to write requested help to stdout and to exit 2 on an unknown command. (#2099)",
|
|
499
|
+
"hash": "762196014eb70f6fc71313240e342d4b163e4c91",
|
|
500
|
+
"entry": 2
|
|
501
|
+
},
|
|
502
|
+
{
|
|
503
|
+
"description": "Adds a \"DOM environment\" section to the `typescript-testing-conventions` skill, which directs a TypeScript test that renders into a DOM to run under happy-dom and allows jsdom only at an opt-in whose comment names the behavior that happy-dom lacks. (#2101)",
|
|
504
|
+
"hash": "f4c7fa57b639bc377fdbbbd6a06c2299478ef5c5",
|
|
505
|
+
"entry": 1
|
|
506
|
+
},
|
|
507
|
+
{
|
|
508
|
+
"description": "Adds the `codeassembly-validate-preferences` bin to `codeassembly-guidance`, which validates each named preferences file against the bundled schema without network access, reports a missing or unparsable file as an error, prints text or one JSON object per file under `--json`, and treats warnings such as an unrecognized key as failures under `--strict`. (#2103)",
|
|
509
|
+
"hash": "701db9b590b93d2d279ce6206fe273910563fcee",
|
|
510
|
+
"entry": 1
|
|
511
|
+
},
|
|
512
|
+
{
|
|
513
|
+
"description": "Renames the deployed `check-preferences.mjs` helper to `validate-preferences.mjs` and gives it the bin's behavior: several files per run, text output by default, and the `--json`, `--strict`, and `--help` options. (#2103)",
|
|
514
|
+
"hash": "701db9b590b93d2d279ce6206fe273910563fcee",
|
|
515
|
+
"entry": 2
|
|
516
|
+
},
|
|
517
|
+
{
|
|
518
|
+
"description": "Directs the agent, in the `williamthorsen-collaboration-preferences` rulebook and the option-format rule, to start each line that states a decision awaiting the checkpoint with โณ, in a turn's narrative as well as in the plan and spike templates' `## Decisions taken` section, where the marker replaces the `(provisional)` parenthetical. (#2104)",
|
|
519
|
+
"hash": "96712f87340a4ab1d8e097528d0550d3d46197c8",
|
|
520
|
+
"entry": 1
|
|
521
|
+
},
|
|
522
|
+
{
|
|
523
|
+
"description": "Extends `triage-spike-findings` to have the agent decide the blockers of each ticket that it creates, create every blocker before the tickets that it blocks, link them through `create-ticket --blocked-by`, and list them in a \"Blocked by\" column of the dispositions comment. (#2105)",
|
|
524
|
+
"hash": "634b2e817907b2622e6569504c9d9a01c6e68112",
|
|
525
|
+
"entry": 1
|
|
526
|
+
},
|
|
527
|
+
{
|
|
528
|
+
"description": "Adds to `williamthorsen-ticketing-preferences` a rule to record a blocker whenever there is some probability that one ticket affects another and should land first, including when one ticket's design takes another ticket's outcome as an input. (#2105)",
|
|
529
|
+
"hash": "634b2e817907b2622e6569504c9d9a01c6e68112",
|
|
530
|
+
"entry": 2
|
|
531
|
+
},
|
|
532
|
+
{
|
|
533
|
+
"description": "Adds a directive to the \"Handoffs\" section of `williamthorsen-collaboration-preferences` that tells the agent to hand over a check of more than one command as one paste-ready script, which cleans up after itself and prints only the facts that the agent needs, and to confirm which machine its commands run on, such as by comparing `hostname`, before it runs or hands over a check of a GUI application. (#2106)",
|
|
534
|
+
"hash": "be68ed4a0a2de8e3efb907683fe19f5bf181c001",
|
|
535
|
+
"entry": 1
|
|
536
|
+
},
|
|
537
|
+
{
|
|
538
|
+
"description": "Adds to `accessibility-conventions` the states that every clickable element shows (a pointer cursor, a hover change, and a focus indicator that meets 3:1 non-text contrast), and requires a browser check of each change to a visible component, with a report that the check did not run when a browser is unavailable. (#2109)",
|
|
539
|
+
"hash": "e971dc4f7fc476119af7d2f0e69bc2dfb73b8a2a",
|
|
540
|
+
"entry": 1
|
|
541
|
+
},
|
|
542
|
+
{
|
|
543
|
+
"description": "Directs `implement-plan` to run that browser check for any change to a visible component, whether or not the plan lists it, and to report what the check found, and adds the interaction states and the check to the plan template's interface guidance. (#2109)",
|
|
544
|
+
"hash": "e971dc4f7fc476119af7d2f0e69bc2dfb73b8a2a",
|
|
545
|
+
"entry": 2
|
|
546
|
+
},
|
|
547
|
+
{
|
|
548
|
+
"description": "Directs `review-criteria` to check each new or changed interactive element in a browser rather than by reading the diff alone, and adds the outcome of that check to the technical assessment in both `review-branch` report templates. (#2109)",
|
|
549
|
+
"hash": "e971dc4f7fc476119af7d2f0e69bc2dfb73b8a2a",
|
|
550
|
+
"entry": 3
|
|
551
|
+
},
|
|
552
|
+
{
|
|
553
|
+
"description": "Makes `design-and-plan`, `plan`, and `refine-plan` report each open blocker of the resolved GitHub or Jira ticket by reference and title, and then continue. (#2113)",
|
|
554
|
+
"hash": "aa7e93fc88f9e8992d291af996ddefad0534b184",
|
|
555
|
+
"entry": 1
|
|
556
|
+
},
|
|
557
|
+
{
|
|
558
|
+
"description": "Makes `implement-plan` ask the user to confirm before it starts the first task when the governing ticket has an open blocker. (#2113)",
|
|
559
|
+
"hash": "aa7e93fc88f9e8992d291af996ddefad0534b184",
|
|
560
|
+
"entry": 2
|
|
561
|
+
},
|
|
562
|
+
{
|
|
563
|
+
"description": "Extends the blocker check to a ticket artifact, which the skills check against the remote ticket named by its `ticket_ref` frontmatter. (#2113)",
|
|
564
|
+
"hash": "aa7e93fc88f9e8992d291af996ddefad0534b184",
|
|
565
|
+
"entry": 3
|
|
566
|
+
},
|
|
567
|
+
{
|
|
568
|
+
"description": "Lets `refine-plan` resolve a Jira ticket by URL or key through the Jira clients that the ticket source resolution ranks, where it previously fetched a Jira URL as a web page. (#2113)",
|
|
569
|
+
"hash": "aa7e93fc88f9e8992d291af996ddefad0534b184",
|
|
570
|
+
"entry": 4
|
|
571
|
+
},
|
|
572
|
+
{
|
|
573
|
+
"description": "Adds a rule to `williamthorsen-tooling-preferences` that directs an agent to log into a local instance of the app under work without asking the developer, and to set a development credential in an untracked local config file when the app needs one, which the rulebook does not count as minting a credential. (#2115)",
|
|
574
|
+
"hash": "71cc729b660333533339dce2d1f266bc1076dde7",
|
|
575
|
+
"entry": 1
|
|
576
|
+
},
|
|
577
|
+
{
|
|
578
|
+
"description": "Limits the login that the handoff ladder in `williamthorsen-collaboration-preferences` names among the resources that an agent asks the developer to supply to a login to a remote service, which excludes an app's local development login. (#2115)",
|
|
579
|
+
"hash": "71cc729b660333533339dce2d1f266bc1076dde7",
|
|
580
|
+
"entry": 2
|
|
581
|
+
},
|
|
582
|
+
{
|
|
583
|
+
"description": "Adds a step to `design-and-plan`, `plan`, `refine-plan`, and `implement-plan` that checks the branch against the remote's default branch before the work starts, fast-forwarding a branch that lacks commits and uncommitted changes of its own and otherwise listing the gained commits and asking whether to bring them in. (#2119)",
|
|
584
|
+
"hash": "10c4b363a10fa7ba137a9e617f425c312e6e6711",
|
|
585
|
+
"entry": 1
|
|
586
|
+
},
|
|
587
|
+
{
|
|
588
|
+
"description": "Adds the `check-branch-currency.mjs` script, which fetches the remote's default branch and reports as JSON how far the checked-out branch is behind and ahead of it, whether its tree is clean, and which gained commits touch the paths passed with `--path`. (#2119)",
|
|
589
|
+
"hash": "10c4b363a10fa7ba137a9e617f425c312e6e6711",
|
|
590
|
+
"entry": 2
|
|
591
|
+
},
|
|
592
|
+
{
|
|
593
|
+
"description": "Adds an \"Authorship\" section to the shared `AGENTS.md`, which states that a creator, reporter, or author field shows the account that made an item rather than who wrote it, and forbids inferring from that field that the developer wrote the item. (#2120)",
|
|
594
|
+
"hash": "94e9a6bed185ce6ac995873d4e0015e138a82989",
|
|
595
|
+
"entry": 1
|
|
596
|
+
},
|
|
597
|
+
{
|
|
598
|
+
"description": "Changes `ticket-evaluation.md` to tell the agent to treat a ticket's content as unsourced, whichever account created the ticket, until the agent traces the content to a source. (#2120)",
|
|
599
|
+
"hash": "94e9a6bed185ce6ac995873d4e0015e138a82989",
|
|
600
|
+
"entry": 2
|
|
601
|
+
},
|
|
602
|
+
{
|
|
603
|
+
"description": "Adds a \"Subcommand names\" section to the `cli-conventions` rulebook, which requires a subcommand that acts to name its action and its object, prescribes a flat verb-object name such as `show-instance-page` while the object has one action and a noun group such as `instance-page show` once it has several, and rejects an existing name that breaks these rules as precedent. (#2121)",
|
|
604
|
+
"hash": "1b313fc011d539f280e50b2bc6f193839cb28c4e",
|
|
605
|
+
"entry": 1
|
|
606
|
+
},
|
|
607
|
+
{
|
|
608
|
+
"description": "Makes `kb-curate` report `missing-destination` when `--kb` is absent and no `.kb/` is discoverable, and `no-default` when `--kb @default` is given without a configured `default_kb`, where both cases previously returned `no-kb-resolvable`. (#2122)",
|
|
609
|
+
"hash": "6b6eb6c9dfdefe4c3e6ef5500150a4b8f3bf771d",
|
|
610
|
+
"entry": 1
|
|
611
|
+
},
|
|
612
|
+
{
|
|
613
|
+
"description": "Makes `kb-edit` report a note outside any discoverable `.kb/` as `missing-destination` instead of `no-kb-resolvable`, the code that `kb-add` uses for the same condition. (#2122)",
|
|
614
|
+
"hash": "6b6eb6c9dfdefe4c3e6ef5500150a4b8f3bf771d",
|
|
615
|
+
"entry": 2
|
|
616
|
+
},
|
|
617
|
+
{
|
|
618
|
+
"description": "Rewrites the `.editorconfig` bullet in the shared \"Style\" guidance to direct agents to follow `.editorconfig` and to fill new comments to the `max_line_length` that it sets. (#2123)",
|
|
619
|
+
"hash": "ee4486dd01ecccb71b9c37871fcd525e4431157b",
|
|
620
|
+
"entry": 1
|
|
621
|
+
},
|
|
622
|
+
{
|
|
623
|
+
"description": "Adds rules to `cli-conventions`, each with an example, on when a behavior is a subcommand rather than an option, standard option names such as `--config`, `--dry-run`, and `--write`, the order in which settings resolve, which commands write by default, `--json` output, color, error messages that suggest the nearest valid name and never take a secret as an argument, and keeping a command's logic apart from its presentation. (#2134)",
|
|
624
|
+
"hash": "f4e728365ae58c60a2f6dad5e1b3511c7ac154b4",
|
|
625
|
+
"entry": 1
|
|
626
|
+
},
|
|
627
|
+
{
|
|
628
|
+
"description": "Changes the exit code that `cli-conventions` assigns to a usage error, such as bad input or an unknown command or option, from 1 to 2, and adds exit code 1 for a check that ran and found problems. (#2134)",
|
|
629
|
+
"hash": "f4e728365ae58c60a2f6dad5e1b3511c7ac154b4",
|
|
630
|
+
"entry": 2
|
|
631
|
+
},
|
|
632
|
+
{
|
|
633
|
+
"description": "Changes the default exit code of the `show_usage` template in `shell-conventions` from 1 to 2, so that a bare `show_usage` call covers every usage error, including an unknown command. (#2134)",
|
|
634
|
+
"hash": "f4e728365ae58c60a2f6dad5e1b3511c7ac154b4",
|
|
635
|
+
"entry": 3
|
|
636
|
+
},
|
|
637
|
+
{
|
|
638
|
+
"description": "Makes `select-lede-exemplars.mjs` act on the breaking marker, which it previously discarded: An unmarked request no longer returns a breaking record, and a request marked by a `!` on `--type` returns breaking records before non-breaking ones within each widening step. (#2136)",
|
|
639
|
+
"hash": "c754ec4cf4853a9497538a75e755ba2b56e95048",
|
|
640
|
+
"entry": 1
|
|
641
|
+
},
|
|
642
|
+
{
|
|
643
|
+
"description": "Adds a `--breaking` flag to `select-lede-exemplars.mjs`, which marks a `--type` or `--tier` request as breaking, and adds a `breaking` field to the JSON output, which reports whether the request was marked. (#2136)",
|
|
644
|
+
"hash": "c754ec4cf4853a9497538a75e755ba2b56e95048",
|
|
645
|
+
"entry": 2
|
|
646
|
+
},
|
|
647
|
+
{
|
|
648
|
+
"description": "Changes the `entry-drafter` subagent to request exemplars once per pair of work type and breaking marker, passing `--breaking` for a breaking entry, rather than once per work type. (#2136)",
|
|
649
|
+
"hash": "c754ec4cf4853a9497538a75e755ba2b56e95048",
|
|
650
|
+
"entry": 3
|
|
651
|
+
},
|
|
652
|
+
{
|
|
653
|
+
"description": "Defines the members of the `triage` collection with `'@unclaimed'`, so that `codeassembly` deploys a newly added library artifact through `triage` until the artifact is promoted to another collection or declares `standalone:`. (#2137)",
|
|
654
|
+
"hash": "a2690848e3e61e8a04b0b63177afd1161f6c60ad",
|
|
655
|
+
"entry": 3
|
|
656
|
+
},
|
|
657
|
+
{
|
|
658
|
+
"description": "Adds the `overused-word` rule to the `revise-prose` sweep, which reports one candidate per sentence that contains a word from the plain-speech calibration's \"Words to look for\" list or an inflection of one, lists the matched words, and leaves `prose-reviser` to repair the site or reject a use in a sense that the list keeps. (#2139)",
|
|
659
|
+
"hash": "79686104a2b46cb903b3cd907fe19ee5ebb1d580",
|
|
660
|
+
"entry": 1
|
|
661
|
+
},
|
|
662
|
+
{
|
|
663
|
+
"description": "Adds the `check-prose.mjs` script, which runs every `revise-prose` detector over one Markdown file at any path without reading or writing the sweep record, and exits 1 when it reports candidates and 2 when it cannot read the file. (#2141)",
|
|
664
|
+
"hash": "2421e7b485b0782753533881ec336f4d4edef55b",
|
|
665
|
+
"entry": 1
|
|
666
|
+
},
|
|
667
|
+
{
|
|
668
|
+
"description": "Adds a writing-rules check to step 6 of `summarize-change`, which runs `check-prose.mjs` over the lede, each entry's `text` and `migration`, and the \"Why\" section, and directs the session to redispatch the `entry-drafter` with the new `writing-rule` rejection code for a confirmed violation in a drafted passage. (#2141)",
|
|
669
|
+
"hash": "2421e7b485b0782753533881ec336f4d4edef55b",
|
|
670
|
+
"entry": 2
|
|
671
|
+
},
|
|
672
|
+
{
|
|
673
|
+
"description": "Extends `revise-comments` to add a missing description to each function, method, class, and component, test helpers included, and to rewrite a description that misstates its code, with an instruction to ask the user first when the code rather than the description could be wrong. (#2146)",
|
|
674
|
+
"hash": "f33f03e09140676b853d4abe6e23728e455a533c",
|
|
675
|
+
"entry": 1
|
|
676
|
+
},
|
|
677
|
+
{
|
|
678
|
+
"description": "Adds a \"Test data\" section to the `testing-conventions` skill, which requires each test to use the smallest data that proves its behavior and requires code that reads data from a module-level singleton to take it as a parameter or from a context whose default is the real value. (#2167)",
|
|
679
|
+
"hash": "584433dfb8531bff50dee4876097352ddc02ae15",
|
|
680
|
+
"entry": 1
|
|
681
|
+
},
|
|
682
|
+
{
|
|
683
|
+
"description": "Extends the \"Fix the design, not the timeout\" rule in `testing-conventions` from a hook's timeout to a test's and a tier's timeout, set in a test or in config, and permits a raise only when smaller data, injection, and shared setup do not apply and the plan or the pull-request description states why. (#2167)",
|
|
684
|
+
"hash": "584433dfb8531bff50dee4876097352ddc02ae15",
|
|
685
|
+
"entry": 2
|
|
686
|
+
},
|
|
687
|
+
{
|
|
688
|
+
"description": "Adds a Warning to `review-criteria` for a raised hook, test, or tier timeout, which a stated reason does not exempt, and a Warning for a test that renders or builds production-scale data, replacing the narrower \"A raised hook timeout\" item. (#2167)",
|
|
689
|
+
"hash": "584433dfb8531bff50dee4876097352ddc02ae15",
|
|
690
|
+
"entry": 3
|
|
691
|
+
}
|
|
692
|
+
]
|
|
693
|
+
},
|
|
694
|
+
{
|
|
695
|
+
"title": "๐ Bug fixes",
|
|
696
|
+
"audience": "all",
|
|
697
|
+
"items": [
|
|
698
|
+
{
|
|
699
|
+
"description": "Fixes the issue that `summarize-change` reported a branch's own steps and a ticket's backstory as what the change did, by having the `entry-drafter` subagent and the summary's audit accept only the diff against the default branch as evidence of what changed. (#2029)",
|
|
700
|
+
"hash": "a4c00c139c0183644820cfe5ee1e82109de99d48",
|
|
701
|
+
"entry": 1
|
|
702
|
+
},
|
|
703
|
+
{
|
|
704
|
+
"description": "Fixes the issue that the `## Why` section of a `summarize-change` summary retold how the need for a change arose, by defining that section as the purpose that the change serves. (#2029)",
|
|
705
|
+
"hash": "a4c00c139c0183644820cfe5ee1e82109de99d48",
|
|
706
|
+
"entry": 2
|
|
707
|
+
},
|
|
708
|
+
{
|
|
709
|
+
"description": "Fixes the issue that `entry-drafter` wrote where code or values were copied from, or why the work is split across pull requests, into the lede and the entries, including when a ticket's `## Problem` section stated it. (#2031)",
|
|
710
|
+
"hash": "5fe9e0da64f8f85f439dfc31d780fab6c652bae8",
|
|
711
|
+
"entry": 1
|
|
712
|
+
},
|
|
713
|
+
{
|
|
714
|
+
"description": "Fixes the issue that `summarize-change` accepted how the work is staged across pull requests as the purpose stated in a change summary's `## Why` section. (#2031)",
|
|
715
|
+
"hash": "5fe9e0da64f8f85f439dfc31d780fab6c652bae8",
|
|
716
|
+
"entry": 2
|
|
717
|
+
},
|
|
718
|
+
{
|
|
719
|
+
"description": "Fixes the issue that `groom-backlog collect` selected a ticket again when its only update was the decision that the sweep itself had applied, because GitHub records that update a moment after the sweep's comment. (#2038)",
|
|
720
|
+
"hash": "e038dd4a3c8853b4b4a3c4867f3018a1c46e2130",
|
|
721
|
+
"entry": 2
|
|
722
|
+
},
|
|
723
|
+
{
|
|
724
|
+
"description": "Fixes the issue that `create-ticket` and `design-and-plan`'s Jira write did not direct the agent to flatten task-list syntax before submitting through a Markdown or HTML Jira client, which Jira stores as bullets reading `\\[ \\]`, on any deployment without `update-jira-ticket`. (#2050)",
|
|
725
|
+
"hash": "e8c08b17720a786407fbe8dbb45bd7c1c3f3f64b",
|
|
726
|
+
"entry": 1
|
|
727
|
+
},
|
|
728
|
+
{
|
|
729
|
+
"description": "Fixes the issue that `manage-jira-ticket.mjs create` created a Jira work item on `acli`'s active site when that site differed from the host of `ticket.base_url`, and makes it exit with the fallback `wrong-site` or `site-unreadable` without writing to Jira, reading `ticket.base_url` from the repository's preferences or the global file. (#2052)",
|
|
730
|
+
"hash": "37dd890748ec052db2b13ce8b5d9393df03748c2",
|
|
731
|
+
"entry": 1
|
|
732
|
+
},
|
|
733
|
+
{
|
|
734
|
+
"description": "Fixes the issue that ticket resolution, `update-jira-ticket`, and `create-ticket` reported a Jira ticket on another site as missing, by directing each to run `manage-jira-ticket.mjs check-site` before calling `acli` and to report the wrong site and the `acli jira auth switch` command instead. (#2052)",
|
|
735
|
+
"hash": "37dd890748ec052db2b13ce8b5d9393df03748c2",
|
|
736
|
+
"entry": 2
|
|
737
|
+
},
|
|
738
|
+
{
|
|
739
|
+
"description": "Fixes the issue that the `live-worktree-policy` rulebook named the removed `list-repos --tag live` command for listing the repos tagged `live`, and replaces it with `thor-repo list --tag live`. (#2053)",
|
|
740
|
+
"hash": "336e4641efe6058c00fc77ae4c8f585435ef36f7",
|
|
741
|
+
"entry": 1
|
|
742
|
+
},
|
|
743
|
+
{
|
|
744
|
+
"description": "Fixes the issue that a `summarize-change` redispatch did not send `entry-drafter` the type corrected by the audit, which left the drafter to rewrite the entry in the form of the old type. (#2058)",
|
|
745
|
+
"hash": "8acd2cf486acc270437d798cdf109261e7601a89",
|
|
746
|
+
"entry": 1
|
|
747
|
+
},
|
|
748
|
+
{
|
|
749
|
+
"description": "Fixes the issue that the artifact guidance never stated what the artifact directory is for, by stating that it is the developer's audit trail rather than a source of truth, directing durable instructions to the repository or to a skill or rulebook, and telling the agent to verify what a search of artifacts returns against the repository, the tickets, and the pull requests. (#2070)",
|
|
750
|
+
"hash": "dd5b8e19d53d66d9c169022507e6b3d40fb40cc6",
|
|
751
|
+
"entry": 1
|
|
752
|
+
},
|
|
753
|
+
{
|
|
754
|
+
"description": "Fixes the issue that `williamthorsen-workflow-preferences` did not say that the branch and worktree for a ticket's work are settled, which left agents asking the developer which one to use. (#2082)",
|
|
755
|
+
"hash": "e51e167cf6a31e0b16e1f84f58d5c169708d343b",
|
|
756
|
+
"entry": 1
|
|
757
|
+
},
|
|
758
|
+
{
|
|
759
|
+
"description": "Fixes the issue that `design-and-plan` ended a session that split a ticket without a launch prompt for each resulting ticket, and that its `Next action` menu could offer to implement an umbrella's child in the umbrella's worktree. (#2083)",
|
|
760
|
+
"hash": "4eae3f57a2be999d34e1337cefd4b391e7c45ffa",
|
|
761
|
+
"entry": 1
|
|
762
|
+
},
|
|
763
|
+
{
|
|
764
|
+
"description": "Fixes the issue that the `triage-spike-findings` helper's `check-labels` command crashed with \"e is not a function\" instead of running `gh label list`, which stopped the skill before triage began. (#2085)",
|
|
765
|
+
"hash": "f4f342e568c6bd428adaf20b726b8f1e80da6e4f",
|
|
766
|
+
"entry": 1
|
|
767
|
+
},
|
|
768
|
+
{
|
|
769
|
+
"description": "Fixes the issue that `williamthorsen-collaboration-preferences` and the `action-items` and `option-format` partials stated many directives in the indicative, which hid whether the agent was to act, by restating them as imperatives addressed to the agent. (#2106)",
|
|
770
|
+
"hash": "be68ed4a0a2de8e3efb907683fe19f5bf181c001",
|
|
771
|
+
"entry": 2
|
|
772
|
+
},
|
|
773
|
+
{
|
|
774
|
+
"description": "Documents in the `kb-add` skill the `readonly-kb` error code, which its helper already returned, and tells the agent to have the user choose a writable KB. (#2122)",
|
|
775
|
+
"hash": "6b6eb6c9dfdefe4c3e6ef5500150a4b8f3bf771d",
|
|
776
|
+
"entry": 3
|
|
777
|
+
},
|
|
778
|
+
{
|
|
779
|
+
"description": "Fixes the issue that the rulebooks, skills, subagents, and partials in `codeassembly-guidance` contained sentences that the library's own current writing rules flag, such as figurative verbs, \"no\" used as a determiner, and reduced object relatives, and keeps each rulebook's `version` because the repairs do not change what it asks. (#2130)",
|
|
780
|
+
"hash": "2994cf92898d06091137cc327f5c927faa81a3e8",
|
|
781
|
+
"entry": 1
|
|
782
|
+
},
|
|
783
|
+
{
|
|
784
|
+
"description": "Fixes the issue that messages printed by `describe-change`, `index-prototypes`, `resolve-review-run`, `revise-prose`, and `triage-spike-findings` broke the writing rules, for example by saying `no manifest in` a directory rather than that the directory does not contain a manifest, and keeps each message's error code. (#2132)",
|
|
785
|
+
"hash": "62f2c0a5859c798e87dc428eb45355ddf399c47e",
|
|
786
|
+
"entry": 1
|
|
787
|
+
},
|
|
788
|
+
{
|
|
789
|
+
"description": "Fixes the issue that the artifact conventions told agents to run `export-ai-artifacts.sh`, which has been deleted, and called a git-ignored `base_dir` the default when the documented default is `~/ai-artifacts`. (#2135)",
|
|
790
|
+
"hash": "209ddf557a4d1a612d93fed7e1ca0efea948d9ed",
|
|
791
|
+
"entry": 1
|
|
792
|
+
},
|
|
793
|
+
{
|
|
794
|
+
"description": "Fixes the issue that `revise-prose` reported a file as swept after its prose was edited, by recording a hash of each file's extracted prose in `.agents/revise-prose.yaml` and reporting the file as unswept when the current hash differs. (#2143)",
|
|
795
|
+
"hash": "9618430493196836710972c5cd6bde02d1b6ee74",
|
|
796
|
+
"entry": 1
|
|
797
|
+
},
|
|
798
|
+
{
|
|
799
|
+
"description": "Fixes the issue that the leader check in the option-format contract and the `williamthorsen-collaboration-preferences` rulebook did not cover gated decisions, and adds a first step that searches each alternative for a disqualifying cost, including one that follows from the work's constraints and acceptance criteria. (#2145)",
|
|
800
|
+
"hash": "329fcf6383fc3bb1eed78f5b328d0295954a6234",
|
|
801
|
+
"entry": 1
|
|
802
|
+
}
|
|
803
|
+
]
|
|
804
|
+
},
|
|
805
|
+
{
|
|
806
|
+
"title": "โก Performance",
|
|
807
|
+
"audience": "all",
|
|
808
|
+
"items": [
|
|
809
|
+
{
|
|
810
|
+
"description": "Shortens the `index-prototypes` skill by 675 bytes, cutting explanations that a neighboring sentence restated, and leaves its behavior unchanged. (#2040)",
|
|
811
|
+
"hash": "73fcfed401b20ee4a49a45c7ee91993547a11a36",
|
|
812
|
+
"entry": 3
|
|
813
|
+
}
|
|
814
|
+
]
|
|
815
|
+
},
|
|
816
|
+
{
|
|
817
|
+
"title": "๐๏ธ Internal features",
|
|
818
|
+
"audience": "dev",
|
|
819
|
+
"items": [
|
|
820
|
+
{
|
|
821
|
+
"description": "Replaces the per-CLI entry-point checks in the helper CLIs, `derive-session-context`'s `isMain` among them, with one shared `isEntryPoint(moduleUrl, programName)`, which writes a warning to stderr naming the program and returns `true` when it cannot resolve the real paths, so that a helper CLI invoked through a stale link runs instead of doing nothing. (#2144)",
|
|
822
|
+
"hash": "f1d8fc7b82572fdc330cb5e8112f86e2d8c5f77b",
|
|
823
|
+
"entry": 1
|
|
824
|
+
}
|
|
825
|
+
]
|
|
826
|
+
},
|
|
827
|
+
{
|
|
828
|
+
"title": "โป๏ธ Refactoring",
|
|
829
|
+
"audience": "dev",
|
|
830
|
+
"items": [
|
|
831
|
+
{
|
|
832
|
+
"description": "Moves every git invocation in the streamline-guidance helper into the `StreamlineGit` adapter in `git.ts`, which the `runCheck`, `runRecord`, `runResolve`, and `runCommand` entry points take as a parameter that defaults to the real adapter. (#2069)",
|
|
833
|
+
"hash": "f581814abed52de80a76598a3ea004b7c8c3092b",
|
|
834
|
+
"entry": 1
|
|
835
|
+
},
|
|
836
|
+
{
|
|
837
|
+
"description": "Adds the `SharedGit` adapter in `packages/guidance/src/shared/git.ts` and routes the shared helpers' and `derive-session-context`'s git calls through it, which lets the helpers' tests and the CLI tests of `derive-session-context`, `capture-event`, and `capture-lede-decision` use the fake adapter from `makeFakeGit` and move from the `tool` tier to the `unit` tier. (#2072)",
|
|
838
|
+
"hash": "546b5f6ed24119be862b61a725cb363b3dc6dddd",
|
|
839
|
+
"entry": 1
|
|
840
|
+
},
|
|
841
|
+
{
|
|
842
|
+
"description": "Moves the `describe-change` helper's git calls (the commit-existence check, the commit listing, and the working-tree root lookup) into a `DescribeChangeGit` adapter in `describe-change/git.ts`, which `runDescribe` reads from an optional `DescribeInput.git` that defaults to the adapter that runs git. (#2073)",
|
|
843
|
+
"hash": "bf7e8b296a05e6169d6b407812b6d3a62ff298dc",
|
|
844
|
+
"entry": 1
|
|
845
|
+
},
|
|
846
|
+
{
|
|
847
|
+
"description": "Routes the git queries of the `revise-prose`, `groom-backlog`, and `pull-from-backlog` helpers through typed git adapters and narrows `CommandRunner` to `gh`, which lets those helpers' in-progress, ledger-path, file-listing, and CLI tests run in the unit tier against a fake adapter rather than against real repositories. (#2075)",
|
|
848
|
+
"hash": "b1d0feee1d2f07bda94196900ef8f58b4e5af12e",
|
|
849
|
+
"entry": 1
|
|
850
|
+
},
|
|
851
|
+
{
|
|
852
|
+
"description": "Derives the KB-resolution error codes and messages of `kb-add`, `kb-curate`, and `kb-edit` from one shared resolver and formatter in `kb-shared`, with a discovery-only resolver for `kb-edit`. (#2122)",
|
|
853
|
+
"hash": "6b6eb6c9dfdefe4c3e6ef5500150a4b8f3bf771d",
|
|
854
|
+
"entry": 4
|
|
855
|
+
},
|
|
856
|
+
{
|
|
857
|
+
"description": "Restructures code across the packages and the catwalk demo to satisfy the new `unicorn` rules, mostly by turning trailing `if` blocks into early returns and `continue` guards, and adds `ESNext.Array` to the root `tsconfig.json` `lib` so that `Array.fromAsync` typechecks. (#2152)",
|
|
858
|
+
"hash": "844d21ccdf4ed85436de9cfcd358af2f34651f09",
|
|
859
|
+
"entry": 2
|
|
860
|
+
},
|
|
861
|
+
{
|
|
862
|
+
"description": "Converts property accesses on index signatures to bracket notation in every package, as `noPropertyAccessFromIndexSignature` requires. (#2153)",
|
|
863
|
+
"hash": "e09ca0e224178ce34444160ac80477d2e884b677",
|
|
864
|
+
"entry": 3
|
|
865
|
+
},
|
|
866
|
+
{
|
|
867
|
+
"description": "Splits the `describe-change` and `revise-prose` source files that exceeded the `max-lines` ceiling into modules by concern, such as argument parsing, merge-message composition, record parsing, prose extraction, and the object-relative detector's word lists and head analysis. (#2164)",
|
|
868
|
+
"hash": "d20b084f6112524eba880d6708576224c6843697",
|
|
869
|
+
"entry": 1
|
|
870
|
+
},
|
|
871
|
+
{
|
|
872
|
+
"description": "Splits `groom-backlog/cli.ts`, `index-prototypes/cli.ts`, `kb-edit/cli.ts`, and `streamline-guidance/resolve.ts` into modules for argument parsing, subcommand runners, and their other separate concerns, which brings each file under the `max-lines` ceiling and leaves the helpers' behavior as it was. (#2165)",
|
|
873
|
+
"hash": "d0e26a298441a9545e27f80654ff59e38f87ceb4",
|
|
874
|
+
"entry": 1
|
|
875
|
+
}
|
|
876
|
+
]
|
|
877
|
+
},
|
|
878
|
+
{
|
|
879
|
+
"title": "๐งช Tests",
|
|
880
|
+
"audience": "dev",
|
|
881
|
+
"items": [
|
|
882
|
+
{
|
|
883
|
+
"description": "Runs the streamline-guidance `resolve`, `check`, `record`, and working-tree listing tests against a fake git adapter in the unit tier, leaving `git.tool.test.ts` and the bundle smoke test as the only ones that build real repositories. (#2069)",
|
|
884
|
+
"hash": "f581814abed52de80a76598a3ea004b7c8c3092b",
|
|
885
|
+
"entry": 2
|
|
886
|
+
},
|
|
887
|
+
{
|
|
888
|
+
"description": "Moves the in-process CLI tests and the commit-reading tests of `describe-change` to the unit tier on a fake git adapter, `make-fake-git`, and keeps real repositories only for the adapter's own tests and the bundle smoke test. (#2073)",
|
|
889
|
+
"hash": "bf7e8b296a05e6169d6b407812b6d3a62ff298dc",
|
|
890
|
+
"entry": 2
|
|
891
|
+
},
|
|
892
|
+
{
|
|
893
|
+
"description": "Adds `ambient-delivery-pins.unit.test.ts`, which fails when a library rulebook declares `ambient` delivery without an entry in `AMBIENT_PINS` stating why nearly every session needs it. (#2087)",
|
|
894
|
+
"hash": "893150e0dea901c3e178565092511dae45ed41bf",
|
|
895
|
+
"entry": 5
|
|
896
|
+
},
|
|
897
|
+
{
|
|
898
|
+
"description": "Moves the `factory` DOM tests and the `index-prototypes` page-script tests in `guidance` from jsdom to happy-dom, and removes the `ResizeObserver` stub that the `factory` setup file installed for jsdom. (#2101)",
|
|
899
|
+
"hash": "f4c7fa57b639bc377fdbbbd6a06c2299478ef5c5",
|
|
900
|
+
"entry": 2
|
|
901
|
+
},
|
|
902
|
+
{
|
|
903
|
+
"description": "Rewords the test titles, assertion messages, and comments in the `codeassembly-guidance` content tests against the current writing rules, and re-pins the body hashes in `rulebook-version-pins.unit.test.ts` to the reworded rulebooks. (#2130)",
|
|
904
|
+
"hash": "2994cf92898d06091137cc327f5c927faa81a3e8",
|
|
905
|
+
"entry": 2
|
|
906
|
+
},
|
|
907
|
+
{
|
|
908
|
+
"description": "Splits the oversized test files of both helpers by subcommand or aspect, and moves the fixtures shared by several of the new files into `test-utils`. (#2164)",
|
|
909
|
+
"hash": "d20b084f6112524eba880d6708576224c6843697",
|
|
910
|
+
"entry": 2
|
|
911
|
+
},
|
|
912
|
+
{
|
|
913
|
+
"description": "Splits the CLI tests of `capture-event`, `groom-backlog`, `kb-add`, and `kb-edit` by subcommand or aspect, moves their shared fixtures into each helper's `test-utils`, and runs the in-process `kb-add` cases under the unit tier instead of the tool tier, which leaves `cli.tool.test.ts` with only the subprocess smoke test. (#2165)",
|
|
914
|
+
"hash": "d0e26a298441a9545e27f80654ff59e38f87ceb4",
|
|
915
|
+
"entry": 2
|
|
916
|
+
}
|
|
917
|
+
]
|
|
918
|
+
},
|
|
919
|
+
{
|
|
920
|
+
"title": "โ๏ธ Tooling",
|
|
921
|
+
"audience": "dev",
|
|
922
|
+
"items": [
|
|
923
|
+
{
|
|
924
|
+
"description": "Makes `install-launchers.sh` exit 2 on a usage error and print requested help to stdout rather than stderr. (#2134)",
|
|
925
|
+
"hash": "f4e728365ae58c60a2f6dad5e1b3511c7ac154b4",
|
|
926
|
+
"entry": 4
|
|
927
|
+
},
|
|
928
|
+
{
|
|
929
|
+
"description": "Deletes the `extract-plugin-skills.sh` script, which failed on every run because it sourced a `functions/colors.sh` file that the repository does not contain. (#2134)",
|
|
930
|
+
"hash": "f4e728365ae58c60a2f6dad5e1b3511c7ac154b4",
|
|
931
|
+
"entry": 5
|
|
932
|
+
}
|
|
933
|
+
]
|
|
934
|
+
},
|
|
935
|
+
{
|
|
936
|
+
"title": "๐ฆ Dependencies",
|
|
937
|
+
"audience": "dev",
|
|
938
|
+
"items": [
|
|
939
|
+
{
|
|
940
|
+
"description": "Replaces `jsdom` 30.1.1 with `happy-dom` 21.0.1 in the workspace catalog and the `factory` and `guidance` manifests, drops `@types/jsdom`, and prunes the jsdom package tree from `pnpm-lock.yaml`. (#2101)",
|
|
941
|
+
"hash": "f4c7fa57b639bc377fdbbbd6a06c2299478ef5c5",
|
|
942
|
+
"entry": 3
|
|
943
|
+
},
|
|
944
|
+
{
|
|
945
|
+
"description": "Applies patch and minor upgrades to the root and `factory` dependencies, among them `react` and `react-dom` 19.3.1, `zod` 4.6.7, and pnpm 12.13.0, and rebuilds the `guidance` helper bundles that bundle `zod`. (#2163)",
|
|
946
|
+
"hash": "394ecd3f317959edfba110efac5f6bd2f4c50541",
|
|
947
|
+
"entry": 2
|
|
948
|
+
}
|
|
949
|
+
]
|
|
950
|
+
},
|
|
951
|
+
{
|
|
952
|
+
"title": "๐ค Agentic support",
|
|
953
|
+
"audience": "dev",
|
|
954
|
+
"items": [
|
|
955
|
+
{
|
|
956
|
+
"description": "Sweep kb, run-core, and root files against the current writing rules (#2127)",
|
|
957
|
+
"body": "Repairs prose in `packages/kb`, `packages/run-core`, and the repository files outside `packages/` against the current versions of the writing rules, covering READMEs, design docs, code comments, test titles, and the repository's agent guidance.",
|
|
958
|
+
"hash": "0d1b6546d5daf93e044a71e702f7b49e93dcbe45"
|
|
959
|
+
}
|
|
960
|
+
]
|
|
961
|
+
},
|
|
962
|
+
{
|
|
963
|
+
"title": "๐ Documentation",
|
|
964
|
+
"audience": "dev",
|
|
965
|
+
"items": [
|
|
966
|
+
{
|
|
967
|
+
"description": "Revise the agents package's prose against the current writing rules (#2128)",
|
|
968
|
+
"body": "Revises the comments, docs, test names, and printed messages of `packages/agents` against the current writing rules, which completes the `revise-prose` sweep of the package. The CLI's warnings now say that a guidance template or a script \"is provided by more than one content root\" instead of \"is shipped by more than one content root\".",
|
|
969
|
+
"hash": "0a26701f3713fc430be0a104361bbcf7ab51881f"
|
|
970
|
+
},
|
|
971
|
+
{
|
|
972
|
+
"description": "Rewrites the comments, test titles, `README.md`, and `docs/` helper guides of `packages/guidance` to follow the current writing rules. (#2132)",
|
|
973
|
+
"hash": "62f2c0a5859c798e87dc428eb45355ddf399c47e",
|
|
974
|
+
"entry": 2
|
|
975
|
+
}
|
|
976
|
+
]
|
|
977
|
+
}
|
|
978
|
+
]
|
|
979
|
+
},
|
|
2
980
|
{
|
|
3
981
|
"version": "0.1.0",
|
|
4
982
|
"date": "2026-10-10",
|
|
@@ -331,6 +1309,12 @@
|
|
|
331
1309
|
"hash": "2d926535c2f21f9db95e7314e26ef1613071b71c",
|
|
332
1310
|
"entry": 3
|
|
333
1311
|
},
|
|
1312
|
+
{
|
|
1313
|
+
"description": "Remove the codeassembly-mcp server (#1945)",
|
|
1314
|
+
"body": "Removes the `codeassembly-mcp` server and its `codeassembly` registration in `.claude/settings.json`, because its five run-management tools served only the orchestration engine, which has been retired. Keeps the v3 run format in `codeassembly-run-core` as a read-only format, so that existing v3 runs stay readable after the removal of the only tool that wrote them.",
|
|
1315
|
+
"breaking": true,
|
|
1316
|
+
"hash": "9021da623524864946b3f389ffd24b89dbb146ee"
|
|
1317
|
+
},
|
|
334
1318
|
{
|
|
335
1319
|
"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
1320
|
"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.",
|