devtronic 1.2.5 → 1.2.6

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 (51) hide show
  1. package/README.md +2 -2
  2. package/dist/{chunk-V4QEAL7Y.js → chunk-WM7R52TC.js} +30 -27
  3. package/dist/index.js +57 -33
  4. package/dist/{plugin-SGSFVXPA.js → plugin-KQQASBQX.js} +1 -1
  5. package/package.json +1 -1
  6. package/templates/addons/auto-devtronic/agents/afk-task-validator.md +78 -0
  7. package/templates/addons/auto-devtronic/agents/{quality-runner.md → quality-executor.md} +1 -1
  8. package/templates/addons/auto-devtronic/manifest.json +2 -1
  9. package/templates/addons/auto-devtronic/skills/auto-devtronic/SKILL.md +14 -14
  10. package/templates/addons/design-best-practices/manifest.json +2 -2
  11. package/templates/addons/design-best-practices/skills/{design-review → design-critique}/SKILL.md +2 -1
  12. package/templates/addons/design-best-practices/skills/design-harden/SKILL.md +1 -0
  13. package/templates/addons/design-best-practices/skills/design-init/SKILL.md +1 -0
  14. package/templates/addons/design-best-practices/skills/design-refine/SKILL.md +2 -0
  15. package/templates/addons/design-best-practices/skills/{design-system → design-tokens}/SKILL.md +3 -1
  16. package/templates/claude-code/.claude/rules/quality.md +4 -0
  17. package/templates/claude-code/.claude/skills/audit/SKILL.md +1 -1
  18. package/templates/claude-code/.claude/skills/backlog/SKILL.md +1 -1
  19. package/templates/claude-code/.claude/skills/brief/SKILL.md +1 -1
  20. package/templates/claude-code/.claude/skills/briefing/SKILL.md +1 -1
  21. package/templates/claude-code/.claude/skills/checkpoint/SKILL.md +1 -1
  22. package/templates/claude-code/.claude/skills/create-plan/SKILL.md +1 -1
  23. package/templates/claude-code/.claude/skills/create-skill/SKILL.md +1 -1
  24. package/templates/claude-code/.claude/skills/design/SKILL.md +1 -1
  25. package/templates/claude-code/.claude/skills/design-audit/SKILL.md +1 -1
  26. package/templates/claude-code/.claude/skills/design-define/SKILL.md +1 -1
  27. package/templates/claude-code/.claude/skills/design-ia/SKILL.md +1 -1
  28. package/templates/claude-code/.claude/skills/design-research/SKILL.md +1 -1
  29. package/templates/claude-code/.claude/skills/design-review/SKILL.md +1 -1
  30. package/templates/claude-code/.claude/skills/design-spec/SKILL.md +1 -1
  31. package/templates/claude-code/.claude/skills/design-system/SKILL.md +1 -1
  32. package/templates/claude-code/.claude/skills/design-system-audit/SKILL.md +1 -1
  33. package/templates/claude-code/.claude/skills/design-system-define/SKILL.md +1 -1
  34. package/templates/claude-code/.claude/skills/design-system-sync/SKILL.md +1 -1
  35. package/templates/claude-code/.claude/skills/design-wireframe/SKILL.md +1 -1
  36. package/templates/claude-code/.claude/skills/devtronic-help/SKILL.md +338 -0
  37. package/templates/claude-code/.claude/skills/execute-plan/SKILL.md +1 -1
  38. package/templates/claude-code/.claude/skills/generate-tests/SKILL.md +1 -1
  39. package/templates/claude-code/.claude/skills/handoff/SKILL.md +1 -1
  40. package/templates/claude-code/.claude/skills/investigate/SKILL.md +1 -1
  41. package/templates/claude-code/.claude/skills/learn/SKILL.md +1 -1
  42. package/templates/claude-code/.claude/skills/opensrc/SKILL.md +1 -1
  43. package/templates/claude-code/.claude/skills/post-review/SKILL.md +2 -2
  44. package/templates/claude-code/.claude/skills/quick/SKILL.md +1 -1
  45. package/templates/claude-code/.claude/skills/recap/SKILL.md +1 -1
  46. package/templates/claude-code/.claude/skills/research/SKILL.md +1 -1
  47. package/templates/claude-code/.claude/skills/scaffold/SKILL.md +1 -1
  48. package/templates/claude-code/.claude/skills/setup/SKILL.md +1 -1
  49. package/templates/claude-code/.claude/skills/spec/SKILL.md +1 -1
  50. package/templates/claude-code/.claude/skills/summary/SKILL.md +1 -1
  51. package/templates/claude-code/.claude/skills/worktree/SKILL.md +1 -1
