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.
- package/README.md +2 -2
- package/dist/{chunk-V4QEAL7Y.js → chunk-WM7R52TC.js} +30 -27
- package/dist/index.js +57 -33
- package/dist/{plugin-SGSFVXPA.js → plugin-KQQASBQX.js} +1 -1
- package/package.json +1 -1
- package/templates/addons/auto-devtronic/agents/afk-task-validator.md +78 -0
- package/templates/addons/auto-devtronic/agents/{quality-runner.md → quality-executor.md} +1 -1
- package/templates/addons/auto-devtronic/manifest.json +2 -1
- package/templates/addons/auto-devtronic/skills/auto-devtronic/SKILL.md +14 -14
- package/templates/addons/design-best-practices/manifest.json +2 -2
- package/templates/addons/design-best-practices/skills/{design-review → design-critique}/SKILL.md +2 -1
- package/templates/addons/design-best-practices/skills/design-harden/SKILL.md +1 -0
- package/templates/addons/design-best-practices/skills/design-init/SKILL.md +1 -0
- package/templates/addons/design-best-practices/skills/design-refine/SKILL.md +2 -0
- package/templates/addons/design-best-practices/skills/{design-system → design-tokens}/SKILL.md +3 -1
- package/templates/claude-code/.claude/rules/quality.md +4 -0
- package/templates/claude-code/.claude/skills/audit/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/backlog/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/brief/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/briefing/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/checkpoint/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/create-plan/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/create-skill/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-audit/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-define/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-ia/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-research/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-review/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-spec/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-system/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-system-audit/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-system-define/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-system-sync/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/design-wireframe/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/devtronic-help/SKILL.md +338 -0
- package/templates/claude-code/.claude/skills/execute-plan/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/generate-tests/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/handoff/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/investigate/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/learn/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/opensrc/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/post-review/SKILL.md +2 -2
- package/templates/claude-code/.claude/skills/quick/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/recap/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/research/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/scaffold/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/setup/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/spec/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/summary/SKILL.md +1 -1
- package/templates/claude-code/.claude/skills/worktree/SKILL.md +1 -1
|
@@ -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"
|
package/templates/addons/design-best-practices/skills/{design-system → design-tokens}/SKILL.md
RENAMED
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: design-
|
|
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,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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: "
|
|
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:
|
|
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:
|
|
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:
|
|
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]"
|