codeassembly-guidance 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/.meta/changelog.json +291 -0
  2. package/CHANGELOG.md +82 -0
  3. package/README.md +20 -121
  4. package/content/_partials/README.md +19 -3
  5. package/content/_partials/diff-audit-checklist.md +1 -0
  6. package/content/_partials/guidance-change-since-capture.md +9 -0
  7. package/content/_partials/kb-standard-tags.md +7 -0
  8. package/content/codeassembly-content.yaml +8 -0
  9. package/content/collections/recommended.md +1 -1
  10. package/content/guidance/README.md +1 -1
  11. package/content/guidance/rulebooks/cli-conventions.md +16 -2
  12. package/content/guidance/rulebooks/codeassembly-content-specification.md +19 -2
  13. package/content/guidance/rulebooks/commit-conventions.md +3 -2
  14. package/content/guidance/rulebooks/williamthorsen-collaboration-preferences.md +6 -2
  15. package/content/guidance/rulebooks/williamthorsen-writing-preferences.md +28 -1
  16. package/content/guidance/shared/AGENTS.md +31 -4
  17. package/content/scripts/check-prose.mjs +38 -38
  18. package/content/scripts/describe-change.mjs +69 -69
  19. package/content/scripts/manage-jira-ticket.mjs +73 -73
  20. package/content/scripts/select-lede-exemplars.mjs +53 -53
  21. package/content/scripts/validate-preferences.mjs +1 -1
  22. package/content/skills/_data/action-items.md +2 -0
  23. package/content/skills/_data/artifact-conventions.md +24 -3
  24. package/content/skills/_data/complexity-classification.md +1 -1
  25. package/content/skills/_data/design-priorities.md +12 -1
  26. package/content/skills/_data/spike-conventions.md +21 -6
  27. package/content/skills/_data/title-templates.md +3 -1
  28. package/content/skills/_partials/apply-guidance-edits.md +5 -0
  29. package/content/skills/_partials/cluster-feedback-events.md +21 -0
  30. package/content/skills/_partials/commit-title-rendering.md +1 -1
  31. package/content/skills/_partials/next-steps-after-plan.md +1 -1
  32. package/content/skills/_partials/option-format.md +2 -2
  33. package/content/skills/_partials/plan-template.md +4 -2
  34. package/content/skills/_partials/ticket-and-plan-completeness.md +1 -1
  35. package/content/skills/_partials/ticket-composition.md +40 -0
  36. package/content/skills/_partials/ticket-skeleton.md +15 -1
  37. package/content/skills/align-ticket-with-implementation/SKILL.md +1 -5
  38. package/content/skills/assess-code-health/SKILL.md +127 -0
  39. package/content/skills/assess-code-health/assess-code-health.mjs +77 -0
  40. package/content/skills/assess-usability/SKILL.md +3 -1
  41. package/content/skills/capture-event/SKILL.md +2 -0
  42. package/content/skills/capture-event/capture-event.mjs +32 -32
  43. package/content/skills/capture-feedback/SKILL.md +1 -1
  44. package/content/skills/collaborate/SKILL.md +2 -2
  45. package/content/skills/create-bitbucket-pr/SKILL.md +2 -1
  46. package/content/skills/create-commit/SKILL.md +1 -1
  47. package/content/skills/create-gh-pr/SKILL.md +4 -1
  48. package/content/skills/create-pr/SKILL.md +2 -1
  49. package/content/skills/create-ticket/SKILL.md +3 -7
  50. package/content/skills/curate-feedback/SKILL.md +102 -0
  51. package/content/skills/curate-feedback/curate-feedback.mjs +211 -0
  52. package/content/skills/derive-session-context/derive-session-context.mjs +94 -94
  53. package/content/skills/design-and-plan/SKILL.md +5 -9
  54. package/content/skills/implement-plan/SKILL.md +2 -2
  55. package/content/skills/index-prototypes/SKILL.md +1 -1
  56. package/content/skills/kb-add/SKILL.md +2 -0
  57. package/content/skills/kb-add/kb-add.mjs +53 -53
  58. package/content/skills/kb-curate/kb-curate.mjs +64 -64
  59. package/content/skills/kb-edit/SKILL.md +2 -0
  60. package/content/skills/kb-edit/kb-edit.mjs +59 -59
  61. package/content/skills/kb-retrieve/kb-retrieve.mjs +75 -75
  62. package/content/skills/kb-retrieve-events/SKILL.md +19 -10
  63. package/content/skills/kb-retrieve-events/kb-retrieve-events.mjs +75 -75
  64. package/content/skills/kb-update-events/SKILL.md +9 -6
  65. package/content/skills/kb-update-events/kb-update-events.mjs +86 -85
  66. package/content/skills/lesson-clusters/lesson-clusters.mjs +209 -0
  67. package/content/skills/migrate-feedback-memories/feedback-memories.mjs +75 -75
  68. package/content/skills/plan/SKILL.md +1 -1
  69. package/content/skills/refine-guidance/SKILL.md +97 -0
  70. package/content/skills/review-branch/SKILL.md +350 -1
  71. package/content/skills/revise-prose/revise-prose.mjs +103 -103
  72. package/content/skills/save-artifact/SKILL.md +1 -1
  73. package/content/skills/streamline-guidance/SKILL.md +10 -15
  74. package/content/skills/streamline-guidance/streamline-guidance.mjs +74 -74
  75. package/content/skills/summarize-change/SKILL.md +1 -1
  76. package/content/skills/testing-conventions/SKILL.md +7 -1
  77. package/content/skills/triage-feedback/SKILL.md +135 -0
  78. package/content/skills/triage-feedback/triage-feedback.mjs +70 -0
  79. package/content/skills/triage-spike-findings/SKILL.md +6 -6
  80. package/content/skills/triage-spike-findings/triage-spike-findings.mjs +30 -28
  81. package/content/skills/update-project-guidance/SKILL.md +10 -10
  82. package/content/subagents/code-health-assessor.md +98 -0
  83. package/content/subagents/feedback-coverage-judge.md +95 -0
  84. package/content/subagents/feedback-triage-challenger.md +86 -0
  85. package/content/subagents/lesson-clusterer.md +68 -0
  86. package/package.json +13 -13
  87. package/schemas/preferences.v1.json +22 -6
  88. package/schemas/work-types.v1.json +1 -1
  89. package/content/_partials/code-descriptions.md +0 -4
  90. package/content/_partials/code-style.md +0 -7
  91. package/content/_partials/live-repo-writes.md +0 -13
  92. package/content/_partials/reduced-object-relative.md +0 -28
  93. package/content/_partials/test-structure-audit-checklist.md +0 -7
  94. package/content/skills/_partials/acceptance-criteria-scaffold.md +0 -15
  95. package/content/skills/_partials/next-steps-after-review.md +0 -350
  96. package/content/skills/_partials/ticket-concision.md +0 -18
  97. package/content/skills/_partials/ticket-placement.md +0 -14
  98. package/content/skills/_partials/ticket-skeleton-tiers.md +0 -6
