devlyn-cli 0.6.0 → 0.7.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.md +18 -18
- package/README.md +32 -32
- package/config/skills/code-health-standards/SKILL.md +3 -3
- package/config/skills/code-review-standards/SKILL.md +3 -3
- package/config/skills/devlyn-clean/SKILL.md +5 -5
- package/config/skills/devlyn-design-ui/SKILL.md +2 -2
- package/config/skills/devlyn-evaluate/SKILL.md +1 -1
- package/config/skills/devlyn-implement-ui/SKILL.md +5 -5
- package/config/skills/devlyn-resolve/SKILL.md +3 -3
- package/config/skills/devlyn-review/SKILL.md +2 -2
- package/config/skills/devlyn-team-design-ui/SKILL.md +5 -5
- package/config/skills/devlyn-team-resolve/SKILL.md +1 -1
- package/config/skills/devlyn-team-review/SKILL.md +2 -2
- package/config/skills/devlyn-update-docs/SKILL.md +10 -10
- package/config/skills/root-cause-analysis/SKILL.md +3 -3
- package/config/skills/ui-implementation-standards/SKILL.md +4 -4
- package/config/skills/workflow-routing/SKILL.md +20 -20
- package/config/templates/prompt-templates.md +2 -2
- package/optional-skills/generate-skill/SKILL.md +1 -1
- package/package.json +1 -1
package/CLAUDE.md
CHANGED
|
@@ -28,16 +28,16 @@ When investigating bugs, analyzing features, or exploring code:
|
|
|
28
28
|
- Remaining unknowns
|
|
29
29
|
- Recommended next steps
|
|
30
30
|
|
|
31
|
-
For complex investigations, use `/devlyn
|
|
31
|
+
For complex investigations, use `/devlyn:team-resolve` to assemble a multi-perspective investigation team, or spawn parallel Task agents to explore different areas simultaneously.
|
|
32
32
|
|
|
33
33
|
## UI/UX Workflow
|
|
34
34
|
|
|
35
35
|
The full design-to-implementation pipeline:
|
|
36
36
|
|
|
37
|
-
1. `/devlyn
|
|
38
|
-
2. `/devlyn
|
|
39
|
-
3. `/devlyn
|
|
40
|
-
4. `/devlyn
|
|
37
|
+
1. `/devlyn:design-ui` → Generate 5 style explorations
|
|
38
|
+
2. `/devlyn:design-system [N]` → Extract tokens from chosen style
|
|
39
|
+
3. `/devlyn:implement-ui` → Team implements or improves UI from design system
|
|
40
|
+
4. `/devlyn:team-resolve [feature]` → Add features on top
|
|
41
41
|
|
|
42
42
|
## Feature Development
|
|
43
43
|
|
|
@@ -54,31 +54,31 @@ The recommended sequence after writing code:
|
|
|
54
54
|
|
|
55
55
|
1. **Write code** (vibe coding)
|
|
56
56
|
2. `/simplify` → Quick cleanup pass (reuse, quality, efficiency)
|
|
57
|
-
3. `/devlyn
|
|
58
|
-
4. `/devlyn
|
|
59
|
-
5. `/devlyn
|
|
60
|
-
6. `/devlyn
|
|
57
|
+
3. `/devlyn:review` → Thorough solo review with security-first checklist
|
|
58
|
+
4. `/devlyn:team-review` → Multi-perspective team review (for important PRs)
|
|
59
|
+
5. `/devlyn:clean` → Periodic codebase-wide hygiene
|
|
60
|
+
6. `/devlyn:update-docs` → Keep docs in sync
|
|
61
61
|
|
|
62
|
-
Steps 4-6 are optional depending on the scope of changes. `/simplify` should always run before `/devlyn
|
|
62
|
+
Steps 4-6 are optional depending on the scope of changes. `/simplify` should always run before `/devlyn:review` to catch low-hanging fruit cheaply.
|
|
63
63
|
|
|
64
64
|
## Documentation Workflow
|
|
65
65
|
|
|
66
|
-
- **Sync docs with codebase**: Use `/devlyn
|
|
67
|
-
- **Focused doc update**: Use `/devlyn
|
|
66
|
+
- **Sync docs with codebase**: Use `/devlyn:update-docs` to clean up stale content, update outdated info, and generate missing docs
|
|
67
|
+
- **Focused doc update**: Use `/devlyn:update-docs [area]` for targeted updates (e.g., "API reference", "getting-started")
|
|
68
68
|
- Preserves all forward-looking content: roadmaps, future plans, visions, open questions
|
|
69
69
|
- If no docs exist, proposes a tailored docs structure and generates initial content
|
|
70
70
|
|
|
71
71
|
## Debugging Workflow
|
|
72
72
|
|
|
73
|
-
- **Simple bugs**: Use `/devlyn
|
|
74
|
-
- **Complex bugs**: Use `/devlyn
|
|
75
|
-
- **Post-fix review**: Use `/devlyn
|
|
73
|
+
- **Simple bugs**: Use `/devlyn:resolve` for systematic bug fixing with test-driven validation
|
|
74
|
+
- **Complex bugs**: Use `/devlyn:team-resolve` for multi-perspective investigation with a full agent team
|
|
75
|
+
- **Post-fix review**: Use `/devlyn:team-review` for thorough multi-reviewer validation
|
|
76
76
|
|
|
77
77
|
## Maintenance Workflow
|
|
78
78
|
|
|
79
|
-
- **Codebase cleanup**: Use `/devlyn
|
|
80
|
-
- **Focused cleanup**: Use `/devlyn
|
|
81
|
-
- **Periodic maintenance sequence**: `/devlyn
|
|
79
|
+
- **Codebase cleanup**: Use `/devlyn:clean` to detect and remove dead code, unused dependencies, complexity hotspots, and tech debt
|
|
80
|
+
- **Focused cleanup**: Use `/devlyn:clean [category]` for targeted sweeps (dead code, deps, tests, complexity, hygiene)
|
|
81
|
+
- **Periodic maintenance sequence**: `/devlyn:clean` → `/simplify` → `/devlyn:update-docs` → `/devlyn:review`
|
|
82
82
|
|
|
83
83
|
## Context Window Management
|
|
84
84
|
|
package/README.md
CHANGED
|
@@ -68,46 +68,46 @@ your-project/
|
|
|
68
68
|
|
|
69
69
|
## Commands
|
|
70
70
|
|
|
71
|
-
Slash commands are invoked directly in Claude Code conversations (e.g., type `/devlyn
|
|
71
|
+
Slash commands are invoked directly in Claude Code conversations (e.g., type `/devlyn:resolve`).
|
|
72
72
|
|
|
73
73
|
### Debugging & Resolution
|
|
74
74
|
|
|
75
75
|
| Command | Description |
|
|
76
76
|
|---|---|
|
|
77
|
-
| `/devlyn
|
|
78
|
-
| `/devlyn
|
|
77
|
+
| `/devlyn:resolve` | Systematic bug fixing with root-cause analysis and test-driven validation |
|
|
78
|
+
| `/devlyn:team-resolve` | Spawns a full agent team — root cause analyst, test engineer, security auditor — to investigate complex issues |
|
|
79
79
|
|
|
80
80
|
### Code Review & Quality
|
|
81
81
|
|
|
82
82
|
| Command | Description |
|
|
83
83
|
|---|---|
|
|
84
|
-
| `/devlyn
|
|
85
|
-
| `/devlyn
|
|
86
|
-
| `/devlyn
|
|
84
|
+
| `/devlyn:review` | Post-implementation review — security, quality, best practices checklist |
|
|
85
|
+
| `/devlyn:team-review` | Multi-perspective team review with specialized reviewers (security, quality, testing, performance, product) |
|
|
86
|
+
| `/devlyn:clean` | Detect and remove dead code, unused dependencies, complexity hotspots, and tech debt |
|
|
87
87
|
|
|
88
88
|
### UI Design & Implementation
|
|
89
89
|
|
|
90
90
|
| Command | Description |
|
|
91
91
|
|---|---|
|
|
92
|
-
| `/devlyn
|
|
93
|
-
| `/devlyn
|
|
94
|
-
| `/devlyn
|
|
95
|
-
| `/devlyn
|
|
92
|
+
| `/devlyn:design-ui` | Generate 5 radically distinct UI style explorations from a spec or reference image |
|
|
93
|
+
| `/devlyn:team-design-ui` | Spawns a design team — creative director, product designer, visual designer, interaction designer, accessibility designer |
|
|
94
|
+
| `/devlyn:design-system` | Extract design system tokens from a chosen style for exact reproduction |
|
|
95
|
+
| `/devlyn:implement-ui` | Team-based UI build — component architect, UX engineer, accessibility engineer, responsive engineer, visual QA |
|
|
96
96
|
|
|
97
97
|
### Product & Planning
|
|
98
98
|
|
|
99
99
|
| Command | Description |
|
|
100
100
|
|---|---|
|
|
101
|
-
| `/devlyn
|
|
102
|
-
| `/devlyn
|
|
103
|
-
| `/devlyn
|
|
104
|
-
| `/devlyn
|
|
101
|
+
| `/devlyn:product-spec` | Generate or incrementally update product spec documents |
|
|
102
|
+
| `/devlyn:feature-spec` | Transform product specs into implementable feature specifications |
|
|
103
|
+
| `/devlyn:discover-product` | Scan codebase to generate feature-oriented product documentation |
|
|
104
|
+
| `/devlyn:recommend-features` | Prioritize top 5 features to build next based on value and readiness |
|
|
105
105
|
|
|
106
106
|
### Documentation
|
|
107
107
|
|
|
108
108
|
| Command | Description |
|
|
109
109
|
|---|---|
|
|
110
|
-
| `/devlyn
|
|
110
|
+
| `/devlyn:update-docs` | Sync all project docs with current codebase — cleans stale content, preserves roadmaps, generates missing docs |
|
|
111
111
|
|
|
112
112
|
## Skills
|
|
113
113
|
|
|
@@ -131,18 +131,18 @@ The full fix → polish → review → maintain cycle:
|
|
|
131
131
|
|
|
132
132
|
| Step | Command | What It Does |
|
|
133
133
|
|---|---|---|
|
|
134
|
-
| 1. **Resolve** | `/devlyn
|
|
134
|
+
| 1. **Resolve** | `/devlyn:resolve` or `/devlyn:team-resolve` | Fix the issue — solo for focused bugs (1-2 modules), team for complex issues (3+ modules) |
|
|
135
135
|
| 2. **Simplify** | `/simplify` | Quick cleanup pass for reuse, quality, and efficiency *(built-in Claude Code command)* |
|
|
136
|
-
| 3. **Review** | `/devlyn
|
|
136
|
+
| 3. **Review** | `/devlyn:review` or `/devlyn:team-review` | Audit the changes — solo for small PRs (< 10 files), team for large PRs (10+ files) |
|
|
137
137
|
| | | *If the review finds issues, loop back to step 1* |
|
|
138
|
-
| 4. **Clean** | `/devlyn
|
|
139
|
-
| 5. **Document** | `/devlyn
|
|
138
|
+
| 4. **Clean** | `/devlyn:clean` | Remove dead code, unused dependencies, and complexity hotspots |
|
|
139
|
+
| 5. **Document** | `/devlyn:update-docs` | Sync project documentation with the current codebase |
|
|
140
140
|
|
|
141
141
|
Steps 4-5 are optional — run them periodically rather than on every PR. Steps 1-3 are the core loop.
|
|
142
142
|
|
|
143
|
-
> **Tip:** Consider running `/devlyn
|
|
143
|
+
> **Tip:** Consider running `/devlyn:review` once more after steps 4-5. `/devlyn:clean` removes code and `/devlyn:update-docs` changes docs — a final review pass catches accidental regressions from cleanup.
|
|
144
144
|
|
|
145
|
-
> **Scope matching matters.** For a simple one-file bug, `/devlyn
|
|
145
|
+
> **Scope matching matters.** For a simple one-file bug, `/devlyn:resolve` + `/devlyn:review` (solo) is fast. For a multi-module feature, `/devlyn:team-resolve` + `/devlyn:team-review` (team) gives you parallel specialist perspectives. Don't over-tool simple changes.
|
|
146
146
|
|
|
147
147
|
### UI Design Pipeline
|
|
148
148
|
|
|
@@ -150,11 +150,11 @@ A full explore → extract → build pipeline:
|
|
|
150
150
|
|
|
151
151
|
| Step | Command | What It Does |
|
|
152
152
|
|---|---|---|
|
|
153
|
-
| 1. **Explore** | `/devlyn
|
|
154
|
-
| 2. **Extract** | `/devlyn
|
|
155
|
-
| 3. **Build** | `/devlyn
|
|
153
|
+
| 1. **Explore** | `/devlyn:design-ui` | Generates 5 radically distinct style options from a spec or reference image |
|
|
154
|
+
| 2. **Extract** | `/devlyn:design-system` | Pulls exact design tokens (colors, spacing, typography) from your chosen style |
|
|
155
|
+
| 3. **Build** | `/devlyn:implement-ui` | Spawns a build team (component architect, UX engineer, accessibility engineer, responsive engineer, visual QA) |
|
|
156
156
|
|
|
157
|
-
> For design exploration with a full creative team, use `/devlyn
|
|
157
|
+
> For design exploration with a full creative team, use `/devlyn:team-design-ui` instead of step 1.
|
|
158
158
|
|
|
159
159
|
After building, follow the [recommended workflow](#recommended-workflow) starting from step 2 (simplify) to review and polish the implementation.
|
|
160
160
|
|
|
@@ -164,12 +164,12 @@ These commands work independently, outside of the main workflow:
|
|
|
164
164
|
|
|
165
165
|
| Command | What It Does |
|
|
166
166
|
|---|---|
|
|
167
|
-
| `/devlyn
|
|
168
|
-
| `/devlyn
|
|
169
|
-
| `/devlyn
|
|
170
|
-
| `/devlyn
|
|
171
|
-
| `/devlyn
|
|
172
|
-
| `/devlyn
|
|
167
|
+
| `/devlyn:clean [focus]` | Focused cleanup — e.g., `/devlyn:clean dependencies` or `/devlyn:clean dead-code` |
|
|
168
|
+
| `/devlyn:update-docs [area]` | Focused doc sync — e.g., `/devlyn:update-docs API reference` |
|
|
169
|
+
| `/devlyn:product-spec` | Generate or update a product specification |
|
|
170
|
+
| `/devlyn:feature-spec` | Transform a product spec into an implementable feature spec |
|
|
171
|
+
| `/devlyn:discover-product` | Scan codebase to auto-generate product documentation |
|
|
172
|
+
| `/devlyn:recommend-features` | Prioritize top 5 features to build next |
|
|
173
173
|
|
|
174
174
|
## Optional Skills & Packs
|
|
175
175
|
|
|
@@ -205,7 +205,7 @@ Installed via the [skills CLI](https://github.com/anthropics/skills) (`npx skill
|
|
|
205
205
|
1. **Run `npx devlyn-cli`** in your project root
|
|
206
206
|
2. The CLI copies config files into `.claude/` and `CLAUDE.md` to the project root
|
|
207
207
|
3. Claude Code automatically reads `.claude/commands/` and `.claude/skills/` on startup
|
|
208
|
-
4. Invoke commands like `/devlyn
|
|
208
|
+
4. Invoke commands like `/devlyn:resolve` in your Claude Code session — skills activate on their own
|
|
209
209
|
|
|
210
210
|
The installation is **idempotent** — run it again anytime to update to the latest config.
|
|
211
211
|
|
|
@@ -8,7 +8,7 @@ Standards for keeping codebases lean and maintainable. Apply these thresholds du
|
|
|
8
8
|
- Adding dependencies
|
|
9
9
|
- Creating new files or modules
|
|
10
10
|
- Refactoring or restructuring code
|
|
11
|
-
- Any use of `/devlyn
|
|
11
|
+
- Any use of `/devlyn:clean`, `/devlyn:resolve`, or `/devlyn:review`
|
|
12
12
|
|
|
13
13
|
## Dead Code Prevention
|
|
14
14
|
|
|
@@ -70,5 +70,5 @@ Code committed to production should not contain:
|
|
|
70
70
|
|
|
71
71
|
## Routing
|
|
72
72
|
|
|
73
|
-
- **Active cleanup**: Use `/devlyn
|
|
74
|
-
- **Focused cleanup**: Use `/devlyn
|
|
73
|
+
- **Active cleanup**: Use `/devlyn:clean` to scan and remove accumulated debt
|
|
74
|
+
- **Focused cleanup**: Use `/devlyn:clean [category]` for targeted sweeps (dead code, deps, tests, complexity, hygiene)
|
|
@@ -7,7 +7,7 @@ Severity framework and quality bar for reviewing code changes. Apply this framew
|
|
|
7
7
|
- Post-implementation review
|
|
8
8
|
- Code review requests
|
|
9
9
|
- PR review or diff analysis
|
|
10
|
-
- Any use of `/devlyn
|
|
10
|
+
- Any use of `/devlyn:review` or `/devlyn:team-review`
|
|
11
11
|
|
|
12
12
|
## Severity Framework
|
|
13
13
|
|
|
@@ -60,5 +60,5 @@ Severity framework and quality bar for reviewing code changes. Apply this framew
|
|
|
60
60
|
|
|
61
61
|
## Routing
|
|
62
62
|
|
|
63
|
-
- **Quick review** (few files, straightforward changes): Use `/devlyn
|
|
64
|
-
- **Thorough review** (many files, security-sensitive, user-facing): Use `/devlyn
|
|
63
|
+
- **Quick review** (few files, straightforward changes): Use `/devlyn:review`
|
|
64
|
+
- **Thorough review** (many files, security-sensitive, user-facing): Use `/devlyn:team-review` for multi-perspective coverage
|
|
@@ -15,7 +15,7 @@ $ARGUMENTS
|
|
|
15
15
|
</user_input>
|
|
16
16
|
|
|
17
17
|
<escalation>
|
|
18
|
-
If the cleanup reveals deeply intertwined architectural debt — circular dependencies, god objects woven into multiple systems, or patterns that can't be safely removed without redesigning interfaces — escalate to `/devlyn
|
|
18
|
+
If the cleanup reveals deeply intertwined architectural debt — circular dependencies, god objects woven into multiple systems, or patterns that can't be safely removed without redesigning interfaces — escalate to `/devlyn:team-resolve` with your findings so a multi-perspective team can plan the refactor.
|
|
19
19
|
</escalation>
|
|
20
20
|
|
|
21
21
|
<process>
|
|
@@ -221,7 +221,7 @@ Present the final summary:
|
|
|
221
221
|
|
|
222
222
|
### Recommendations
|
|
223
223
|
- {Any follow-up actions needed}
|
|
224
|
-
- Schedule: run `/devlyn
|
|
224
|
+
- Schedule: run `/devlyn:clean` periodically to prevent debt accumulation
|
|
225
225
|
```
|
|
226
226
|
|
|
227
227
|
</process>
|
|
@@ -230,7 +230,7 @@ Present the final summary:
|
|
|
230
230
|
|
|
231
231
|
## Handling Focus Area Arguments
|
|
232
232
|
|
|
233
|
-
If the user provides a focus area (e.g., `/devlyn
|
|
233
|
+
If the user provides a focus area (e.g., `/devlyn:clean dependencies` or `/devlyn:clean tests`):
|
|
234
234
|
|
|
235
235
|
1. Still run Phase 1 (codebase understanding) at reduced depth
|
|
236
236
|
2. In Phase 2, only run the relevant analysis category:
|
|
@@ -266,7 +266,7 @@ When in doubt, classify as P3 (flagged) rather than P0 (auto-remove).
|
|
|
266
266
|
|
|
267
267
|
### Example 1: Small project cleanup
|
|
268
268
|
|
|
269
|
-
Input: `/devlyn
|
|
269
|
+
Input: `/devlyn:clean`
|
|
270
270
|
|
|
271
271
|
Finds: 2 orphan files, 3 unused deps, 8 console.logs, 1 stale test.
|
|
272
272
|
|
|
@@ -278,7 +278,7 @@ Tests pass. 340 lines removed.
|
|
|
278
278
|
|
|
279
279
|
### Example 2: Focused dependency cleanup
|
|
280
280
|
|
|
281
|
-
Input: `/devlyn
|
|
281
|
+
Input: `/devlyn:clean deps`
|
|
282
282
|
|
|
283
283
|
Scans only dependency hygiene. Finds `moment` (replaced by `dayjs` already in use), `lodash` (only `_.get` used — replaceable with optional chaining). Presents targeted plan.
|
|
284
284
|
|
|
@@ -7,7 +7,7 @@ source: project
|
|
|
7
7
|
You are the **Lead Designer** with full creative authority. Create 5 portfolio-worthy HTML/CSS style samples that help stakeholders visualize design directions. These aren't mockups—they're design statements.
|
|
8
8
|
|
|
9
9
|
<escalation>
|
|
10
|
-
If the design task requires multi-perspective exploration (brand strategy + interaction design + accessibility + visual craft all mattering equally), consider escalating to `/devlyn
|
|
10
|
+
If the design task requires multi-perspective exploration (brand strategy + interaction design + accessibility + visual craft all mattering equally), consider escalating to `/devlyn:team-design-ui` for a full 5-person design team.
|
|
11
11
|
</escalation>
|
|
12
12
|
|
|
13
13
|
<context>
|
|
@@ -347,5 +347,5 @@ Make bold choices. Each design should be portfolio-worthy—something you'd prou
|
|
|
347
347
|
|
|
348
348
|
<next_step>
|
|
349
349
|
After the user picks a style, suggest:
|
|
350
|
-
→ Run `/devlyn
|
|
350
|
+
→ Run `/devlyn:design-system [style-number]` to extract design tokens from the chosen style into a reusable design system reference.
|
|
351
351
|
</next_step>
|
|
@@ -459,7 +459,7 @@ Present the evaluation in this format:
|
|
|
459
459
|
- [Explicitly call out things done well — balanced feedback prevents over-correction]
|
|
460
460
|
|
|
461
461
|
### Recommendation
|
|
462
|
-
[Next action — e.g., "Fix the 3 CRITICAL issues, then run `/devlyn
|
|
462
|
+
[Next action — e.g., "Fix the 3 CRITICAL issues, then run `/devlyn:team-review` for a full review" or "Ship it"]
|
|
463
463
|
|
|
464
464
|
</evaluation_report>
|
|
465
465
|
</output_format>
|
|
@@ -13,9 +13,9 @@ This command expects a design system at `docs/design-system.md`. If it doesn't e
|
|
|
13
13
|
```
|
|
14
14
|
No design system found at docs/design-system.md
|
|
15
15
|
Run the pipeline first:
|
|
16
|
-
1. /devlyn
|
|
17
|
-
2. /devlyn
|
|
18
|
-
3. /devlyn
|
|
16
|
+
1. /devlyn:design-ui → Generate style explorations
|
|
17
|
+
2. /devlyn:design-system [style-number] → Extract design tokens
|
|
18
|
+
3. /devlyn:implement-ui → Build/improve UI (this command)
|
|
19
19
|
```
|
|
20
20
|
</prerequisites>
|
|
21
21
|
|
|
@@ -459,8 +459,8 @@ Present the result in this format:
|
|
|
459
459
|
- [ ] Semantic HTML throughout
|
|
460
460
|
|
|
461
461
|
### Next Steps
|
|
462
|
-
- Run `/devlyn
|
|
463
|
-
- Run `/devlyn
|
|
462
|
+
- Run `/devlyn:team-review` to validate code quality
|
|
463
|
+
- Run `/devlyn:team-resolve [feature]` to add features on top of this UI
|
|
464
464
|
|
|
465
465
|
</team_build_summary>
|
|
466
466
|
</output_format>
|
|
@@ -20,7 +20,7 @@ When in doubt, enter plan mode.
|
|
|
20
20
|
</default_to_plan_mode>
|
|
21
21
|
|
|
22
22
|
<escalation>
|
|
23
|
-
Escalate to `/devlyn
|
|
23
|
+
Escalate to `/devlyn:team-resolve` if ANY of the following are true:
|
|
24
24
|
- Investigation reveals the issue spans 3+ modules
|
|
25
25
|
- Root cause is unclear after applying 5 Whys to all plausible hypotheses
|
|
26
26
|
- Competing hypotheses can't be ruled out without parallel investigation
|
|
@@ -64,7 +64,7 @@ Choose the right technique based on the issue:
|
|
|
64
64
|
1. **[Hypothesis A]** — Evidence for: [...] Evidence against: [...]
|
|
65
65
|
2. **[Hypothesis B]** — Evidence for: [...] Evidence against: [...]
|
|
66
66
|
- Rule out hypotheses by reading the code — do not guess
|
|
67
|
-
- If hypotheses can't be ruled out solo, escalate to `/devlyn
|
|
67
|
+
- If hypotheses can't be ruled out solo, escalate to `/devlyn:team-resolve`
|
|
68
68
|
</analysis_approach>
|
|
69
69
|
|
|
70
70
|
<test_driven_validation>
|
|
@@ -154,5 +154,5 @@ Analysis:
|
|
|
154
154
|
2. In plan mode, present fix options if multiple valid solutions exist
|
|
155
155
|
3. Write failing test before implementing
|
|
156
156
|
4. Only mark complete after full test suite passes
|
|
157
|
-
5. If stuck after 2 hypothesis attempts → escalate to `/devlyn
|
|
157
|
+
5. If stuck after 2 hypothesis attempts → escalate to `/devlyn:team-resolve`
|
|
158
158
|
</next_steps>
|
|
@@ -5,7 +5,7 @@ You are a Senior Code Reviewer. You review with a security-first mindset, fix is
|
|
|
5
5
|
Perform a comprehensive post-implementation review. After receiving tool results, carefully reflect on their quality and determine optimal next steps before proceeding.
|
|
6
6
|
|
|
7
7
|
<escalation>
|
|
8
|
-
If the changeset is large (10+ files), touches multiple domains (UI + API + auth), or requires multi-perspective judgment, escalate to `/devlyn
|
|
8
|
+
If the changeset is large (10+ files), touches multiple domains (UI + API + auth), or requires multi-perspective judgment, escalate to `/devlyn:team-review` instead of solo review.
|
|
9
9
|
</escalation>
|
|
10
10
|
|
|
11
11
|
<procedure>
|
|
@@ -15,7 +15,7 @@ If the changeset is large (10+ files), touches multiple domains (UI + API + auth
|
|
|
15
15
|
4. Fix issues directly — do not just suggest fixes
|
|
16
16
|
5. Run linter (`npm run lint` or equivalent) and fix all reported lint issues
|
|
17
17
|
6. Run test suite to verify changes don't break existing functionality
|
|
18
|
-
7. If lint or tests fail → use `/devlyn
|
|
18
|
+
7. If lint or tests fail → use `/devlyn:resolve` workflow to fix, then re-run
|
|
19
19
|
8. Generate summary report with file:line references
|
|
20
20
|
9. Block approval if any CRITICAL or HIGH issues remain unfixed OR tests fail
|
|
21
21
|
</procedure>
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
Assemble a world-class design team to generate 5 radically distinct, portfolio-worthy UI style explorations. Like `/devlyn
|
|
1
|
+
Assemble a world-class design team to generate 5 radically distinct, portfolio-worthy UI style explorations. Like `/devlyn:design-ui` but powered by a full team of design specialists — Creative Director, Product Designer, Visual Designer, Interaction Designer, and Accessibility Designer — who collaborate to produce 5 stunning HTML design samples that go far beyond what a single designer could achieve.
|
|
2
2
|
|
|
3
3
|
This is design exploration only. After the user picks a style:
|
|
4
|
-
→ `/devlyn
|
|
5
|
-
→ `/devlyn
|
|
4
|
+
→ `/devlyn:design-system [N]` to extract tokens
|
|
5
|
+
→ `/devlyn:implement-ui` to build it
|
|
6
6
|
|
|
7
7
|
<brief>
|
|
8
8
|
$ARGUMENTS
|
|
@@ -677,6 +677,6 @@ After all 5 HTML files are generated:
|
|
|
677
677
|
|
|
678
678
|
<next_step>
|
|
679
679
|
After the user picks a style, suggest:
|
|
680
|
-
→ Run `/devlyn
|
|
681
|
-
→ Then run `/devlyn
|
|
680
|
+
→ Run `/devlyn:design-system [style-number]` to extract design tokens from the chosen style into a reusable design system reference.
|
|
681
|
+
→ Then run `/devlyn:implement-ui` to build the production UI from that design system.
|
|
682
682
|
</next_step>
|
|
@@ -564,7 +564,7 @@ Present findings in this format:
|
|
|
564
564
|
- [ ] Manual verification (if applicable)
|
|
565
565
|
|
|
566
566
|
### Recommendation
|
|
567
|
-
Run `/devlyn
|
|
567
|
+
Run `/devlyn:team-review` to validate the fix meets all quality standards with a full multi-perspective review.
|
|
568
568
|
|
|
569
569
|
</team_resolution>
|
|
570
570
|
</output_format>
|
|
@@ -418,7 +418,7 @@ After receiving all reviewer findings:
|
|
|
418
418
|
After all fixes are applied:
|
|
419
419
|
|
|
420
420
|
1. Run the full test suite
|
|
421
|
-
2. If tests fail → chain to `/devlyn
|
|
421
|
+
2. If tests fail → chain to `/devlyn:team-resolve` for the failing tests
|
|
422
422
|
3. Re-read fixed files to verify fixes didn't introduce new issues
|
|
423
423
|
4. Generate the final review summary
|
|
424
424
|
|
|
@@ -468,7 +468,7 @@ Present the final review in this format:
|
|
|
468
468
|
- [MEDIUM/severity] description — [concrete reason for deferral]
|
|
469
469
|
|
|
470
470
|
### Recommendation
|
|
471
|
-
If any issues were deferred or if the fix was complex, consider running `/devlyn
|
|
471
|
+
If any issues were deferred or if the fix was complex, consider running `/devlyn:team-resolve` on the specific concern for deeper analysis.
|
|
472
472
|
|
|
473
473
|
</team_review_summary>
|
|
474
474
|
</output_format>
|
|
@@ -220,7 +220,7 @@ Present the summary:
|
|
|
220
220
|
### Recommendations
|
|
221
221
|
- {Any manual follow-up needed}
|
|
222
222
|
- {Docs that would benefit from human review or expansion}
|
|
223
|
-
- Suggestion: run `/devlyn
|
|
223
|
+
- Suggestion: run `/devlyn:update-docs` periodically to keep docs in sync
|
|
224
224
|
```
|
|
225
225
|
|
|
226
226
|
</process>
|
|
@@ -239,7 +239,7 @@ Suggest structure based on project type:
|
|
|
239
239
|
```yaml
|
|
240
240
|
web_app:
|
|
241
241
|
docs/
|
|
242
|
-
- product-spec.md # Product specification (suggest /devlyn
|
|
242
|
+
- product-spec.md # Product specification (suggest /devlyn:product-spec)
|
|
243
243
|
- architecture.md # System architecture and tech decisions
|
|
244
244
|
- getting-started.md # Developer setup guide
|
|
245
245
|
- deployment.md # Deployment instructions
|
|
@@ -282,13 +282,13 @@ docs/
|
|
|
282
282
|
└── {file4}.md — {purpose}
|
|
283
283
|
|
|
284
284
|
### Generation Plan
|
|
285
|
-
- `product-spec.md` → I recommend running `/devlyn
|
|
285
|
+
- `product-spec.md` → I recommend running `/devlyn:product-spec` separately for this
|
|
286
286
|
- `{other docs}` → I'll generate from codebase analysis
|
|
287
287
|
|
|
288
288
|
Create this documentation structure?
|
|
289
289
|
```
|
|
290
290
|
|
|
291
|
-
Wait for user approval, then generate initial content for each approved doc by scanning the codebase. For product specs and feature specs, recommend the dedicated commands (`/devlyn
|
|
291
|
+
Wait for user approval, then generate initial content for each approved doc by scanning the codebase. For product specs and feature specs, recommend the dedicated commands (`/devlyn:product-spec`, `/devlyn:feature-spec`) rather than generating them inline.
|
|
292
292
|
|
|
293
293
|
</no_docs_mode>
|
|
294
294
|
|
|
@@ -400,7 +400,7 @@ Read the team config at ~/.claude/teams/{team-name}/config.json to discover team
|
|
|
400
400
|
|
|
401
401
|
## Handling Focus Area Arguments
|
|
402
402
|
|
|
403
|
-
If the user provides a focus area (e.g., `/devlyn
|
|
403
|
+
If the user provides a focus area (e.g., `/devlyn:update-docs API docs` or `/devlyn:update-docs getting-started`):
|
|
404
404
|
|
|
405
405
|
1. Still run Phase 1 (codebase understanding) but at reduced depth — focus on the relevant area
|
|
406
406
|
2. In Phase 2, only inventory docs related to the focus area
|
|
@@ -415,7 +415,7 @@ This enables quick, targeted doc updates without a full sync.
|
|
|
415
415
|
|
|
416
416
|
### Example 1: Small project with stale docs
|
|
417
417
|
|
|
418
|
-
Input: `/devlyn
|
|
418
|
+
Input: `/devlyn:update-docs`
|
|
419
419
|
|
|
420
420
|
Phase 1-3 discovers:
|
|
421
421
|
- 3 doc files: README.md, docs/api.md, docs/setup.md
|
|
@@ -434,7 +434,7 @@ Updates:
|
|
|
434
434
|
|
|
435
435
|
### Example 2: No docs at all
|
|
436
436
|
|
|
437
|
-
Input: `/devlyn
|
|
437
|
+
Input: `/devlyn:update-docs`
|
|
438
438
|
|
|
439
439
|
No docs/ folder found. Project identified as a Next.js web app.
|
|
440
440
|
|
|
@@ -442,7 +442,7 @@ Plan:
|
|
|
442
442
|
```
|
|
443
443
|
No documentation found. Proposed structure:
|
|
444
444
|
docs/
|
|
445
|
-
├── product-spec.md -> Run /devlyn
|
|
445
|
+
├── product-spec.md -> Run /devlyn:product-spec to generate
|
|
446
446
|
├── architecture.md -> System design overview (will generate)
|
|
447
447
|
├── getting-started.md -> Dev setup guide (will generate)
|
|
448
448
|
└── deployment.md -> Deployment instructions (will generate)
|
|
@@ -450,13 +450,13 @@ docs/
|
|
|
450
450
|
|
|
451
451
|
### Example 3: Focused update
|
|
452
452
|
|
|
453
|
-
Input: `/devlyn
|
|
453
|
+
Input: `/devlyn:update-docs API reference`
|
|
454
454
|
|
|
455
455
|
Only inventories API-related docs. Updates endpoint signatures, request/response schemas, and auth requirements to match current code.
|
|
456
456
|
|
|
457
457
|
### Example 4: Large project triggering team mode
|
|
458
458
|
|
|
459
|
-
Input: `/devlyn
|
|
459
|
+
Input: `/devlyn:update-docs`
|
|
460
460
|
|
|
461
461
|
Phase 4 discovers 14 doc files spanning API docs, user guides, architecture specs, and feature specs. Spawns 3-person team (codebase-analyst, doc-reviewer, content-organizer) for parallel analysis, then synthesizes findings into a comprehensive plan.
|
|
462
462
|
|
|
@@ -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
|
|
11
|
+
- Any use of `/devlyn:resolve` or `/devlyn:team-resolve`
|
|
12
12
|
|
|
13
13
|
## 5 Whys Protocol
|
|
14
14
|
|
|
@@ -58,5 +58,5 @@ If the real fix requires significant refactoring, present the scope to the user
|
|
|
58
58
|
|
|
59
59
|
## Routing
|
|
60
60
|
|
|
61
|
-
- **Simple issue** (single file, obvious cause): Use `/devlyn
|
|
62
|
-
- **Complex issue** (multi-module, unclear cause, security implications): Use `/devlyn
|
|
61
|
+
- **Simple issue** (single file, obvious cause): Use `/devlyn:resolve`
|
|
62
|
+
- **Complex issue** (multi-module, unclear cause, security implications): Use `/devlyn:team-resolve` for multi-perspective investigation
|
|
@@ -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
|
|
10
|
+
- Any use of `/devlyn:implement-ui`, `/devlyn:design-ui`, or `/devlyn:design-system`
|
|
11
11
|
- Frontend development tasks involving visual design
|
|
12
12
|
|
|
13
13
|
## Design System Fidelity
|
|
@@ -69,6 +69,6 @@ Every interactive component or data-dependent view needs all states:
|
|
|
69
69
|
|
|
70
70
|
## Routing
|
|
71
71
|
|
|
72
|
-
- **Build new UI or improve existing**: Use `/devlyn
|
|
73
|
-
- **Add features to existing UI**: Use `/devlyn
|
|
74
|
-
- **Review UI code quality**: Use `/devlyn
|
|
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
|
|
74
|
+
- **Review UI code quality**: Use `/devlyn:team-review` for multi-perspective code review
|
|
@@ -16,47 +16,47 @@ Match the user's current activity to the right command:
|
|
|
16
16
|
### Discovery & Planning
|
|
17
17
|
| Situation | Command | Why |
|
|
18
18
|
|-----------|---------|-----|
|
|
19
|
-
| Need to understand what the project does | `/devlyn
|
|
20
|
-
| Need to define a new product | `/devlyn
|
|
21
|
-
| Need to plan a specific feature | `/devlyn
|
|
22
|
-
| Need to decide what to build next | `/devlyn
|
|
19
|
+
| Need to understand what the project does | `/devlyn:discover-product` | Generates feature-oriented product documentation from code |
|
|
20
|
+
| Need to define a new product | `/devlyn:product-spec` | Creates or updates product spec documents |
|
|
21
|
+
| Need to plan a specific feature | `/devlyn:feature-spec` | Transforms product specs into implementable feature specs |
|
|
22
|
+
| Need to decide what to build next | `/devlyn:recommend-features` | Prioritizes top 5 features by value and readiness |
|
|
23
23
|
|
|
24
24
|
### Design
|
|
25
25
|
| Situation | Command | Why |
|
|
26
26
|
|-----------|---------|-----|
|
|
27
|
-
| Need UI style exploration (solo) | `/devlyn
|
|
28
|
-
| Need team-based design exploration | `/devlyn
|
|
29
|
-
| Need to extract design tokens | `/devlyn
|
|
30
|
-
| Need to build or improve UI | `/devlyn
|
|
27
|
+
| Need UI style exploration (solo) | `/devlyn:design-ui` | Generates 5 distinct style options |
|
|
28
|
+
| Need team-based design exploration | `/devlyn:team-design-ui` | 5-person design team with diverse perspectives |
|
|
29
|
+
| Need to extract design tokens | `/devlyn:design-system` | Converts chosen style into reusable token system |
|
|
30
|
+
| Need to build or improve UI | `/devlyn:implement-ui` | Team-based UI implementation from design system |
|
|
31
31
|
|
|
32
32
|
### Implementation & Debugging
|
|
33
33
|
| Situation | Command | Why |
|
|
34
34
|
|-----------|---------|-----|
|
|
35
|
-
| Simple bug (single module, clear cause) | `/devlyn
|
|
36
|
-
| Complex bug (multi-module, unclear cause) | `/devlyn
|
|
37
|
-
| Feature implementation on existing UI | `/devlyn
|
|
35
|
+
| Simple bug (single module, clear cause) | `/devlyn:resolve` | Solo root cause analysis with 5 Whys |
|
|
36
|
+
| Complex bug (multi-module, unclear cause) | `/devlyn:team-resolve` | Multi-perspective investigation team |
|
|
37
|
+
| Feature implementation on existing UI | `/devlyn:team-resolve [feature]` | Team approach for feature work |
|
|
38
38
|
|
|
39
39
|
### Review & Quality
|
|
40
40
|
| Situation | Command | Why |
|
|
41
41
|
|-----------|---------|-----|
|
|
42
|
-
| Quick review (few files) | `/devlyn
|
|
43
|
-
| Thorough review (many files, security-sensitive) | `/devlyn
|
|
42
|
+
| Quick review (few files) | `/devlyn:review` | Solo review with severity framework |
|
|
43
|
+
| Thorough review (many files, security-sensitive) | `/devlyn:team-review` | Multi-reviewer team coverage |
|
|
44
44
|
|
|
45
45
|
### Maintenance
|
|
46
46
|
| Situation | Command | Why |
|
|
47
47
|
|-----------|---------|-----|
|
|
48
|
-
| Remove dead code and tech debt | `/devlyn
|
|
49
|
-
| Targeted cleanup (deps, tests, etc.) | `/devlyn
|
|
50
|
-
| Sync documentation with codebase | `/devlyn
|
|
51
|
-
| Targeted doc update | `/devlyn
|
|
48
|
+
| Remove dead code and tech debt | `/devlyn:clean` | 5-category codebase health analysis |
|
|
49
|
+
| Targeted cleanup (deps, tests, etc.) | `/devlyn:clean [category]` | Focused sweep on one area |
|
|
50
|
+
| Sync documentation with codebase | `/devlyn:update-docs` | Cleans stale content, preserves roadmaps |
|
|
51
|
+
| Targeted doc update | `/devlyn:update-docs [area]` | Focused update on specific doc area |
|
|
52
52
|
|
|
53
53
|
## Escalation Paths
|
|
54
54
|
|
|
55
55
|
When a solo command isn't enough:
|
|
56
56
|
|
|
57
|
-
- `/devlyn
|
|
58
|
-
- `/devlyn
|
|
59
|
-
- `/devlyn
|
|
57
|
+
- `/devlyn:resolve` → escalate to `/devlyn:team-resolve` if issue spans 3+ modules or root cause is unclear
|
|
58
|
+
- `/devlyn:review` → escalate to `/devlyn:team-review` if changeset is 10+ files or touches multiple domains
|
|
59
|
+
- `/devlyn:design-ui` → escalate to `/devlyn:team-design-ui` if design needs multi-perspective exploration
|
|
60
60
|
|
|
61
61
|
## Common Workflow Sequences
|
|
62
62
|
|
|
@@ -23,7 +23,7 @@ Start with the minimum viable solution, then improve if time allows.
|
|
|
23
23
|
|
|
24
24
|
## Debugging
|
|
25
25
|
|
|
26
|
-
For systematic debugging, use `/devlyn
|
|
26
|
+
For systematic debugging, use `/devlyn:resolve [issue description]` which includes:
|
|
27
27
|
- Code path mapping
|
|
28
28
|
- Hypothesis-driven analysis
|
|
29
29
|
- Test-driven fix validation
|
|
@@ -61,7 +61,7 @@ have working, tested code ready for PR.
|
|
|
61
61
|
For complex bugs that need autonomous resolution:
|
|
62
62
|
|
|
63
63
|
```
|
|
64
|
-
/devlyn
|
|
64
|
+
/devlyn:resolve [bug description]
|
|
65
65
|
|
|
66
66
|
After analysis, implement the fix autonomously:
|
|
67
67
|
- Write failing test first
|
|
@@ -124,7 +124,7 @@ After generating the skill, present:
|
|
|
124
124
|
3. **Test invocation** — Example command to test the skill
|
|
125
125
|
|
|
126
126
|
Offer to:
|
|
127
|
-
- Run `/devlyn
|
|
127
|
+
- Run `/devlyn:review` on the generated skill for quality assurance
|
|
128
128
|
- Run `pyx-scan` if the skill will be published
|
|
129
129
|
|
|
130
130
|
---
|