codeassembly-guidance 0.5.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.meta/changelog.json +491 -0
- package/CHANGELOG.md +118 -0
- package/README.md +33 -4
- package/content/_partials/finding-grades.md +4 -0
- package/content/_partials/kb-unsearched-private-stores.md +6 -0
- package/content/codeassembly-content.yaml +4 -0
- package/content/collections/recommended.md +5 -2
- package/content/guidance/_harnesses/rovo/AGENTS.md +0 -1
- package/content/guidance/rulebooks/accessibility-conventions.md +26 -6
- package/content/guidance/rulebooks/cli-conventions.md +17 -2
- package/content/guidance/rulebooks/codeassembly-content-specification.md +11 -11
- package/content/guidance/rulebooks/live-worktree-policy.md +2 -2
- package/content/guidance/rulebooks/machine-readable-output-conventions.md +85 -0
- package/content/guidance/rulebooks/ui-copy-conventions.md +2 -2
- package/content/guidance/rulebooks/williamthorsen-collaboration-preferences.md +10 -10
- package/content/guidance/rulebooks/williamthorsen-ticketing-preferences.md +3 -1
- package/content/guidance/rulebooks/williamthorsen-typescript-preferences.md +7 -3
- package/content/guidance/rulebooks/williamthorsen-workflow-preferences.md +3 -1
- package/content/guidance/rulebooks/williamthorsen-writing-preferences.md +5 -5
- package/content/guidance/shared/AGENTS.md +1 -1
- package/content/scripts/check-prose.mjs +1 -1
- package/content/scripts/describe-change.mjs +88 -88
- package/content/scripts/manage-jira-ticket.mjs +113 -113
- package/content/scripts/select-lede-exemplars.mjs +85 -85
- package/content/scripts/validate-preferences.mjs +38 -38
- package/content/skills/_data/action-items.md +2 -2
- package/content/skills/_data/artifact-conventions.md +20 -10
- package/content/skills/_data/concision.md +1 -1
- package/content/skills/_data/entry-points.md +37 -0
- package/content/skills/_data/project-stage.md +9 -5
- package/content/skills/_data/recommendation-gradient.md +6 -6
- package/content/skills/_data/spike-conventions.md +20 -7
- package/content/skills/_data/ticket-source-resolution.md +21 -4
- package/content/skills/_data/title-templates.md +4 -4
- package/content/skills/_partials/commit-title-rendering.md +2 -1
- package/content/skills/_partials/implementation-order-list.md +27 -0
- package/content/skills/_partials/next-steps-after-plan.md +6 -5
- package/content/skills/_partials/option-format.md +8 -8
- package/content/skills/_partials/plan-template.md +5 -1
- package/content/skills/_partials/resolve-plan-and-ticket.md +22 -0
- package/content/skills/_partials/split-launch-prompts.md +2 -2
- package/content/skills/_partials/ticket-criteria-conventions.md +2 -0
- package/content/skills/align-ticket-with-implementation/SKILL.md +1 -1
- package/content/skills/analyze-performance/SKILL.md +102 -0
- package/content/skills/analyze-performance/analyze-performance.mjs +70 -0
- package/content/skills/assess-code-health/SKILL.md +16 -14
- package/content/skills/assess-code-health/assess-code-health.mjs +29 -28
- package/content/skills/assess-usability/SKILL.md +5 -3
- package/content/skills/capture-event/SKILL.md +20 -11
- package/content/skills/capture-event/capture-event.mjs +122 -122
- package/content/skills/capture-feedback/SKILL.md +2 -1
- package/content/skills/capture-lede-decision/capture-lede-decision.mjs +97 -97
- package/content/skills/convert-agent-prompt/SKILL.md +60 -0
- package/content/skills/create-commit/SKILL.md +10 -5
- package/content/skills/create-pr/SKILL.md +11 -11
- package/content/skills/create-ticket/SKILL.md +1 -0
- package/content/skills/create-ticket/resolve-ticket-target.mjs +92 -92
- package/content/skills/curate-feedback/curate-feedback.mjs +82 -82
- package/content/skills/derive-session-context/derive-session-context.mjs +107 -107
- package/content/skills/design-and-plan/SKILL.md +6 -4
- package/content/skills/implement-plan/SKILL.md +4 -29
- package/content/skills/implementation-order/implementation-order.mjs +67 -0
- package/content/skills/index-prototypes/SKILL.md +36 -17
- package/content/skills/index-prototypes/index-prototypes.mjs +14 -14
- package/content/skills/investigate-spike/SKILL.md +48 -0
- 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-implementation-order/SKILL.md +23 -0
- package/content/skills/merge-bb-pr/SKILL.md +31 -8
- package/content/skills/merge-gh-pr/SKILL.md +25 -12
- package/content/skills/merge-gh-pr/merge-gh-pr.mjs +13 -8
- package/content/skills/merge-pr/SKILL.md +55 -20
- package/content/skills/migrate-feedback-memories/SKILL.md +1 -0
- package/content/skills/plan/SKILL.md +3 -1
- package/content/skills/prepare-prototype-brief/SKILL.md +20 -14
- package/content/skills/refine-plan/SKILL.md +9 -4
- package/content/skills/refine-prototype/SKILL.md +5 -5
- package/content/skills/review-branch/SKILL.md +8 -8
- package/content/skills/review-criteria/SKILL.md +4 -4
- package/content/skills/review-gh-pr/SKILL.md +1 -1
- package/content/skills/revise-prose/SKILL.md +9 -8
- package/content/skills/revise-prose/revise-prose.mjs +111 -111
- package/content/skills/save-plan/SKILL.md +2 -0
- package/content/skills/start-ticket/SKILL.md +27 -0
- package/content/skills/streamline-guidance/streamline-guidance.mjs +76 -76
- package/content/skills/summarize-change/SKILL.md +27 -9
- package/content/skills/testing-conventions/SKILL.md +14 -3
- package/content/skills/triage-feedback/SKILL.md +4 -0
- package/content/skills/triage-spike-findings/SKILL.md +36 -12
- package/content/skills/typescript-testing-conventions/SKILL.md +40 -0
- package/content/skills/wrap-up/SKILL.md +4 -0
- package/content/subagents/_data/claude.yaml +3 -0
- package/content/subagents/code-health-assessor.md +4 -4
- package/content/subagents/disposition-challenger.md +3 -4
- package/content/subagents/entry-drafter.md +2 -2
- package/content/subagents/handoff-reviewer.md +1 -1
- package/content/subagents/prototype-builder.md +69 -0
- package/content/subagents/usability-assessor.md +1 -1
- package/package.json +11 -10
- package/schemas/preferences.v1.json +74 -8
- package/schemas/work-types.v1.json +1 -1
- package/content/guidance/_harnesses/rovo/codeassembly-guidance.md +0 -4
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"$id": "https://unpkg.com/codeassembly-guidance@0.
|
|
3
|
+
"$id": "https://unpkg.com/codeassembly-guidance@0.7.0/schemas/preferences.v1.json",
|
|
4
4
|
"title": "Preferences",
|
|
5
5
|
"description": "Configuration read by agent skills. Resolved from .agents/preferences.yaml at the project level, with ~/.agents/preferences.yaml as a global fallback.",
|
|
6
6
|
"type": "object",
|
|
@@ -109,19 +109,37 @@
|
|
|
109
109
|
},
|
|
110
110
|
"merge": {
|
|
111
111
|
"type": "object",
|
|
112
|
-
"description": "
|
|
112
|
+
"description": "Merge configuration for the `merge-pr` skill family: approval, merge strategy, branch deletion, and squash-merge title rendering.",
|
|
113
113
|
"properties": {
|
|
114
|
+
"approval": {
|
|
115
|
+
"type": "string",
|
|
116
|
+
"enum": [
|
|
117
|
+
"ask",
|
|
118
|
+
"auto"
|
|
119
|
+
],
|
|
120
|
+
"description": "Whether `merge-pr` asks before merging: `ask`, or `auto` to merge without asking only when the run is clean: no notice, no decision of its own, not breaking, and a clean merge state on GitHub. Defaults to `ask`."
|
|
121
|
+
},
|
|
114
122
|
"title_format": {
|
|
115
123
|
"type": "string",
|
|
116
124
|
"description": "Template string used to render the squash-merge commit title. Supports the same token vocabulary as `commit.title_format`, plus `{pr_number}`."
|
|
117
125
|
},
|
|
118
126
|
"strategy": {
|
|
119
127
|
"type": "string",
|
|
120
|
-
"
|
|
128
|
+
"enum": [
|
|
129
|
+
"squash",
|
|
130
|
+
"merge",
|
|
131
|
+
"rebase"
|
|
132
|
+
],
|
|
133
|
+
"description": "How `merge-pr` merges a pull request. Its `--strategy` flag outranks this value. Defaults to `squash`."
|
|
121
134
|
},
|
|
122
|
-
"
|
|
123
|
-
"type": "
|
|
124
|
-
"
|
|
135
|
+
"deletion_strategy": {
|
|
136
|
+
"type": "string",
|
|
137
|
+
"enum": [
|
|
138
|
+
"both",
|
|
139
|
+
"remote",
|
|
140
|
+
"none"
|
|
141
|
+
],
|
|
142
|
+
"description": "Which branches `merge-pr` deletes after merging: `both` (GitHub only), `remote`, or `none`. Its `--delete` flag outranks this value. Defaults to `remote`."
|
|
125
143
|
}
|
|
126
144
|
}
|
|
127
145
|
},
|
|
@@ -153,7 +171,7 @@
|
|
|
153
171
|
},
|
|
154
172
|
"project": {
|
|
155
173
|
"type": "object",
|
|
156
|
-
"description": "Project identification configuration, and the project's declared stage (`maturity`, `sensitivity`, `audience`), which design guidance treats as premises.",
|
|
174
|
+
"description": "Project identification configuration, and the project's declared stage (`maturity`, `sensitivity`, `audience`, and the `stages` of its subdirectories), which design guidance treats as premises.",
|
|
157
175
|
"properties": {
|
|
158
176
|
"audience": {
|
|
159
177
|
"type": "string",
|
|
@@ -167,11 +185,12 @@
|
|
|
167
185
|
"maturity": {
|
|
168
186
|
"type": "string",
|
|
169
187
|
"enum": [
|
|
188
|
+
"exploration",
|
|
170
189
|
"hobby",
|
|
171
190
|
"early",
|
|
172
191
|
"production"
|
|
173
192
|
],
|
|
174
|
-
"description": "How far the project has come. `hobby`: built for the owner's own use or learning; breakage costs only the owner's time. `early`: in use by others, but the shape is still changing; downtime is tolerated. `production`: others depend on it; downtime and data loss have real costs. Read from the project preferences file only."
|
|
193
|
+
"description": "How far the project has come. `exploration`: the output's shape is still being found, and nothing depends on it yet. `hobby`: built for the owner's own use or learning; breakage costs only the owner's time. `early`: in use by others, but the shape is still changing; downtime is tolerated. `production`: others depend on it; downtime and data loss have real costs. Read from the project preferences file only."
|
|
175
194
|
},
|
|
176
195
|
"scopes": {
|
|
177
196
|
"type": "array",
|
|
@@ -209,6 +228,53 @@
|
|
|
209
228
|
"type": "string",
|
|
210
229
|
"description": "Project identifier used for namespacing artifacts under `{base_dir}/projects/{slug}/`."
|
|
211
230
|
},
|
|
231
|
+
"stages": {
|
|
232
|
+
"type": "array",
|
|
233
|
+
"description": "Stages that subdirectories declare, overriding the project's for work under them. Each value that an entry leaves undeclared is inherited from the project. When entries are nested, the longest containing path wins. Read from the project preferences file only.",
|
|
234
|
+
"items": {
|
|
235
|
+
"type": "object",
|
|
236
|
+
"properties": {
|
|
237
|
+
"audience": {
|
|
238
|
+
"type": "string",
|
|
239
|
+
"enum": [
|
|
240
|
+
"owner",
|
|
241
|
+
"team",
|
|
242
|
+
"public"
|
|
243
|
+
],
|
|
244
|
+
"description": "Who uses the subdirectory's output, as `project.audience` defines the values."
|
|
245
|
+
},
|
|
246
|
+
"maturity": {
|
|
247
|
+
"type": "string",
|
|
248
|
+
"enum": [
|
|
249
|
+
"exploration",
|
|
250
|
+
"hobby",
|
|
251
|
+
"early",
|
|
252
|
+
"production"
|
|
253
|
+
],
|
|
254
|
+
"description": "How far the subdirectory's work has come, as `project.maturity` defines the values."
|
|
255
|
+
},
|
|
256
|
+
"path": {
|
|
257
|
+
"type": "string",
|
|
258
|
+
"minLength": 1,
|
|
259
|
+
"description": "Directory relative to the repository root."
|
|
260
|
+
},
|
|
261
|
+
"sensitivity": {
|
|
262
|
+
"type": "string",
|
|
263
|
+
"enum": [
|
|
264
|
+
"low",
|
|
265
|
+
"personal",
|
|
266
|
+
"confidential"
|
|
267
|
+
],
|
|
268
|
+
"description": "The most sensitive data that the subdirectory holds, as `project.sensitivity` defines the values."
|
|
269
|
+
}
|
|
270
|
+
},
|
|
271
|
+
"required": [
|
|
272
|
+
"path"
|
|
273
|
+
],
|
|
274
|
+
"minProperties": 2,
|
|
275
|
+
"additionalProperties": false
|
|
276
|
+
}
|
|
277
|
+
},
|
|
212
278
|
"ticket_ref_prefix": {
|
|
213
279
|
"type": "string",
|
|
214
280
|
"description": "Prefix that appears at the start of `ticket_ref`. Use `#` for GitHub issues (added at render time, omitted from file paths) or a Jira project key like `MAC-` (part of the canonical ticket ID)."
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"$id": "https://unpkg.com/codeassembly-guidance@0.
|
|
3
|
+
"$id": "https://unpkg.com/codeassembly-guidance@0.7.0/schemas/work-types.v1.json",
|
|
4
4
|
"additionalProperties": false,
|
|
5
5
|
"description": "Canonical work-types taxonomy consumed by skill content and downstream changelog/release-notes tooling. Defines the work-type vocabulary, tier grouping, breaking-change policy, changelog-eligibility flags, and cross-cutting section markers (e.g., the breaking-changes indicator).",
|
|
6
6
|
"properties": {
|