@codyswann/lisa 2.173.2 → 2.173.3

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 (81) hide show
  1. package/package.json +1 -1
  2. package/plugins/lisa/.claude-plugin/plugin.json +1 -1
  3. package/plugins/lisa/.codex-plugin/plugin.json +1 -1
  4. package/plugins/lisa-agy/plugin.json +1 -1
  5. package/plugins/lisa-cdk/.claude-plugin/plugin.json +1 -1
  6. package/plugins/lisa-cdk/.codex-plugin/plugin.json +1 -1
  7. package/plugins/lisa-cdk-agy/plugin.json +1 -1
  8. package/plugins/lisa-cdk-copilot/.claude-plugin/plugin.json +1 -1
  9. package/plugins/lisa-cdk-cursor/.claude-plugin/plugin.json +1 -1
  10. package/plugins/lisa-copilot/.claude-plugin/plugin.json +1 -1
  11. package/plugins/lisa-cursor/.claude-plugin/plugin.json +1 -1
  12. package/plugins/lisa-expo/.claude-plugin/plugin.json +1 -1
  13. package/plugins/lisa-expo/.codex-plugin/plugin.json +1 -1
  14. package/plugins/lisa-expo/commands/exploratory-qa.md +2 -2
  15. package/plugins/lisa-expo/skills/exploratory-qa/SKILL.md +16 -7
  16. package/plugins/lisa-expo-agy/commands/exploratory-qa.md +2 -2
  17. package/plugins/lisa-expo-agy/plugin.json +1 -1
  18. package/plugins/lisa-expo-agy/skills/exploratory-qa/SKILL.md +16 -7
  19. package/plugins/lisa-expo-copilot/.claude-plugin/plugin.json +1 -1
  20. package/plugins/lisa-expo-copilot/commands/exploratory-qa.md +2 -2
  21. package/plugins/lisa-expo-copilot/skills/exploratory-qa/SKILL.md +16 -7
  22. package/plugins/lisa-expo-cursor/.claude-plugin/plugin.json +1 -1
  23. package/plugins/lisa-expo-cursor/commands/exploratory-qa.md +2 -2
  24. package/plugins/lisa-expo-cursor/skills/exploratory-qa/SKILL.md +16 -7
  25. package/plugins/lisa-harper-fabric/.claude-plugin/plugin.json +1 -1
  26. package/plugins/lisa-harper-fabric/.codex-plugin/plugin.json +1 -1
  27. package/plugins/lisa-harper-fabric/commands/exploratory-qa.md +2 -2
  28. package/plugins/lisa-harper-fabric/skills/exploratory-qa/SKILL.md +16 -7
  29. package/plugins/lisa-harper-fabric-agy/commands/exploratory-qa.md +2 -2
  30. package/plugins/lisa-harper-fabric-agy/plugin.json +1 -1
  31. package/plugins/lisa-harper-fabric-agy/skills/exploratory-qa/SKILL.md +16 -7
  32. package/plugins/lisa-harper-fabric-copilot/.claude-plugin/plugin.json +1 -1
  33. package/plugins/lisa-harper-fabric-copilot/commands/exploratory-qa.md +2 -2
  34. package/plugins/lisa-harper-fabric-copilot/skills/exploratory-qa/SKILL.md +16 -7
  35. package/plugins/lisa-harper-fabric-cursor/.claude-plugin/plugin.json +1 -1
  36. package/plugins/lisa-harper-fabric-cursor/commands/exploratory-qa.md +2 -2
  37. package/plugins/lisa-harper-fabric-cursor/skills/exploratory-qa/SKILL.md +16 -7
  38. package/plugins/lisa-nestjs/.claude-plugin/plugin.json +1 -1
  39. package/plugins/lisa-nestjs/.codex-plugin/plugin.json +1 -1
  40. package/plugins/lisa-nestjs-agy/plugin.json +1 -1
  41. package/plugins/lisa-nestjs-copilot/.claude-plugin/plugin.json +1 -1
  42. package/plugins/lisa-nestjs-cursor/.claude-plugin/plugin.json +1 -1
  43. package/plugins/lisa-openclaw/.claude-plugin/plugin.json +1 -1
  44. package/plugins/lisa-openclaw/.codex-plugin/plugin.json +1 -1
  45. package/plugins/lisa-openclaw-agy/plugin.json +1 -1
  46. package/plugins/lisa-openclaw-copilot/.claude-plugin/plugin.json +1 -1
  47. package/plugins/lisa-openclaw-cursor/.claude-plugin/plugin.json +1 -1
  48. package/plugins/lisa-phaser/.claude-plugin/plugin.json +1 -1
  49. package/plugins/lisa-phaser/.codex-plugin/plugin.json +1 -1
  50. package/plugins/lisa-phaser-agy/plugin.json +1 -1
  51. package/plugins/lisa-phaser-copilot/.claude-plugin/plugin.json +1 -1
  52. package/plugins/lisa-phaser-cursor/.claude-plugin/plugin.json +1 -1
  53. package/plugins/lisa-rails/.claude-plugin/plugin.json +1 -1
  54. package/plugins/lisa-rails/.codex-plugin/plugin.json +1 -1
  55. package/plugins/lisa-rails/commands/exploratory-qa.md +2 -2
  56. package/plugins/lisa-rails/skills/exploratory-qa/SKILL.md +16 -7
  57. package/plugins/lisa-rails-agy/commands/exploratory-qa.md +2 -2
  58. package/plugins/lisa-rails-agy/plugin.json +1 -1
  59. package/plugins/lisa-rails-agy/skills/exploratory-qa/SKILL.md +16 -7
  60. package/plugins/lisa-rails-copilot/.claude-plugin/plugin.json +1 -1
  61. package/plugins/lisa-rails-copilot/commands/exploratory-qa.md +2 -2
  62. package/plugins/lisa-rails-copilot/skills/exploratory-qa/SKILL.md +16 -7
  63. package/plugins/lisa-rails-cursor/.claude-plugin/plugin.json +1 -1
  64. package/plugins/lisa-rails-cursor/commands/exploratory-qa.md +2 -2
  65. package/plugins/lisa-rails-cursor/skills/exploratory-qa/SKILL.md +16 -7
  66. package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -1
  67. package/plugins/lisa-typescript/.codex-plugin/plugin.json +1 -1
  68. package/plugins/lisa-typescript-agy/plugin.json +1 -1
  69. package/plugins/lisa-typescript-copilot/.claude-plugin/plugin.json +1 -1
  70. package/plugins/lisa-typescript-cursor/.claude-plugin/plugin.json +1 -1
  71. package/plugins/lisa-wiki/.claude-plugin/plugin.json +1 -1
  72. package/plugins/lisa-wiki/.codex-plugin/plugin.json +1 -1
  73. package/plugins/lisa-wiki-agy/plugin.json +1 -1
  74. package/plugins/lisa-wiki-copilot/.claude-plugin/plugin.json +1 -1
  75. package/plugins/lisa-wiki-cursor/.claude-plugin/plugin.json +1 -1
  76. package/plugins/src/expo/commands/exploratory-qa.md +2 -2
  77. package/plugins/src/expo/skills/exploratory-qa/SKILL.md +16 -7
  78. package/plugins/src/harper-fabric/commands/exploratory-qa.md +2 -2
  79. package/plugins/src/harper-fabric/skills/exploratory-qa/SKILL.md +16 -7
  80. package/plugins/src/rails/commands/exploratory-qa.md +2 -2
  81. package/plugins/src/rails/skills/exploratory-qa/SKILL.md +16 -7