@@ -2,6 +2,7 @@
2
2
  name: design-init
3
3
  description: One-time project design context setup — gathers visual direction, constraints, and writes Design Context to CLAUDE.md
4
4
  user-invokable: true
5
+ allowed-tools: Read, Write, Edit, Glob, Grep, AskUserQuestion
5
6
  ---
6
7
 
7
8
  # Design Init
@@ -2,6 +2,8 @@
2
2
  name: design-refine
3
3
  description: Directional design refinement — push the design bolder, quieter, more minimal, or more delightful
4
4
  user-invokable: true
5
+ allowed-tools: Read, Edit, Glob, Grep, AskUserQuestion
6
+ argument-hint: "--direction [bolder|quieter|minimal|delightful]"
5
7
  args:
6
8
  - name: direction
7
9
  description: "Refinement direction: bolder, quieter, minimal, delightful"
@@ -1,7 +1,9 @@
1
1
  ---
2
- name: design-system
2
+ name: design-tokens
3
3
  description: Design system extraction and normalization — find patterns or apply consistent tokens across the codebase
4
4
  user-invokable: true
5
+ allowed-tools: Read, Edit, Glob, Grep
6
+ argument-hint: "--mode [extract|normalize]"
5
7
  args:
6
8
  - name: mode
7
9
  description: "Mode: extract (find patterns and tokens) or normalize (apply system consistently)"
@@ -1,3 +1,7 @@
1
+ ---
2
+ alwaysApply: true
3
+ ---
4
+
1
5
  # Code Quality Checks
2
6
 
3
7
  After implementing a new feature or modifying existing code, **always run the following checks** before considering the task complete.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:audit
2
+ name: audit
3
3
  description: "Comprehensive codebase audit (SonarQube lite): architecture, code smells, complexity, security, coverage, and technical debt."
4
4
  allowed-tools: Read, Grep, Glob, Bash, Task, Write, AskUserQuestion
5
5
  argument-hint: "[--architecture|--code|--complexity|--security|--quick|directory]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:backlog
2
+ name: backlog
3
3
  description: Manage the issue backlog. Add, prioritize, start work, complete, and cleanup items. Keeps the file manageable with automatic limits.
4
4
  allowed-tools: Read, Write, Edit, Glob, AskUserQuestion
5
5
  argument-hint: "[add|move|cleanup] [args]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:brief
2
+ name: brief
3
3
  description: Quick contextual briefing with pre-flight validation. Scans docs, code, git, and runs health checks before starting work.
4
4
  allowed-tools: Task, Glob, Grep, Read, Bash
5
5
  argument-hint: "[topic]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:briefing
2
+ name: briefing
3
3
  description: Pre-planning alignment Q&A. Generates targeted questions to clarify scope, style, priority and constraints before diving into implementation.
4
4
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
5
5
  argument-hint: "[topic]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:checkpoint
2
+ name: checkpoint
3
3
  description: Save current session progress for resumption. Creates a compact state document with what's done, what's pending, and how to continue.
4
4
  allowed-tools: Read, Write, Bash, Glob
5
5
  argument-hint: "[task-name]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:create-plan
2
+ name: create-plan
3
3
  description: Strategic planning for complex tasks. Default creates phased implementation plan. Use --detailed for task-level pseudocode breakdown.
4
4
  allowed-tools: Read, Grep, Glob, Bash, AskUserQuestion, Write
5
5
  argument-hint: "[feature] [--detailed|--from-spec]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:create-skill
2
+ name: create-skill
3
3
  description: Meta skill to create new skills. Guides through defining purpose, workflow steps, tools, and generates the skill file.
4
4
  allowed-tools: AskUserQuestion, Write, Read, Glob
5
5
  argument-hint: "[skill-name]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design
