codeassembly-guidance 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (124) hide show
  1. package/.meta/changelog.json +446 -0
  2. package/CHANGELOG.md +107 -0
  3. package/README.md +47 -51
  4. package/bin/codeassembly-validate-preferences.js +2 -8
  5. package/content/_partials/diff-audit-checklist.md +1 -0
  6. package/content/_partials/kb-unsearched-private-stores.md +6 -0
  7. package/content/_partials/plain-speech.md +2 -2
  8. package/content/_partials/ticket-assessment.md +3 -3
  9. package/content/codeassembly-content.yaml +8 -0
  10. package/content/collections/recommended.md +6 -0
  11. package/content/collections/williamthorsen.md +2 -1
  12. package/content/guidance/rulebooks/accessibility-conventions.md +6 -3
  13. package/content/guidance/rulebooks/cross-repo-migration-conventions.md +27 -0
  14. package/content/guidance/rulebooks/live-worktree-policy.md +2 -2
  15. package/content/guidance/rulebooks/ui-copy-conventions.md +2 -2
  16. package/content/guidance/rulebooks/visual-design-conventions.md +58 -0
  17. package/content/guidance/rulebooks/williamthorsen-collaboration-preferences.md +3 -18
  18. package/content/guidance/rulebooks/williamthorsen-ticketing-preferences.md +7 -1
  19. package/content/guidance/rulebooks/williamthorsen-visual-design-preferences.md +14 -0
  20. package/content/guidance/rulebooks/williamthorsen-workflow-preferences.md +5 -3
  21. package/content/guidance/rulebooks/williamthorsen-writing-preferences.md +5 -20
  22. package/content/guidance/shared/AGENTS.md +3 -4
  23. package/content/scripts/README.md +1 -1
  24. package/content/scripts/check-branch-currency.mjs +7 -7
  25. package/content/scripts/check-prose.mjs +38 -38
  26. package/content/scripts/describe-change.mjs +89 -89
  27. package/content/scripts/manage-jira-ticket.mjs +162 -160
  28. package/content/scripts/select-lede-exemplars.mjs +85 -85
  29. package/content/scripts/validate-preferences.mjs +41 -41
  30. package/content/skills/_data/artifact-conventions.md +3 -3
  31. package/content/skills/_data/entry-points.md +1 -1
  32. package/content/skills/_data/project-stage.md +9 -5
  33. package/content/skills/_data/reduced-object-relatives.md +15 -0
  34. package/content/skills/_data/spike-conventions.md +16 -6
  35. package/content/skills/_data/ticket-evaluation.md +3 -0
  36. package/content/skills/_partials/implementation-order-list.md +27 -0
  37. package/content/skills/_partials/merge-settled-criterion.md +1 -0
  38. package/content/skills/_partials/next-steps-after-plan.md +2 -2
  39. package/content/skills/_partials/plan-template.md +3 -1
  40. package/content/skills/_partials/resolve-plan-and-ticket.md +2 -2
  41. package/content/skills/_partials/split-launch-prompts.md +1 -1
  42. package/content/skills/_partials/split-ticket-create.md +1 -1
  43. package/content/skills/_partials/ticket-criteria-conventions.md +2 -0
  44. package/content/skills/align-ticket-with-implementation/SKILL.md +3 -3
  45. package/content/skills/analyze-performance/SKILL.md +1 -1
  46. package/content/skills/assess-code-health/SKILL.md +4 -4
  47. package/content/skills/assess-code-health/assess-code-health.mjs +20 -20
  48. package/content/skills/assess-ticket/SKILL.md +3 -1
  49. package/content/skills/assess-ticket/next-steps-after-assessment.md +11 -14
  50. package/content/skills/assess-usability/SKILL.md +4 -4
  51. package/content/skills/capture-event/SKILL.md +20 -11
  52. package/content/skills/capture-event/capture-event.mjs +123 -123
  53. package/content/skills/capture-feedback/SKILL.md +2 -1
  54. package/content/skills/capture-lede-decision/SKILL.md +1 -1
  55. package/content/skills/capture-lede-decision/capture-lede-decision.mjs +97 -97
  56. package/content/skills/collaborate/SKILL.md +1 -1
  57. package/content/skills/condense-branch/SKILL.md +18 -36
  58. package/content/skills/condense-branch/condense-branch.mjs +17 -0
  59. package/content/skills/create-bitbucket-pr/SKILL.md +9 -11
  60. package/content/skills/create-commit/SKILL.md +1 -1
  61. package/content/skills/create-devlog/SKILL.md +4 -4
  62. package/content/skills/create-gh-pr/SKILL.md +9 -11
  63. package/content/skills/create-pr/SKILL.md +10 -12
  64. package/content/skills/create-ticket/SKILL.md +22 -15
  65. package/content/skills/create-ticket/resolve-ticket-target.mjs +92 -92
  66. package/content/skills/curate-feedback/SKILL.md +2 -2
  67. package/content/skills/curate-feedback/curate-feedback.mjs +82 -82
  68. package/content/skills/derive-session-context/derive-session-context.mjs +120 -120
  69. package/content/skills/design-and-plan/SKILL.md +10 -8
  70. package/content/skills/groom-backlog/groom-backlog.mjs +15 -15
  71. package/content/skills/implement-plan/SKILL.md +4 -2
  72. package/content/skills/implementation-order/implementation-order.mjs +67 -0
  73. package/content/skills/index-prototypes/SKILL.md +2 -2
  74. package/content/skills/investigate-spike/SKILL.md +3 -3
  75. package/content/skills/kb-add/SKILL.md +12 -3
  76. package/content/skills/kb-add/kb-add.mjs +88 -88
  77. package/content/skills/kb-curate/kb-curate.mjs +88 -88
  78. package/content/skills/kb-edit/kb-edit.mjs +90 -90
  79. package/content/skills/kb-retrieve/SKILL.md +8 -3
  80. package/content/skills/kb-retrieve/kb-retrieve.mjs +104 -104
  81. package/content/skills/kb-retrieve-events/SKILL.md +8 -3
  82. package/content/skills/kb-retrieve-events/kb-retrieve-events.mjs +113 -113
  83. package/content/skills/kb-update-events/kb-update-events.mjs +92 -92
  84. package/content/skills/lesson-clusters/lesson-clusters.mjs +102 -102
  85. package/content/skills/list-gh-progress-items/SKILL.md +36 -0
  86. package/content/skills/list-gh-progress-items/list-gh-progress-items.mjs +68 -0
  87. package/content/skills/list-implementation-order/SKILL.md +23 -0
  88. package/content/skills/merge-bb-pr/SKILL.md +40 -19
  89. package/content/skills/merge-gh-pr/SKILL.md +34 -23
  90. package/content/skills/merge-gh-pr/merge-gh-pr.mjs +13 -8
  91. package/content/skills/merge-pr/SKILL.md +64 -31
  92. package/content/skills/migrate-feedback-memories/SKILL.md +1 -0
  93. package/content/skills/plan/SKILL.md +5 -3
  94. package/content/skills/prepare-prototype-brief/SKILL.md +5 -3
  95. package/content/skills/pull-from-backlog/pull-from-backlog.mjs +22 -22
  96. package/content/skills/refine-plan/SKILL.md +5 -3
  97. package/content/skills/refine-prototype/SKILL.md +2 -1
  98. package/content/skills/respond-to-review/SKILL.md +4 -4
  99. package/content/skills/review-bb-pr/SKILL.md +1 -2
  100. package/content/skills/review-branch/SKILL.md +19 -14
  101. package/content/skills/review-criteria/SKILL.md +2 -2
  102. package/content/skills/review-gh-pr/SKILL.md +1 -2
  103. package/content/skills/review-pr/SKILL.md +2 -3
  104. package/content/skills/revise-prose/revise-prose.mjs +109 -109
  105. package/content/skills/save-artifact/SKILL.md +4 -6
  106. package/content/skills/save-plan/SKILL.md +4 -2
  107. package/content/skills/start-ticket/SKILL.md +1 -1
  108. package/content/skills/streamline-guidance/streamline-guidance.mjs +80 -80
  109. package/content/skills/summarize-change/SKILL.md +20 -9
  110. package/content/skills/summarize-chat/SKILL.md +2 -2
  111. package/content/skills/testing-conventions/SKILL.md +2 -2
  112. package/content/skills/triage-feedback/SKILL.md +6 -2
  113. package/content/skills/triage-spike-findings/SKILL.md +33 -24
  114. package/content/skills/triage-spike-findings/triage-spike-findings.mjs +19 -19
  115. package/content/skills/update-project-guidance/SKILL.md +1 -1
  116. package/content/skills/wrap-up/SKILL.md +8 -4
  117. package/content/skills/write-progress-report/SKILL.md +111 -0
  118. package/content/skills/write-progress-report/write-progress-report.mjs +150 -0
  119. package/content/subagents/disposition-challenger.md +7 -6
  120. package/content/subagents/entry-drafter.md +2 -0
  121. package/content/subagents/usability-assessor.md +3 -2
  122. package/package.json +13 -12
  123. package/schemas/preferences.v1.json +82 -8
  124. package/schemas/work-types.v1.json +1 -1