@@ -1,19 +1,22 @@
1
1
  ---
2
2
  name: exploratory-qa
3
- description: First-time-user exploratory QA walkthrough for web apps that FEEDS THE LIFECYCLE. Use when asked to experience an app the way a brand-new human user would — landing cold on the home page and clicking through to find anything confusing, broken, or hard to understand (unclear purpose or audience, human-facing jargon, contextless extracted data, machine-style labels, raw dates/enums, sparse data with no explanation, wrong control semantics, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent/non-standard UX, awkward scroll behavior, unclear affordances, dead-end flows that strand a user — e.g. a login page with no way to register or recover a password, or a primary action that drops the user into an incomplete/unsatisfiable state with no way to finish) across all breakpoints. Instead of writing a report file, it files every finding as a tracked work item via lisa:tracker-write (bugs and usability/UX issues). A `ready` parameter controls whether those tickets are created build-ready (auto-picked-up by lisa:intake) or left in the backlog for human triage (default). For gaps in the automated Playwright test suite, use the e2e-coverage-gaps skill instead.
3
+ description: First-time-user exploratory QA walkthrough for web apps that FEEDS THE LIFECYCLE. Use when asked to experience an app the way a brand-new human user would — opening it in a real browser or browser automation session, landing cold on the home page, and clicking/typing/selecting through visible controls to find anything confusing, broken, or hard to understand (unclear purpose or audience, human-facing jargon, contextless extracted data, machine-style labels, raw dates/enums, sparse data with no explanation, wrong control semantics, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent/non-standard UX, awkward scroll behavior, unclear affordances, dead-end flows that strand a user — e.g. a login page with no way to register or recover a password, or a primary action that drops the user into an incomplete/unsatisfiable state with no way to finish) across all breakpoints. Static route scans, HTTP fetches, screenshots alone, or console/network checks alone are not sufficient exploratory QA evidence. Instead of writing a report file, it files every finding as a tracked work item via lisa:tracker-write (bugs and usability/UX issues). A `ready` parameter controls whether those tickets are created build-ready (auto-picked-up by lisa:intake) or left in the backlog for human triage (default). For gaps in the automated Playwright test suite, use the e2e-coverage-gaps skill instead.
4
4
  ---
5
5
 
6
6
  # Exploratory QA
7
7
 
8
8
  ## Overview
9
9
 
10
- Experience the app the way a **brand-new human user** would: land cold on the home page with no prior
11
- knowledge, then click through and actually try to use it just like a real person. The goal is to
12
- surface anything **confusing, broken, or hard to understand**, and to do so at **every breakpoint**.
10
+ Experience the app the way a **brand-new human user** would: open it in a real browser or browser
11
+ automation tool, land cold on the home page with no prior knowledge, then click through and actually
12
+ try to use it just like a real person. The goal is to surface anything **confusing, broken, or hard
13
+ to understand**, and to do so at **every breakpoint**.
13
14
 
14
15
  This is a usability/experience pass, **not** a test-coverage audit. It does not look at the Playwright
15
16
  suite or hunt for coverage gaps — for that, use the `e2e-coverage-gaps` skill. Here, every finding is
16
- filed as a tracked work item so it enters the Lisa lifecycle — no static report file.
17
+ filed as a tracked work item so it enters the Lisa lifecycle — no static report file. Static route
18
+ scans, HTTP fetches, screenshots alone, and console/network checks alone do not count as exploratory
19
+ QA evidence because they do not prove a person could use the visible UI.
17
20
 
18
21
  ## Parameters
19
22
 