2
+ name: design
3
3
  description: Orchestrates the design phase. Detects context and delegates to the right sub-skill.
4
4
  allowed-tools: Task, Read, Glob, AskUserQuestion, Write
5
5
  argument-hint: "[--research|--define|--ia|--wireframe|--system|--audit|--review|--spec]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-audit
2
+ name: design-audit
3
3
  description: UX audit — evaluates designs against Nielsen's 10 heuristics and WCAG 2.1 AA accessibility. Consolidates findings with severity.
4
4
  allowed-tools: Task, Read, Glob, Write, Bash
5
5
  argument-hint: "[--wireframes|--code|--both]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-define
2
+ name: design-define
3
3
  description: Synthesis phase — generates personas, user journey maps, and HMW problem statements from research.
4
4
  allowed-tools: Task, Read, Write, AskUserQuestion
5
5
  argument-hint: "[topic]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-ia
2
+ name: design-ia
3
3
  description: Information architecture phase — defines navigation structure, sitemap, and user flows from personas and journeys.
4
4
  allowed-tools: Task, Read, Write, AskUserQuestion
5
5
  argument-hint: "[scope]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-research
2
+ name: design-research
3
3
  description: Discovery phase — synthesizes competitive analysis, target audience, and business context into a research document.
4
4
  allowed-tools: Task, Read, Glob, AskUserQuestion, Write, WebFetch
5
5
  argument-hint: "[topic]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-review
2
+ name: design-review
3
3
  description: QA visual review — compares implementation against wireframe specs and design system. Surfaces deviations with severity.
4
4
  allowed-tools: Task, Read, Glob, Bash, Write
5
5
  argument-hint: "[component-name|--all]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-spec
2
+ name: design-spec
3
3
  description: Generates a developer-ready design specification from design artifacts. Bridges design phase and implementation planning.
4
4
  allowed-tools: Task, Read, Write, Glob
5
5
  argument-hint: "[screen-name|--all]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-system
2
+ name: design-system
3
3
  description: Design system router — delegates to define, audit, or sync based on flag. Manages design tokens, components, and style guide lifecycle.
4
4
  allowed-tools: Task, AskUserQuestion
5
5
  argument-hint: "[--define|--audit|--sync]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-system-audit
2
+ name: design-system-audit
3
3
  description: Audits the codebase for design system drift — finds hardcoded values, unused tokens, and components that bypass the system.
4
4
  allowed-tools: Task, Read, Glob, Grep, Write, Bash
5
5
  argument-hint: "[--files path/to/dir]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-system-define
2
+ name: design-system-define
3
3
  description: Creates or extracts a design system — tokens, components, and style guide — persisted to thoughts/design/design-system.md.
4
4
  allowed-tools: Task, Read, Write, Edit, AskUserQuestion, Bash, Glob
5
5
  argument-hint: "[--extract]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-system-sync
2
+ name: design-system-sync
3
3
  description: Syncs design tokens from thoughts/design/design-system.md to project config files (Tailwind, CSS vars, tokens.json).
4
4
  allowed-tools: Task, Read, Write, Edit, Glob, Bash, AskUserQuestion
5
5
  argument-hint: "[--dry-run]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:design-wireframe
2
+ name: design-wireframe
3
3
  description: Wireframe specification phase — generates structured text-based wireframe specs per screen. Tool-agnostic. Reads IA and define artifacts.
4
4
  allowed-tools: Task, Read, Write, AskUserQuestion
5
5
  argument-hint: "[screen-name|--all]"
