devlyn-cli 2.3.2 → 2.4.1

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.
@@ -8,7 +8,7 @@ Standard methodology for investigating bugs, issues, and unexpected behavior. Ap
8
8
  - Error logs or stack traces need diagnosis
9
9
  - "Why does X happen?" or "What's causing X?" questions
10
10
  - Debugging sessions
11
- - Any use of `/devlyn:resolve` or `/devlyn:team-resolve`
11
+ - Any use of `/devlyn:resolve`
12
12
 
13
13
  ## 5 Whys Protocol
14
14
 
@@ -62,5 +62,4 @@ If the real fix requires significant refactoring, present the scope to the user
62
62
 
63
63
  ## Routing
64
64
 
65
- - **Simple issue** (single file, obvious cause): Use `/devlyn:resolve`
66
- - **Complex issue** (multi-module, unclear cause, security implications): Use `/devlyn:team-resolve` for multi-perspective investigation
65
+ - Use `/devlyn:resolve` — handles both simple and multi-module investigations; VERIFY pair-judge fires conditionally on high-risk / complex specs.
@@ -7,7 +7,7 @@ Quality framework for building and improving UI from design systems. Apply these
7
7
  - Building UI components or pages
8
8
  - Implementing designs from a design system
9
9
  - Improving or refactoring existing UI
10
- - Any use of `/devlyn:implement-ui`, `/devlyn:design-ui`, or `/devlyn:design-system`
10
+ - Any use of `/devlyn:design-ui`
11
11
  - Frontend development tasks involving visual design
12
12
 
13
13
  ## Design System Fidelity
@@ -70,5 +70,5 @@ Every interactive component or data-dependent view needs all states:
70
70
  ## Routing
71
71
 
72
72
  - **Build new UI or improve existing**: Use `/devlyn:implement-ui` for a full team approach
73
- - **Add features to existing UI**: Use `/devlyn:team-resolve` with the feature description
73
+ - **Add features to existing UI**: Use `/devlyn:resolve` with the feature description
74
74
  - **Review UI code quality**: Use `/devlyn:team-review` for multi-perspective code review
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "devlyn-cli",
3
- "version": "2.3.2",
3
+ "version": "2.4.1",
4
4
  "description": "AI development toolkit for Claude Code — ideate, resolve, and ship with context engineering and agent orchestration",
5
5
  "homepage": "https://github.com/fysoul17/devlyn-cli#readme",
