codeassembly-guidance 0.7.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 (101) hide show
  1. package/.meta/changelog.json +261 -0
  2. package/CHANGELOG.md +62 -0
  3. package/README.md +47 -29
  4. package/bin/codeassembly-validate-preferences.js +2 -8
  5. package/content/_partials/diff-audit-checklist.md +1 -0
  6. package/content/_partials/plain-speech.md +2 -2
  7. package/content/_partials/ticket-assessment.md +3 -3
  8. package/content/codeassembly-content.yaml +6 -0
  9. package/content/collections/recommended.md +6 -0
  10. package/content/collections/williamthorsen.md +2 -1
  11. package/content/guidance/rulebooks/accessibility-conventions.md +6 -3
  12. package/content/guidance/rulebooks/cross-repo-migration-conventions.md +27 -0
  13. package/content/guidance/rulebooks/ui-copy-conventions.md +2 -2
  14. package/content/guidance/rulebooks/visual-design-conventions.md +58 -0
  15. package/content/guidance/rulebooks/williamthorsen-collaboration-preferences.md +3 -18
  16. package/content/guidance/rulebooks/williamthorsen-ticketing-preferences.md +6 -2
  17. package/content/guidance/rulebooks/williamthorsen-visual-design-preferences.md +14 -0
  18. package/content/guidance/rulebooks/williamthorsen-workflow-preferences.md +5 -3
  19. package/content/guidance/rulebooks/williamthorsen-writing-preferences.md +5 -20
  20. package/content/guidance/shared/AGENTS.md +2 -3
  21. package/content/scripts/README.md +1 -1
  22. package/content/scripts/check-branch-currency.mjs +7 -7
  23. package/content/scripts/check-prose.mjs +38 -38
  24. package/content/scripts/describe-change.mjs +32 -32
  25. package/content/scripts/manage-jira-ticket.mjs +148 -146
  26. package/content/scripts/validate-preferences.mjs +9 -9
  27. package/content/skills/_data/artifact-conventions.md +3 -3
  28. package/content/skills/_data/entry-points.md +1 -1
  29. package/content/skills/_data/reduced-object-relatives.md +15 -0
  30. package/content/skills/_data/spike-conventions.md +9 -2
  31. package/content/skills/_data/ticket-evaluation.md +3 -0
  32. package/content/skills/_partials/implementation-order-list.md +4 -4
  33. package/content/skills/_partials/merge-settled-criterion.md +1 -0
  34. package/content/skills/_partials/plan-template.md +1 -1
  35. package/content/skills/_partials/resolve-plan-and-ticket.md +2 -2
  36. package/content/skills/_partials/split-ticket-create.md +1 -1
  37. package/content/skills/_partials/ticket-criteria-conventions.md +2 -0
  38. package/content/skills/align-ticket-with-implementation/SKILL.md +2 -2
  39. package/content/skills/analyze-performance/SKILL.md +1 -1
  40. package/content/skills/assess-code-health/SKILL.md +4 -4
  41. package/content/skills/assess-code-health/assess-code-health.mjs +20 -20
  42. package/content/skills/assess-ticket/SKILL.md +3 -1
  43. package/content/skills/assess-ticket/next-steps-after-assessment.md +11 -14
  44. package/content/skills/assess-usability/SKILL.md +4 -4
  45. package/content/skills/capture-event/capture-event.mjs +30 -30
  46. package/content/skills/capture-lede-decision/SKILL.md +1 -1
  47. package/content/skills/capture-lede-decision/capture-lede-decision.mjs +37 -37
  48. package/content/skills/collaborate/SKILL.md +1 -1
  49. package/content/skills/condense-branch/SKILL.md +18 -36
  50. package/content/skills/condense-branch/condense-branch.mjs +17 -0
  51. package/content/skills/create-bitbucket-pr/SKILL.md +9 -11
  52. package/content/skills/create-commit/SKILL.md +1 -1
  53. package/content/skills/create-devlog/SKILL.md +4 -4
  54. package/content/skills/create-gh-pr/SKILL.md +9 -11
  55. package/content/skills/create-pr/SKILL.md +9 -11
  56. package/content/skills/create-ticket/SKILL.md +22 -15
  57. package/content/skills/curate-feedback/SKILL.md +2 -2
  58. package/content/skills/derive-session-context/derive-session-context.mjs +103 -103
  59. package/content/skills/design-and-plan/SKILL.md +6 -6
  60. package/content/skills/groom-backlog/groom-backlog.mjs +15 -15
  61. package/content/skills/implement-plan/SKILL.md +1 -1
  62. package/content/skills/implementation-order/implementation-order.mjs +29 -29
  63. package/content/skills/index-prototypes/SKILL.md +2 -2
  64. package/content/skills/investigate-spike/SKILL.md +3 -3
  65. package/content/skills/list-gh-progress-items/SKILL.md +36 -0
  66. package/content/skills/list-gh-progress-items/list-gh-progress-items.mjs +68 -0
  67. package/content/skills/list-implementation-order/SKILL.md +2 -2
  68. package/content/skills/merge-bb-pr/SKILL.md +9 -11
  69. package/content/skills/merge-gh-pr/SKILL.md +9 -11
  70. package/content/skills/merge-pr/SKILL.md +10 -12
  71. package/content/skills/plan/SKILL.md +2 -2
  72. package/content/skills/prepare-prototype-brief/SKILL.md +2 -2
  73. package/content/skills/pull-from-backlog/pull-from-backlog.mjs +22 -22
  74. package/content/skills/refine-plan/SKILL.md +3 -3
  75. package/content/skills/refine-prototype/SKILL.md +2 -1
  76. package/content/skills/respond-to-review/SKILL.md +4 -4
  77. package/content/skills/review-bb-pr/SKILL.md +1 -2
  78. package/content/skills/review-branch/SKILL.md +18 -13
  79. package/content/skills/review-criteria/SKILL.md +1 -1
  80. package/content/skills/review-gh-pr/SKILL.md +1 -2
  81. package/content/skills/review-pr/SKILL.md +2 -3
  82. package/content/skills/revise-prose/revise-prose.mjs +52 -52
  83. package/content/skills/save-artifact/SKILL.md +4 -6
  84. package/content/skills/save-plan/SKILL.md +2 -2
  85. package/content/skills/start-ticket/SKILL.md +1 -1
  86. package/content/skills/streamline-guidance/streamline-guidance.mjs +24 -24
  87. package/content/skills/summarize-change/SKILL.md +5 -4
  88. package/content/skills/summarize-chat/SKILL.md +2 -2
  89. package/content/skills/triage-feedback/SKILL.md +2 -2
  90. package/content/skills/triage-spike-findings/SKILL.md +26 -22
  91. package/content/skills/triage-spike-findings/triage-spike-findings.mjs +19 -19
  92. package/content/skills/update-project-guidance/SKILL.md +1 -1
  93. package/content/skills/wrap-up/SKILL.md +4 -4
  94. package/content/skills/write-progress-report/SKILL.md +111 -0
  95. package/content/skills/write-progress-report/write-progress-report.mjs +150 -0
  96. package/content/subagents/disposition-challenger.md +7 -6
  97. package/content/subagents/entry-drafter.md +2 -0
  98. package/content/subagents/usability-assessor.md +3 -2
  99. package/package.json +11 -10
  100. package/schemas/preferences.v1.json +9 -1
  101. package/schemas/work-types.v1.json +1 -1
