@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.
Files changed (34) hide show
  1. package/.claude/agents/ux-engineer.md +118 -114
  2. package/.claude/skills/activity-refine/SKILL.md +1 -0
  3. package/.claude/skills/ux-scaffold/SKILL.md +129 -0
  4. package/.claude/skills/ux-scaffold/scripts/scaffold-full.sh +183 -0
  5. package/.claude/skills/ux-scaffold/scripts/scaffold-lite.sh +235 -0
  6. package/.claude/skills/ux-theme-gen/SKILL.md +149 -0
  7. package/.github/agents/ux-engineer.agent.md +119 -114
  8. package/.github/skills/activity-refine/SKILL.md +6 -0
  9. package/.github/skills/ux-scaffold/SKILL.md +129 -0
  10. package/.github/skills/ux-scaffold/scripts/scaffold-full.sh +183 -0
  11. package/.github/skills/ux-scaffold/scripts/scaffold-lite.sh +235 -0
  12. package/.github/skills/ux-theme-gen/SKILL.md +149 -0
  13. package/.kiro/agents/ux-engineer.md +119 -132
  14. package/.kiro/skills/activity-refine/SKILL.md +1 -0
  15. package/.kiro/skills/ux-scaffold/SKILL.md +129 -0
  16. package/.kiro/skills/ux-scaffold/scripts/scaffold-full.sh +183 -0
  17. package/.kiro/skills/ux-scaffold/scripts/scaffold-lite.sh +235 -0
  18. package/.kiro/skills/ux-theme-gen/SKILL.md +149 -0
  19. package/AGENTS.md +8 -7
  20. package/CHANGELOG.md +31 -0
  21. package/DESIGN.md +233 -0
  22. package/README.md +30 -28
  23. package/bundle-manifest.json +1 -0
  24. package/dist/core/distribution/doctor.d.ts +2 -2
  25. package/dist/core/distribution/doctor.js +3 -3
  26. package/dist/core/distribution/profiles.d.ts.map +1 -1
  27. package/dist/core/distribution/profiles.js +1 -1
  28. package/dist/core/distribution/profiles.js.map +1 -1
  29. package/package.json +4 -3
  30. package/.claude/skills/webapp-mockup/SKILL.md +0 -76
  31. package/.claude/skills/webapp-mockup/scripts/scaffold-mockup.sh +0 -469
  32. package/.github/skills/webapp-mockup/SKILL.md +0 -71
  33. package/.github/skills/webapp-mockup/scripts/scaffold-mockup.sh +0 -469
  34. package/.kiro/skills/webapp-mockup/SKILL.md +0 -76
