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.
- package/.meta/changelog.json +261 -0
- package/CHANGELOG.md +62 -0
- package/README.md +47 -29
- package/bin/codeassembly-validate-preferences.js +2 -8
- package/content/_partials/diff-audit-checklist.md +1 -0
- package/content/_partials/plain-speech.md +2 -2
- package/content/_partials/ticket-assessment.md +3 -3
- package/content/codeassembly-content.yaml +6 -0
- package/content/collections/recommended.md +6 -0
- package/content/collections/williamthorsen.md +2 -1
- package/content/guidance/rulebooks/accessibility-conventions.md +6 -3
- package/content/guidance/rulebooks/cross-repo-migration-conventions.md +27 -0
- package/content/guidance/rulebooks/ui-copy-conventions.md +2 -2
- package/content/guidance/rulebooks/visual-design-conventions.md +58 -0
- package/content/guidance/rulebooks/williamthorsen-collaboration-preferences.md +3 -18
- package/content/guidance/rulebooks/williamthorsen-ticketing-preferences.md +6 -2
- package/content/guidance/rulebooks/williamthorsen-visual-design-preferences.md +14 -0
- package/content/guidance/rulebooks/williamthorsen-workflow-preferences.md +5 -3
- package/content/guidance/rulebooks/williamthorsen-writing-preferences.md +5 -20
- package/content/guidance/shared/AGENTS.md +2 -3
- package/content/scripts/README.md +1 -1
- package/content/scripts/check-branch-currency.mjs +7 -7
- package/content/scripts/check-prose.mjs +38 -38
- package/content/scripts/describe-change.mjs +32 -32
- package/content/scripts/manage-jira-ticket.mjs +148 -146
- package/content/scripts/validate-preferences.mjs +9 -9
- package/content/skills/_data/artifact-conventions.md +3 -3
- package/content/skills/_data/entry-points.md +1 -1
- package/content/skills/_data/reduced-object-relatives.md +15 -0
- package/content/skills/_data/spike-conventions.md +9 -2
- package/content/skills/_data/ticket-evaluation.md +3 -0
- package/content/skills/_partials/implementation-order-list.md +4 -4
- package/content/skills/_partials/merge-settled-criterion.md +1 -0
- package/content/skills/_partials/plan-template.md +1 -1
- package/content/skills/_partials/resolve-plan-and-ticket.md +2 -2
- package/content/skills/_partials/split-ticket-create.md +1 -1
- package/content/skills/_partials/ticket-criteria-conventions.md +2 -0
- package/content/skills/align-ticket-with-implementation/SKILL.md +2 -2
- package/content/skills/analyze-performance/SKILL.md +1 -1
- package/content/skills/assess-code-health/SKILL.md +4 -4
- package/content/skills/assess-code-health/assess-code-health.mjs +20 -20
- package/content/skills/assess-ticket/SKILL.md +3 -1
- package/content/skills/assess-ticket/next-steps-after-assessment.md +11 -14
- package/content/skills/assess-usability/SKILL.md +4 -4
- package/content/skills/capture-event/capture-event.mjs +30 -30
- package/content/skills/capture-lede-decision/SKILL.md +1 -1
- package/content/skills/capture-lede-decision/capture-lede-decision.mjs +37 -37
- package/content/skills/collaborate/SKILL.md +1 -1
- package/content/skills/condense-branch/SKILL.md +18 -36
- package/content/skills/condense-branch/condense-branch.mjs +17 -0
- package/content/skills/create-bitbucket-pr/SKILL.md +9 -11
- package/content/skills/create-commit/SKILL.md +1 -1
- package/content/skills/create-devlog/SKILL.md +4 -4
- package/content/skills/create-gh-pr/SKILL.md +9 -11
- package/content/skills/create-pr/SKILL.md +9 -11
- package/content/skills/create-ticket/SKILL.md +22 -15
- package/content/skills/curate-feedback/SKILL.md +2 -2
- package/content/skills/derive-session-context/derive-session-context.mjs +103 -103
- package/content/skills/design-and-plan/SKILL.md +6 -6
- package/content/skills/groom-backlog/groom-backlog.mjs +15 -15
- package/content/skills/implement-plan/SKILL.md +1 -1
- package/content/skills/implementation-order/implementation-order.mjs +29 -29
- package/content/skills/index-prototypes/SKILL.md +2 -2
- package/content/skills/investigate-spike/SKILL.md +3 -3
- package/content/skills/list-gh-progress-items/SKILL.md +36 -0
- package/content/skills/list-gh-progress-items/list-gh-progress-items.mjs +68 -0
- package/content/skills/list-implementation-order/SKILL.md +2 -2
- package/content/skills/merge-bb-pr/SKILL.md +9 -11
- package/content/skills/merge-gh-pr/SKILL.md +9 -11
- package/content/skills/merge-pr/SKILL.md +10 -12
- package/content/skills/plan/SKILL.md +2 -2
- package/content/skills/prepare-prototype-brief/SKILL.md +2 -2
- package/content/skills/pull-from-backlog/pull-from-backlog.mjs +22 -22
- package/content/skills/refine-plan/SKILL.md +3 -3
- package/content/skills/refine-prototype/SKILL.md +2 -1
- package/content/skills/respond-to-review/SKILL.md +4 -4
- package/content/skills/review-bb-pr/SKILL.md +1 -2
- package/content/skills/review-branch/SKILL.md +18 -13
- package/content/skills/review-criteria/SKILL.md +1 -1
- package/content/skills/review-gh-pr/SKILL.md +1 -2
- package/content/skills/review-pr/SKILL.md +2 -3
- package/content/skills/revise-prose/revise-prose.mjs +52 -52
- package/content/skills/save-artifact/SKILL.md +4 -6
- package/content/skills/save-plan/SKILL.md +2 -2
- package/content/skills/start-ticket/SKILL.md +1 -1
- package/content/skills/streamline-guidance/streamline-guidance.mjs +24 -24
- package/content/skills/summarize-change/SKILL.md +5 -4
- package/content/skills/summarize-chat/SKILL.md +2 -2
- package/content/skills/triage-feedback/SKILL.md +2 -2
- package/content/skills/triage-spike-findings/SKILL.md +26 -22
- package/content/skills/triage-spike-findings/triage-spike-findings.mjs +19 -19
- package/content/skills/update-project-guidance/SKILL.md +1 -1
- package/content/skills/wrap-up/SKILL.md +4 -4
- package/content/skills/write-progress-report/SKILL.md +111 -0
- package/content/skills/write-progress-report/write-progress-report.mjs +150 -0
- package/content/subagents/disposition-challenger.md +7 -6
- package/content/subagents/entry-drafter.md +2 -0
- package/content/subagents/usability-assessor.md +3 -2
- package/package.json +11 -10
- package/schemas/preferences.v1.json +9 -1
- package/schemas/work-types.v1.json +1 -1
|
@@ -37,7 +37,7 @@ The plan artifact is read-only. It is a record of what was decided at plan time,
|
|
|
37
37
|
|
|
38
38
|
6. **Audit the diff** per [Diff audit](#diff-audit). Because the audit runs over the work of every task, ahead of the gates, a repair that it forces is itself covered by them. A repair made once the tasks are committed, whether the audit forces it or a gate does, is committed the same way: amended into the commit that it corrects, or made as a commit of its own, composed with the `{skill:create-commit}` skill.
|
|
39
39
|
|
|
40
|
-
7. **Run the plan's verification gates.** Execute the `## Verification` section's checks yourself and report the actual results, including a browser check through a debug browser when the environment provides one. When the change touches a visible component, run the browser
|
|
40
|
+
7. **Run the plan's verification gates.** Execute the `## Verification` section's checks yourself and report the actual results, including a browser check through a debug browser when the environment provides one. When the change touches a visible component, run the browser checks in {rulebook:accessibility-conventions} and {rulebook:visual-design-conventions} whether or not `## Verification` lists them, and run each once when it does. Retry a command that the sandbox refuses through the permission gate, and cut a check whose observable outcome a gate already asserts rather than run it. A gate that fails is not done: Fix the cause, or report the failure. Never claim a gate passed without having seen it pass, and never turn a check into a developer action item.
|
|
41
41
|
|
|
42
42
|
8. **Report completion.** Send each fact found during the run to the place that [Fact routing](#fact-routing) names, then summarize what was built against the ticket's acceptance criteria, naming any criterion left unmet and any divergence from the plan. For a change to a visible component, the summary states what the browser check found, or reports that it did not run as that rulebook requires. Every sentence of that summary is read back from the diff per [Diff audit](#diff-audit), a criterion reported unmet as much as one reported met. The report lists what was verified and never a step for the developer to run; the "Handoffs" section of the collaboration preferences states when you may hand a step over.
|
|
43
43
|
|