@@ -0,0 +1,338 @@
1
+ ---
2
+ name: devtronic-help
3
+ description: Devtronic meta-help. Discover available skills, agents, addons, and workflows without leaving the IDE. Use when unsure what devtronic can do or which skill to use next.
4
+ allowed-tools: Glob, Read, Bash
5
+ argument-hint: "[topic|--workflows|--addons|--agents|--all]"
6
+ ---
7
+
8
+ # Help - Devtronic Discovery
9
+
10
+ Show what devtronic can do, right from the IDE. No need to switch to a terminal or read docs.
11
+
12
+ ## When to Use
13
+
14
+ - First time using devtronic in a project
15
+ - Unsure which skill to use for a task
16
+ - Want to see available agents or addons
17
+ - Need the recommended workflow for a specific task type
18
+
19
+ ## Modes
20
+
21
+ | Mode | Command | Shows |
22
+ |------|---------|-------|
23
+ | **Default** | `/devtronic-help` | Quick overview: skill categories + suggested next step |
24
+ | **Topic** | `/devtronic-help design` | Skills related to a topic |
25
+ | **Workflows** | `/devtronic-help --workflows` | Recommended workflows by task type |
26
+ | **Agents** | `/devtronic-help --agents` | Available subagents and their roles |
27
+ | **Addons** | `/devtronic-help --addons` | Installed and available addons |
28
+ | **All** | `/devtronic-help --all` | Full inventory |
29
+
30
+ ---
31
+
32
+ ## Process
33
+
34
+ ```
35
+ 1. PARSE INPUT
36
+ └── Determine mode from $ARGUMENTS
37
+
38
+ 2. SCAN INSTALLED ASSETS
39
+ ├── Skills: .claude/skills/*/SKILL.md
40
+ ├── Agents: .claude/agents/*.md
41
+ ├── Addons: .claude/addons/*/manifest.json (if any)
42
+ └── Rules: .claude/rules/*.md
43
+
44
+ 3. FORMAT OUTPUT
45
+ └── Display categorized, scannable results
46
+
47
+ 4. SUGGEST NEXT STEP
48
+ └── Based on what the user seems to need
49
+ ```
50
+
51
+ ---
52
+
53
+ ## Step 1: Parse Input
54
+
55
+ Parse `$ARGUMENTS`:
56
+
57
+ - Empty or no args → **Default mode** (overview)
58
+ - `--workflows` → Show workflow recipes
59
+ - `--agents` → List agents with descriptions
60
+ - `--addons` → Show addon status
61
+ - `--all` → Full inventory
62
+ - Anything else → **Topic mode** (filter by keyword)
63
+
64
+ ---
65
+
66
+ ## Step 2: Scan Installed Assets
67
+
68
+ ### Skills
69
+
70
+ ```bash
71
+ # Find all installed skills
72
+ find .claude/skills -name "SKILL.md" -type f 2>/dev/null
73
+ ```
74
+
75
+ For each SKILL.md, read the YAML frontmatter to extract `name` and `description`.
76
+
77
+ ### Agents
78
+
79
+ ```bash
80
+ # Find all installed agents
81
+ find .claude/agents -name "*.md" -type f 2>/dev/null
82
+ ```
83
+
84
+ For each agent file, read the first few lines to extract purpose.
85
+
86
+ ### Addons
87
+
88
+ ```bash
89
+ # Check for addon manifests
90
+ find .claude/addons -name "manifest.json" -type f 2>/dev/null
91
+ # Also check for addon skills/agents that were merged into main dirs
92
+ ```
93
+
94
+ ### Rules
95
+
96
+ ```bash
97
+ # Find active rules
98
+ find .claude/rules -name "*.md" -type f 2>/dev/null
99
+ ```
100
+
101
+ ---
102
+
103
+ ## Step 3: Output Formats
104
+
105
+ ### Default Mode (no args)
106
+
107
+ ```markdown
108
+ # Devtronic Help
109
+
110
+ You have **X skills**, **Y agents**, and **Z rules** installed.
111
+
112
+ ## Skill Categories
113
+
114
+ | Category | Skills | Start With |
115
+ |----------|--------|------------|
116
+ | Workflow | brief, spec, create-plan, execute-plan, summary, post-review | `/brief` |
117
+ | Session | checkpoint, handoff, recap, backlog | `/checkpoint` |
118
+ | Research | research, investigate, learn | `/research [topic]` |
119
+ | Design | design, design-research, design-define, design-ia, design-wireframe | `/design --research` |
120
+ | Design System | design-system, design-system-define, design-system-audit, design-system-sync | `/design-system --define` |
121
+ | Quality | audit, design-audit, design-review | `/audit` |
122
+ | Scaffold | scaffold, setup, create-skill, worktree | `/scaffold` |
123
+ | Quick | quick, opensrc | `/quick [task]` |
124
+
125
+ ## What Do You Want to Do?
126
+
127
+ | I want to... | Run |
128
+ |--------------|-----|
129
+ | Start a new feature | `/brief` then `/spec` |
130
+ | Fix a bug | `/brief` then `/investigate [error]` |
131
+ | Understand this codebase | `/research [topic]` |
132
+ | Design a UI | `/design --research` |
133
+ | Run a quick task | `/quick [task]` |
134
+ | Create a new project | `/scaffold` |
135
+ | Audit code quality | `/audit` |
136
+ | See available agents | `/devtronic-help --agents` |
137
+
138
+ > Tip: Run `/devtronic-help [topic]` to find skills related to a specific topic.
139
+ > Tip: Run `/devtronic-help --workflows` to see full workflow recipes.
140
+ ```
141
+
142
+ ### Topic Mode (`/devtronic-help design`)
143
+
144
+ Filter skills and agents whose name or description matches the keyword. Display matching items with descriptions.
145
+
146
+ ```markdown
147
+ # Devtronic Help: "design"
148
+
149
+ ## Matching Skills
150
+
151
+ | Skill | Description |
152
+ |-------|-------------|
153
+ | `/design` | Orchestrates the design phase. Detects context and delegates. |
154
+ | `/design-research` | Discovery phase — competitive analysis, audience, context. |
155
+ | `/design-define` | Personas, user journeys, HMW statements. |
156
+ | `/design-ia` | Information architecture — navigation, sitemap, flows. |
157
+ | `/design-wireframe` | Wireframe specs per screen. |
158
+ | `/design-spec` | Developer-ready design specification. |
159
+ | `/design-audit` | UX audit — Nielsen + WCAG. |
160
+ | `/design-review` | QA visual — implementation vs wireframes. |
161
+
162
+ ## Matching Agents
163
+
164
+ | Agent | Role |
165
+ |-------|------|
166
+ | design-critic | Evaluates design decisions |
167
+ | visual-qa | Compares implementation against spec |
168
+
169
+ ## Recommended Workflow
170
+
171
+ ```
172
+ /design --research → /design --define → /design --ia → /design --wireframe → /design-system --define
173
+ ```
174
+
175
+ > Run `/devtronic-help --workflows` for all workflow recipes.
176
+ ```
177
+
178
+ ### Workflows Mode (`/devtronic-help --workflows`)
179
+
180
+ ```markdown
181
+ # Devtronic Workflows
182
+
183
+ ## New Feature (full)
184
+
185
+ ```
186
+ /brief → /spec → /create-plan → /generate-tests → /execute-plan → /summary → /post-review
187
+ ```
188
+
189
+ ## New Feature (quick)
190
+
191
+ ```
192
+ /quick [describe the task]
193
+ ```
194
+
195
+ ## Bug Fix
196
+
197
+ ```
198
+ /brief → /investigate [error] → fix → test → /summary → /post-review
199
+ ```
200
+
201
+ ## Design (new product/page)
202
+
203
+ ```
204
+ /design --research → /design --define → /design --ia → /design --wireframe → /design-system --define → /spec → /create-plan → /execute-plan → /design-review → /post-review
205
+ ```
206
+
207
+ ## Refactor
208
+
209
+ ```
210
+ /brief → /create-plan → implement → /summary → /post-review
211
+ ```
212
+
213
+ ## Session Management
214
+
215
+ ```
216
+ /brief ← Start session (orientation)
217
+ /checkpoint ← Save progress mid-session
218
+ /handoff ← End session, prepare for next
219
+ /recap ← Quick summary from git
220
+ /summary ← Detailed post-change summary
221
+ ```
222
+
223
+ ## Design System
224
+
225
+ ```
226
+ /design-system --define ← Create or extract tokens
227
+ /design-system --audit ← Find drift and violations
228
+ /design-system --sync ← Push tokens to config files
229
+ ```
230
+
231
+ > Tip: Most workflows start with `/brief` for orientation.
232
+ ```
233
+
234
+ ### Agents Mode (`/devtronic-help --agents`)
235
+
236
+ Read each agent file and display:
237
+
238
+ ```markdown
239
+ # Devtronic Agents
240
+
241
+ Agents are specialized subagents that skills invoke automatically. You don't call them directly — they're used by skills like `/execute-plan`, `/audit`, and `/post-review`.
242
+
243
+ ## Available Agents
244
+
245
+ | Agent | Role | Used By |
246
+ |-------|------|---------|
247
+ | code-reviewer | Reviews code for quality and patterns | post-review |
248
+ | quality-runner | Runs typecheck, lint, test | brief, post-review |
249
+ | error-investigator | Deep error analysis | investigate |
250
+ | architecture-checker | Validates clean architecture | audit, post-review |
251
+ | commit-changes | Commits with conventional format | execute-plan |
252
+ | dependency-checker | Checks deps for issues | audit |
253
+ | doc-sync | Keeps docs in sync with code | summary |
254
+ | test-generator | Generates test cases | generate-tests |
255
+ | a11y-auditor | Accessibility audit | design-audit |
256
+ | design-critic | Evaluates design decisions | design-review |
257
+ | design-system-guardian | Enforces design system usage | design-system --audit |
258
+ | design-token-extractor | Extracts tokens from designs | design-system --define |
259
+ | ia-architect | Information architecture | design --ia |
260
+ | ux-researcher | UX research synthesis | design --research |
261
+ | visual-qa | Visual comparison | design-review |
262
+
263
+ > These are invoked automatically. You interact with them through skills.
264
+ ```
265
+
266
+ ### Addons Mode (`/devtronic-help --addons`)
267
+
268
+ ```markdown
269
+ # Devtronic Addons
270
+
271
+ Addons extend devtronic with extra skills, agents, and rules.
272
+
273
+ ## Installed Addons
274
+
275
+ [Scan .claude/ for addon-sourced files and list them]
276
+
277
+ ## Available Addons
278
+
279
+ To see all addons available for installation, run in your terminal:
280
+
281
+ ```bash
282
+ devtronic addon list
283
+ ```
284
+
285
+ To add an addon:
286
+
287
+ ```bash
288
+ devtronic addon add [name]
289
+ ```
290
+
291
+ > Addons add skills, agents, rules, and reference material to your project.
292
+ ```
293
+
294
+ ### All Mode (`/devtronic-help --all`)
295
+
296
+ Combine: Default overview + full skill list with descriptions + agents + addons + workflows.
297
+
298
+ ---
299
+
300
+ ## Edge Cases
301
+
302
+ ### No Skills Found
303
+
304
+ If `.claude/skills/` is empty or missing:
305
+
306
+ ```markdown
307
+ # Devtronic Help
308
+
309
+ No devtronic skills detected in this project.
310
+
311
+ ## Getting Started
312
+
313
+ Run in your terminal:
314
+
315
+ ```bash
316
+ npx devtronic init
317
+ ```
318
+
319
+ This will analyze your project and install skills, agents, and rules.
320
+ ```
321
+
322
+ ### Partial Installation
323
+
324
+ If some directories exist but others don't, show what's available and note what's missing:
325
+
326
+ ```markdown
327
+ > Note: No agents found. Run `devtronic init` to install the full set.
328
+ ```
329
+
330
+ ---
331
+
332
+ ## Tips
333
+
334
+ 1. **Start with `/devtronic-help`** — get oriented fast
335
+ 2. **Use topic search** — `/devtronic-help auth` finds relevant skills
336
+ 3. **Check workflows** — `/devtronic-help --workflows` shows the right sequence
337
+ 4. **Don't call agents directly** — skills orchestrate them for you
338
+ 5. **Extend with addons** — `/devtronic-help --addons` shows what's available
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:execute-plan
2
+ name: execute-plan
3
3
  description: Execute a plan in parallel phases. Reads task dependencies and runs independent tasks as concurrent subagents. Claude Code only.
