@llipe.com/dev-tasks 0.9.2 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/.claude/agents/developer.md +11 -0
  2. package/.claude/agents/qa-engineer.md +31 -2
  3. package/.claude/agents/researcher.md +96 -0
  4. package/.claude/agents/ux-engineer.md +118 -114
  5. package/.claude/commands/planner.md +22 -7
  6. package/.claude/commands/product-engineer.md +37 -10
  7. package/.claude/commands/researcher.md +28 -0
  8. package/.claude/skills/activity-codebase-research/SKILL.md +158 -0
  9. package/.claude/skills/activity-contract-validation/SKILL.md +167 -0
  10. package/.claude/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  11. package/.claude/skills/activity-integration-test-implementation/SKILL.md +156 -0
  12. package/.claude/skills/activity-refine/SKILL.md +1 -0
  13. package/.claude/skills/activity-test-standards/SKILL.md +41 -0
  14. package/.claude/skills/ux-scaffold/SKILL.md +129 -0
  15. package/.claude/skills/ux-scaffold/scripts/scaffold-full.sh +183 -0
  16. package/.claude/skills/ux-scaffold/scripts/scaffold-lite.sh +235 -0
  17. package/.claude/skills/ux-theme-gen/SKILL.md +149 -0
  18. package/.github/agents/developer.agent.md +11 -0
  19. package/.github/agents/planner.agent.md +22 -7
  20. package/.github/agents/product-engineer.agent.md +37 -10
  21. package/.github/agents/qa-engineer.agent.md +30 -3
  22. package/.github/agents/researcher.agent.md +96 -0
  23. package/.github/agents/ux-engineer.agent.md +119 -114
  24. package/.github/prompts/researcher.prompt.md +29 -0
  25. package/.github/skills/activity-codebase-research/SKILL.md +158 -0
  26. package/.github/skills/activity-contract-validation/SKILL.md +167 -0
  27. package/.github/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  28. package/.github/skills/activity-integration-test-implementation/SKILL.md +156 -0
  29. package/.github/skills/activity-refine/SKILL.md +6 -0
  30. package/.github/skills/activity-test-standards/SKILL.md +41 -0
  31. package/.github/skills/ux-scaffold/SKILL.md +129 -0
  32. package/.github/skills/ux-scaffold/scripts/scaffold-full.sh +183 -0
  33. package/.github/skills/ux-scaffold/scripts/scaffold-lite.sh +235 -0
  34. package/.github/skills/ux-theme-gen/SKILL.md +149 -0
  35. package/.kiro/agents/developer.md +11 -0
  36. package/.kiro/agents/planner.md +22 -7
  37. package/.kiro/agents/product-engineer.md +37 -10
  38. package/.kiro/agents/qa-engineer.md +30 -3
  39. package/.kiro/agents/researcher.md +99 -0
  40. package/.kiro/agents/ux-engineer.md +119 -132
  41. package/.kiro/agents/verifier.md +1 -1
  42. package/.kiro/skills/activity-codebase-research/SKILL.md +158 -0
  43. package/.kiro/skills/activity-contract-validation/SKILL.md +167 -0
  44. package/.kiro/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  45. package/.kiro/skills/activity-integration-test-implementation/SKILL.md +156 -0
  46. package/.kiro/skills/activity-refine/SKILL.md +1 -0
  47. package/.kiro/skills/activity-test-standards/SKILL.md +41 -0
  48. package/.kiro/skills/ux-scaffold/SKILL.md +129 -0
  49. package/.kiro/skills/ux-scaffold/scripts/scaffold-full.sh +183 -0
  50. package/.kiro/skills/ux-scaffold/scripts/scaffold-lite.sh +235 -0
  51. package/.kiro/skills/ux-theme-gen/SKILL.md +149 -0
  52. package/AGENTS.md +91 -214
  53. package/CHANGELOG.md +64 -0
  54. package/CLAUDE.md +3 -2
  55. package/DESIGN.md +233 -0
  56. package/README.md +31 -28
  57. package/TESTING.md +19 -11
  58. package/bundle-manifest.json +1 -0
  59. package/dist/core/distribution/doctor.d.ts +2 -2
  60. package/dist/core/distribution/doctor.js +3 -3
  61. package/dist/core/distribution/profiles.d.ts.map +1 -1
  62. package/dist/core/distribution/profiles.js +1 -1
  63. package/dist/core/distribution/profiles.js.map +1 -1
  64. package/package.json +4 -3
  65. package/.claude/skills/webapp-mockup/SKILL.md +0 -76
  66. package/.claude/skills/webapp-mockup/scripts/scaffold-mockup.sh +0 -469
  67. package/.github/skills/webapp-mockup/SKILL.md +0 -71
  68. package/.github/skills/webapp-mockup/scripts/scaffold-mockup.sh +0 -469
  69. package/.kiro/skills/webapp-mockup/SKILL.md +0 -76