6
6
  "bin": {
@@ -1,503 +0,0 @@
1
- ---
2
- name: devlyn:design-system
3
- description: Extract all design values from selected style for exact reproduction
4
- argument-hint: <style-number> [platform] (e.g., "3", "3 flutter", "style 2 web")
5
- allowed-tools: Bash(ls:*), Bash(cat:*), Bash(grep:*), View, Edit, Write
6
- ---
7
-
8
- Extract design values from a style preview HTML to generate a framework-agnostic design reference.
9
-
10
- <context>
11
- User input: $ARGUMENTS
12
- Available styles: !`ls -1 docs/design/style_*.html 2>/dev/null || echo "No styles found"`
13
- </context>
14
-
15
- <input_parsing>
16
-
17
- Parse two values from input:
18
-
19
- 1. **Style number** (required): "3", "style 3", or "style_3_concept_name" all resolve to style 3
20
-
21
- 2. **Platform** (optional, defaults to "web"):
22
- - `web` — HTML/CSS, React, Vue, Svelte, Next.js
23
- - `flutter` — Dart/Flutter
24
- - `native` — iOS (SwiftUI) / Android (Compose)
25
- - `desktop` — Electron, Tauri, PyQt
26
- - `terminal` — CLI apps with color support
27
-
28
- </input_parsing>
29
-
30
- <goal>
31
-
32
- Create a design reference document that enables any AI agent to:
33
-
34
- 1. Apply correct visual styling (colors, typography, spacing, shadows, motion)
35
- 2. Build components that match the design language (patterns, behaviors, icon approach)
36
-
37
- This document contains **values and patterns**—no framework-specific implementation code. The implementing agent determines the correct syntax based on the actual project setup.
38
-
39
- **Important distinction**:
40
-
41
- - This document defines HOW things should look (reusable across any page structure)
42
- - Feature specs define WHAT to build (page structure, sections, content)
43
- - An agent uses both: feature spec for structure + this document for styling
44
-
45
- </goal>
46
-
47
- <extraction_requirements>
48
-
49
- Extract all concrete values that define the design's appearance and reusable component patterns.
50
-
51
- <colors>
52
- Extract every color used:
53
- - Background, surface, text primary, text secondary
54
- - Accent colors (primary, secondary if present)
55
- - Borders, dividers, hover states
56
- - Any gradients (with exact color stops and direction)
57
-
58
- Format: hex values (e.g., #F4F7FA)
59
- </colors>
60
-
61
- <typography>
62
- Extract the exact font configuration:
63
- - Font family name (exact Google Fonts spelling)
64
- - All font weights used (e.g., 300, 400, 600, 700)
65
-
66
- For each text level (H1, H2, H3, Body, Body Large, Small/Caption, Label):
67
-
68
- - Size in pixels
69
- - Weight
70
- - Letter-spacing (em or px)
71
- - Line-height (unitless ratio)
72
- </typography>
73
-
74
- <spacing>
75
- Extract actual pixel values used, not abstract scales:
76
- - Section/page padding
77
- - Hero section padding (if different)
78
- - Component/card padding (large and small variants)
79
- - Element gap (between buttons, cards)
80
- - Tight gap (icon + text, inline elements)
81
- - Navigation gaps
82
- - Section header margin-bottom
83
- </spacing>
84
-
85
- <shape>
86
- Extract border-radius values:
87
- - Cards and containers
88
- - Feature icons
89
- - Small icons
90
- - Buttons and pills (often "full" or 100px)
91
- - CTA sections (if different)
92
- </shape>
93
-
94
- <shadows>
95
- Extract complete box-shadow CSS values:
96
- - Default/subtle shadow
97
- - Navigation/badge shadow
98
- - Floating card shadow
99
- - Hover state shadow
100
- - Button hover shadow
101
-
102
- Include the full value: offset, blur, spread, color with alpha.
103
- </shadows>
104
-
105
- <motion>
106
- Extract animation timing:
107
- - Easing function (exact cubic-bezier or keyword)
108
- - Base transition duration
109
- - Enter/appear animation duration
110
- - Scroll-triggered transition duration
111
- - Stagger delay between items
112
- - Any cyclic animation durations (float, drift effects)
113
- </motion>
114
-
115
- <effects>
116
- Only if present in the design:
117
- - Background effects (orbs, gradients, patterns)
118
- - Glassmorphism (backdrop-filter blur value, background opacity)
119
- - Gradient text treatment
120
- - Any texture overlays
121
- </effects>
122
-
123
- <components>
124
- Extract reusable component patterns found in the design. For each distinct component type:
125
-
126
- 1. **Navigation** (if present):
127
-
128
- - Layout type (fixed, sticky, static)
129
- - Visual treatment (solid, glassmorphism, transparent)
130
- - Elements included (logo style, link style, CTA style)
131
-
132
- 2. **Cards** (identify all card variants):
133
-
134
- - Name/purpose (feature card, stat card, testimonial card, etc.)
135
- - Icon approach: emoji, SVG, or icon font
136
- - If emoji: note this explicitly
137
- - Icon container style (size, background, radius)
138
- - Content structure (what elements: icon, title, description, stat, etc.)
139
- - Hover behavior (transform, shadow change, with duration)
140
-
141
- 3. **Buttons** (identify all variants):
142
-
143
- - Primary, secondary, ghost styles
144
- - Hover transforms and shadow changes
145
-
146
- 4. **Badges/Labels**:
147
-
148
- - Visual style (pill, tag, etc.)
149
- - Any animated elements (pulse dots, etc.)
150
-
151
- 5. **Section Headers**:
152
-
153
- - Label + title + description pattern
154
- - Alignment (centered, left)
155
-
156
- 6. **Special Elements**:
157
- - Any unique patterns (floating cards, step indicators, etc.)
158
- - Animation behaviors
159
-
160
- For each component, describe it as a reusable pattern that can be applied regardless of how many times it appears or what content it contains.
161
- </components>
162
-
163
- <interactive_states>
164
- Document hover/active/focus states for interactive elements:
165
-
166
- - What property changes (transform, shadow, background, scale, opacity)
167
- - From value → To value
168
- - Duration and easing
169
-
170
- Format as a reference table.
171
- </interactive_states>
172
-
173
- <character>
174
- Summarize the design's personality:
175
- - Theme: Light or Dark
176
- - Shape language: Angular, Curved, or Mixed
177
- - Density: Spacious or Dense
178
- - Energy: Calm, Dynamic, or Playful
179
- </character>
180
-
181
- </extraction_requirements>
182
-
183
- <output_format>
184
-
185
- Generate `docs/design-system.md` with this structure:
186
-
187
- ```markdown
188
- # Design Style: {Concept Name}
189
-
190
- > {One sentence capturing the design's mood and intent}
191
-
192
- **Platform**: {platform}
193
- **Source**: `{source filename}`
194
-
195
- ---
196
-
197
- ## Implementation Note
198
-
199
- This document defines the visual design language—HOW things should look.
200
-
201
- When implementing:
202
-
203
- 1. Use your **feature spec** for page structure (WHAT sections/components to build)
204
- 2. Use **this document** for styling those components (HOW they should look)
205
- 3. Apply values using syntax appropriate for your framework
206
-
207
- ---
208
-
209
- ## Colors
210
-
211
- | Role | Value |
212
- | --------------------- | --------- |
213
- | Background | `#______` |
214
- | Surface | `#______` |
215
- | Text | `#______` |
216
- | Text Muted | `#______` |
217
- | Accent | `#______` |
218
- | {additional roles...} | `#______` |
219
-
220
- **Gradients** (if present):
221
-
222
- - {Name}: `{direction}deg, {color1} {stop1}%, {color2} {stop2}%`
223
-
224
- ## Typography
225
-
226
- **Font Family**: {exact name} (with {fallback} for {language} if applicable)
227
- **Weights**: {comma-separated list}
228
-
229
- | Element | Size | Weight | Letter-spacing | Line-height |
230
- | ------------- | ----- | ------ | -------------- | ----------- |
231
- | H1 | {n}px | {n} | {n}em | {n} |
232
- | H2 | {n}px | {n} | {n}em | {n} |
233
- | H3 | {n}px | {n} | {n}em | {n} |
234
- | Body | {n}px | {n} | — | {n} |
235
- | Body Large | {n}px | {n} | — | {n} |
236
- | Small/Caption | {n}px | {n} | — | {n} |
237
- | Label | {n}px | {n} | — | {n} |
238
-
239
- ## Spacing
240
-
241
- | Context | Value |
242
- | ---------------------------- | -------------------------------- |
243
- | Section padding | {n}px vertical, {n}px horizontal |
244
- | Hero padding | {top}px top, {bottom}px bottom |
245
- | Card padding (large) | {n}px |
246
- | Card padding (small) | {n}px |
247
- | Element gap | {n}px |
248
- | Tight gap | {n}px |
249
- | Section header margin-bottom | {n}px |
250
-
251
- ## Shape
252
-
253
- | Context | Radius |
254
- | ---------------- | ------------ |
255
- | Cards/Containers | {n}px |
256
- | Icons (large) | {n}px |
257
- | Icons (small) | {n}px |
258
- | Buttons/Pills | {n}px (full) |
259
-
260
- ## Shadows
261
-
262
- | Name | Value |
263
- | ------------ | --------------------- |
264
- | Subtle | `{full shadow value}` |
265
- | Card | `{full shadow value}` |
266
- | Card Hover | `{full shadow value}` |
267
- | Float | `{full shadow value}` |
268
- | Button Hover | `{full shadow value}` |
269
-
270
- ## Motion
271
-
272
- | Property | Value |
273
- | ------------------- | ---------------------------------- |
274
- | Easing (soft) | `cubic-bezier({a}, {b}, {c}, {d})` |
275
- | Easing (bounce) | `cubic-bezier({a}, {b}, {c}, {d})` |
276
- | Base duration | {n}s |
277
- | Hover duration | {n}s |
278
- | Enter duration | {n}s |
279
- | Stagger | {n}s |
280
- | {Cyclic animations} | {n}s |
281
-
282
- ## Effects
283
-
284
- {Only include sections that exist in the source design}
285
-
286
- **Background Elements** (if present):
287
-
288
- - {Description with sizes, colors, blur, positions, animations}
289
-
290
- **Glassmorphism** (if present):
291
-
292
- - Background: `rgba({r}, {g}, {b}, {a})`
293
- - Backdrop blur: {n}px
294
-
295
- **Gradient Text** (if present):
296
-
297
- - Applied to: {list elements}
298
- - CSS: background-clip text with transparent fill
299
-
300
- ---
301
-
302
- ## Component Patterns
303
-
304
- Reusable patterns that define how components should look, regardless of page structure.
305
-
306
- ### Icon Approach
307
-
308
- - **Type**: {emoji | SVG | icon font}
309
- - **Container**: {size}px, {background}, {radius}px radius
310
- {If emoji, note: "Use emoji characters directly, not icon libraries"}
311
-
312
- ### Navigation
313
-
314
- - **Position**: {fixed center | sticky top | etc.}
315
- - **Style**: {glassmorphism | solid | transparent}
316
- - **Elements**: Logo ({style}), Links ({style}), CTA button ({style})
317
-
318
- ### Card: Feature
319
-
320
- - **Use for**: Feature highlights, service descriptions
321
- - **Structure**: Icon container → Title → Description
322
- - **Icon**: {size}px container, {background style}
323
- - **Hover**: {transform}, {shadow change}, {duration}
324
-
325
- ### Card: Stat
326
-
327
- - **Use for**: Metrics, numbers, KPIs
328
- - **Structure**: Large value (gradient text) → Label
329
- - **Hover**: {transform}, {duration}
330
-
331
- ### Card: {Other variants found...}
332
-
333
- {Document each distinct card pattern}
334
-
335
- ### Button: Primary
336
-
337
- - **Style**: {gradient/solid} background, {text color}
338
- - **Hover**: {transform}, {shadow}
339
-
340
- ### Button: Secondary
341
-
342
- - **Style**: {background}, {border if any}
343
- - **Hover**: {changes}
344
-
345
- ### Badge/Label
346
-
347
- - **Style**: Pill shape, {background}, {text style}
348
- - **Animation**: {if any, e.g., pulse dot}
349
-
350
- ### Section Header
351
-
352
- - **Pattern**: Label badge (optional) → H2 title → Description (optional)
353
- - **Alignment**: {centered | left}
354
- - **Spacing**: {margin-bottom}px below
355
-
356
- ### {Special Patterns}
357
-
358
- {Document any unique patterns like floating cards, step indicators, etc.}
359
-
360
- ---
361
-
362
- ## Interactive States
363
-
364
- | Component | Trigger | Property | From | To | Duration |
365
- | ------------------------------------------ | ------- | --------- | ------ | ---------------- | -------- |
366
- | Feature Card | hover | transform | none | translateY(-8px) | {n}s |
367
- | Feature Card | hover | shadow | subtle | card-hover | {n}s |
368
- | Button Primary | hover | transform | none | translateY(-3px) | {n}s |
369
- | Button Primary | hover | shadow | none | button-hover | {n}s |
370
- | {continue for all interactive elements...} | | | | | |
371
-
372
- ---
373
-
374
- ## Character
375
-
376
- - **Theme**: {Light | Dark}
377
- - **Shape**: {Angular | Curved | Mixed}
378
- - **Density**: {Spacious | Dense}
379
- - **Energy**: {Calm | Dynamic | Playful}
380
-
381
- ---
382
-
383
- ## Token Reference
384
-
385
- Quick reference for implementation.
386
-
387
- ### Colors
388
- ```
389
-
390
- color-bg: #**\_\_**
391
- color-surface: #**\_\_**
392
- color-text: #**\_\_**
393
- color-text-muted: #**\_\_**
394
- color-accent: #**\_\_**
395
- gradient-primary: {direction}, {stops}
396
-
397
- ```
398
-
399
- ### Typography
400
- ```
401
-
402
- font-family: {name}, {fallback}
403
- font-weight-regular: {n}
404
- font-weight-semibold: {n}
405
- font-weight-bold: {n}
406
-
407
- ```
408
-
409
- ### Spacing
410
- ```
411
-
412
- space-section: {n}px
413
- space-component: {n}px
414
- space-element: {n}px
415
- space-tight: {n}px
416
-
417
- ```
418
-
419
- ### Shape
420
- ```
421
-
422
- radius-card: {n}px
423
- radius-icon: {n}px
424
- radius-button: full
425
-
426
- ```
427
-
428
- ### Motion
429
- ```
430
-
431
- ease-soft: cubic-bezier({values})
432
- ease-bounce: cubic-bezier({values})
433
- duration-base: {n}s
434
- duration-hover: {n}s
435
-
436
- ```
437
-
438
- ---
439
-
440
- _Generated from: `{source filename}`_
441
- ```
442
-
443
- </output_format>
444
-
445
- <platform_adaptations>
446
-
447
- Adjust the Token Reference section based on platform:
448
-
449
- **flutter**: Include Dart-style comments showing Color() and Duration() syntax as reference
450
- **native**: Note that colors should be added to asset catalogs
451
- **terminal**: Include ANSI color code mappings
452
-
453
- Keep these as **reference comments**, not copy-paste code.
454
-
455
- </platform_adaptations>
456
-
457
- <quality_verification>
458
-
459
- Before saving, verify completeness:
460
-
461
- **Values extraction**:
462
-
463
- - [ ] All colors extracted with valid hex values
464
- - [ ] Font name matches exact Google Fonts spelling
465
- - [ ] Typography table complete for all text levels
466
- - [ ] Spacing values are concrete pixels
467
- - [ ] Border radius values for all contexts
468
- - [ ] Shadow values are complete CSS
469
- - [ ] Easing is exact cubic-bezier
470
- - [ ] Animation durations in seconds
471
-
472
- **Component patterns**:
473
-
474
- - [ ] Icon approach clearly stated (emoji vs SVG vs font)
475
- - [ ] All card variants documented with hover behavior
476
- - [ ] Button variants documented
477
- - [ ] Navigation pattern documented
478
- - [ ] Section header pattern documented
479
- - [ ] Special/unique patterns documented
480
-
481
- **Interactive states**:
482
-
483
- - [ ] All hover transforms documented
484
- - [ ] All shadow transitions documented
485
- - [ ] Durations specified for each
486
-
487
- **Reproduction test**: Could another agent read this document and build components that look identical, regardless of what page structure they're implementing?
488
-
489
- </quality_verification>
490
-
491
- <execution>
492
-
493
- 1. Parse style number and platform from $ARGUMENTS
494
- 2. Read the matching `docs/design/style_{n}_*.html` file
495
- 3. Extract all values following the extraction requirements
496
- 4. Extract all component patterns
497
- 5. Document all interactive states
498
- 6. Generate `docs/design-system.md` following the output format
499
- 7. Confirm what was created and note the source file
500
-
501
- If the style file doesn't exist, list the available options.
502
-
503
- </execution>