@@ -29,6 +32,9 @@ filed as a tracked work item so it enters the Lisa lifecycle — no static repor
29
32
 
30
33
  - Identify the target environment, account type, and browser requirement, and read the `ready` flag
31
34
  (default `false`).
35
+ - Open the target in a real browser or browser automation tool before drawing conclusions. Use static
36
+ code inspection, route lists, network/console logs, and screenshots only as supporting evidence, not
37
+ as a substitute for live browser interaction.
32
38
  - **Confirm the tracker is configured.** Findings are filed as tickets, so read `tracker` from
33
39
  `.lisa.config.json` (local overrides global). If it is unset, stop and report that the tracker must
34
40
  be configured (via `/lisa:setup:jira` / `:github` / `:linear`) before exploratory QA can file
@@ -49,8 +55,11 @@ filed as a tracked work item so it enters the Lisa lifecycle — no static repor
49
55
 
50
56
  ### 3. Use It Like a Human
51
57
 
52
- Click through the visible paths and actually attempt real tasks — a first-time user explores, makes
53
- mistakes, and tries the obvious thing. Cover at least these dimensions unless the user narrows scope:
58
+ Click through the visible paths and actually attempt real tasks in the browser — a first-time user
59
+ explores, makes mistakes, and tries the obvious thing. When a page exposes forms, filters, menus,
60
+ links, buttons, selects, tabs, or other visible controls, click, type, select, submit, clear,
61
+ navigate, and otherwise exercise representative controls when safe; then verify the resulting UI or
62
+ data state in the browser. Cover at least these dimensions unless the user narrows scope:
54
63
 
55
64
  - **Comprehension & labeling:** human-facing copy must sound like something a normal first-time user