package/CHANGELOG.md CHANGED
@@ -5,6 +5,70 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/).
7
7
 
8
+ ## [0.11.0] - 2026-08-25
9
+
10
+ ### Added
11
+
12
+ - feat(agent): add researcher agent and activity-codebase-research skill
13
+ - feat(test): add integration, E2E, and contract validation skills (#130)
14
+
15
+ ### Fixed
16
+
17
+ - fix: trim AGENTS.md from 2678 to 1218 words
18
+
19
+ ### Changed
20
+
21
+ - chore: prettier
22
+ - chore: archive workstream
23
+ - Merge pull request #147 from llipe:issue/139-research-agent
24
+ - docs: fix drift found by technical-writer pass
25
+ - Merge pull request #146 from llipe:issue/142-clean-agents-md
26
+ - test(fixtures): update catalog fixture timestamps and generator version
27
+ - Merge pull request #138 from llipe/issue/130-integration-testing-playwright-e2e
28
+ - test: add parity and content tests for issue #130 skills
29
+
30
+ ## [Unreleased]
31
+
32
+ ### Added
33
+
34
+ - feat(agent): add `researcher` agent and `activity-codebase-research` skill (#139)
35
+ - Ten-agent roster (Copilot/Kiro), eight Claude subagents
36
+ - Eight-slice taxonomy, 250-line/30-file budget caps
37
+ - Conditional pre-refine (Issue Mode) and pre-spec (Feature Mode) research step
38
+ - Developer troubleshooting and planner pre-orchestration paths
39
+ - ADR-004: pre-spec codebase research step
40
+
41
+ ## [0.10.0] - 2026-08-19
42
+
43
+ ### Added
44
+
45
+ - feat(ux): add ux-scaffold, ux-theme-gen skills; rewrite ux-engineer agent
46
+
47
+ ### Fixed
48
+
49
+ - fix(design): distribute DESIGN.md and convert it to a placeholder contract
50
+
51
+ ### Changed
52
+
53
+ - chore: format update
54
+ - Merge pull request #137 from llipe/issue/136-ux-engineer-overhaul
55
+ - chore: remove webapp-mockup skill entirely
56
+ - docs: add DESIGN.md to system-overview and update workflow-chains with lite mode
57
+ - chore!: raise minimum Node.js to >= 24
58
+
59
+ ## [Unreleased]
60
+
61
+ ### Changed
62
+
63
+ - **BREAKING:** raise the minimum supported Node.js version to `>= 24` (was `>= 20`).
64
+ Node 24 is an LTS line supported through April 2028; Node 20 is past end-of-life,
65
+ so the previous floor claimed support for an unsupported runtime. Consumers on
66
+ Node 20 or 22 must upgrade. Affects `engines.node`, the `dev-tasks doctor` check
67
+ (`MIN_NODE_MAJOR`), the shipped CI templates (`templates/meta-repo/catalog-rebuild.yml`,
68
+ `templates/bitbucket-pipelines.yml`), and the documented prerequisites.
69
+ - Pin `@types/node` to `24.13.3`, matching the minimum supported runtime rather than
70
+ the latest release, so Node 26-only APIs cannot be referenced against a Node 24 floor.
71
+
8
72
  ## [0.9.2] - 2026-08-18
9
73
 
10
74
  ### Fixed
package/CLAUDE.md CHANGED
@@ -55,13 +55,14 @@ This toolkit is exposed as **commands** (entry points you invoke with `/`), **su
55
55
  | `/technical-writer` | Sync `/docs` with the codebase. |
56
56
  | `/housekeeping` | Fix lint/type/test-wiring issues. |
57
57
  | `/qa-engineer` | Establish `/TESTING.md`, author missing Layer 1-2 tests, and report `coverage_gate` plus risk-ranked gaps. |
58
+ | `/researcher` | Bounded codebase investigation producing a structured research artifact at `/workstream/research-*.md`. |
58
59
  | `/ux-engineer` | PRD/SPEC → React mockups + refinement handoff. |
59
60
  | `/verifier-design` | Generate a compliance test plan + traceability matrix from a spec/story (Design Mode). |
60
61
  | `/verifier-audit` | Grey-box fidelity audit of delivered work against requirements and PRD/spec intent (Audit Mode). |
61
62
 
62
63
  ### Subagents (`.claude/agents/`)
63
64
 
64
- `developer`, `github-ops`, `technical-writer`, `housekeeping`, `ux-engineer`, `verifier`, `qa-engineer` — isolated, scoped-tool workers. Claude delegates to these automatically when a task matches their description, and the orchestrator commands (`/planner`, `/product-engineer`) drive them via the Task tool.
65
+ `developer`, `github-ops`, `technical-writer`, `housekeeping`, `ux-engineer`, `verifier`, `qa-engineer`, `researcher` — isolated, scoped-tool workers. Claude delegates to these automatically when a task matches their description, and the orchestrator commands (`/planner`, `/product-engineer`) drive them via the Task tool.
65
66
 
66
67
  ### Orchestration model (important)
67
68
 
@@ -72,7 +73,7 @@ Claude Code subagents **cannot spawn other subagents** — the hierarchy is flat
72
73
 
73
74
  ### Skills (`.claude/skills/`)
74
75
 
75
- Activity skills: `activity-init`, `activity-refine`, `activity-generate-spec`, `activity-generate-stories`, `activity-publish-github`, `activity-e2e-test-design`, `activity-contract-test-design`, `activity-edge-case-refinement`, `activity-random-test-tactics`, `activity-test-standards`, `activity-test-implementation`, `activity-coverage-gap-analysis`, `activity-drift-reconciliation` (routes `verifier` drift findings into task-list/checklist expansion, new issues, or human-confirmed PRD/spec changelog updates — used by `product-engineer`). Process skills: `plan`, `implement` (the single source of truth for task-list execution rules, including the mandatory `verifier` audit gate). Operational: `git-ops`, `webapp-mockup`, `memo-cli-usage`.
76
+ Activity skills: `activity-init`, `activity-refine`, `activity-codebase-research`, `activity-generate-spec`, `activity-generate-stories`, `activity-publish-github`, `activity-e2e-test-design`, `activity-e2e-test-implementation`, `activity-contract-test-design`, `activity-contract-validation`, `activity-edge-case-refinement`, `activity-random-test-tactics`, `activity-test-standards`, `activity-test-implementation`, `activity-integration-test-implementation`, `activity-coverage-gap-analysis`, `activity-drift-reconciliation` (routes `verifier` drift findings into task-list/checklist expansion, new issues, or human-confirmed PRD/spec changelog updates — used by `product-engineer`). Process skills: `plan`, `implement` (the single source of truth for task-list execution rules, including the mandatory `verifier` audit gate). Operational: `git-ops`, `ux-scaffold`, `ux-theme-gen`, `memo-cli-usage`.
76
77
 
77
78
  `plan` and `implement` are scoped instructions on Copilot (`applyTo`) and scoped steering on Kiro (`fileMatchPattern`); as Claude skills they load on demand instead of consuming context on every matching turn.
78
79
 
package/DESIGN.md ADDED
@@ -0,0 +1,233 @@
1
+ ---
2
+ version: alpha
3
+ name: Design Standard
4
+ description: Canonical visual and technical contract for UI artifacts, mockups, and implementation guidance in this repository.
5
+ status: placeholder
6
+ owner: ux-engineer
7
+ # ─── Technical contract ───────────────────────────────────────────────────────
8
+ platform: "<unfilled>" # web | mobile | both
9
+ framework: "<unfilled>" # react | react-native | html
10
+ css_approach: "<unfilled>" # tailwind | css-modules | styled-components | inline
11
+ component_library: "<unfilled>" # shadcn | chakra | mui | custom | none
12
+ primitive_base: "<unfilled>" # radix | base | aria — shadcn --base; only when component_library: shadcn
13
+ component_library_version: "<unfilled>" # pin exactly, never ^ or latest
14
+ theme_output: "<unfilled>" # where ux-theme-gen writes; default /mockups/.theme/
15
+ responsive_breakpoints:
16
+ sm: "<unfilled>" # e.g. 640px
17
+ md: "<unfilled>" # e.g. 768px
18
+ lg: "<unfilled>" # e.g. 1024px
19
+ xl: "<unfilled>" # e.g. 1280px
20
+ # ─── Visual tokens ────────────────────────────────────────────────────────────
21
+ # Semantic slot names below match shadcn/ui so generated themes can override
22
+ # them directly. Add project-specific extras under `colors-extended`.
23
+ colors:
24
+ background: "<unfilled>"
25
+ foreground: "<unfilled>"
26
+ card: "<unfilled>"
27
+ card-foreground: "<unfilled>"
28
+ primary: "<unfilled>"
29
+ primary-foreground: "<unfilled>"
30
+ secondary: "<unfilled>"
31
+ secondary-foreground: "<unfilled>"
32
+ muted: "<unfilled>"
33
+ muted-foreground: "<unfilled>"
34
+ accent: "<unfilled>"
35
+ accent-foreground: "<unfilled>"
36
+ destructive: "<unfilled>"
37
+ destructive-foreground: "<unfilled>"
38
+ border: "<unfilled>"
39
+ input: "<unfilled>"
40
+ ring: "<unfilled>"
41
+ colors-extended: {} # project tokens with no shadcn slot; declare the mapping below
42
+ typography:
43
+ heading-xl:
44
+ fontFamily: "<unfilled>"
45
+ fontSize: "<unfilled>"
46
+ fontWeight: "<unfilled>"
47
+ lineHeight: "<unfilled>"
48
+ heading-md:
49
+ fontFamily: "<unfilled>"
50
+ fontSize: "<unfilled>"
51
+ fontWeight: "<unfilled>"
52
+ lineHeight: "<unfilled>"
53
+ body-md:
54
+ fontFamily: "<unfilled>"
55
+ fontSize: "<unfilled>"
56
+ fontWeight: "<unfilled>"
57
+ lineHeight: "<unfilled>"
58
+ body-sm:
59
+ fontFamily: "<unfilled>"
60
+ fontSize: "<unfilled>"
61
+ fontWeight: "<unfilled>"
62
+ lineHeight: "<unfilled>"
63
+ label-sm:
64
+ fontFamily: "<unfilled>"
65
+ fontSize: "<unfilled>"
66
+ fontWeight: "<unfilled>"
67
+ lineHeight: "<unfilled>"
68
+ rounded:
69
+ sm: "<unfilled>"
70
+ md: "<unfilled>"
71
+ lg: "<unfilled>"
72
+ spacing:
73
+ xs: "<unfilled>"
74
+ sm: "<unfilled>"
75
+ md: "<unfilled>"
76
+ lg: "<unfilled>"
77
+ xl: "<unfilled>"
78
+ components: {} # component token overrides; see Components section
79
+ ---
80
+
81
+ <!--
82
+ PLACEHOLDER. This file ships with dev-tasks as a section contract only — it
83
+ deliberately asserts no project-specific values.
84
+
85
+ Run `ux-engineer` to inspect this repository and fill it in. The agent audits
86
+ existing UI code for signal, presents inferred values as labelled proposals,
87
+ interviews you for the decisions it cannot infer, and writes this file only
88
+ after your explicit confirmation. It MUST NOT author a design system silently.
89
+
90
+ The sentinel for an unset value is the string "<unfilled>" in front matter and
91
+ `<!-- unfilled -->` in prose. `ux-theme-gen` refuses to generate while any
92
+
93
+ sentinel remains, and agents MUST treat `status: placeholder` as "no standard
94
+ established" rather than as permission.
95
+
96
+ Owned by `ux-engineer`. `developer` keeps it current when the visual contract
97
+ changes. Listed in `consumer_owned_paths`, so `dev-tasks update` will never
98
+ overwrite a version you have filled in.
99
+ -->
100
+
101
+ ## Changelog
102
+
103
+ | Version | Date | Summary | Author |
104
+ | ------- | ---- | ------------------------------- | --------- |
105
+ | alpha | — | Shipped as an unfilled contract | dev-tasks |
106
+
107
+ Add a row on every change once filled.
108
+
109
+ ## Overview
110
+
111
+ Describe the intended feel of the product in two or three sentences: how
112
+ structured or expressive it should be, how much visual weight to carry, and what
113
+ the reader should trust about a screen at a glance.
114
+
115
+ <!-- unfilled -->
116
+
117
+ ## Colors
118
+
119
+ Declare how brand colour is applied versus neutral surface, and what each
120
+ semantic slot means in this product.
121
+
122
+ - `background` / `foreground` — base surface and its text
123
+ - `primary` — principal action and brand emphasis
124
+ - `secondary` — supporting emphasis and interactive accent
125
+ - `muted` — low-emphasis surfaces and secondary text
126
+ - `accent` — highlights and selected states
127
+ - `destructive` — irreversible and error affordances
128
+ - `border` / `input` / `ring` — separation and focus
129
+
130
+ Any token without a shadcn slot goes in `colors-extended`, with its purpose and
131
+ the slot it maps onto recorded here.
132
+
133
+ <!-- unfilled -->
134
+
135
+ ## Typography
136
+
137
+ State the hierarchy and where each token is used. Prioritize clarity and
138
+ scanning over decorative range.
139
+
140
+ <!-- unfilled -->
141
+
142
+ ## Layout
143
+
144
+ State the layout model, the breakpoint intent, and whether the product is
145
+ mobile-first or desktop-first.
146
+
147
+ <!-- unfilled -->
148
+
149
+ ## Elevation and Depth
150
+
151
+ State how separation is expressed — borders, shadow, or spacing — and how much
152
+ depth is acceptable.
153
+
154
+ <!-- unfilled -->
155
+
156
+ ## Shapes
157
+
158
+ State the radius convention and which radius belongs to which component family.
159
+
160
+ <!-- unfilled -->
161
+
162
+ ## Components
163
+
164
+ Component tokens define the baseline visual contract for controls and
165
+ containers. Model state-specific styling as separate component entries rather
166
+ than as inline exceptions.
167
+
168
+ <!-- unfilled -->
169
+
170
+ ## Voice and Tone
171
+
172
+ ### Communication principles
173
+
174
+ - Register: <!-- unfilled --> (concise / friendly / formal / technical)
175
+ - Voice: <!-- unfilled --> (active preferred, and where passive is acceptable)
176
+ - Person: <!-- unfilled --> (first / second / third)
177
+
178
+ ### Microcopy patterns
179
+
180
+ | Context | Pattern | Example |
181
+ | -------------------- | ----------------------------- | --------------------------------------------------------- |
182
+ | Success confirmation | <!-- unfilled --> | "Changes saved." |
183
+ | Error message | cause + recovery action | "Could not save. Check your connection and try again." |
184
+ | Empty state | state + next action | "No transactions yet. Add your first one to get started." |
185
+ | Loading | <!-- unfilled --> | "Loading your data..." |
186
+ | Destructive action | consequence + irreversibility | "This permanently deletes X. This cannot be undone." |
187
+ | Button labels | verb or verb + noun | "Save changes" / "Delete" / "Continue" |
188
+ | Placeholder text | example-prefixed | "e.g., john@example.com" |
189
+
190
+ Examples above are defaults, not decisions — replace them with this product's
191
+ actual phrasing when filling the contract.
192
+
193
+ ### Accessibility copy
194
+
195
+ - Every interactive element has a visible label.
196
+ - Error messages associate with their field via `aria-describedby`.
197
+ - Status messages use `aria-live` regions.
198
+ - Icon-only controls carry `sr-only` text alternatives.
199
+
200
+ ## Technical Standards
201
+
202
+ ### Framework and libraries
203
+
204
+ Values come from the front matter above. Record the reasoning here, especially
205
+ where the choice constrains future work.
206
+
207
+ - Platform: <!-- unfilled -->
208
+ - Framework: <!-- unfilled -->
209
+ - CSS approach: <!-- unfilled -->
210
+ - Component library and primitive base: <!-- unfilled -->
211
+
212
+ ### Token consumption
213
+
214
+ - Mockups and production code **MUST** consume tokens from `ux-theme-gen`
215
+ output, not from hand-copied values.
216
+ - Hardcoded colour or spacing values outside this file are findings.
217
+ - Generated theme files are derived artifacts. Regenerate them; never hand-edit.
218
+ - Colour values are emitted as declared here. `@theme` accepts any valid CSS
219
+ colour, so no colour-space conversion is performed.
220
+
221
+ ### File conventions
222
+
223
+ - Components `PascalCase`; files `kebab-case`.
224
+ - Web consumes CSS variables; React Native consumes the theme object.
225
+ - Mobile-first, progressively enhanced.
226
+
227
+ ## Do's and Don'ts
228
+
229
+ - Do keep contrast high for text and controls.
230
+ - Do preserve visible focus indicators and accessible state messaging.
231
+ - Do reuse tokens and component patterns before introducing new values.
232
+ - Don't introduce arbitrary hex values outside this file.
233
+ - Don't mix incompatible button, spacing, or radius patterns within one feature.
package/README.md CHANGED
@@ -249,14 +249,15 @@ Multi-story orchestration with checkpoint/resume:
249
249
 
250
250
  ### Other Agents
251
251
 
252
- | Agent | Purpose |
253
- | ------------------ | -------------------------------------------------------------------- |
254
- | `ux-engineer` | PRD/SPEC-to-mockup prototyping |
255
- | `technical-writer` | Documentation maintenance |
256
- | `housekeeping` | Lint, type, and test-wiring fixes |
257
- | `github-ops` | GitHub consistency — issues, PRs, branches, labels |
258
- | `verifier` | Compliance test-plan design and fidelity auditing |
259
- | `qa-engineer` | Testing standard, missing test harnesses, coverage and gap reporting |
252
+ | Agent | Purpose |
253
+ | ------------------ | ------------------------------------------------------------------------------- |
254
+ | `ux-engineer` | PRD/SPEC-to-screen visualization (lite/full), DESIGN.md ownership, gap analysis |
255
+ | `technical-writer` | Documentation maintenance |
256
+ | `housekeeping` | Lint, type, and test-wiring fixes |
257
+ | `github-ops` | GitHub consistency — issues, PRs, branches, labels |
258
+ | `verifier` | Compliance test-plan design and fidelity auditing |
259
+ | `qa-engineer` | Testing standard, missing test harnesses, coverage and gap reporting |
260
+ | `researcher` | Bounded codebase investigation producing structured research artifacts |
260
261
 
261
262
  ---
262
263
 
@@ -264,24 +265,25 @@ Multi-story orchestration with checkpoint/resume:
264
265
 
265
266
  On-demand capabilities loaded only when invoked.
266
267
 
267
- | Skill | Purpose | Consumer |
268
- | -------------------------------- | ----------------------------------------------- | --------------------------------------------------- |
269
- | `activity-init` | Product context and technical guidelines | `product-engineer` |
270
- | `activity-refine` | Issue refinement or PRD creation | `product-engineer` |
271
- | `activity-generate-spec` | PRD → technical specification | `product-engineer` |
272
- | `activity-generate-stories` | Spec → user stories with coverage validation | `product-engineer` |
273
- | `activity-publish-github` | Stories → GitHub Issues | `product-engineer` |
274
- | `activity-drift-reconciliation` | Routes verifier drift findings into remediation | `product-engineer` |
275
- | `git-ops` | Branch, rebase, merge, conflict resolution | `developer`, `planner` |
276
- | `webapp-mockup` | React mockup scaffold for UX testing | `ux-engineer` |
277
- | `activity-e2e-test-design` | E2E black-box test scenario generation | `verifier` |
278
- | `activity-contract-test-design` | Consumer/provider contract testing | `verifier` |
279
- | `activity-edge-case-refinement` | Systematic edge-case discovery | `verifier` |
280
- | `activity-random-test-tactics` | Randomized, fuzz, and property-inspired tests | `verifier` |
281
- | `activity-test-standards` | Establish and maintain `/TESTING.md` | `qa-engineer` |
282
- | `activity-test-implementation` | Author Layer 1-2 tests with enforced boundaries | `qa-engineer` |
283
- | `activity-coverage-gap-analysis` | Coverage measurement and risk-ranked gaps | `qa-engineer` |
284
- | `memo-cli-usage` | Shared architectural memory across sessions | `product-engineer`, `developer`, `technical-writer` |
268
+ | Skill | Purpose | Consumer |
269
+ | -------------------------------- | ------------------------------------------------------- | --------------------------------------------------- |
270
+ | `activity-init` | Product context and technical guidelines | `product-engineer` |
271
+ | `activity-refine` | Issue refinement or PRD creation | `product-engineer` |
272
+ | `activity-generate-spec` | PRD → technical specification | `product-engineer` |
273
+ | `activity-generate-stories` | Spec → user stories with coverage validation | `product-engineer` |
274
+ | `activity-publish-github` | Stories → GitHub Issues | `product-engineer` |
275
+ | `activity-drift-reconciliation` | Routes verifier drift findings into remediation | `product-engineer` |
276
+ | `git-ops` | Branch, rebase, merge, conflict resolution | `developer`, `planner` |
277
+ | `ux-scaffold` | Template-aware mockup generation (lite/full) | `ux-engineer` |
278
+ | `ux-theme-gen` | DESIGN.md → theme artifacts (CSS vars, Tailwind v4, RN) | `ux-engineer`, `developer` |
279
+ | `activity-e2e-test-design` | E2E black-box test scenario generation | `verifier` |
280
+ | `activity-contract-test-design` | Consumer/provider contract testing | `verifier` |
281
+ | `activity-edge-case-refinement` | Systematic edge-case discovery | `verifier` |
282
+ | `activity-random-test-tactics` | Randomized, fuzz, and property-inspired tests | `verifier` |
283
+ | `activity-test-standards` | Establish and maintain `/TESTING.md` | `qa-engineer` |
284
+ | `activity-test-implementation` | Author Layer 1-2 tests with enforced boundaries | `qa-engineer` |
285
+ | `activity-coverage-gap-analysis` | Coverage measurement and risk-ranked gaps | `qa-engineer` |
286
+ | `memo-cli-usage` | Shared architectural memory across sessions | `product-engineer`, `developer`, `technical-writer` |
285
287
 
286
288
  ---
287
289
 
@@ -337,7 +339,8 @@ Match your situation to a chain, then invoke the first agent in it. Full diagram
337
339
  | Several dependent stories | `product-engineer` (… → plan) → `planner` → `developer` per story, sequential |
338
340
  | Quick fix, task list exists | `developer` |
339
341
  | Test-first design | … → plan → `verifier` (design) → `developer` → `qa-engineer` → `verifier` (audit) → `product-engineer` (drift reconciliation) |
340
- | UX validation before build | `product-engineer` (refine → spec) → `ux-engineer` → `product-engineer` |
342
+ | UX validation before build | `product-engineer` (refine → spec) → `ux-engineer` (lite) → `product-engineer` (stories) → `developer` |
343
+ | Quick screen sketches | `ux-engineer` (lite mode, direct invocation with PRD/spec path) |
341
344
  | New project | `product-engineer` (init mode) |
342
345
 
343
346
  The `verifier` audit after implementation is mandatory and non-skippable before a PR is marked ready.
@@ -407,7 +410,7 @@ memo setup init --repo <repo-name> --org <org-name> --domain <domain>
407
410
 
408
411
  ### Prerequisites
409
412
 
410
- - Node.js >= 20
413
+ - Node.js >= 24
411
414
  - pnpm (via `corepack enable`)
412
415
  - git >= 2.37
413
416
 
package/TESTING.md CHANGED
@@ -25,15 +25,18 @@ established" rather than as permission.
25
25
 
26
26
  The layer taxonomy below is fixed. What belongs in each layer is project-specific.
27
27
 
28
- | Layer | Name | Scope | Status |
29
- | ----- | ------------------------- | ------------------------------------------------------------------------- | ----------------- |
30
- | 1 | Deterministic foundations | Unit tests, schema validation. No I/O, no network, no real database. | <!-- unfilled --> |
31
- | 2 | Constrained model/tool | Backend component tests, mocked APIs, fixtures and gold datasets. | <!-- unfilled --> |
32
- | 3 | Product evaluation | Semantic, tone, groundedness, hallucination evals. Only for LLM features. | <!-- unfilled --> |
33
- | 4 | Human evaluation | Review gates, safeguards, risk alerts. | <!-- unfilled --> |
34
-
35
- Integration and end-to-end layers are declared per project in the table below
36
- when they exist.
28
+ | Layer | Name | Scope | Status |
29
+ | -------- | ------------------------- | ------------------------------------------------------------------------------------- | ----------------- |
30
+ | 1 | Deterministic foundations | Unit tests, schema validation. No I/O, no network, no real database. | <!-- unfilled --> |
31
+ | 2 | Constrained model/tool | Backend component tests, mocked APIs, fixtures and gold datasets. | <!-- unfilled --> |
32
+ | 2.5 | Integration | Real database, real migrations, RLS policies, schema contracts. No mocked data layer. | <!-- unfilled --> |
33
+ | E2E | End-to-end | Playwright CLI — committed browser automation, full-stack, scenario-driven. | <!-- unfilled --> |
34
+ | Contract | Contract validation | API spec drift, breaking-change detection, consumer impact. `dt verify` family. | <!-- unfilled --> |
35
+ | 3 | Product evaluation | Semantic, tone, groundedness, hallucination evals. Only for LLM features. | <!-- unfilled --> |
36
+ | 4 | Human evaluation | Review gates, safeguards, risk alerts. | <!-- unfilled --> |
37
+
38
+ Integration, end-to-end, and contract validation layers are declared per project
39
+ in the table below when they exist.
37
40
 
38
41
  ### Layer boundaries
39
42
 
@@ -42,8 +45,12 @@ enforceable rather than aspirational.
42
45
 
43
46
  - **Layer 1 must not:** <!-- unfilled -->
44
47
  - **Layer 2 must not:** <!-- unfilled -->
48
+ - **Layer 2.5 must not:** mock the data layer. If the database is mocked, the test belongs at Layer 2. If the test hits a live external service over the network, it may belong at E2E or remote integration.
49
+ - **E2E must not:** assert on internal state or implementation details. Assertions are on observable user-facing behavior only.
50
+ - **Contract validation must not:** test internal business logic. It checks the boundary/interface only.
45
51
  - **Escalation rule** — when a Layer 1 test needs a real dependency, it moves up
46
52
  a layer rather than growing a test double that reimplements the dependency.
53
+ When a Layer 2 test needs a real database, it moves to Layer 2.5.
47
54
 
48
55
  ## Packages
49
56
 
@@ -86,8 +93,9 @@ Canonical script names for JS/TS packages. Prefer `pnpm`.
86
93
  | `typecheck` | Type analysis | yes |
87
94
  | `test` | Aggregate — MUST reach every test package | yes |
88
95
  | `test:unit` | Layer 1 | yes |
89
- | `test:integration` | Integration layer | when present |
90
- | `test:e2e` | End-to-end layer | when present |
96
+ | `test:integration` | Layer 2.5 — real database integration | when present |
97
+ | `test:e2e` | E2E layer — Playwright browser automation | when present |
98
+ | `test:contract` | Contract validation — `dt verify` family | when present |
91
99
  | `test:coverage` | Coverage measurement | when tooling exists |
92
100
  | `audit` | Dependency vulnerability scan | yes |
93
101
  | `validate` | Aggregate quality gate | yes |
@@ -103,6 +103,7 @@
103
103
  "consumer_owned_paths": [
104
104
  "AGENTS.md",
105
105
  "CLAUDE.md",
106
+ "DESIGN.md",
106
107
  "TESTING.md",
107
108
  ".claude/settings.json",
108
109
  ".kiro/settings/mcp.json",
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Doctor checks — validate environment prerequisites.
3
- * Checks: Node >= 20, git >= 2.37, cache dir writable, version skew.
3
+ * Checks: Node >= 24, git >= 2.37, cache dir writable, version skew.
4
4
  */
5
5
  export interface DoctorCheck {
6
6
  name: string;
@@ -12,7 +12,7 @@ export interface DoctorOptions {
12
12
  cacheDir?: string;
13
13
  }
14
14
  /**
15
- * Check Node.js version >= 20.
15
+ * Check Node.js version >= 24.
16
16
  */
17
17
  export declare function checkNodeVersion(versionStr?: string): DoctorCheck;
18
18
  /**
@@ -1,13 +1,13 @@
1
1
  /**
2
2
  * Doctor checks — validate environment prerequisites.
3
- * Checks: Node >= 20, git >= 2.37, cache dir writable, version skew.
3
+ * Checks: Node >= 24, git >= 2.37, cache dir writable, version skew.
4
4
  */
5
5
  import { mkdir, writeFile, rm } from "node:fs/promises";
6
6
  import { join } from "node:path";
7
7
  import { execSync } from "node:child_process";
8
8
  import { readManifest } from "./manifest.js";
9
9
  import { readPin } from "./pin.js";
10
- const MIN_NODE_MAJOR = 20;
10
+ const MIN_NODE_MAJOR = 24;
11
11
  const MIN_GIT_MAJOR = 2;
12
12
  const MIN_GIT_MINOR = 37;
13
13
  /**
@@ -24,7 +24,7 @@ function parseSemver(version) {
24
24
  };
25
25
  }
26
26
  /**
27
- * Check Node.js version >= 20.
27
+ * Check Node.js version >= 24.
28
28
  */
29
29
  export function checkNodeVersion(versionStr) {
30
30
  const version = versionStr ?? process.version;
@@ -1 +1 @@
1
- {"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../core/distribution/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mCAAmC;AACnC,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErE,qEAAqE;AACrE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,6DAA6D;AAC7D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAmBzD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAA4B,CAAC;AAErE;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,+CAA+C;AAC/C,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,EAMnC,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,EAAE,CAa3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,CAE9D"}
1
+ {"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../core/distribution/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mCAAmC;AACnC,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErE,qEAAqE;AACrE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,6DAA6D;AAC7D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAmBzD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAAyC,CAAC;AAElF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,+CAA+C;AAC/C,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,EAMnC,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,EAAE,CAa3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,CAE9D"}
@@ -34,7 +34,7 @@ export const PROFILE_PATHS = {
34
34
  * Entries MUST be bare filenames at the repository root — a nested or
35
35
  * platform-prefixed path belongs in `PROFILE_PATHS` instead.
36
36
  */
37
- export const ROOT_FILES = ["TESTING.md"];
37
+ export const ROOT_FILES = ["DESIGN.md", "TESTING.md"];
38
38
  /**
39
39
  * Manifest `profile` tag for root files.
40
40
  *
@@ -1 +1 @@
1
- {"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../core/distribution/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAoC;IAC5D,OAAO,EAAE;QACP,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE;QACvE,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,IAAI,EAAE;QACnF,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,EAAE;KAC3E;IACD,MAAM,EAAE;QACN,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE;QACvE,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,EAAE;QAC5E,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE;KACtE;IACD,IAAI,EAAE;QACJ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE;QACpE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE;QACnE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE;KAClE;CACF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsB,CAAC,YAAY,CAAU,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,KAAK;CACG,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/B,KAAK,KAAK;YACR,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAgB,CAAC,CAAC;AACnD,CAAC"}
1
+ {"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../core/distribution/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAoC;IAC5D,OAAO,EAAE;QACP,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE;QACvE,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,IAAI,EAAE;QACnF,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,EAAE;KAC3E;IACD,MAAM,EAAE;QACN,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE;QACvE,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,EAAE;QAC5E,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE;KACtE;IACD,IAAI,EAAE;QACJ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE;QACpE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE;QACnE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE;KAClE;CACF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsB,CAAC,WAAW,EAAE,YAAY,CAAU,CAAC;AAElF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,KAAK;CACG,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/B,KAAK,KAAK;YACR,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAgB,CAAC,CAAC;AACnD,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@llipe.com/dev-tasks",
3
- "version": "0.9.2",
3
+ "version": "0.11.0",
4
4
  "description": "Multi-repo context tooling for dev-tasks",
5
5
  "type": "module",
6
6
  "imports": {
@@ -30,6 +30,7 @@
30
30
  ".kiro/hooks/",
31
31
  "AGENTS.md",
32
32
  "CLAUDE.md",
33
+ "DESIGN.md",
33
34
  "TESTING.md",
34
35
  "bundle-manifest.json",
35
36
  "README.md",
@@ -40,7 +41,7 @@
40
41
  "registry": "https://registry.npmjs.org/"
41
42
  },
42
43
  "engines": {
43
- "node": ">=20"
44
+ "node": ">=24"
44
45
  },
45
46
  "scripts": {
46
47
  "build": "tsc",
@@ -75,7 +76,7 @@
75
76
  "packageManager": "pnpm@10.11.0",
76
77
  "devDependencies": {
77
78
  "@types/express": "^5.0.6",
78
- "@types/node": "22.15.18",
79
+ "@types/node": "24.13.3",
79
80
  "@typescript-eslint/eslint-plugin": "8.32.1",
80
81
  "@typescript-eslint/parser": "8.32.1",
81
82
  "eslint": "9.27.0",