create-harness-vibe-coding 0.8.7 → 0.8.9

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 (126) hide show
  1. package/README-CN.md +163 -105
  2. package/README.md +179 -244
  3. package/bin/create-harness-vibe-coding.js +2 -2
  4. package/docs/images/harness-architecture-light.png +0 -0
  5. package/docs/images/harness-architecture.drawio +164 -0
  6. package/docs/images/harness-icon.png +0 -0
  7. package/package.json +47 -44
  8. package/src/generator.js +41 -5
  9. package/src/index.js +86 -13
  10. package/src/prompts.js +37 -37
  11. package/templates/common/.claude/agents/architect-manager.md +45 -45
  12. package/templates/common/.claude/agents/architect.md +31 -31
  13. package/templates/common/.claude/agents/codebase-explorer.md +45 -0
  14. package/templates/common/.claude/agents/context-master.md +75 -75
  15. package/templates/common/.claude/agents/debugger.md +41 -41
  16. package/templates/common/.claude/agents/docs-researcher.md +41 -41
  17. package/templates/common/.claude/agents/explore-manager.md +41 -41
  18. package/templates/common/.claude/agents/implement-manager.md +49 -49
  19. package/templates/common/.claude/agents/implementer.md +40 -40
  20. package/templates/common/.claude/agents/memory-master.md +82 -64
  21. package/templates/common/.claude/agents/planner.md +34 -34
  22. package/templates/common/.claude/agents/researcher.md +41 -41
  23. package/templates/common/.claude/agents/review-manager.md +56 -56
  24. package/templates/common/.claude/agents/reviewer.md +34 -34
  25. package/templates/common/.claude/agents/task-scribe.md +70 -0
  26. package/templates/common/.claude/agents/verifier.md +29 -29
  27. package/templates/common/.claude/commands/wf-help.md +9 -5
  28. package/templates/common/.claude/commands/wf-update.md +24 -0
  29. package/templates/common/.claude/rules/ecc/common.md +57 -44
  30. package/templates/common/.claude/settings.json +13 -0
  31. package/templates/common/.claude/skills/subagent-orchestrator/SKILL.md +8 -4
  32. package/templates/common/.claude/skills/wf/SKILL.md +15 -8
  33. package/templates/common/.claude/skills/wf-auto/SKILL.md +10 -7
  34. package/templates/common/.claude/skills/wf-learn/SKILL.md +9 -2
  35. package/templates/common/.claude/skills/wf-max/SKILL.md +23 -5
  36. package/templates/common/.claude/skills/wf-readme/SKILL.md +49 -49
  37. package/templates/common/.claude/skills/wf-remove/SKILL.md +7 -7
  38. package/templates/common/.claude/skills/wf-update/SKILL.md +15 -2
  39. package/templates/common/.codex/hooks.json +17 -0
  40. package/templates/common/.harness-version +130 -45
  41. package/templates/common/.opencode/agents/architect-manager.md +52 -0
  42. package/templates/common/.opencode/agents/architect.md +35 -0
  43. package/templates/common/.opencode/agents/codebase-explorer.md +45 -0
  44. package/templates/common/.opencode/agents/context-master.md +81 -0
  45. package/templates/common/.opencode/agents/debugger.md +43 -0
  46. package/templates/common/.opencode/agents/docs-researcher.md +42 -0
  47. package/templates/common/.opencode/agents/explore-manager.md +49 -0
  48. package/templates/common/.opencode/agents/implement-manager.md +56 -0
  49. package/templates/common/.opencode/agents/implementer.md +42 -0
  50. package/templates/common/.opencode/agents/memory-master.md +88 -0
  51. package/templates/common/.opencode/agents/planner.md +38 -0
  52. package/templates/common/.opencode/agents/reflector.md +39 -0
  53. package/templates/common/.opencode/agents/researcher.md +42 -0
  54. package/templates/common/.opencode/agents/review-manager.md +63 -0
  55. package/templates/common/.opencode/agents/reviewer.md +37 -0
  56. package/templates/common/.opencode/agents/task-scribe.md +70 -0
  57. package/templates/common/.opencode/agents/tdd-guide.md +83 -0
  58. package/templates/common/.opencode/agents/test-writer.md +54 -0
  59. package/templates/common/.opencode/agents/verifier.md +37 -0
  60. package/templates/common/.opencode/commands/wf-auto-spark.md +15 -0
  61. package/templates/common/.opencode/commands/wf-auto.md +15 -0
  62. package/templates/common/.opencode/commands/wf-help.md +27 -0
  63. package/templates/common/.opencode/commands/wf-learn.md +15 -0
  64. package/templates/common/.opencode/commands/wf-max.md +15 -0
  65. package/templates/common/.opencode/commands/wf-readme.md +15 -0
  66. package/templates/common/.opencode/commands/wf-remove.md +15 -0
  67. package/templates/common/.opencode/commands/wf-review.md +15 -0
  68. package/templates/common/.opencode/commands/wf-update.md +24 -0
  69. package/templates/common/.opencode/commands/wf.md +15 -0
  70. package/templates/common/.opencode/plugins/harness-wf-status.mjs +135 -0
  71. package/templates/common/AGENTS.md +2 -29
  72. package/templates/common/CLAUDE.md +114 -88
  73. package/templates/common/Harness/ACCEPTANCE_PROTOCOL.md +2 -2
  74. package/templates/common/{MEMORY.md → Harness/MEMORY.md} +17 -4
  75. package/templates/common/Harness/MEMORY_PROTOCOL.md +80 -30
  76. package/templates/common/Harness/PROGRESS.md +17 -17
  77. package/templates/common/Harness/README.md +58 -19
  78. package/templates/common/{SETUP.md → Harness/SETUP.md} +278 -276
  79. package/templates/common/Harness/TASK_ARCHIVE.md +56 -0
  80. package/templates/common/Harness/WF-AUTO-ANGLES.md +170 -0
  81. package/templates/common/Harness/WF-AUTO-SPARK.md +10 -19
  82. package/templates/common/Harness/WF-AUTO.md +93 -167
  83. package/templates/common/Harness/WF-KERNEL.md +189 -0
  84. package/templates/common/Harness/WF-MAX.md +60 -328
  85. package/templates/common/Harness/WF-STATE.md +83 -0
  86. package/templates/common/Harness/WF.md +117 -237
  87. package/templates/common/Harness/agent-workflow.md +2 -2
  88. package/templates/common/Harness/architecture.md +124 -124
  89. package/templates/common/Harness/context-loading.md +111 -111
  90. package/templates/common/Harness/dispatch.md +43 -35
  91. package/templates/common/Harness/extension.md +66 -66
  92. package/templates/common/Harness/lifecycle.md +20 -20
  93. package/templates/common/Harness/research/PRD.md +56 -56
  94. package/templates/common/Harness/research/README.md +169 -169
  95. package/templates/common/Harness/research/research-results.md +66 -66
  96. package/templates/common/Harness/scripts/archive-tasks.mjs +239 -0
  97. package/templates/common/{scripts → Harness/scripts}/scan-clean.mjs +443 -416
  98. package/templates/common/{scripts → Harness/scripts}/validate-harness.mjs +691 -452
  99. package/templates/common/Harness/scripts/wf-auto-update-prompt.mjs +258 -0
  100. package/templates/common/{scripts → Harness/scripts}/wf-remove.mjs +56 -39
  101. package/templates/common/{scripts → Harness/scripts}/wf-update-check.mjs +632 -599
  102. package/templates/common/Harness/subagents.md +215 -214
  103. package/templates/common/Harness/tasks/_template/ARTIFACTS.md +2 -2
  104. package/templates/common/Harness/tasks/_template/NOTES.md +2 -2
  105. package/templates/common/Harness/tasks/_template/PLAN.md +5 -0
  106. package/templates/common/Harness/tasks/_template/STATE.json +23 -0
  107. package/templates/common/README.md +37 -37
  108. package/templates/common/memory/agent-lessons-patterns.md +22 -21
  109. package/templates/common/memory/routes.md +43 -0
  110. package/templates/common/memory/startup-hints.md +32 -0
  111. package/templates/common/memory/tool-usage-reflections.md +22 -21
  112. package/templates/common/memory/user-corrections-preferences.md +23 -21
  113. package/templates/common/opencode.json +19 -0
  114. package/templates/optional/catalog.json +49 -33
  115. package/templates/optional/skills/browser-e2e/.claude/skills/browser-e2e/SKILL.md +42 -42
  116. package/templates/optional/skills/browser-e2e/.claude/skills/wf-browser/SKILL.md +193 -193
  117. package/templates/optional/skills/browser-e2e/.opencode/commands/wf-browser.md +15 -0
  118. package/templates/optional/skills/browser-e2e/Harness/workflows/browser-e2e.md +48 -48
  119. package/templates/optional/skills/github-pr-review/.claude/skills/github-pr-review/SKILL.md +40 -40
  120. package/templates/optional/skills/github-pr-review/Harness/workflows/github-pr-review.md +28 -28
  121. package/templates/optional/skills/python-backend/.claude/skills/python-backend/SKILL.md +40 -40
  122. package/templates/optional/skills/python-backend/Harness/workflows/python-backend.md +34 -34
  123. package/templates/optional/skills/ts-react-frontend/.claude/skills/ts-react-frontend/SKILL.md +43 -43
  124. package/templates/optional/skills/ts-react-frontend/Harness/workflows/ts-react-frontend.md +34 -34
  125. package/templates/optional/skills/ui-ux-review/.claude/skills/ui-ux-review/SKILL.md +40 -40
  126. package/templates/optional/skills/ui-ux-review/Harness/workflows/ui-ux-review.md +26 -26