@@ -9,7 +9,7 @@ supported-harnesses: [claude]
9
9
 
10
10
  Find where a product would lead its users to conclude that it is broken or unfinished. Each lens is a {subagent:usability-assessor} that walks its use cases in a browser or, for a command-line product, in a shell, without seeing any other lens's report. You prepare the targets, write the brief that every lens reads, dispatch the lenses one at a time, and merge their reports into one findings artifact.
11
11
 
12
- The skill writes nothing remote: It does not create a ticket, post a comment, or edit an issue. The findings artifact is the input of `triage-spike-findings`, which decides what becomes a ticket.
12
+ The skill's one remote write is the [closing post](../_data/spike-conventions.md#closing-post) on the ticket, made on the developer's consent: It does not create a ticket or edit an issue. The findings artifact is the input of `triage-spike-findings`, which decides what becomes a ticket.
13
13
 
14
14
  ## Inputs
15
15
 
@@ -94,3 +94,5 @@ Then publish it as an artifact page: Load the artifact-design skill, and render
94
94
  ### 7. Report
95
95
 
96
96
  Give the developer the findings artifact's path, the page's URL, and one line of counts: use cases exercised, findings by effect, and ideas. Name `triage-spike-findings` as the next step, with the findings artifact's path as its input.
97
+
98
+ In the same response's action-items block, offer the closing post on the ticket, whose contents, consent, and duplicate check are stated in [Closing post](../_data/spike-conventions.md#closing-post). For an assessment, the answers that the post gives are the counts and the top findings by effect, and its groupings are the proposed groupings of step 5.
@@ -55,6 +55,8 @@ A caller whose destination is a configured role rather than a per-lesson judgmen
55
55
 
56
56
  Amend is a plain in-place edit and does not consult push state. To correct an event that may already have been shared, prefer appending a supersession with `kb-update-events --add-addressed-by` over rewriting it, so that the correction becomes a new record rather than a change to history.
57
57
 
58
+ <!-- include: ../../_partials/kb-standard-tags.md / -->
59
+
58
60
  ## Runtime dependencies
59
61
 
60
62
  - **`node` ≥ 24**: The bundled helper inherits the Node version floor of `@williamthorsen/kb`.