56
65
  would understand. Flag machine-style or developer labels shown to users (raw IDs, enum keys,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-rails",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,7 +1,7 @@
1
1
  ---
2
- description: "Run a first-time-user exploratory QA walkthrough: experience the app like a brand-new human user, clicking through to find anything confusing, broken, or hard to understand (human-facing jargon, contextless extracted data, machine-style labels, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent UX, awkward scroll behavior) across all breakpoints, and file each finding (bug or usability issue) as a tracked work item via lisa:tracker-write. The optional ready flag marks tickets build-ready (auto-picked-up by lisa:intake) or leaves them in the backlog for human triage (default). For gaps in the automated Playwright suite, use e2e-coverage-gaps instead."
2
+ description: "Run a first-time-user exploratory QA walkthrough: experience the app like a brand-new human user in a real browser or browser automation session, clicking/typing/selecting through visible controls to find anything confusing, broken, or hard to understand (human-facing jargon, contextless extracted data, machine-style labels, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent UX, awkward scroll behavior) across all breakpoints, and file each finding (bug or usability issue) as a tracked work item via lisa:tracker-write. Static scans, HTTP fetches, screenshots alone, or console/network checks alone are not sufficient. The optional ready flag marks tickets build-ready (auto-picked-up by lisa:intake) or leaves them in the backlog for human triage (default). For gaps in the automated Playwright suite, use e2e-coverage-gaps instead."
3
3
  allowed-tools: ["Skill"]
4
4
  argument-hint: "[target-url | env] [ready=true|false]"
5
5
  ---
6
6
 
7
- Use the /lisa-rails:exploratory-qa skill to experience the app like a brand-new first-time user — landing cold on the home page and clicking through to find anything confusing, broken, or hard to understand across all breakpoints — and file each finding (bugs, usability/clarity issues) as a tracked work item via lisa:tracker-write, build-ready or in triage per the ready flag (default: triage). For automated Playwright coverage gaps, use /lisa-rails:e2e-coverage-gaps. $ARGUMENTS
7
+ Use the /lisa-rails:exploratory-qa skill to experience the app like a brand-new first-time user in a real browser or browser automation session — landing cold on the home page, clicking/typing/selecting through visible controls, and verifying resulting UI state across all breakpoints — and file each finding (bugs, usability/clarity issues) as a tracked work item via lisa:tracker-write, build-ready or in triage per the ready flag (default: triage). Static scans, HTTP fetches, screenshots alone, or console/network checks alone are not enough. For automated Playwright coverage gaps, use /lisa-rails:e2e-coverage-gaps. $ARGUMENTS
@@ -1,19 +1,22 @@
1
1
  ---
2
2
  name: exploratory-qa
3
- description: First-time-user exploratory QA walkthrough for web apps that FEEDS THE LIFECYCLE. Use when asked to experience an app the way a brand-new human user would — landing cold on the home page and clicking through to find anything confusing, broken, or hard to understand (unclear purpose or audience, human-facing jargon, contextless extracted data, machine-style labels, raw dates/enums, sparse data with no explanation, wrong control semantics, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent/non-standard UX, awkward scroll behavior, unclear affordances, dead-end flows that strand a user — e.g. a login page with no way to register or recover a password, or a primary action that drops the user into an incomplete/unsatisfiable state with no way to finish) across all breakpoints. Instead of writing a report file, it files every finding as a tracked work item via lisa:tracker-write (bugs and usability/UX issues). A `ready` parameter controls whether those tickets are created build-ready (auto-picked-up by lisa:intake) or left in the backlog for human triage (default). For gaps in the automated Playwright test suite, use the e2e-coverage-gaps skill instead.
3
+ description: First-time-user exploratory QA walkthrough for web apps that FEEDS THE LIFECYCLE. Use when asked to experience an app the way a brand-new human user would — opening it in a real browser or browser automation session, landing cold on the home page, and clicking/typing/selecting through visible controls to find anything confusing, broken, or hard to understand (unclear purpose or audience, human-facing jargon, contextless extracted data, machine-style labels, raw dates/enums, sparse data with no explanation, wrong control semantics, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent/non-standard UX, awkward scroll behavior, unclear affordances, dead-end flows that strand a user — e.g. a login page with no way to register or recover a password, or a primary action that drops the user into an incomplete/unsatisfiable state with no way to finish) across all breakpoints. Static route scans, HTTP fetches, screenshots alone, or console/network checks alone are not sufficient exploratory QA evidence. Instead of writing a report file, it files every finding as a tracked work item via lisa:tracker-write (bugs and usability/UX issues). A `ready` parameter controls whether those tickets are created build-ready (auto-picked-up by lisa:intake) or left in the backlog for human triage (default). For gaps in the automated Playwright test suite, use the e2e-coverage-gaps skill instead.
4
4
  ---
5
5
 
6
6
  # Exploratory QA
7
7
 
8
8
  ## Overview
9
9
 
10
- Experience the app the way a **brand-new human user** would: land cold on the home page with no prior
11
- knowledge, then click through and actually try to use it just like a real person. The goal is to
12
- surface anything **confusing, broken, or hard to understand**, and to do so at **every breakpoint**.
10
+ Experience the app the way a **brand-new human user** would: open it in a real browser or browser
11
+ automation tool, land cold on the home page with no prior knowledge, then click through and actually
12
+ try to use it just like a real person. The goal is to surface anything **confusing, broken, or hard
13
+ to understand**, and to do so at **every breakpoint**.
13
14
 
14
15
  This is a usability/experience pass, **not** a test-coverage audit. It does not look at the Playwright
15
16
  suite or hunt for coverage gaps — for that, use the `e2e-coverage-gaps` skill. Here, every finding is
16
- filed as a tracked work item so it enters the Lisa lifecycle — no static report file.
17
+ filed as a tracked work item so it enters the Lisa lifecycle — no static report file. Static route
18
+ scans, HTTP fetches, screenshots alone, and console/network checks alone do not count as exploratory
19
+ QA evidence because they do not prove a person could use the visible UI.
17
20
 
18
21
  ## Parameters
19
22
 
@@ -29,6 +32,9 @@ filed as a tracked work item so it enters the Lisa lifecycle — no static repor
29
32
 
30
33
  - Identify the target environment, account type, and browser requirement, and read the `ready` flag
31
34
  (default `false`).
35
+ - Open the target in a real browser or browser automation tool before drawing conclusions. Use static
36
+ code inspection, route lists, network/console logs, and screenshots only as supporting evidence, not
37
+ as a substitute for live browser interaction.
32
38
  - **Confirm the tracker is configured.** Findings are filed as tickets, so read `tracker` from
33
39
  `.lisa.config.json` (local overrides global). If it is unset, stop and report that the tracker must
34
40
  be configured (via `/lisa:setup:jira` / `:github` / `:linear`) before exploratory QA can file
@@ -49,8 +55,11 @@ filed as a tracked work item so it enters the Lisa lifecycle — no static repor
49
55
 
50
56
  ### 3. Use It Like a Human
51
57
 
52
- Click through the visible paths and actually attempt real tasks — a first-time user explores, makes
53
- mistakes, and tries the obvious thing. Cover at least these dimensions unless the user narrows scope:
58
+ Click through the visible paths and actually attempt real tasks in the browser — a first-time user
59
+ explores, makes mistakes, and tries the obvious thing. When a page exposes forms, filters, menus,
60
+ links, buttons, selects, tabs, or other visible controls, click, type, select, submit, clear,
61
+ navigate, and otherwise exercise representative controls when safe; then verify the resulting UI or
62
+ data state in the browser. Cover at least these dimensions unless the user narrows scope:
54
63
 
55
64
  - **Comprehension & labeling:** human-facing copy must sound like something a normal first-time user
56
65
  would understand. Flag machine-style or developer labels shown to users (raw IDs, enum keys,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-typescript",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-typescript",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "TypeScript-specific hooks for formatting, linting, and ast-grep scanning on edit.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-typescript",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-typescript",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-typescript",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-wiki",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-wiki",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "Distributable LLM Wiki kernel — ingest, query, lint, and maintain a git-native markdown knowledge base across Claude and Codex.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-wiki",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-wiki",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-wiki",
3
- "version": "2.173.2",
3
+ "version": "2.173.3",
4
4
  "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,7 +1,7 @@
1
1
  ---
2
- description: "Run a first-time-user exploratory QA walkthrough: experience the app like a brand-new human user, clicking through to find anything confusing, broken, or hard to understand (human-facing jargon, contextless extracted data, machine-style labels, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent UX, awkward scroll behavior) across all breakpoints, and file each finding (bug or usability issue) as a tracked work item via lisa:tracker-write. The optional ready flag marks tickets build-ready (auto-picked-up by lisa:intake) or leaves them in the backlog for human triage (default). For gaps in the automated Playwright suite, use e2e-coverage-gaps instead."
2
+ description: "Run a first-time-user exploratory QA walkthrough: experience the app like a brand-new human user in a real browser or browser automation session, clicking/typing/selecting through visible controls to find anything confusing, broken, or hard to understand (human-facing jargon, contextless extracted data, machine-style labels, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent UX, awkward scroll behavior) across all breakpoints, and file each finding (bug or usability issue) as a tracked work item via lisa:tracker-write. Static scans, HTTP fetches, screenshots alone, or console/network checks alone are not sufficient. The optional ready flag marks tickets build-ready (auto-picked-up by lisa:intake) or leaves them in the backlog for human triage (default). For gaps in the automated Playwright suite, use e2e-coverage-gaps instead."
3
3
  allowed-tools: ["Skill"]
4
4
  argument-hint: "[target-url | env] [ready=true|false]"
5
5
  ---
6
6
 
7
- Use the /lisa-expo:exploratory-qa skill to experience the app like a brand-new first-time user — landing cold on the home page and clicking through to find anything confusing, broken, or hard to understand across all breakpoints — and file each finding (bugs, usability/clarity issues) as a tracked work item via lisa:tracker-write, build-ready or in triage per the ready flag (default: triage). For automated Playwright coverage gaps, use /lisa-expo:e2e-coverage-gaps. $ARGUMENTS
7
+ Use the /lisa-expo:exploratory-qa skill to experience the app like a brand-new first-time user in a real browser or browser automation session — landing cold on the home page, clicking/typing/selecting through visible controls, and verifying resulting UI state across all breakpoints — and file each finding (bugs, usability/clarity issues) as a tracked work item via lisa:tracker-write, build-ready or in triage per the ready flag (default: triage). Static scans, HTTP fetches, screenshots alone, or console/network checks alone are not enough. For automated Playwright coverage gaps, use /lisa-expo:e2e-coverage-gaps. $ARGUMENTS
@@ -1,19 +1,22 @@
1
1
  ---
2
2
  name: exploratory-qa
3
- description: First-time-user exploratory QA walkthrough for web apps that FEEDS THE LIFECYCLE. Use when asked to experience an app the way a brand-new human user would — landing cold on the home page and clicking through to find anything confusing, broken, or hard to understand (unclear purpose or audience, human-facing jargon, contextless extracted data, machine-style labels, raw dates/enums, sparse data with no explanation, wrong control semantics, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent/non-standard UX, awkward scroll behavior, unclear affordances, dead-end flows that strand a user — e.g. a login page with no way to register or recover a password, or a primary action that drops the user into an incomplete/unsatisfiable state with no way to finish) across all breakpoints. Instead of writing a report file, it files every finding as a tracked work item via lisa:tracker-write (bugs and usability/UX issues). A `ready` parameter controls whether those tickets are created build-ready (auto-picked-up by lisa:intake) or left in the backlog for human triage (default). For gaps in the automated Playwright test suite, use the e2e-coverage-gaps skill instead.
3
+ description: First-time-user exploratory QA walkthrough for web apps that FEEDS THE LIFECYCLE. Use when asked to experience an app the way a brand-new human user would — opening it in a real browser or browser automation session, landing cold on the home page, and clicking/typing/selecting through visible controls to find anything confusing, broken, or hard to understand (unclear purpose or audience, human-facing jargon, contextless extracted data, machine-style labels, raw dates/enums, sparse data with no explanation, wrong control semantics, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent/non-standard UX, awkward scroll behavior, unclear affordances, dead-end flows that strand a user — e.g. a login page with no way to register or recover a password, or a primary action that drops the user into an incomplete/unsatisfiable state with no way to finish) across all breakpoints. Static route scans, HTTP fetches, screenshots alone, or console/network checks alone are not sufficient exploratory QA evidence. Instead of writing a report file, it files every finding as a tracked work item via lisa:tracker-write (bugs and usability/UX issues). A `ready` parameter controls whether those tickets are created build-ready (auto-picked-up by lisa:intake) or left in the backlog for human triage (default). For gaps in the automated Playwright test suite, use the e2e-coverage-gaps skill instead.
4
4
  ---
5
5
 
6
6
  # Exploratory QA
7
7
 
8
8
  ## Overview
9
9
 
10
- Experience the app the way a **brand-new human user** would: land cold on the home page with no prior
11
- knowledge, then click through and actually try to use it just like a real person. The goal is to
12
- surface anything **confusing, broken, or hard to understand**, and to do so at **every breakpoint**.
10
+ Experience the app the way a **brand-new human user** would: open it in a real browser or browser
11
+ automation tool, land cold on the home page with no prior knowledge, then click through and actually
12
+ try to use it just like a real person. The goal is to surface anything **confusing, broken, or hard
13
+ to understand**, and to do so at **every breakpoint**.
13
14
 
14
15
  This is a usability/experience pass, **not** a test-coverage audit. It does not look at the Playwright
15
16
  suite or hunt for coverage gaps — for that, use the `e2e-coverage-gaps` skill. Here, every finding is
16
- filed as a tracked work item so it enters the Lisa lifecycle — no static report file.
17
+ filed as a tracked work item so it enters the Lisa lifecycle — no static report file. Static route
18
+ scans, HTTP fetches, screenshots alone, and console/network checks alone do not count as exploratory
19
+ QA evidence because they do not prove a person could use the visible UI.
17
20
 
18
21
  ## Parameters
19
22
 
@@ -29,6 +32,9 @@ filed as a tracked work item so it enters the Lisa lifecycle — no static repor
29
32
 
30
33
  - Identify the target environment, account type, and browser requirement, and read the `ready` flag
31
34
  (default `false`).
35
+ - Open the target in a real browser or browser automation tool before drawing conclusions. Use static
36
+ code inspection, route lists, network/console logs, and screenshots only as supporting evidence, not
37
+ as a substitute for live browser interaction.
32
38
  - **Confirm the tracker is configured.** Findings are filed as tickets, so read `tracker` from
33
39
  `.lisa.config.json` (local overrides global). If it is unset, stop and report that the tracker must
34
40
  be configured (via `/lisa:setup:jira` / `:github` / `:linear`) before exploratory QA can file
@@ -49,8 +55,11 @@ filed as a tracked work item so it enters the Lisa lifecycle — no static repor
49
55
 
50
56
  ### 3. Use It Like a Human
51
57
 
52
- Click through the visible paths and actually attempt real tasks — a first-time user explores, makes
53
- mistakes, and tries the obvious thing. Cover at least these dimensions unless the user narrows scope:
58
+ Click through the visible paths and actually attempt real tasks in the browser — a first-time user
59
+ explores, makes mistakes, and tries the obvious thing. When a page exposes forms, filters, menus,
60
+ links, buttons, selects, tabs, or other visible controls, click, type, select, submit, clear,
61
+ navigate, and otherwise exercise representative controls when safe; then verify the resulting UI or
62
+ data state in the browser. Cover at least these dimensions unless the user narrows scope:
54
63
 
55
64
  - **Comprehension & labeling:** human-facing copy must sound like something a normal first-time user
56
65
  would understand. Flag machine-style or developer labels shown to users (raw IDs, enum keys,
@@ -1,7 +1,7 @@
1
1
  ---
2
- description: "Run a first-time-user exploratory QA walkthrough: experience the app like a brand-new human user, clicking through to find anything confusing, broken, or hard to understand (human-facing jargon, contextless extracted data, machine-style labels, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent UX, awkward scroll behavior) across all breakpoints, and file each finding (bug or usability issue) as a tracked work item via lisa:tracker-write. The optional ready flag marks tickets build-ready (auto-picked-up by lisa:intake) or leaves them in the backlog for human triage (default). For gaps in the automated Playwright suite, use e2e-coverage-gaps instead."
2
+ description: "Run a first-time-user exploratory QA walkthrough: experience the app like a brand-new human user in a real browser or browser automation session, clicking/typing/selecting through visible controls to find anything confusing, broken, or hard to understand (human-facing jargon, contextless extracted data, machine-style labels, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent UX, awkward scroll behavior) across all breakpoints, and file each finding (bug or usability issue) as a tracked work item via lisa:tracker-write. Static scans, HTTP fetches, screenshots alone, or console/network checks alone are not sufficient. The optional ready flag marks tickets build-ready (auto-picked-up by lisa:intake) or leaves them in the backlog for human triage (default). For gaps in the automated Playwright suite, use e2e-coverage-gaps instead."
3
3
  allowed-tools: ["Skill"]
4
4
  argument-hint: "[target-url | env] [ready=true|false]"
5
5
  ---
6
6
 
7
- Use the /lisa-harper-fabric:exploratory-qa skill to experience the app like a brand-new first-time user — landing cold on the home page and clicking through to find anything confusing, broken, or hard to understand across all breakpoints — and file each finding (bugs, usability/clarity issues) as a tracked work item via lisa:tracker-write, build-ready or in triage per the ready flag (default: triage). For automated Playwright coverage gaps, use /lisa-harper-fabric:e2e-coverage-gaps. $ARGUMENTS
7
+ Use the /lisa-harper-fabric:exploratory-qa skill to experience the app like a brand-new first-time user in a real browser or browser automation session — landing cold on the home page, clicking/typing/selecting through visible controls, and verifying resulting UI state across all breakpoints — and file each finding (bugs, usability/clarity issues) as a tracked work item via lisa:tracker-write, build-ready or in triage per the ready flag (default: triage). Static scans, HTTP fetches, screenshots alone, or console/network checks alone are not enough. For automated Playwright coverage gaps, use /lisa-harper-fabric:e2e-coverage-gaps. $ARGUMENTS
@@ -1,19 +1,22 @@
1
1
  ---
2
2
  name: exploratory-qa
3
- description: First-time-user exploratory QA walkthrough for web apps that FEEDS THE LIFECYCLE. Use when asked to experience an app the way a brand-new human user would — landing cold on the home page and clicking through to find anything confusing, broken, or hard to understand (unclear purpose or audience, human-facing jargon, contextless extracted data, machine-style labels, raw dates/enums, sparse data with no explanation, wrong control semantics, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent/non-standard UX, awkward scroll behavior, unclear affordances, dead-end flows that strand a user — e.g. a login page with no way to register or recover a password, or a primary action that drops the user into an incomplete/unsatisfiable state with no way to finish) across all breakpoints. Instead of writing a report file, it files every finding as a tracked work item via lisa:tracker-write (bugs and usability/UX issues). A `ready` parameter controls whether those tickets are created build-ready (auto-picked-up by lisa:intake) or left in the backlog for human triage (default). For gaps in the automated Playwright test suite, use the e2e-coverage-gaps skill instead.
3
+ description: First-time-user exploratory QA walkthrough for web apps that FEEDS THE LIFECYCLE. Use when asked to experience an app the way a brand-new human user would — opening it in a real browser or browser automation session, landing cold on the home page, and clicking/typing/selecting through visible controls to find anything confusing, broken, or hard to understand (unclear purpose or audience, human-facing jargon, contextless extracted data, machine-style labels, raw dates/enums, sparse data with no explanation, wrong control semantics, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent/non-standard UX, awkward scroll behavior, unclear affordances, dead-end flows that strand a user — e.g. a login page with no way to register or recover a password, or a primary action that drops the user into an incomplete/unsatisfiable state with no way to finish) across all breakpoints. Static route scans, HTTP fetches, screenshots alone, or console/network checks alone are not sufficient exploratory QA evidence. Instead of writing a report file, it files every finding as a tracked work item via lisa:tracker-write (bugs and usability/UX issues). A `ready` parameter controls whether those tickets are created build-ready (auto-picked-up by lisa:intake) or left in the backlog for human triage (default). For gaps in the automated Playwright test suite, use the e2e-coverage-gaps skill instead.
4
4
  ---
5
5
 
6
6
  # Exploratory QA
7
7
 
8
8
  ## Overview
9
9
 
10
- Experience the app the way a **brand-new human user** would: land cold on the home page with no prior
11
- knowledge, then click through and actually try to use it just like a real person. The goal is to
12
- surface anything **confusing, broken, or hard to understand**, and to do so at **every breakpoint**.
10
+ Experience the app the way a **brand-new human user** would: open it in a real browser or browser
11
+ automation tool, land cold on the home page with no prior knowledge, then click through and actually
12
+ try to use it just like a real person. The goal is to surface anything **confusing, broken, or hard
13
+ to understand**, and to do so at **every breakpoint**.
13
14
 
14
15
  This is a usability/experience pass, **not** a test-coverage audit. It does not look at the Playwright
15
16
  suite or hunt for coverage gaps — for that, use the `e2e-coverage-gaps` skill. Here, every finding is
16
- filed as a tracked work item so it enters the Lisa lifecycle — no static report file.
17
+ filed as a tracked work item so it enters the Lisa lifecycle — no static report file. Static route
18
+ scans, HTTP fetches, screenshots alone, and console/network checks alone do not count as exploratory
19
+ QA evidence because they do not prove a person could use the visible UI.
17
20
 
18
21
  ## Parameters
19
22
 
@@ -29,6 +32,9 @@ filed as a tracked work item so it enters the Lisa lifecycle — no static repor
29
32
 
30
33
  - Identify the target environment, account type, and browser requirement, and read the `ready` flag
31
34
  (default `false`).
35
+ - Open the target in a real browser or browser automation tool before drawing conclusions. Use static
36
+ code inspection, route lists, network/console logs, and screenshots only as supporting evidence, not
37
+ as a substitute for live browser interaction.
32
38
  - **Confirm the tracker is configured.** Findings are filed as tickets, so read `tracker` from
33
39
  `.lisa.config.json` (local overrides global). If it is unset, stop and report that the tracker must
34
40
  be configured (via `/lisa:setup:jira` / `:github` / `:linear`) before exploratory QA can file
@@ -49,8 +55,11 @@ filed as a tracked work item so it enters the Lisa lifecycle — no static repor
49
55
 
50
56
  ### 3. Use It Like a Human
51
57
 
52
- Click through the visible paths and actually attempt real tasks — a first-time user explores, makes
53
- mistakes, and tries the obvious thing. Cover at least these dimensions unless the user narrows scope:
58
+ Click through the visible paths and actually attempt real tasks in the browser — a first-time user
59
+ explores, makes mistakes, and tries the obvious thing. When a page exposes forms, filters, menus,
60
+ links, buttons, selects, tabs, or other visible controls, click, type, select, submit, clear,
61
+ navigate, and otherwise exercise representative controls when safe; then verify the resulting UI or
62
+ data state in the browser. Cover at least these dimensions unless the user narrows scope:
54
63
 
55
64
  - **Comprehension & labeling:** human-facing copy must sound like something a normal first-time user
56
65
  would understand. Flag machine-style or developer labels shown to users (raw IDs, enum keys,
@@ -1,7 +1,7 @@
1
1
  ---
2
- description: "Run a first-time-user exploratory QA walkthrough: experience the app like a brand-new human user, clicking through to find anything confusing, broken, or hard to understand (human-facing jargon, contextless extracted data, machine-style labels, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent UX, awkward scroll behavior) across all breakpoints, and file each finding (bug or usability issue) as a tracked work item via lisa:tracker-write. The optional ready flag marks tickets build-ready (auto-picked-up by lisa:intake) or leaves them in the backlog for human triage (default). For gaps in the automated Playwright suite, use e2e-coverage-gaps instead."
2
+ description: "Run a first-time-user exploratory QA walkthrough: experience the app like a brand-new human user in a real browser or browser automation session, clicking/typing/selecting through visible controls to find anything confusing, broken, or hard to understand (human-facing jargon, contextless extracted data, machine-style labels, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent UX, awkward scroll behavior) across all breakpoints, and file each finding (bug or usability issue) as a tracked work item via lisa:tracker-write. Static scans, HTTP fetches, screenshots alone, or console/network checks alone are not sufficient. The optional ready flag marks tickets build-ready (auto-picked-up by lisa:intake) or leaves them in the backlog for human triage (default). For gaps in the automated Playwright suite, use e2e-coverage-gaps instead."
3
3
  allowed-tools: ["Skill"]
4
4
  argument-hint: "[target-url | env] [ready=true|false]"
5
5
  ---
6
6
 
7
- Use the /lisa-rails:exploratory-qa skill to experience the app like a brand-new first-time user — landing cold on the home page and clicking through to find anything confusing, broken, or hard to understand across all breakpoints — and file each finding (bugs, usability/clarity issues) as a tracked work item via lisa:tracker-write, build-ready or in triage per the ready flag (default: triage). For automated Playwright coverage gaps, use /lisa-rails:e2e-coverage-gaps. $ARGUMENTS
7
+ Use the /lisa-rails:exploratory-qa skill to experience the app like a brand-new first-time user in a real browser or browser automation session — landing cold on the home page, clicking/typing/selecting through visible controls, and verifying resulting UI state across all breakpoints — and file each finding (bugs, usability/clarity issues) as a tracked work item via lisa:tracker-write, build-ready or in triage per the ready flag (default: triage). Static scans, HTTP fetches, screenshots alone, or console/network checks alone are not enough. For automated Playwright coverage gaps, use /lisa-rails:e2e-coverage-gaps. $ARGUMENTS
@@ -1,19 +1,22 @@
1
1
  ---
2
2
  name: exploratory-qa
3
- description: First-time-user exploratory QA walkthrough for web apps that FEEDS THE LIFECYCLE. Use when asked to experience an app the way a brand-new human user would — landing cold on the home page and clicking through to find anything confusing, broken, or hard to understand (unclear purpose or audience, human-facing jargon, contextless extracted data, machine-style labels, raw dates/enums, sparse data with no explanation, wrong control semantics, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent/non-standard UX, awkward scroll behavior, unclear affordances, dead-end flows that strand a user — e.g. a login page with no way to register or recover a password, or a primary action that drops the user into an incomplete/unsatisfiable state with no way to finish) across all breakpoints. Instead of writing a report file, it files every finding as a tracked work item via lisa:tracker-write (bugs and usability/UX issues). A `ready` parameter controls whether those tickets are created build-ready (auto-picked-up by lisa:intake) or left in the backlog for human triage (default). For gaps in the automated Playwright test suite, use the e2e-coverage-gaps skill instead.
3
+ description: First-time-user exploratory QA walkthrough for web apps that FEEDS THE LIFECYCLE. Use when asked to experience an app the way a brand-new human user would — opening it in a real browser or browser automation session, landing cold on the home page, and clicking/typing/selecting through visible controls to find anything confusing, broken, or hard to understand (unclear purpose or audience, human-facing jargon, contextless extracted data, machine-style labels, raw dates/enums, sparse data with no explanation, wrong control semantics, slow or unclear loads, late meaningful content, cramped or cut-off UI, inconsistent/non-standard UX, awkward scroll behavior, unclear affordances, dead-end flows that strand a user — e.g. a login page with no way to register or recover a password, or a primary action that drops the user into an incomplete/unsatisfiable state with no way to finish) across all breakpoints. Static route scans, HTTP fetches, screenshots alone, or console/network checks alone are not sufficient exploratory QA evidence. Instead of writing a report file, it files every finding as a tracked work item via lisa:tracker-write (bugs and usability/UX issues). A `ready` parameter controls whether those tickets are created build-ready (auto-picked-up by lisa:intake) or left in the backlog for human triage (default). For gaps in the automated Playwright test suite, use the e2e-coverage-gaps skill instead.
4
4
  ---
5
5
 
6
6
  # Exploratory QA
7
7
 
8
8
  ## Overview
9
9
 
10
- Experience the app the way a **brand-new human user** would: land cold on the home page with no prior
11
- knowledge, then click through and actually try to use it just like a real person. The goal is to
12
- surface anything **confusing, broken, or hard to understand**, and to do so at **every breakpoint**.
10
+ Experience the app the way a **brand-new human user** would: open it in a real browser or browser
11
+ automation tool, land cold on the home page with no prior knowledge, then click through and actually
12
+ try to use it just like a real person. The goal is to surface anything **confusing, broken, or hard
13
+ to understand**, and to do so at **every breakpoint**.
13
14
 
14
15
  This is a usability/experience pass, **not** a test-coverage audit. It does not look at the Playwright
15
16
  suite or hunt for coverage gaps — for that, use the `e2e-coverage-gaps` skill. Here, every finding is
16
- filed as a tracked work item so it enters the Lisa lifecycle — no static report file.
17
+ filed as a tracked work item so it enters the Lisa lifecycle — no static report file. Static route
18
+ scans, HTTP fetches, screenshots alone, and console/network checks alone do not count as exploratory
19
+ QA evidence because they do not prove a person could use the visible UI.
17
20
 
18
21
  ## Parameters
19
22
 
@@ -29,6 +32,9 @@ filed as a tracked work item so it enters the Lisa lifecycle — no static repor
29
32
 
30
33
  - Identify the target environment, account type, and browser requirement, and read the `ready` flag
31
34
  (default `false`).
35
+ - Open the target in a real browser or browser automation tool before drawing conclusions. Use static
36
+ code inspection, route lists, network/console logs, and screenshots only as supporting evidence, not
37
+ as a substitute for live browser interaction.
32
38
  - **Confirm the tracker is configured.** Findings are filed as tickets, so read `tracker` from
33
39
  `.lisa.config.json` (local overrides global). If it is unset, stop and report that the tracker must
34
40
  be configured (via `/lisa:setup:jira` / `:github` / `:linear`) before exploratory QA can file
@@ -49,8 +55,11 @@ filed as a tracked work item so it enters the Lisa lifecycle — no static repor
49
55
 
50
56
  ### 3. Use It Like a Human
51
57
 
52
- Click through the visible paths and actually attempt real tasks — a first-time user explores, makes
53
- mistakes, and tries the obvious thing. Cover at least these dimensions unless the user narrows scope:
58
+ Click through the visible paths and actually attempt real tasks in the browser — a first-time user
59
+ explores, makes mistakes, and tries the obvious thing. When a page exposes forms, filters, menus,
60
+ links, buttons, selects, tabs, or other visible controls, click, type, select, submit, clear,
61
+ navigate, and otherwise exercise representative controls when safe; then verify the resulting UI or
62
+ data state in the browser. Cover at least these dimensions unless the user narrows scope:
54
63
 
55
64
  - **Comprehension & labeling:** human-facing copy must sound like something a normal first-time user
56
65
  would understand. Flag machine-style or developer labels shown to users (raw IDs, enum keys,