@llipe.com/dev-tasks 0.9.2 → 0.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/ux-engineer.md +118 -114
- package/.claude/skills/activity-refine/SKILL.md +1 -0
- package/.claude/skills/ux-scaffold/SKILL.md +129 -0
- package/.claude/skills/ux-scaffold/scripts/scaffold-full.sh +183 -0
- package/.claude/skills/ux-scaffold/scripts/scaffold-lite.sh +235 -0
- package/.claude/skills/ux-theme-gen/SKILL.md +149 -0
- package/.github/agents/ux-engineer.agent.md +119 -114
- package/.github/skills/activity-refine/SKILL.md +6 -0
- package/.github/skills/ux-scaffold/SKILL.md +129 -0
- package/.github/skills/ux-scaffold/scripts/scaffold-full.sh +183 -0
- package/.github/skills/ux-scaffold/scripts/scaffold-lite.sh +235 -0
- package/.github/skills/ux-theme-gen/SKILL.md +149 -0
- package/.kiro/agents/ux-engineer.md +119 -132
- package/.kiro/skills/activity-refine/SKILL.md +1 -0
- package/.kiro/skills/ux-scaffold/SKILL.md +129 -0
- package/.kiro/skills/ux-scaffold/scripts/scaffold-full.sh +183 -0
- package/.kiro/skills/ux-scaffold/scripts/scaffold-lite.sh +235 -0
- package/.kiro/skills/ux-theme-gen/SKILL.md +149 -0
- package/AGENTS.md +8 -7
- package/CHANGELOG.md +31 -0
- package/DESIGN.md +233 -0
- package/README.md +30 -28
- package/bundle-manifest.json +1 -0
- package/dist/core/distribution/doctor.d.ts +2 -2
- package/dist/core/distribution/doctor.js +3 -3
- package/dist/core/distribution/profiles.d.ts.map +1 -1
- package/dist/core/distribution/profiles.js +1 -1
- package/dist/core/distribution/profiles.js.map +1 -1
- package/package.json +4 -3
- package/.claude/skills/webapp-mockup/SKILL.md +0 -76
- package/.claude/skills/webapp-mockup/scripts/scaffold-mockup.sh +0 -469
- package/.github/skills/webapp-mockup/SKILL.md +0 -71
- package/.github/skills/webapp-mockup/scripts/scaffold-mockup.sh +0 -469
- package/.kiro/skills/webapp-mockup/SKILL.md +0 -76
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,14 @@ Multi-story orchestration with checkpoint/resume:
|
|
|
249
249
|
|
|
250
250
|
### Other Agents
|
|
251
251
|
|
|
252
|
-
| Agent | Purpose
|
|
253
|
-
| ------------------ |
|
|
254
|
-
| `ux-engineer` | PRD/SPEC-to-
|
|
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
260
|
|
|
261
261
|
---
|
|
262
262
|
|
|
@@ -264,24 +264,25 @@ Multi-story orchestration with checkpoint/resume:
|
|
|
264
264
|
|
|
265
265
|
On-demand capabilities loaded only when invoked.
|
|
266
266
|
|
|
267
|
-
| Skill | Purpose
|
|
268
|
-
| -------------------------------- |
|
|
269
|
-
| `activity-init` | Product context and technical guidelines
|
|
270
|
-
| `activity-refine` | Issue refinement or PRD creation
|
|
271
|
-
| `activity-generate-spec` | PRD → technical specification
|
|
272
|
-
| `activity-generate-stories` | Spec → user stories with coverage validation
|
|
273
|
-
| `activity-publish-github` | Stories → GitHub Issues
|
|
274
|
-
| `activity-drift-reconciliation` | Routes verifier drift findings into remediation
|
|
275
|
-
| `git-ops` | Branch, rebase, merge, conflict resolution
|
|
276
|
-
| `
|
|
277
|
-
| `
|
|
278
|
-
| `activity-
|
|
279
|
-
| `activity-
|
|
280
|
-
| `activity-
|
|
281
|
-
| `activity-test-
|
|
282
|
-
| `activity-test-
|
|
283
|
-
| `activity-
|
|
284
|
-
| `
|
|
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
|
+
| `ux-scaffold` | Template-aware mockup generation (lite/full) | `ux-engineer` |
|
|
277
|
+
| `ux-theme-gen` | DESIGN.md → theme artifacts (CSS vars, Tailwind v4, RN) | `ux-engineer`, `developer` |
|
|
278
|
+
| `activity-e2e-test-design` | E2E black-box test scenario generation | `verifier` |
|
|
279
|
+
| `activity-contract-test-design` | Consumer/provider contract testing | `verifier` |
|
|
280
|
+
| `activity-edge-case-refinement` | Systematic edge-case discovery | `verifier` |
|
|
281
|
+
| `activity-random-test-tactics` | Randomized, fuzz, and property-inspired tests | `verifier` |
|
|
282
|
+
| `activity-test-standards` | Establish and maintain `/TESTING.md` | `qa-engineer` |
|
|
283
|
+
| `activity-test-implementation` | Author Layer 1-2 tests with enforced boundaries | `qa-engineer` |
|
|
284
|
+
| `activity-coverage-gap-analysis` | Coverage measurement and risk-ranked gaps | `qa-engineer` |
|
|
285
|
+
| `memo-cli-usage` | Shared architectural memory across sessions | `product-engineer`, `developer`, `technical-writer` |
|
|
285
286
|
|
|
286
287
|
---
|
|
287
288
|
|
|
@@ -337,7 +338,8 @@ Match your situation to a chain, then invoke the first agent in it. Full diagram
|
|
|
337
338
|
| Several dependent stories | `product-engineer` (… → plan) → `planner` → `developer` per story, sequential |
|
|
338
339
|
| Quick fix, task list exists | `developer` |
|
|
339
340
|
| 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`
|
|
341
|
+
| UX validation before build | `product-engineer` (refine → spec) → `ux-engineer` (lite) → `product-engineer` (stories) → `developer` |
|
|
342
|
+
| Quick screen sketches | `ux-engineer` (lite mode, direct invocation with PRD/spec path) |
|
|
341
343
|
| New project | `product-engineer` (init mode) |
|
|
342
344
|
|
|
343
345
|
The `verifier` audit after implementation is mandatory and non-skippable before a PR is marked ready.
|
|
@@ -407,7 +409,7 @@ memo setup init --repo <repo-name> --org <org-name> --domain <domain>
|
|
|
407
409
|
|
|
408
410
|
### Prerequisites
|
|
409
411
|
|
|
410
|
-
- Node.js >=
|
|
412
|
+
- Node.js >= 24
|
|
411
413
|
- pnpm (via `corepack enable`)
|
|
412
414
|
- git >= 2.37
|
|
413
415
|
|
package/bundle-manifest.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Doctor checks — validate environment prerequisites.
|
|
3
|
-
* Checks: Node >=
|
|
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 >=
|
|
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 >=
|
|
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 =
|
|
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 >=
|
|
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,
|
|
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;
|
|
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.
|
|
3
|
+
"version": "0.10.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": ">=
|
|
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": "
|
|
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",
|
|
@@ -1,76 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: webapp-mockup
|
|
3
|
-
description: "Scaffold and generate runnable React mockups for UX testing. Use when prototyping UI before full implementation."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Webapp Mockup Skill
|
|
7
|
-
|
|
8
|
-
Purpose
|
|
9
|
-
|
|
10
|
-
- Generate consistent, runnable React mockups for feature discovery and UI/functionality gap analysis.
|
|
11
|
-
- Produce partial, high-signal mockups with realistic UI artifacts: components, texts, transitions, popups, warnings, inputs, and validations.
|
|
12
|
-
|
|
13
|
-
When to use
|
|
14
|
-
|
|
15
|
-
- User asks to visualize a potential UI before full implementation.
|
|
16
|
-
- Team needs a browsable prototype to identify missing requirements.
|
|
17
|
-
- A feature section is still exploratory and should not include full backend flow.
|
|
18
|
-
|
|
19
|
-
Required behavior
|
|
20
|
-
|
|
21
|
-
1. Folder layout
|
|
22
|
-
|
|
23
|
-
- Create mockups only under:
|
|
24
|
-
- /mockups/mockup-<feature>-<num>
|
|
25
|
-
- Keep each mockup self-contained and runnable with npm scripts.
|
|
26
|
-
|
|
27
|
-
2. Color palette rule
|
|
28
|
-
|
|
29
|
-
- If the project or user has not defined a palette, ask for one.
|
|
30
|
-
- Default fallback palette source:
|
|
31
|
-
- https://colorhunt.co/palette/281c594e8d9c85c79aedf7bd
|
|
32
|
-
|
|
33
|
-
3. UI coverage requirements
|
|
34
|
-
|
|
35
|
-
- Include:
|
|
36
|
-
- Core components (cards, buttons, inputs, labels)
|
|
37
|
-
- Meaningful UI text and microcopy
|
|
38
|
-
- Transition behavior (section reveal, popup open/close)
|
|
39
|
-
- Popup/dialog examples
|
|
40
|
-
- Warning and error states
|
|
41
|
-
- Input validation states and messages
|
|
42
|
-
- No need to complete entire flow.
|
|
43
|
-
- If only a section is implemented, add a visible banner with instructions indicating this is a partial mockup and where to continue.
|
|
44
|
-
|
|
45
|
-
4. CSS references
|
|
46
|
-
|
|
47
|
-
- Ensure CSS files are referenced correctly from app entry/components.
|
|
48
|
-
- Keep any additional stylesheet imports explicit.
|
|
49
|
-
|
|
50
|
-
5. Consistency via scaffold script
|
|
51
|
-
|
|
52
|
-
- Use:
|
|
53
|
-
- ./.claude/skills/webapp-mockup/scripts/scaffold-mockup.sh <feature> <num> [palette_url]
|
|
54
|
-
- This script must be the default path for creating new mockups to keep structure and baseline behavior consistent.
|
|
55
|
-
- The scaffold path must remain non-interactive so agents can run it without manual terminal confirmation.
|
|
56
|
-
|
|
57
|
-
Operational workflow
|
|
58
|
-
|
|
59
|
-
1. Confirm feature slug and mockup number.
|
|
60
|
-
2. Confirm palette or apply fallback URL.
|
|
61
|
-
3. Run scaffold script.
|
|
62
|
-
|
|
63
|
-
- The script is designed to run non-interactively in agent terminal sessions.
|
|
64
|
-
|
|
65
|
-
4. Implement or adjust the specific mockup section requested.
|
|
66
|
-
5. Verify app runs with npm run dev.
|
|
67
|
-
6. Summarize what is mocked vs intentionally not implemented.
|
|
68
|
-
|
|
69
|
-
Acceptance checklist
|
|
70
|
-
|
|
71
|
-
- Mockup path follows /mockups/mockup-<feature>-<num>
|
|
72
|
-
- App is runnable locally
|
|
73
|
-
- Palette is user-defined or fallback applied
|
|
74
|
-
- Banner exists for partial implementation
|
|
75
|
-
- Includes inputs + validations + warnings + popup + transitions
|
|
76
|
-
- CSS references are present and valid
|