4
4
  allowed-tools: Task, Read, Write, Bash, Glob, Grep, Edit
5
5
  argument-hint: "[plan-path|--latest]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:generate-tests
2
+ name: generate-tests
3
3
  description: Generate failing tests from a spec before implementation (Tests-as-DoD). Creates test files encoding acceptance criteria as executable tests, plus a traceability manifest.
4
4
  allowed-tools: Read, Write, Glob, Grep, Bash
5
5
  argument-hint: "[--from-spec|spec-path]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:handoff
2
+ name: handoff
3
3
  description: Context rotation for fresh sessions. Saves current state and signals to start a new session with clean context.
4
4
  allowed-tools: Read, Write, Bash, Glob
5
5
  argument-hint: "[reason]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:investigate
2
+ name: investigate
3
3
  description: Deep analysis of errors and bugs. Use when you paste an error for detailed investigation. Identifies root cause, analyzes flow, and proposes fix with code.
4
4
  allowed-tools: Read, Grep, Glob, Bash, Write, Edit
5
5
  argument-hint: "[error or description]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:learn
2
+ name: learn
3
3
  description: Post-task teaching breakdown. After any task, get a detailed explanation of what was done, why, and how to apply the concepts yourself. Use when you say "explain what you did" or "teach me".
4
4
  allowed-tools: Read, Grep, Glob, AskUserQuestion