@@ -36,21 +36,19 @@ Run artifacts are saved by the skills that produce them (`review-branch`, `respo
36
36
 
37
37
  ## Path resolution
38
38
 
39
- Resolve the artifact directory before saving. Invoke `node {harness_home_dir}/skills/derive-session-context/derive-session-context.mjs` via Bash to obtain `artifact_base_dir`, `project_slug`, and `ticket_id` from the manifest JSON emitted on stdout.
39
+ Resolve the artifact directory before saving. Invoke `node {harness_home_dir}/skills/derive-session-context/derive-session-context.mjs` via Bash to obtain `ticket_dir` and `project_artifact_dir` from the manifest JSON emitted on stdout. The deriver composes both; do not compose either from other manifest fields.
40
40
 
41
41
  ### Ticket-scoped path
42
42
 
43
- ```
44
- {artifact_base_dir}/projects/{project_slug}/tickets/{ticket_id}/
45
- ```
43
+ The ticket directory, `{ticket_dir}`, is the manifest's `ticket_dir`. When `ticket_dir` is `null`, the branch does not encode a ticket: Generate an ID per [artifact conventions](../_data/artifact-conventions.md#ticket-id), and use `{project_artifact_dir}/tickets/{generated id}`. Every skill that resolves the ticket directory per this skill takes this fallback; it is not restated elsewhere.
46
44
 
47
45
  Create the directory if needed.
48
46
 
49
47
  ### Non-ticket paths
50
48
 
51
- Read `artifact_paths` from the session-context manifest for category paths (chats, devlogs, plans). These are relative to the project directory: `{artifact_base_dir}/projects/{project_slug}/{category}/`.
49
+ Read `artifact_paths` from the session-context manifest for category paths (chats, devlogs, plans). These are relative to the project directory: `{project_artifact_dir}/{category}/`.
52
50
 
53
- Devlogs, deferred-findings, feedback-curation, and feedback-triage artifacts use their non-ticket category paths only as a fallback: When a ticket is in session context they are written as ticket-level artifacts under `tickets/{ticket_id}/` instead. See [artifact conventions](../_data/artifact-conventions.md#non-ticket-paths) for the dual-homing rule. For frontmatter shapes, see `create-devlog/SKILL.md` (devlogs), the deferred-findings step in `wrap-up/SKILL.md` (deferred-findings), step 8 of `curate-feedback/SKILL.md` (feedback-curation), and step 8 of `triage-feedback/SKILL.md` (feedback-triage).
51
+ Devlogs, deferred-findings, feedback-curation, and feedback-triage artifacts use their non-ticket category paths only as a fallback: When a ticket is in session context they are written as ticket-level artifacts under `{ticket_dir}/` instead. See [artifact conventions](../_data/artifact-conventions.md#non-ticket-paths) for the dual-homing rule. For frontmatter shapes, see `create-devlog/SKILL.md` (devlogs), the deferred-findings step in `wrap-up/SKILL.md` (deferred-findings), step 8 of `curate-feedback/SKILL.md` (feedback-curation), and step 8 of `triage-feedback/SKILL.md` (feedback-triage).
54
52
 
55
53
  Follow [artifact conventions](../_data/artifact-conventions.md).
56
54
 
@@ -13,8 +13,8 @@ Save the plan from the current conversation as a ticket-scoped artifact. Useful
13
13
  1. **Extract plan content** from conversation context (the most recent plan discussed or produced)
14
14
 
15
15
  2. **Resolve artifact path**:
16
- - Invoke `node {harness_home_dir}/skills/derive-session-context/derive-session-context.mjs` via Bash to obtain `ticket_id`, `project_slug`, and `artifact_base_dir` from the manifest JSON emitted on stdout
17
- - Ticket directory: `{artifact_base_dir}/projects/{project_slug}/tickets/{ticket_id}/`
16
+ - Invoke `node {harness_home_dir}/skills/derive-session-context/derive-session-context.mjs` via Bash to obtain `ticket_dir` from the manifest JSON emitted on stdout
17
+ - Ticket directory: `{ticket_dir}/`, or the directory that {skill:save-artifact} states when `ticket_dir` is null
18
18
 
19
19
  3. **Resolve the slug** per [artifact conventions](../_data/artifact-conventions.md#naming-conventions)
20
20
 
@@ -53,3 +53,5 @@ Follow the options, output format, and recommendation rules in [next-steps optio
53
53
  <!-- include: ../_partials/next-steps-after-plan.md / -->
54
54
 
55
55
  <!-- include: ../_partials/option-format.md / -->
56
+
57
+ <!-- include: ../_partials/implementation-order-list.md / -->
@@ -14,7 +14,7 @@ Open the work in a ticket's worktree with one fixed prompt. The skill resolves t
14
14
 
15
15
  ## Process
16
16
 
17
- 1. **Get context**: Invoke `node {harness_home_dir}/skills/derive-session-context/derive-session-context.mjs` via Bash, and read `branch_name`, `ticket_id`, `ticket_ref`, `ticket_url`, `pr_url`, `project_slug`, and `artifact_base_dir` from the manifest JSON that it emits.
17
+ 1. **Get context**: Invoke `node {harness_home_dir}/skills/derive-session-context/derive-session-context.mjs` via Bash, and read `branch_name`, `ticket_id`, `ticket_ref`, `ticket_url`, `pr_url`, and `ticket_dir` from the manifest JSON that it emits.
18
18
 
19
19
  2. **Resolve the ticket** from the argument, or else by [auto-resolve](../_data/ticket-source-resolution.md#auto-resolve), requesting the ticket's state with its content. When the argument is absent and `ticket_id` is null, as on the default branch, say that the branch does not encode a ticket and ask for the ticket ref. Never guess a ticket from the branch's commits, the artifact directory, or the backlog. When the source resolves to a URL, persist it per [Stored ticket URL](../_data/ticket-source-resolution.md#stored-ticket-url), and report the ticket's open blockers per [Open blockers](../_data/ticket-source-resolution.md#open-blockers). A blocker does not stop the choice; the skill that opens the work decides what it means.
20
20