@@ -14,7 +14,7 @@ Publish one index page for a ticket's prototypes instead of one link per prototy
14
14
  A ticket has one prototype set, in its artifact directory:
15
15
 
16
16
  ```
17
- {artifact_base_dir}/projects/{project_slug}/tickets/{ticket_id}/prototypes/
17
+ {ticket_dir}/prototypes/
18
18
  ├── manifest.json # set title, summary, index URL, one entry per registration
19
19
  ├── shots/{slug}-v{n}.png
20
20
  └── {slug}-v{n}.html # prototype sources
@@ -47,7 +47,7 @@ The set has one list of note labels: a few facts that differ from one prototype
47
47
 
48
48
  ### 1. Resolve the set directory
49
49
 
50
- Invoke `node {harness_home_dir}/skills/derive-session-context/derive-session-context.mjs` via Bash, and build the set directory from `artifact_base_dir`, `project_slug`, and `ticket_id` as shown above. When `manifest.json` exists there, read it, and [read back the verdicts](#read-back-the-verdicts) before planning the round.
50
+ Invoke `node {harness_home_dir}/skills/derive-session-context/derive-session-context.mjs` via Bash, and build the set directory from the manifest's `ticket_dir` as shown above. When `manifest.json` exists there, read it, and [read back the verdicts](#read-back-the-verdicts) before planning the round.
51
51
 
52
52
  Resolve a scratch directory for the rendered page: the scratchpad directory that the environment declares, or, when it declares none, a new one:
53
53
 
@@ -6,7 +6,7 @@ user-invocable: true
6
6
 
7
7
  # Investigate spike
8
8
 
9
- Carry out a spike plan, the `## Investigation steps` / `## Deliverable` shape defined in [spike conventions](../_data/spike-conventions.md). A spike produces findings rather than a diff: The run ends with a findings artifact and either the offer of the closing post or, when the findings propose work, the recommendation of the triage round that offers it, not with commits. The skill re-resolves everything it needs from the environment, so it works the same in the session that produced the plan and in a fresh one.
9
+ Carry out a spike plan, the `## Investigation steps` / `## Deliverable` shape defined in [spike conventions](../_data/spike-conventions.md). A spike produces findings rather than a diff: The run ends with a findings artifact and either the offer of the closing post or, when the findings propose work on a [triage platform](../_data/spike-conventions.md#triage-platforms), the recommendation of the triage round that offers it, not with commits. The skill re-resolves everything it needs from the environment, so it works the same in the session that produced the plan and in a fresh one.
10
10
 
11
11
  ## Arguments
12
12
 
@@ -40,8 +40,8 @@ The plan artifact is read-only. It records what was planned, and a later reader
40
40
  7. **Report** the answers and the recommendations against the ticket's questions and decisions, naming any question left unanswered and any departure from the plan, and give the artifact's path.
41
41
 
42
42
  8. **Close** with an action-items block:
43
- - When the findings propose work, recommend {skill?:triage-spike-findings} with the artifact path and the ticket, and do not offer the closing post: The triage round ends the spike and offers it, as [Closing post](../_data/spike-conventions.md#closing-post) states.
44
- - Otherwise, when a ticket governs the run, offer to close it with the closing post, with the post's body shown; on consent, post it and close the ticket as that section states.
43
+ - When the findings propose work and the ticket is on a [triage platform](../_data/spike-conventions.md#triage-platforms), recommend {skill?:triage-spike-findings} with the artifact path and the ticket, and do not offer the closing post: The triage round ends the spike and offers it, as [Closing post](../_data/spike-conventions.md#closing-post) states.
44
+ - Otherwise, when a ticket governs the run, name the proposals left for disposal by hand when there are any, and offer to close it with the closing post, with the post's body shown; on consent, post it and close the ticket as that section states.
45
45
 
46
46
  <!-- include: ../_partials/action-items.md / -->
47
47
 
@@ -0,0 +1,36 @@
1
+ ---
2
+ name: list-gh-progress-items
3
+ description: List a GitHub repository's issues as progress-report items, using the delegate interface from write-progress-report
4
+ user-invocable: false
5
+ ---
6
+
7
+ # List GitHub progress items
8
+
9
+ Internal delegate that supplies the work items of a progress report from a GitHub repository's issues. Called by `write-progress-report`; this skill does not assign statuses or render anything.
10
+
11
+ ## Delegate interface
12
+
13
+ | Input | Type | Description |
14
+ | ----------------- | ---------------- | -------------------------------------------------------------------------------------------- |
15
+ | `out` | string | The path to which the items file is written |
16
+ | `scope` | string or absent | A GitHub issue search query, such as `label:customer milestone:v2`; absent reads every issue |
17
+ | `repo` | string or absent | The repository as `OWNER/NAME`; absent means the repository of the working directory |
18
+ | `limit` | number or absent | The most issues to read; 500 when absent |
19
+ | `needsInputLabel` | string or absent | The label that marks an issue as an ask of the customer; `needs-input` when absent |
20
+
21
+ The delegate reports the items file's path, the item count, and whether the limit cut the list.
22
+
23
+ ## Mapping
24
+
25
+ An issue closed as completed is completed on the UTC date of its `closedAt`. An issue closed for any other reason is closed and not completed, which the report omits. An open issue has started when it has an assignee or a linked pull request. An open issue with the needs-input label needs the customer's input. A milestone's due date is the target date of each of its issues. An issue's parent issue is its workstream, identified by the parent's URL, and an issue that has sub-issues is a workstream rather than an item. The issue's URL is its source, which the report never renders.
26
+
27
+ ## Process
28
+
29
+ 1. Run `gh auth status`. If it fails, stop and report that `gh` is not authenticated.
30
+ 2. Run the helper:
31
+
32
+ ```bash
33
+ node {harness_home_dir}/skills/list-gh-progress-items/list-gh-progress-items.mjs list --out {out} [--scope {scope}] [--repo {repo}] [--limit {limit}] [--needs-input-label {needsInputLabel}]
34
+ ```
35
+
36
+ 3. When the result has `ok: false`, stop and report its `message` as written. Otherwise, return its `path`, `count`, and `truncated` to the caller.