@@ -0,0 +1,235 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+
4
+ # scaffold-lite.sh — Generate a navigable html-lite mockup scaffold.
5
+ # All screens are self-contained HTML files styled from DESIGN.md tokens.
6
+ #
7
+ # Usage:
8
+ # ./scripts/scaffold-lite.sh <feature> <variant-num> <theme-css-path> <output-dir>
9
+ #
10
+ # Example:
11
+ # ./scripts/scaffold-lite.sh onboarding 1 /mockups/.theme/theme.css docs/requirements/mockups/onboarding/
12
+
13
+ usage() {
14
+ echo "Usage: $0 <feature> <variant-num> <theme-css-path> <output-dir>"
15
+ echo ""
16
+ echo " feature Feature slug (lowercase, hyphenated)"
17
+ echo " variant-num Variant number (integer)"
18
+ echo " theme-css-path Path to the generated theme.css from ux-theme-gen"
19
+ echo " output-dir Directory to create the mockup in"
20
+ exit 1
21
+ }
22
+
23
+ if [[ $# -ne 4 ]]; then
24
+ usage
25
+ fi
26
+
27
+ FEATURE="$(echo "$1" | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd 'a-z0-9-')"
28
+ VARIANT="$2"
29
+ THEME_CSS="$3"
30
+ OUTPUT_DIR="$4"
31
+
32
+ if [[ -z "$FEATURE" ]]; then
33
+ echo "Error: <feature> produced an empty slug."
34
+ exit 1
35
+ fi
36
+
37
+ if ! [[ "$VARIANT" =~ ^[0-9]+$ ]]; then
38
+ echo "Error: <variant-num> must be an integer."
39
+ exit 1
40
+ fi
41
+
42
+ if [[ ! -f "$THEME_CSS" ]]; then
43
+ echo "Error: theme.css not found at: $THEME_CSS"
44
+ echo "Run ux-theme-gen first to generate theme artifacts from DESIGN.md."
45
+ exit 1
46
+ fi
47
+
48
+ # Extract :root block from theme.css to inline in HTML files
49
+ ROOT_STYLES=$(sed -n '/:root/,/^}/p' "$THEME_CSS")
50
+ THEME_INLINE=$(sed -n '/@theme inline/,/^}/p' "$THEME_CSS")
51
+
52
+ mkdir -p "$OUTPUT_DIR"
53
+
54
+ # Screen types the agent will fill with content
55
+ SCREENS=(
56
+ "happy:Primary flow — success state"
57
+ "error-validation:Form validation failures"
58
+ "error-server:Server or network error state"
59
+ "error-permission:Permission denied or unauthorized"
60
+ "empty:No data or first-use experience"
61
+ "loading:Skeleton screens and spinners"
62
+ "edge-overflow:Long text, many items"
63
+ "edge-zero:Zero items, disabled states"
64
+ )
65
+
66
+ # Generate individual screen files
67
+ for entry in "${SCREENS[@]}"; do
68
+ name="${entry%%:*}"
69
+ desc="${entry#*:}"
70
+ filename="screen-${name}.html"
71
+
72
+ cat > "${OUTPUT_DIR}/${filename}" << SCREEN_EOF
73
+ <!DOCTYPE html>
74
+ <html lang="en">
75
+ <head>
76
+ <meta charset="UTF-8">
77
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
78
+ <title>${FEATURE} v${VARIANT} — ${name}</title>
79
+ <style>
80
+ ${ROOT_STYLES}
81
+
82
+ * { margin: 0; padding: 0; box-sizing: border-box; }
83
+ body {
84
+ font-family: system-ui, -apple-system, sans-serif;
85
+ background: var(--background);
86
+ color: var(--foreground);
87
+ min-height: 100vh;
88
+ padding: 1rem;
89
+ }
90
+ .nav-strip {
91
+ display: flex; gap: 0.5rem; padding: 0.75rem 1rem;
92
+ background: var(--muted); border-radius: 0.5rem;
93
+ margin-bottom: 1.5rem; flex-wrap: wrap; font-size: 0.875rem;
94
+ }
95
+ .nav-strip a { color: var(--primary); text-decoration: none; }
96
+ .nav-strip a:hover { text-decoration: underline; }
97
+ .nav-strip .current { font-weight: 700; color: var(--foreground); }
98
+ .screen-content {
99
+ border: 1px solid var(--border); border-radius: 0.75rem;
100
+ padding: 2rem; min-height: 60vh;
101
+ }
102
+ .screen-content h1 { font-size: 1.5rem; margin-bottom: 1rem; }
103
+ .screen-content .description { color: var(--muted-foreground); margin-bottom: 2rem; }
104
+ .banner {
105
+ background: var(--accent); color: var(--accent-foreground);
106
+ padding: 0.75rem 1rem; border-radius: 0.5rem; margin-bottom: 1.5rem;
107
+ font-size: 0.875rem;
108
+ }
109
+ </style>
110
+ </head>
111
+ <body>
112
+ <nav class="nav-strip">
113
+ <a href="index.html">Index</a>
114
+ SCREEN_EOF
115
+
116
+ # Add prev/next/related links placeholder
117
+ cat >> "${OUTPUT_DIR}/${filename}" << 'NAV_EOF'
118
+ <!-- Agent: replace with actual prev/next links based on screen order -->
119
+ <span class="current">CURRENT_SCREEN</span>
120
+ </nav>
121
+
122
+ <div class="banner">
123
+ Partial mockup — variant VARIANT_NUM of feature FEATURE_NAME. Extend with actual UI content.
124
+ </div>
125
+
126
+ <main class="screen-content" data-ac="AC-TODO">
127
+ <h1>SCREEN_TITLE</h1>
128
+ <p class="description">SCREEN_DESC</p>
129
+
130
+ <!-- Agent: implement the screen content here -->
131
+ <p style="color: var(--muted-foreground); font-style: italic;">
132
+ Screen content to be implemented by ux-engineer.
133
+ </p>
134
+ </main>
135
+ </body>
136
+ </html>
137
+ NAV_EOF
138
+
139
+ # Replace placeholders
140
+ sed -i '' "s/CURRENT_SCREEN/${name}/g" "${OUTPUT_DIR}/${filename}"
141
+ sed -i '' "s/VARIANT_NUM/${VARIANT}/g" "${OUTPUT_DIR}/${filename}"
142
+ sed -i '' "s/FEATURE_NAME/${FEATURE}/g" "${OUTPUT_DIR}/${filename}"
143
+ sed -i '' "s/SCREEN_TITLE/${name}/g" "${OUTPUT_DIR}/${filename}"
144
+ sed -i '' "s/SCREEN_DESC/${desc}/g" "${OUTPUT_DIR}/${filename}"
145
+ done
146
+
147
+ # Generate index.html
148
+ cat > "${OUTPUT_DIR}/index.html" << INDEX_EOF
149
+ <!DOCTYPE html>
150
+ <html lang="en">
151
+ <head>
152
+ <meta charset="UTF-8">
153
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
154
+ <title>${FEATURE} v${VARIANT} — Screen Index</title>
155
+ <style>
156
+ ${ROOT_STYLES}
157
+
158
+ * { margin: 0; padding: 0; box-sizing: border-box; }
159
+ body {
160
+ font-family: system-ui, -apple-system, sans-serif;
161
+ background: var(--background);
162
+ color: var(--foreground);
163
+ min-height: 100vh;
164
+ padding: 2rem;
165
+ max-width: 800px; margin: 0 auto;
166
+ }
167
+ h1 { font-size: 2rem; margin-bottom: 0.5rem; }
168
+ .subtitle { color: var(--muted-foreground); margin-bottom: 2rem; }
169
+ .screen-list { list-style: none; }
170
+ .screen-list li {
171
+ border: 1px solid var(--border); border-radius: 0.5rem;
172
+ padding: 1rem; margin-bottom: 0.75rem;
173
+ }
174
+ .screen-list a { color: var(--primary); text-decoration: none; font-weight: 600; }
175
+ .screen-list a:hover { text-decoration: underline; }
176
+ .screen-list .desc { color: var(--muted-foreground); font-size: 0.875rem; margin-top: 0.25rem; }
177
+ .screen-map { margin-top: 2rem; padding: 1.5rem; border: 1px solid var(--border); border-radius: 0.75rem; }
178
+ .screen-map h2 { margin-bottom: 1rem; }
179
+ pre { background: var(--muted); padding: 1rem; border-radius: 0.5rem; overflow-x: auto; font-size: 0.8rem; }
180
+ </style>
181
+ </head>
182
+ <body>
183
+ <h1>${FEATURE} — Variant ${VARIANT}</h1>
184
+ <p class="subtitle">Lite mockup — open any screen below. All links are relative and work from file://.</p>
185
+
186
+ <ul class="screen-list">
187
+ INDEX_EOF
188
+
189
+ for entry in "${SCREENS[@]}"; do
190
+ name="${entry%%:*}"
191
+ desc="${entry#*:}"
192
+ cat >> "${OUTPUT_DIR}/index.html" << ITEM_EOF
193
+ <li>
194
+ <a href="screen-${name}.html">${name}</a>
195
+ <div class="desc">${desc}</div>
196
+ </li>
197
+ ITEM_EOF
198
+ done
199
+
200
+ cat >> "${OUTPUT_DIR}/index.html" << FOOTER_EOF
201
+ </ul>
202
+
203
+ <div class="screen-map">
204
+ <h2>Screen Map</h2>
205
+ <pre><code>
206
+ See screen-map.md for the Mermaid source.
207
+ Agent: embed a rendered diagram here or link to screen-map.md.
208
+ </code></pre>
209
+ </div>
210
+ </body>
211
+ </html>
212
+ FOOTER_EOF
213
+
214
+ # Generate screen-map.md placeholder
215
+ cat > "${OUTPUT_DIR}/screen-map.md" << MAP_EOF
216
+ # Screen Map — ${FEATURE} v${VARIANT}
217
+
218
+ \`\`\`mermaid
219
+ flowchart LR
220
+ happy[Happy Path] --> error-validation[Validation Error]
221
+ happy --> empty[Empty State]
222
+ happy --> loading[Loading]
223
+ error-validation --> happy
224
+ error-server[Server Error] --> happy
225
+ error-permission[Permission Denied] --> happy
226
+ empty --> happy
227
+ edge-overflow[Overflow] --> happy
228
+ edge-zero[Zero Items] --> happy
229
+ \`\`\`
230
+
231
+ > Agent: update this diagram to reflect the actual navigation flow derived from the PRD/spec.
232
+ MAP_EOF
233
+
234
+ echo "Done. Lite scaffold created at: ${OUTPUT_DIR}"
235
+ echo " index.html + $(echo "${SCREENS[@]}" | wc -w | tr -d ' ') screen files + screen-map.md"
@@ -0,0 +1,149 @@
1
+ ---
2
+ name: ux-theme-gen
3
+ description: "Generate platform-specific theme artifacts from DESIGN.md. Use when mockups or production code need consumable tokens derived from the canonical design contract."
4
+ ---
5
+
6
+ # UX Theme Generation
7
+
8
+ ## Purpose
9
+
10
+ Transform the YAML front matter in `/DESIGN.md` into consumable theme artifacts that mockups and production code import directly. This eliminates hand-copied colour values and keeps every surface aligned with the declared contract.
11
+
12
+ ## When to Use
13
+
14
+ - Before generating any mockup (Phase 0 of `ux-engineer`).
15
+ - When `developer` needs production theme files aligned with DESIGN.md.
16
+ - After filling or updating DESIGN.md tokens.
17
+ - When a stale theme artifact is detected (its tokens don't match DESIGN.md).
18
+
19
+ ## Inputs
20
+
21
+ | Input | Required | Default |
22
+ | --------------------------------------- | -------- | ------------------ |
23
+ | `/DESIGN.md` | yes | — |
24
+ | `theme_output` path (from front matter) | no | `/mockups/.theme/` |
25
+
26
+ ## Contract Check (Must Run First)
27
+
28
+ Before generating any artifact:
29
+
30
+ 1. Read `/DESIGN.md` front matter.
31
+ 2. If `status: placeholder` → **refuse** with: "DESIGN.md is an unfilled placeholder. Run ux-engineer to fill it first."
32
+ 3. If any `"<unfilled>"` sentinel remains in the token groups (`colors`, `typography`, `rounded`, `spacing`) → **refuse** and list the unfilled fields.
33
+ 4. Resolve `{colors.x}` / `{typography.y}` style references. If a reference points to an unfilled or missing key → **refuse** and report the broken reference.
34
+ 5. Only proceed to generation if all checks pass.
35
+
36
+ ## Outputs
37
+
38
+ Generated into `{theme_output}` (default `/mockups/.theme/`):
39
+
40
+ | File | Content | When |
41
+ | ------------- | ------------------------------------------------------------------ | ------------------------------------------------ |
42
+ | `theme.css` | `:root` token declarations + `@theme inline` block for Tailwind v4 | always |
43
+ | `tokens.json` | Raw JSON: all token groups as a flat or nested object | always |
44
+ | `rn-theme.ts` | TypeScript theme object for React Native | only when `platform` includes `mobile` or `both` |
45
+
46
+ ### `theme.css` structure
47
+
48
+ ```css
49
+ /* DO NOT EDIT — generated from /DESIGN.md by ux-theme-gen */
50
+
51
+ @theme inline {
52
+ --font-sans: "<fontFamily from typography.body-md>";
53
+ --color-background: var(--background);
54
+ --color-foreground: var(--foreground);
55
+ --color-primary: var(--primary);
56
+ --color-primary-foreground: var(--primary-foreground);
57
+ /* ... one --color-* per semantic slot ... */
58
+ --radius-sm: <rounded.sm>;
59
+ --radius-md: <rounded.md>;
60
+ --radius-lg: <rounded.lg>;
61
+ }
62
+
63
+ :root {
64
+ --background: <colors.background>;
65
+ --foreground: <colors.foreground>;
66
+ --primary: <colors.primary>;
67
+ --primary-foreground: <colors.primary-foreground>;
68
+ /* ... all semantic slots ... */
69
+ --radius: <rounded.md>;
70
+ }
71
+
72
+ .dark {
73
+ /* dark-mode overrides if declared in DESIGN.md */
74
+ }
75
+ ```
76
+
77
+ ### Colour handling
78
+
79
+ - Emit colour values **exactly as declared** in DESIGN.md (hex, rgb, hsl, oklch — whatever the consumer wrote).
80
+ - Do **not** convert between colour spaces. `@theme` accepts any valid CSS colour.
81
+ - If DESIGN.md uses hex and the consumer later wants OKLCH, that is a DESIGN.md authoring decision, not a generator decision.
82
+
83
+ ### Slot mapping
84
+
85
+ The semantic slots below are the ones Tailwind v4 + shadcn components consume via `@theme inline`. `ux-theme-gen` maps from DESIGN.md token names to these slots:
86
+
87
+ | DESIGN.md token | CSS variable | @theme inline mapping |
88
+ | ------------------------------- | -------------------------- | --------------------------------------------------------------- |
89
+ | `colors.background` | `--background` | `--color-background: var(--background)` |
90
+ | `colors.foreground` | `--foreground` | `--color-foreground: var(--foreground)` |
91
+ | `colors.primary` | `--primary` | `--color-primary: var(--primary)` |
92
+ | `colors.primary-foreground` | `--primary-foreground` | `--color-primary-foreground: var(--primary-foreground)` |
93
+ | `colors.secondary` | `--secondary` | `--color-secondary: var(--secondary)` |
94
+ | `colors.secondary-foreground` | `--secondary-foreground` | `--color-secondary-foreground: var(--secondary-foreground)` |
95
+ | `colors.muted` | `--muted` | `--color-muted: var(--muted)` |
96
+ | `colors.muted-foreground` | `--muted-foreground` | `--color-muted-foreground: var(--muted-foreground)` |
97
+ | `colors.accent` | `--accent` | `--color-accent: var(--accent)` |
98
+ | `colors.accent-foreground` | `--accent-foreground` | `--color-accent-foreground: var(--accent-foreground)` |
99
+ | `colors.destructive` | `--destructive` | `--color-destructive: var(--destructive)` |
100
+ | `colors.destructive-foreground` | `--destructive-foreground` | `--color-destructive-foreground: var(--destructive-foreground)` |
101
+ | `colors.border` | `--border` | `--color-border: var(--border)` |
102
+ | `colors.input` | `--input` | `--color-input: var(--input)` |
103
+ | `colors.ring` | `--ring` | `--color-ring: var(--ring)` |
104
+ | `colors.card` | `--card` | `--color-card: var(--card)` |
105
+ | `colors.card-foreground` | `--card-foreground` | `--color-card-foreground: var(--card-foreground)` |
106
+
107
+ Tokens in `colors-extended` get their own `--<name>` variable in `:root` and a `--color-<name>` in `@theme inline`.
108
+
109
+ ### `tokens.json` structure
110
+
111
+ ```json
112
+ {
113
+ "colors": { "background": "#...", "foreground": "#...", ... },
114
+ "colors-extended": { ... },
115
+ "typography": { ... },
116
+ "rounded": { "sm": "6px", "md": "8px", "lg": "12px" },
117
+ "spacing": { "xs": "4px", ... }
118
+ }
119
+ ```
120
+
121
+ ### Generated file header
122
+
123
+ Every generated file **MUST** start with:
124
+
125
+ ```
126
+ /* DO NOT EDIT — generated from /DESIGN.md by ux-theme-gen */
127
+ ```
128
+
129
+ (or the equivalent comment syntax for `.ts` / `.json`).
130
+
131
+ ## Rules
132
+
133
+ 1. **Read-only on DESIGN.md** — never modify the contract.
134
+ 2. **Refuse on placeholder** — never generate from unfilled tokens.
135
+ 3. **No colour-space conversion** — emit values as declared.
136
+ 4. **Idempotent** — running twice with the same DESIGN.md produces byte-identical output.
137
+ 5. **Regenerable** — hand-edits to generated files are findings; the correct fix is to update DESIGN.md and regenerate.
138
+ 6. **Independent of mockup workflow** — `developer` can invoke this skill directly for production theming.
139
+
140
+ ## Acceptance Checklist
141
+
142
+ - Contract check runs before any file is written
143
+ - Refuses against a placeholder or partially-unfilled DESIGN.md
144
+ - Generated `theme.css` uses `@theme inline` (Tailwind v4 pattern)
145
+ - Generated `tokens.json` is valid JSON with all token groups
146
+ - `rn-theme.ts` is only produced when `platform` includes `mobile` or `both`
147
+ - No hardcoded palette values exist in output (all derived from DESIGN.md)
148
+ - Every generated file carries the DO-NOT-EDIT header
149
+ - Output directory matches `theme_output` from front matter or defaults to `/mockups/.theme/`
package/AGENTS.md CHANGED
@@ -18,7 +18,7 @@ This system brings structure and clarity to AI-assisted development by:
18
18
 
19
19
  `/DESIGN.md` is the canonical design-system artifact for this repository.
20
20
 
21
- - `ux-engineer` **MUST** use `/DESIGN.md` as the primary style source for mockups.
21
+ - `ux-engineer` **OWNS** `/DESIGN.md` and fills it per project via the interview-driven filling procedure. It **MUST** use `/DESIGN.md` as the primary style source for mockups.
22
22
  - `product-engineer` **MUST** reference `/DESIGN.md` for UI-impacting specs and stories.
23
23
  - `developer` **MUST** validate UI changes against `/DESIGN.md` and update it when the visual contract changes.
24
24
  - `planner` **MUST** require DESIGN.md compliance in UI-impacting delegated runs.
@@ -60,7 +60,7 @@ It ships with dev-tasks as a placeholder and is listed in `consumer_owned_paths`
60
60
  | **technical-writer** | `technical-writer.agent.md` | Autonomous documentation maintenance |
61
61
  | **housekeeping** | `housekeeping.agent.md` | Lint, type, and test-wiring fixes |
62
62
  | **github-ops** | `github-ops.agent.md` | GitHub consistency — standardizes issues, PRs, branches, labels, milestones, comments, and enforces merge authority policy |
63
- | **ux-engineer** | `ux-engineer.agent.md` | UX prototyping and gap analysis — turns PRD/SPEC into testable mockups and feeds refinements back to `product-engineer` |
63
+ | **ux-engineer** | `ux-engineer.agent.md` | UX prototyping, DESIGN.md ownership, and gap analysis — owns `/DESIGN.md`, generates navigable screen sets at two fidelity levels (html-lite, react-full), and feeds refinements back to `product-engineer` |
64
64
  | **qa-engineer** | `qa-engineer.agent.md` | Quality agent — establishes the `/TESTING.md` standard, authors tests for layers the project lacks, and reports coverage and structural gaps. Invoked by `developer` at the completion gate, before the `verifier` audit |
65
65
  | **verifier** | `verifier.agent.md` | Verification agent — owns compliance test-plan design (`design` mode) and post-implementation grey-box fidelity auditing (`audit` mode) against codebase, `/workstream`, tests, and PRD/spec intent |
66
66
 
@@ -90,11 +90,12 @@ Skills are on-demand capabilities invoked by agents — **not** loaded unless ex
90
90
 
91
91
  ### Operational Skills
92
92
 
93
- | Skill | Directory | Purpose | Primary Consumer |
94
- | ------------------ | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
95
- | **git-ops** | `skills/git-ops/` | Branch management, rebase, merge, conflict resolution, recovery | `developer`, `planner` |
96
- | **webapp-mockup** | `skills/webapp-mockup/` | Scaffold and generate React mockup apps for UX testing | `ux-engineer` |
97
- | **memo-cli-usage** | `skills/memo-cli-usage/` | Read and write architectural decisions to a shared Qdrant knowledge base for multi-session, multi-agent, and team-wide context continuity | `technical-writer`, `developer` |
93
+ | Skill | Directory | Purpose | Primary Consumer |
94
+ | ------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
95
+ | **git-ops** | `skills/git-ops/` | Branch management, rebase, merge, conflict resolution, recovery | `developer`, `planner` |
96
+ | **ux-scaffold** | `skills/ux-scaffold/` | Template-aware mockup project creation with DESIGN.md-derived tokens. Supports html-lite (zero-install, navigable) and react-full (shadcn + Vite + Radix) | `ux-engineer` |
97
+ | **ux-theme-gen** | `skills/ux-theme-gen/` | Generate platform-specific theme artifacts from DESIGN.md. Use when mockups or production code need consumable tokens derived from the canonical design contract | `ux-engineer`, `developer` |
98
+ | **memo-cli-usage** | `skills/memo-cli-usage/` | Read and write architectural decisions to a shared Qdrant knowledge base for multi-session, multi-agent, and team-wide context continuity | `technical-writer`, `developer` |
98
99
 
99
100
  ### Third-Party Skills
100
101
 
package/CHANGELOG.md CHANGED
@@ -5,6 +5,37 @@ 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.10.0] - 2026-08-19
9
+
10
+ ### Added
11
+
12
+ - feat(ux): add ux-scaffold, ux-theme-gen skills; rewrite ux-engineer agent
13
+
14
+ ### Fixed
15
+
16
+ - fix(design): distribute DESIGN.md and convert it to a placeholder contract
17
+
18
+ ### Changed
19
+
20
+ - chore: format update
21
+ - Merge pull request #137 from llipe/issue/136-ux-engineer-overhaul
22
+ - chore: remove webapp-mockup skill entirely
23
+ - docs: add DESIGN.md to system-overview and update workflow-chains with lite mode
24
+ - chore!: raise minimum Node.js to >= 24
25
+
26
+ ## [Unreleased]
27
+
28
+ ### Changed
29
+
30
+ - **BREAKING:** raise the minimum supported Node.js version to `>= 24` (was `>= 20`).
31
+ Node 24 is an LTS line supported through April 2028; Node 20 is past end-of-life,
32
+ so the previous floor claimed support for an unsupported runtime. Consumers on
33
+ Node 20 or 22 must upgrade. Affects `engines.node`, the `dev-tasks doctor` check
34
+ (`MIN_NODE_MAJOR`), the shipped CI templates (`templates/meta-repo/catalog-rebuild.yml`,
35
+ `templates/bitbucket-pipelines.yml`), and the documented prerequisites.
36
+ - Pin `@types/node` to `24.13.3`, matching the minimum supported runtime rather than
37
+ the latest release, so Node 26-only APIs cannot be referenced against a Node 24 floor.
38
+
8
39
  ## [0.9.2] - 2026-08-18
9
40
 
10
41
  ### Fixed