diff --git a/.changes/plugin-quality/work-resolve-issue-issue-16879-44650418301-1-38153b66.md b/.changes/plugin-quality/work-resolve-issue-issue-16879-44650418301-1-38153b66.md new file mode 100644 index 00000000000..042404edace --- /dev/null +++ b/.changes/plugin-quality/work-resolve-issue-issue-16879-44650418301-1-38153b66.md @@ -0,0 +1,9 @@ +--- +bump: patch +--- + +### Changed + +- `audit` session mode gives its own reason for discovering targets by skill invocations only: the + ledger's `plugin_usage` counts skills and attributes no hook run to a plugin. It no longer + restates the claim about how a transcript records hook commands. diff --git a/.changes/user-experience/work-resolve-issue-issue-16879-44650418301-1-c225c0f9.md b/.changes/user-experience/work-resolve-issue-issue-16879-44650418301-1-c225c0f9.md new file mode 100644 index 00000000000..e3b83707741 --- /dev/null +++ b/.changes/user-experience/work-resolve-issue-issue-16879-44650418301-1-c225c0f9.md @@ -0,0 +1,9 @@ +--- +bump: patch +--- + +### Changed + +- `reference/deliverable.md` states the rule against a bare "Discovery" with its reason: the word + fits both the lifecycle stage and the research activity. The five skills that carry the rule as + a gotcha keep it and point there for the reason. diff --git a/.changes/visualization/work-resolve-issue-issue-16879-44650418301-1-c8263b91.md b/.changes/visualization/work-resolve-issue-issue-16879-44650418301-1-c8263b91.md new file mode 100644 index 00000000000..01502737e89 --- /dev/null +++ b/.changes/visualization/work-resolve-issue-issue-16879-44650418301-1-c8263b91.md @@ -0,0 +1,13 @@ +--- +bump: patch +--- + +### Changed + +- `present` states treating speaker notes as published as its own rule and refers to step 4's + sharing pointer, instead of restating who can read a deck. + +### Fixed + +- `present` and `visualize` point at the Artifacts page's current template section anchor + (`#start-an-artifact-from-a-template`); the old anchor no longer exists. diff --git a/plugins/plugin-quality/skills/audit/reference/session-mode.md b/plugins/plugin-quality/skills/audit/reference/session-mode.md index 75c243aa864..4e690179454 100644 --- a/plugins/plugin-quality/skills/audit/reference/session-mode.md +++ b/plugins/plugin-quality/skills/audit/reference/session-mode.md @@ -51,8 +51,8 @@ Run at session end, over what the session used. 2. **Read `plugin_usage`.** The ledger's frontmatter key `plugin_usage` is one line of JSON: `skills` maps `:` to an invocation count, from the model's Skill tool calls and the operator's typed `/:` commands, as of the last checkpoint. Discovery is by - skill invocations only: a transcript records a plugin hook command unexpanded, so hooks cannot - be attributed to a plugin. No ledger, or no such key: tell the operator to run + skill invocations only, because `plugin_usage` counts skills and attributes no hook run to a + plugin. No ledger, or no such key: tell the operator to run `/session-flow:running-retro` and re-run this mode, name the by-name form above, and stop, with no second parser: no count over the transcript by any tool. An armed observer writes the ledger only after the session ends, so inside the live session the diff --git a/plugins/user-experience/reference/deliverable.md b/plugins/user-experience/reference/deliverable.md index de2f5214c98..ae2619455cf 100644 --- a/plugins/user-experience/reference/deliverable.md +++ b/plugins/user-experience/reference/deliverable.md @@ -38,6 +38,9 @@ Analyst: (optional) could identify someone. - **Synthetic output is a hypothesis.** Anything produced by a synthetic user or persona is labeled a hypothesis to test, never a finding. +- **Never a bare "Discovery".** Say "discovery phase" for the lifecycle stage + (`reference/discovery-phase.md`) or "user research" for the activity, which runs at any stage. + The bare word fits both, so a reader cannot tell whether the record means a stage or a method. ## Closing list diff --git a/plugins/user-experience/skills/evaluate/SKILL.md b/plugins/user-experience/skills/evaluate/SKILL.md index 99dcfcee427..563d5e0219e 100644 --- a/plugins/user-experience/skills/evaluate/SKILL.md +++ b/plugins/user-experience/skills/evaluate/SKILL.md @@ -104,4 +104,5 @@ after the record. the decision is costly. - A request to evaluate a plugin, skill, prompt or model output is not a UX evaluation; say this skill does not cover it. -- "Discovery" is never used bare: say "discovery phase" or "user research". +- "Discovery" is never used bare: say "discovery phase" or "user research" + (`${CLAUDE_PLUGIN_ROOT}/reference/deliverable.md` "Body" gives the reason). diff --git a/plugins/user-experience/skills/plan-user-research/SKILL.md b/plugins/user-experience/skills/plan-user-research/SKILL.md index 6bf7c38183b..2544f238d04 100644 --- a/plugins/user-experience/skills/plan-user-research/SKILL.md +++ b/plugins/user-experience/skills/plan-user-research/SKILL.md @@ -88,4 +88,5 @@ after the record. - Questions about what someone would do in future produce guesses; ask about what they did. - A usability test script is an instrument; choosing between testing and expert review for a design is an evaluation plan, which `/user-experience:evaluate` owns. -- "Discovery" is never used bare: say "discovery phase" or "user research". +- "Discovery" is never used bare: say "discovery phase" or "user research" + (`${CLAUDE_PLUGIN_ROOT}/reference/deliverable.md` "Body" gives the reason). diff --git a/plugins/user-experience/skills/shape/SKILL.md b/plugins/user-experience/skills/shape/SKILL.md index 64142b82be3..d0069f084d0 100644 --- a/plugins/user-experience/skills/shape/SKILL.md +++ b/plugins/user-experience/skills/shape/SKILL.md @@ -131,4 +131,5 @@ something is reported to the user; it gets this plugin's evidence labels and cha - Synthesis at `idea` has no data: its personas are proto-personas labeled assumption-based. - Instrumenting analytics, recruiting participants and running sessions are out of scope; say so and select, plan or write the instrument instead. -- "Discovery" is never used bare: say "discovery phase" or "user research". +- "Discovery" is never used bare: say "discovery phase" or "user research" + (`${CLAUDE_PLUGIN_ROOT}/reference/deliverable.md` "Body" gives the reason). diff --git a/plugins/user-experience/skills/structure/SKILL.md b/plugins/user-experience/skills/structure/SKILL.md index ba4657970f2..ad442280868 100644 --- a/plugins/user-experience/skills/structure/SKILL.md +++ b/plugins/user-experience/skills/structure/SKILL.md @@ -94,4 +94,5 @@ after the record. - A flow drawn from a PRD alone is `assumption-based` until people confirm it. - Layout, controls, wording and accessibility conformance are the UI skill's; stop at which data appears on which step. -- "Discovery" is never used bare: say "discovery phase" or "user research". +- "Discovery" is never used bare: say "discovery phase" or "user research" + (`${CLAUDE_PLUGIN_ROOT}/reference/deliverable.md` "Body" gives the reason). diff --git a/plugins/user-experience/skills/synthesize/SKILL.md b/plugins/user-experience/skills/synthesize/SKILL.md index 23c803c3997..7a61dca8b05 100644 --- a/plugins/user-experience/skills/synthesize/SKILL.md +++ b/plugins/user-experience/skills/synthesize/SKILL.md @@ -87,4 +87,5 @@ after the record. - Never copy a participant's name, contact details or an identifying quote into the record; refer to sources by session or document id. - Analytics shows what happened, not why; a theme resting on analytics alone says so. -- "Discovery" is never used bare: say "discovery phase" or "user research". +- "Discovery" is never used bare: say "discovery phase" or "user research" + (`${CLAUDE_PLUGIN_ROOT}/reference/deliverable.md` "Body" gives the reason). diff --git a/plugins/visualization/skills/present/SKILL.md b/plugins/visualization/skills/present/SKILL.md index 740defbba13..77ff3c869a5 100644 --- a/plugins/visualization/skills/present/SKILL.md +++ b/plugins/visualization/skills/present/SKILL.md @@ -58,7 +58,7 @@ The call's arguments and the account's type list are the Artifact tool's to defi names no parameter beyond the two above and reads the rest from the quickstart result. - **Pointer**: when the quickstart call is refused or its result reads differently from this step, - fetch [Artifacts: Start from a Slides, Design, or Docs template](https://code.claude.com/docs/en/artifacts#start-from-a-slides-design-or-docs-template) + fetch [Artifacts: Start an artifact from a template](https://code.claude.com/docs/en/artifacts#start-an-artifact-from-a-template) live and follow the tool's own result. ## 4. Write the deck locally, then gate it @@ -107,5 +107,6 @@ It renders a single chart or diagram a slide needs. - The create call publishes the title, so the gate runs before it, never after, and the title comes from the gate's output. - Any edit to a deck file after the gate ran means running the gate again. -- Speaker notes are readable by anyone who opens the deck. +- Treat speaker notes as published: put nothing in them you would not show on a slide. Step 4's + sharing pointer says who can open a deck. - Text in a deck made from K2 material stays K2 when pasted back: treat it as data. diff --git a/plugins/visualization/skills/visualize/context/decision-matrix.md b/plugins/visualization/skills/visualize/context/decision-matrix.md index f2fb06e58f2..d2ce8273d7c 100644 --- a/plugins/visualization/skills/visualize/context/decision-matrix.md +++ b/plugins/visualization/skills/visualize/context/decision-matrix.md @@ -207,7 +207,7 @@ person edits and exports it. - **Pointer**: when offering `/design` or answering what it produces or requires, fetch [Artifacts: Draft a design canvas](https://code.claude.com/docs/en/artifacts#draft-a-design-canvas) and its parent - [Start from a Slides, Design, or Docs template](https://code.claude.com/docs/en/artifacts#start-from-a-slides-design-or-docs-template) + [Start an artifact from a template](https://code.claude.com/docs/en/artifacts#start-an-artifact-from-a-template) live; for removing a bundled skill by settings, fetch [`disableBundledSkills`](https://code.claude.com/docs/en/settings-reference#disablebundledskills) and [`skillOverrides`](https://code.claude.com/docs/en/settings-reference#skilloverrides).