@@ -1,40 +1,40 @@
1
- ---
2
- name: python-backend
3
- description: Python backend workflow for API changes, service logic, FastAPI-style routes, and unittest or pytest verification.
4
- ---
5
-
6
- # Python Backend
7
-
8
- ## When To Use
9
-
10
- Use this skill when changing Python API routes, service logic, persistence boundaries, background jobs, or backend tests.
11
-
12
- ## Docs To Load
13
-
14
- - `Harness/workflows/python-backend.md`
15
- - `Harness/PROGRESS.md` and current task `tasks/<id>/PLAN.md`
16
- - Project backend README, API docs, dependency files, and test configuration.
17
-
18
- ## Required Inputs
19
-
20
- - Target behavior, endpoint, service, or bug.
21
- - Existing test command and runtime setup.
22
- - Database, environment variable, or fixture constraints.
23
-
24
- ## Allowed Writes
25
-
26
- - Python source, tests, fixtures, and backend docs in the task scope.
27
- - Local evidence artifacts such as test output snippets.
28
- - Current task `tasks/<id>/PLAN.md` when the task requires plan tracking.
29
-
30
- ## Output Format
31
-
32
- Return files changed, API or behavior summary, tests run, important logs, migration/config notes, and remaining risks.
33
-
34
- ## PROGRESS.md & Task PLAN.md Updates
35
-
36
- Update `Harness/tasks/<task-id>/PLAN.md` only when executing a tracked plan item or recording required validation evidence.
37
-
38
- ## dispatch.md Usage
39
-
40
- Use `Harness/dispatch.md` for separable backend work such as API implementation, database changes, and test coverage.
1
+ ---
2
+ name: python-backend
3
+ description: Python backend workflow for API changes, service logic, FastAPI-style routes, and unittest or pytest verification.
4
+ ---
5
+
6
+ # Python Backend
7
+
8
+ ## When To Use
9
+
10
+ Use this skill when changing Python API routes, service logic, persistence boundaries, background jobs, or backend tests.
11
+
12
+ ## Docs To Load
13
+
14
+ - `Harness/workflows/python-backend.md`
15
+ - `Harness/PROGRESS.md` and current task `tasks/<id>/PLAN.md`
16
+ - Project backend README, API docs, dependency files, and test configuration.
17
+
18
+ ## Required Inputs
19
+
20
+ - Target behavior, endpoint, service, or bug.
21
+ - Existing test command and runtime setup.
22
+ - Database, environment variable, or fixture constraints.
23
+
24
+ ## Allowed Writes
25
+
26
+ - Python source, tests, fixtures, and backend docs in the task scope.
27
+ - Local evidence artifacts such as test output snippets.
28
+ - Current task `tasks/<id>/PLAN.md` when the task requires plan tracking.
29
+
30
+ ## Output Format
31
+
32
+ Return files changed, API or behavior summary, tests run, important logs, migration/config notes, and remaining risks.
33
+
34
+ ## PROGRESS.md & Task PLAN.md Updates
35
+
36
+ Update `Harness/tasks/<task-id>/PLAN.md` only when executing a tracked plan item or recording required validation evidence.
37
+
38
+ ## dispatch.md Usage
39
+
40
+ Use `Harness/dispatch.md` for separable backend work such as API implementation, database changes, and test coverage.
@@ -1,34 +1,34 @@
1
- # Python Backend Workflow
2
-
3
- ## Required Evidence
4
-
5
- - Python executable, version, and dependency manager detected.
6
- - Unit/integration test command and result.
7
- - API smoke evidence for changed endpoints when applicable.
8
- - Migration, fixture, or environment assumptions.
9
-
10
- ## Common Commands
11
-
12
- ```powershell
13
- python --version
14
- py --version
15
- python3 --version
16
- python -m unittest discover -s tests
17
- py -m unittest discover -s tests
18
- python3 -m unittest discover -s tests
19
- python -m pytest
20
- python -m pytest tests
21
- uv run pytest
22
- poetry run pytest
23
- python -m uvicorn app.main:app --reload
24
- ```
25
-
26
- Prefer commands already documented by the project. When no project-specific command is documented, detect an available Python executable in the current shell (`python`, then `py`, then `python3`) and run the matching `-m unittest discover -s tests` or pytest command. `unittest` is first-class for standard-library test suites; do not require pytest when the project already uses unittest.
27
-
28
- ## Fallback
29
-
30
- If unittest, pytest, or the app runner is unavailable, run targeted Python modules, import checks, or framework-specific tests that already exist. Do not create or install a new backend stack without approval.
31
-
32
- ## Windows Notes
33
-
34
- Virtual environment activation is usually `.\\.venv\\Scripts\\Activate.ps1`. If script execution is blocked, use the environment's Python executable directly, for example `.\\.venv\\Scripts\\python.exe -m unittest discover -s tests` or `.\\.venv\\Scripts\\python.exe -m pytest`.
1
+ # Python Backend Workflow
2
+
3
+ ## Required Evidence
4
+
5
+ - Python executable, version, and dependency manager detected.
6
+ - Unit/integration test command and result.
7
+ - API smoke evidence for changed endpoints when applicable.
8
+ - Migration, fixture, or environment assumptions.
9
+
10
+ ## Common Commands
11
+
12
+ ```powershell
13
+ python --version
14
+ py --version
15
+ python3 --version
16
+ python -m unittest discover -s tests
17
+ py -m unittest discover -s tests
18
+ python3 -m unittest discover -s tests
19
+ python -m pytest
20
+ python -m pytest tests
21
+ uv run pytest
22
+ poetry run pytest
23
+ python -m uvicorn app.main:app --reload
24
+ ```
25
+
26
+ Prefer commands already documented by the project. When no project-specific command is documented, detect an available Python executable in the current shell (`python`, then `py`, then `python3`) and run the matching `-m unittest discover -s tests` or pytest command. `unittest` is first-class for standard-library test suites; do not require pytest when the project already uses unittest.
27
+
28
+ ## Fallback
29
+
30
+ If unittest, pytest, or the app runner is unavailable, run targeted Python modules, import checks, or framework-specific tests that already exist. Do not create or install a new backend stack without approval.
31
+
32
+ ## Windows Notes
33
+
34
+ Virtual environment activation is usually `.\\.venv\\Scripts\\Activate.ps1`. If script execution is blocked, use the environment's Python executable directly, for example `.\\.venv\\Scripts\\python.exe -m unittest discover -s tests` or `.\\.venv\\Scripts\\python.exe -m pytest`.
@@ -1,43 +1,43 @@
1
- ---
2
- name: ts-react-frontend
3
- description: TypeScript React frontend workflow for components, state, routing, typecheck, tests, builds, and browser smoke evidence.
4
- ---
5
-
6
- # TypeScript React Frontend
7
-
8
- ## When To Use
9
-
10
- Use this skill when changing React components, hooks, routes, client state, styling, build configuration, or frontend tests.
11
- For user-visible changes, typecheck, build, and unit tests are not enough; include real-browser smoke or screenshot evidence before claiming acceptance.
12
-
13
- ## Docs To Load
14
-
15
- - `Harness/workflows/ts-react-frontend.md`
16
- - `Harness/PROGRESS.md` and current task `tasks/<id>/PLAN.md`
17
- - Existing frontend README, package scripts, design system, and test setup.
18
-
19
- ## Required Inputs
20
-
21
- - Screen, component, or flow being changed.
22
- - Expected behavior and acceptance criteria.
23
- - Existing package manager and verification commands.
24
- - Selector contract: stable accessible labels/roles and `data-testid` hooks for critical inputs, buttons, filters, rows, empty/error/loading states, and other targetable UI states.
25
-
26
- ## Allowed Writes
27
-
28
- - Frontend source, styles, tests, and focused docs in task scope.
29
- - Generated evidence such as screenshots or test reports in existing artifact paths.
30
- - Current task `tasks/<id>/PLAN.md` when tracking a plan item.
31
-
32
- ## Output Format
33
-
34
- Return changed files, UI behavior summary, commands run, browser or test evidence, and unresolved risks.
35
- Include selectors added or verified for CDP/Playwright/manual checks.
36
-
37
- ## PROGRESS.md & Task PLAN.md Updates
38
-
39
- Update `Harness/tasks/<task-id>/PLAN.md` only when executing a tracked task or recording required validation evidence.
40
-
41
- ## dispatch.md Usage
42
-
43
- Use `Harness/dispatch.md` when independent frontend tasks can run in parallel, such as components, tests, and browser checks.
1
+ ---
2
+ name: ts-react-frontend
3
+ description: TypeScript React frontend workflow for components, state, routing, typecheck, tests, builds, and browser smoke evidence.
4
+ ---
5
+
6
+ # TypeScript React Frontend
7
+
8
+ ## When To Use
9
+
10
+ Use this skill when changing React components, hooks, routes, client state, styling, build configuration, or frontend tests.
11
+ For user-visible changes, typecheck, build, and unit tests are not enough; include real-browser smoke or screenshot evidence before claiming acceptance.
12
+
13
+ ## Docs To Load
14
+
15
+ - `Harness/workflows/ts-react-frontend.md`
16
+ - `Harness/PROGRESS.md` and current task `tasks/<id>/PLAN.md`
17
+ - Existing frontend README, package scripts, design system, and test setup.
18
+
19
+ ## Required Inputs
20
+
21
+ - Screen, component, or flow being changed.
22
+ - Expected behavior and acceptance criteria.
23
+ - Existing package manager and verification commands.
24
+ - Selector contract: stable accessible labels/roles and `data-testid` hooks for critical inputs, buttons, filters, rows, empty/error/loading states, and other targetable UI states.
25
+
26
+ ## Allowed Writes
27
+
28
+ - Frontend source, styles, tests, and focused docs in task scope.
29
+ - Generated evidence such as screenshots or test reports in existing artifact paths.
30
+ - Current task `tasks/<id>/PLAN.md` when tracking a plan item.
31
+
32
+ ## Output Format
33
+
34
+ Return changed files, UI behavior summary, commands run, browser or test evidence, and unresolved risks.
35
+ Include selectors added or verified for CDP/Playwright/manual checks.
36
+
37
+ ## PROGRESS.md & Task PLAN.md Updates
38
+
39
+ Update `Harness/tasks/<task-id>/PLAN.md` only when executing a tracked task or recording required validation evidence.
40
+
41
+ ## dispatch.md Usage
42
+
43
+ Use `Harness/dispatch.md` when independent frontend tasks can run in parallel, such as components, tests, and browser checks.
@@ -1,35 +1,35 @@
1
- # TypeScript React Frontend Workflow
2
-
3
- ## Required Evidence
4
-
5
- - Package manager and scripts detected.
6
- - Typecheck, lint, test, or build results according to project conventions.
7
- - Real-browser smoke or screenshot evidence for user-visible changes.
8
- - Console/runtime error check result for the changed screen or flow.
9
- - Notes on responsive behavior and important interaction states.
1
+ # TypeScript React Frontend Workflow
2
+
3
+ ## Required Evidence
4
+
5
+ - Package manager and scripts detected.
6
+ - Typecheck, lint, test, or build results according to project conventions.
7
+ - Real-browser smoke or screenshot evidence for user-visible changes.
8
+ - Console/runtime error check result for the changed screen or flow.
9
+ - Notes on responsive behavior and important interaction states.
10
10
  - Stable accessible labels/roles and stable test selectors such as `data-testid` are required for critical UI controls and states: inputs, buttons, filters, rows, empty/error/loading states.