5
5
  argument-hint: "[topic or recent task]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:opensrc
2
+ name: opensrc
3
3
  description: Fetch source code of npm packages or GitHub repos so AI agents have full implementation context, not just type definitions. Uses vercel-labs/opensrc under the hood.
4
4
  allowed-tools: Bash, Read, Glob, Edit
5
5
  argument-hint: "<package[@version]|owner/repo[@ref]> [packages...]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:post-review
2
+ name: post-review
3
3
  description: Post-feature review before PR. Checks requirements, architecture, quality, and captures lessons. Auto-invoke after completing a plan implementation. Use --strict for senior engineer mode.
4
4
  allowed-tools: Read, Grep, Glob, Bash, Edit, Write, Task
5
5
  argument-hint: "[--strict|--quick|files...]"
@@ -145,7 +145,7 @@ If no plan with done criteria exists, use the manual requirements checklist:
145
145
 
146
146
  ```
147
147
  Use the Task tool with:
148
- subagent_type: "devtronic:architecture-checker"
148
+ subagent_type: "architecture-checker"
149
149
  model: "sonnet"
150
150
  prompt: "Check architecture compliance on these changed files: [file list from Step 1]"
151
151
  ```
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:quick
2
+ name: quick
3
3
  description: Fast ad-hoc task execution. Skips spec/research/plan — just implement, verify, commit. For small, well-defined tasks.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
5
  argument-hint: "<task description>"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:recap
2
+ name: recap
3
3
  description: Quick structured session summary from git activity and modified files. Compact companion to /summary.
4
4
  allowed-tools: Read, Write, Bash, Glob, Grep
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:research
2
+ name: research
3
3
  description: Codebase investigation. Quick mode (default) for fast orientation. Deep mode for thorough analysis. External mode for GitHub + user-configured MCPs.
4
4
  allowed-tools: Read, Grep, Glob, Bash, WebFetch, Task, Write
5
5
  argument-hint: "[topic] [--deep|--external|--all]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:scaffold
2
+ name: scaffold
3
3
  description: Create new projects from scratch with guided architecture and structure. Use when starting a brand new project.
4
4
  allowed-tools: Read, Glob, Bash, Write, AskUserQuestion
5
5
  argument-hint: "[project-name]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:setup
2
+ name: setup
3
3
  description: Configure devtronic for this project through interactive conversation. Use when setting up AI assistance in an existing project.
4
4
  allowed-tools: Bash, Read, Glob, AskUserQuestion, Write
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:spec
2
+ name: spec
3
3
  description: Create a product specification (PRD) by interviewing the user. Captures requirements, UX decisions, edge cases, and success metrics before technical work begins.
4
4
  allowed-tools: AskUserQuestion, Write, Read, Glob
5
5
  argument-hint: "[feature]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:summary
2
+ name: summary
3
3
  description: Generate a structured post-change summary. Captures what changed, why, what's pending, and files modified.
4
4
  allowed-tools: Read, Write, Bash, Glob, Grep
5
5
  argument-hint: "[feature-name]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: devtronic:worktree
2
+ name: worktree
3
3
  description: Manage git worktrees with intuitive flags. Create, list, remove, and prune worktrees with consistent naming and enriched status.
4
4
  allowed-tools: Bash, AskUserQuestion, Read, Glob
5
5
  argument-hint: "[--create|--list|--remove|--prune] [name]"