11
-
12
- Typecheck, build, and unit tests are necessary signals but are not enough for user-visible React changes. Before claiming UI acceptance, load the app in a real browser by Playwright, Chrome DevTools/CDP, or a documented manual run and capture screenshot/trace/console evidence.
13
- For TS/React UI work, capture the selector contract in the feature doc before implementation so tests and manual checks can target stable selectors instead of component internals or brittle DOM paths.
14
-
15
- ## Common Commands
16
-
17
- ```powershell
18
- npm run typecheck
19
- npm run lint
20
- npm test
21
- npm run build
22
- npm run dev
23
- pnpm test
24
- yarn test
25
- ```
26
-
27
- Use the package manager and scripts already present in the repository.
28
-
29
- ## Fallback
30
-
31
- If no formal checks exist, run the closest available build or dev command, inspect the changed UI manually, and document the missing automation. Do not add dependencies unless the task requires it and the user approves.
32
-
33
- ## Windows Notes
34
-
35
- Use PowerShell syntax for environment variables: `$env:VITE_API_URL='http://localhost:8000'; npm run dev`. Quote paths and prefer package scripts over shell-specific command chains.
11
+
12
+ Typecheck, build, and unit tests are necessary signals but are not enough for user-visible React changes. Before claiming UI acceptance, load the app in a real browser by Playwright, Chrome DevTools/CDP, or a documented manual run and capture screenshot/trace/console evidence.
13
+ For TS/React UI work, capture the selector contract in the feature doc before implementation so tests and manual checks can target stable selectors instead of component internals or brittle DOM paths.
14
+
15
+ ## Common Commands
16
+
17
+ ```powershell
18
+ npm run typecheck
19
+ npm run lint
20
+ npm test
21
+ npm run build
22
+ npm run dev
23
+ pnpm test
24
+ yarn test
25
+ ```
26
+
27
+ Use the package manager and scripts already present in the repository.
28
+
29
+ ## Fallback
30
+
31
+ If no formal checks exist, run the closest available build or dev command, inspect the changed UI manually, and document the missing automation. Do not add dependencies unless the task requires it and the user approves.
32
+
33
+ ## Windows Notes
34
+
35
+ Use PowerShell syntax for environment variables: `$env:VITE_API_URL='http://localhost:8000'; npm run dev`. Quote paths and prefer package scripts over shell-specific command chains.
@@ -1,40 +1,40 @@
1
- ---
2
- name: ui-ux-review
3
- description: Screenshot-driven UI and UX review for responsive behavior, accessibility, visual polish, and task clarity.
4
- ---
5
-
6
- # UI/UX Review
7
-
8
- ## When To Use
9
-
10
- Use this skill when reviewing or changing user-facing screens, layouts, visual hierarchy, interaction states, accessibility, or responsive behavior.
11
-
12
- ## Docs To Load
13
-
14
- - `Harness/workflows/ui-ux-review.md`
15
- - `Harness/PROGRESS.md` and current task `tasks/<id>/PLAN.md`
16
- - Existing design system, component, or style documentation.
17
-
18
- ## Required Inputs
19
-
20
- - Screens, routes, or components under review.
21
- - Target users and primary tasks.
22
- - Breakpoints, themes, and accessibility expectations.
23
-
24
- ## Allowed Writes
25
-
26
- - UI code and style files already in scope for the task.
27
- - Screenshot or audit artifacts in existing evidence folders.
28
- - Current task `tasks/<id>/PLAN.md` when the review is part of a tracked plan.
29
-
30
- ## Output Format
31
-
32
- Return prioritized findings with file or screen references, evidence, recommended fixes, commands run, and residual risks.
33
-
34
- ## PROGRESS.md & Task PLAN.md Updates
35
-
36
- Update current task `tasks/<id>/PLAN.md` only for tracked review tasks or when recording required evidence.
37
-
38
- ## dispatch.md Usage
39
-
40
- Use `Harness/dispatch.md` only for independent review streams such as separate routes or breakpoints.
1
+ ---
2
+ name: ui-ux-review
3
+ description: Screenshot-driven UI and UX review for responsive behavior, accessibility, visual polish, and task clarity.
4
+ ---
5
+
6
+ # UI/UX Review
7
+
8
+ ## When To Use
9
+
10
+ Use this skill when reviewing or changing user-facing screens, layouts, visual hierarchy, interaction states, accessibility, or responsive behavior.
11
+
12
+ ## Docs To Load
13
+
14
+ - `Harness/workflows/ui-ux-review.md`
15
+ - `Harness/PROGRESS.md` and current task `tasks/<id>/PLAN.md`
16
+ - Existing design system, component, or style documentation.
17
+
18
+ ## Required Inputs
19
+
20
+ - Screens, routes, or components under review.
21
+ - Target users and primary tasks.
22
+ - Breakpoints, themes, and accessibility expectations.
23
+
24
+ ## Allowed Writes
25
+
26
+ - UI code and style files already in scope for the task.
27
+ - Screenshot or audit artifacts in existing evidence folders.
28
+ - Current task `tasks/<id>/PLAN.md` when the review is part of a tracked plan.
29
+
30
+ ## Output Format
31
+
32
+ Return prioritized findings with file or screen references, evidence, recommended fixes, commands run, and residual risks.
33
+
34
+ ## PROGRESS.md & Task PLAN.md Updates
35
+
36
+ Update current task `tasks/<id>/PLAN.md` only for tracked review tasks or when recording required evidence.
37
+
38
+ ## dispatch.md Usage
39
+
40
+ Use `Harness/dispatch.md` only for independent review streams such as separate routes or breakpoints.
@@ -1,26 +1,26 @@
1
- # UI/UX Review Workflow
2
-
3
- ## Required Evidence
4
-
5
- - Screenshots for desktop and mobile views.
6
- - Notes on layout, typography, interaction states, accessibility, and empty/loading/error states.
7
- - Any automated accessibility, lint, or visual test output available in the project.
8
-
9
- ## Common Commands
10
-
11
- ```powershell
12
- npm run dev
13
- npm run lint
14
- npm run test
15
- npx playwright test
16
- ```
17
-
18
- Use the project's existing commands first. Browser screenshots may come from Playwright, CDP, framework tooling, or manual capture.
19
-
20
- ## Fallback
21
-
22
- When automation is unavailable, inspect the running UI manually at representative viewport sizes and document findings with screenshots. Avoid adding design or test dependencies without approval.
23
-
24
- ## Windows Notes
25
-
26
- PowerShell does not support POSIX inline environment variables. Use `$env:NAME='value'; command` and quote screenshot paths with spaces.
1
+ # UI/UX Review Workflow
2
+
3
+ ## Required Evidence
4
+
5
+ - Screenshots for desktop and mobile views.
6
+ - Notes on layout, typography, interaction states, accessibility, and empty/loading/error states.
7
+ - Any automated accessibility, lint, or visual test output available in the project.
8
+
9
+ ## Common Commands
10
+
11
+ ```powershell
12
+ npm run dev
13
+ npm run lint
14
+ npm run test
15
+ npx playwright test
16
+ ```
17
+
18
+ Use the project's existing commands first. Browser screenshots may come from Playwright, CDP, framework tooling, or manual capture.
19
+
20
+ ## Fallback
21
+
22
+ When automation is unavailable, inspect the running UI manually at representative viewport sizes and document findings with screenshots. Avoid adding design or test dependencies without approval.
23
+
24
+ ## Windows Notes
25
+
26
+ PowerShell does not support POSIX inline environment variables. Use `$env:NAME='value'; command` and quote screenshot paths with spaces.