claude-autopm 1.18.0 → 1.20.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (108) hide show
  1. package/README.md +159 -0
  2. package/autopm/.claude/agents/README.md +1 -1
  3. package/autopm/.claude/agents/core/mcp-manager.md +1 -1
  4. package/autopm/.claude/agents/decision-matrices/python-backend-selection.md +25 -25
  5. package/autopm/.claude/agents/decision-matrices/ui-framework-selection.md +43 -43
  6. package/autopm/.claude/agents/devops/github-operations-specialist.md +1 -1
  7. package/autopm/.claude/agents/frameworks/README.md +5 -5
  8. package/autopm/.claude/agents/frameworks/e2e-test-engineer.md +1 -1
  9. package/autopm/.claude/agents/frameworks/nats-messaging-expert.md +1 -1
  10. package/autopm/.claude/agents/frameworks/react-frontend-engineer.md +1 -1
  11. package/autopm/.claude/agents/frameworks/react-ui-expert.md +3 -3
  12. package/autopm/.claude/agents/frameworks/tailwindcss-expert.md +3 -3
  13. package/autopm/.claude/agents/frameworks/ux-design-expert.md +3 -3
  14. package/autopm/.claude/commands/infrastructure/traefik-setup.md +1 -1
  15. package/autopm/.claude/commands/playwright/test-scaffold.md +1 -1
  16. package/autopm/.claude/commands/pm/context.md +11 -0
  17. package/autopm/.claude/commands/pm/epic-decompose.md +25 -2
  18. package/autopm/.claude/commands/pm/epic-oneshot.md +13 -0
  19. package/autopm/.claude/commands/pm/epic-start.md +19 -0
  20. package/autopm/.claude/commands/pm/epic-sync-modular.md +10 -10
  21. package/autopm/.claude/commands/pm/epic-sync.md +14 -14
  22. package/autopm/.claude/commands/pm/issue-start.md +50 -5
  23. package/autopm/.claude/commands/pm/issue-sync.md +15 -15
  24. package/autopm/.claude/commands/pm/what-next.md +11 -0
  25. package/autopm/.claude/commands/ui/bootstrap-scaffold.md +6 -5
  26. package/autopm/.claude/commands/ui/tailwind-system.md +1 -1
  27. package/autopm/.claude/examples/mcp/playwright-mcp.md +2 -2
  28. package/autopm/.claude/examples/mcp-servers.example.json +2 -2
  29. package/autopm/.claude/hooks/docker-first-enforcement.sh +1 -1
  30. package/autopm/.claude/mcp/MCP-REGISTRY.md +1 -1
  31. package/autopm/.claude/mcp/playwright-mcp.md +2 -2
  32. package/autopm/.claude/rules/agent-coordination.md +26 -24
  33. package/autopm/.claude/rules/docker-first-development.md +1 -1
  34. package/autopm/.claude/rules/infrastructure-pipeline.md +1 -1
  35. package/autopm/.claude/rules/ui-development-standards.md +1 -1
  36. package/autopm/.claude/rules/visual-testing.md +3 -3
  37. package/autopm/.claude/scripts/azure/active-work.js +2 -2
  38. package/autopm/.claude/scripts/azure/blocked.js +13 -13
  39. package/autopm/.claude/scripts/azure/daily.js +1 -1
  40. package/autopm/.claude/scripts/azure/dashboard.js +1 -1
  41. package/autopm/.claude/scripts/azure/feature-list.js +2 -2
  42. package/autopm/.claude/scripts/azure/feature-status.js +1 -1
  43. package/autopm/.claude/scripts/azure/next-task.js +1 -1
  44. package/autopm/.claude/scripts/azure/search.js +1 -1
  45. package/autopm/.claude/scripts/azure/setup.js +15 -15
  46. package/autopm/.claude/scripts/azure/sprint-report.js +2 -2
  47. package/autopm/.claude/scripts/azure/sync.js +1 -1
  48. package/autopm/.claude/scripts/azure/us-list.js +1 -1
  49. package/autopm/.claude/scripts/azure/us-status.js +1 -1
  50. package/autopm/.claude/scripts/azure/validate.js +13 -13
  51. package/autopm/.claude/scripts/lib/frontmatter-utils.sh +42 -7
  52. package/autopm/.claude/scripts/lib/logging-utils.sh +20 -16
  53. package/autopm/.claude/scripts/lib/validation-utils.sh +1 -1
  54. package/autopm/.claude/scripts/pm/context.js +338 -0
  55. package/autopm/.claude/scripts/pm/issue-sync/format-comment.sh +3 -3
  56. package/autopm/.claude/scripts/pm/lib/README.md +85 -0
  57. package/autopm/.claude/scripts/pm/lib/logger.js +78 -0
  58. package/autopm/.claude/scripts/pm/next.js +25 -1
  59. package/autopm/.claude/scripts/pm/what-next.js +660 -0
  60. package/autopm/.claude/teams.json +3 -5
  61. package/autopm/.claude/templates/claude-templates/addons/devops-agents.md +2 -2
  62. package/autopm/.claude/templates/claude-templates/addons/docker-agents.md +4 -4
  63. package/autopm/.claude/templates/claude-templates/addons/minimal-agents.md +1 -1
  64. package/autopm/.claude/templates/issue-decomposition/api.yaml +2 -2
  65. package/autopm/.claude/templates/issue-decomposition/auth.yaml +4 -4
  66. package/autopm/.claude/templates/issue-decomposition/crud.yaml +3 -3
  67. package/autopm/.claude/templates/issue-decomposition/default.yaml +1 -1
  68. package/autopm/.claude/templates/issue-decomposition/ui-feature.yaml +2 -2
  69. package/bin/autopm.js +25 -0
  70. package/package.json +1 -2
  71. package/lib/agentExecutor.js.deprecated +0 -101
  72. package/lib/azure/cache.js +0 -80
  73. package/lib/azure/client.js +0 -77
  74. package/lib/azure/formatter.js +0 -177
  75. package/lib/commandHelpers.js +0 -177
  76. package/lib/context/manager.js +0 -290
  77. package/lib/documentation/manager.js +0 -528
  78. package/lib/github/workflow-manager.js +0 -546
  79. package/lib/helpers/azure-batch-api.js +0 -133
  80. package/lib/helpers/azure-cache-manager.js +0 -287
  81. package/lib/helpers/azure-parallel-processor.js +0 -158
  82. package/lib/helpers/azure-work-item-create.js +0 -278
  83. package/lib/helpers/gh-issue-create.js +0 -250
  84. package/lib/helpers/interactive-prompt.js +0 -336
  85. package/lib/helpers/output-manager.js +0 -335
  86. package/lib/helpers/progress-indicator.js +0 -258
  87. package/lib/performance/benchmarker.js +0 -429
  88. package/lib/pm/epic-decomposer.js +0 -273
  89. package/lib/pm/epic-syncer.js +0 -221
  90. package/lib/prdMetadata.js +0 -270
  91. package/lib/providers/azure/index.js +0 -234
  92. package/lib/providers/factory.js +0 -87
  93. package/lib/providers/github/index.js +0 -204
  94. package/lib/providers/interface.js +0 -73
  95. package/lib/python/scaffold-manager.js +0 -576
  96. package/lib/react/scaffold-manager.js +0 -745
  97. package/lib/regression/analyzer.js +0 -578
  98. package/lib/release/manager.js +0 -324
  99. package/lib/tailwind/manager.js +0 -486
  100. package/lib/traefik/manager.js +0 -484
  101. package/lib/utils/colors.js +0 -126
  102. package/lib/utils/config.js +0 -317
  103. package/lib/utils/filesystem.js +0 -316
  104. package/lib/utils/logger.js +0 -135
  105. package/lib/utils/prompts.js +0 -294
  106. package/lib/utils/shell.js +0 -237
  107. package/lib/validators/email-validator.js +0 -337
  108. package/lib/workflow/manager.js +0 -449
package/README.md CHANGED
@@ -269,6 +269,165 @@ autopm pm:epic-sync user-auth
269
269
 
270
270
  **That's it!** You're now using structured, spec-driven development with AI agents.
271
271
 
272
+ ## 📋 Complete PM Workflow Guide
273
+
274
+ ### Understanding the Process: PRD → Epic → Tasks
275
+
276
+ ClaudeAutoPM follows a structured workflow from requirements to implementation:
277
+
278
+ ```
279
+ PRD (Product Requirements)
280
+
281
+ Epic Split (Optional - for complex projects)
282
+
283
+ Task Decomposition
284
+
285
+ GitHub/Azure Sync
286
+
287
+ Development & Tracking
288
+ ```
289
+
290
+ ### Quick Decision Guide
291
+
292
+ **When to use ONE epic (`/pm:epic-decompose`):**
293
+ - ✅ Simple feature (1-2 weeks)
294
+ - ✅ Single component (frontend OR backend)
295
+ - ✅ One developer
296
+ - ✅ Examples: "Add user profile page", "Create REST API endpoint"
297
+
298
+ **When to use MULTIPLE epics (`/pm:epic-split`):**
299
+ - ✅ Complex project (2+ months)
300
+ - ✅ Multiple components (frontend + backend + infrastructure)
301
+ - ✅ Multiple teams working in parallel
302
+ - ✅ Examples: "E-commerce platform", "Social media dashboard"
303
+
304
+ ### Workflow Examples
305
+
306
+ <details>
307
+ <summary><b>Simple Feature Workflow</b> - Single epic, quick delivery</summary>
308
+
309
+ ```bash
310
+ # 1. Create PRD
311
+ /pm:prd-new user-profile
312
+
313
+ # 2. Parse and analyze
314
+ /pm:prd-parse user-profile
315
+
316
+ # 3. Decompose into tasks (ONE epic)
317
+ /pm:epic-decompose user-profile
318
+ # Creates: .claude/epics/user-profile/
319
+ # ├── epic.md
320
+ # ├── 001.md # Create profile component
321
+ # ├── 002.md # Add avatar upload
322
+ # ├── 003.md # Implement edit form
323
+ # └── 004.md # Add validation
324
+
325
+ # 4. Sync with GitHub/Azure
326
+ /pm:epic-sync user-profile
327
+
328
+ # 5. Start working
329
+ /pm:next # Get next task
330
+ /pm:issue-start #123 # Begin work
331
+ # ... development ...
332
+ /pm:issue-close #123 # Complete task
333
+ ```
334
+ </details>
335
+
336
+ <details>
337
+ <summary><b>Complex Project Workflow</b> - Multiple epics, phased delivery</summary>
338
+
339
+ ```bash
340
+ # 1. Create PRD
341
+ /pm:prd-new ecommerce-platform
342
+
343
+ # 2. Parse and analyze
344
+ /pm:prd-parse ecommerce-platform
345
+
346
+ # 3. Split into multiple epics (AUTOMATIC)
347
+ /pm:epic-split ecommerce-platform
348
+ # Automatically creates 6 epics:
349
+ # Epic 1: Infrastructure (Docker, DB, Redis) - P0, 1w
350
+ # Epic 2: Auth Backend (JWT, users, RBAC) - P0, 2w
351
+ # Epic 3: Product API (catalog, orders) - P0, 3w
352
+ # Epic 4: Frontend Foundation (React setup) - P0, 1w
353
+ # Epic 5: E-commerce UI (pages, cart) - P1, 3w
354
+ # Epic 6: Testing & Deployment (CI/CD) - P1, 1w
355
+
356
+ # 4. Decompose EACH epic into tasks
357
+ /pm:epic-decompose ecommerce-platform/01-infrastructure # 12 tasks
358
+ /pm:epic-decompose ecommerce-platform/02-auth-backend # 15 tasks
359
+ /pm:epic-decompose ecommerce-platform/03-product-api # 20 tasks
360
+ /pm:epic-decompose ecommerce-platform/04-frontend # 10 tasks
361
+ /pm:epic-decompose ecommerce-platform/05-ui # 25 tasks
362
+ /pm:epic-decompose ecommerce-platform/06-testing # 8 tasks
363
+ # TOTAL: ~90 tasks across 6 epics
364
+
365
+ # 5. Sync ALL epics at once
366
+ /pm:epic-sync ecommerce-platform
367
+
368
+ # 6. Parallel team work
369
+ /pm:next # Team 1: Infrastructure (P0)
370
+ /pm:next # Team 2: Auth Backend (P0, parallel)
371
+ /pm:next # Team 3: Frontend Foundation (P0, parallel)
372
+ ```
373
+ </details>
374
+
375
+ <details>
376
+ <summary><b>Multiple PRDs Workflow</b> - Independent features</summary>
377
+
378
+ ```bash
379
+ # Create multiple independent features
380
+ /pm:prd-new login-page
381
+ /pm:prd-new payment-system
382
+ /pm:prd-new notifications
383
+
384
+ # Process each independently
385
+ /pm:prd-parse login-page
386
+ /pm:epic-decompose login-page # 5 tasks
387
+ /pm:epic-sync login-page
388
+
389
+ /pm:prd-parse payment-system
390
+ /pm:epic-decompose payment-system # 8 tasks
391
+ /pm:epic-sync payment-system
392
+
393
+ /pm:prd-parse notifications
394
+ /pm:epic-decompose notifications # 4 tasks
395
+ /pm:epic-sync notifications
396
+
397
+ # /pm:next automatically picks highest priority across ALL epics
398
+ ```
399
+ </details>
400
+
401
+ ### Key Commands Reference
402
+
403
+ | Command | Purpose | When to Use |
404
+ |---------|---------|-------------|
405
+ | `/pm:prd-new <name>` | Create PRD | Always start here |
406
+ | `/pm:prd-parse <name>` | Analyze PRD | After writing requirements |
407
+ | `/pm:epic-split <name>` | Create multiple epics | Complex, multi-component projects |
408
+ | `/pm:epic-decompose <name>` | Break into tasks | Always (once per epic) |
409
+ | `/pm:epic-sync <name>` | Sync with GitHub/Azure | After decomposition |
410
+ | `/pm:context` | Show current state | Check progress anytime |
411
+ | `/pm:next` | Get next task | Ready to work |
412
+ | `/pm:issue-start #N` | Start task | Before coding |
413
+ | `/pm:issue-close #N` | Complete task | After finishing |
414
+
415
+ ### FAQ
416
+
417
+ **Q: Can I create multiple PRDs at once?**
418
+ A: Yes! Each PRD is independent. Create as many as you need.
419
+
420
+ **Q: How do I decide between epic-split and epic-decompose?**
421
+ A: Use epic-split for multi-component projects (frontend + backend + infra). Use epic-decompose for single-component features.
422
+
423
+ **Q: Do I need to decompose ALL epics after split?**
424
+ A: Yes, before syncing. But you can decompose them one at a time as needed.
425
+
426
+ **Q: How do I check my progress?**
427
+ A: Use `/pm:context` to see current project, epics, and task progress.
428
+
429
+ 📖 **Full Workflow Guide:** See [PM-WORKFLOW-GUIDE.md](PM-WORKFLOW-GUIDE.md) for detailed examples and decision flows.
430
+
272
431
  ## 🎯 Core Workflow: Crawl → Walk → Run
273
432
 
274
433
  ### Crawl: Basic Commands
@@ -57,7 +57,7 @@ Language-specific development:
57
57
  Framework specialists:
58
58
 
59
59
  - `react-frontend-engineer` - React/Next.js expert
60
- - `playwright-test-engineer` - E2E testing expert
60
+ - `frontend-testing-engineer` - E2E testing expert
61
61
  - *Planned: angular, vue, django, spring, express*
62
62
 
63
63
  ### Cloud (4 agents, 5+ planned)
@@ -28,7 +28,7 @@ Each MCP server is defined in a Markdown file with:
28
28
  - **monitoring**: Observability and metrics
29
29
 
30
30
  ### Configuration Management
31
- - Servers defined in `autopm/.claude/mcp/*.md`
31
+ - Servers defined in `.claude/mcp/*.md`
32
32
  - Active servers tracked in `.claude/config.json`
33
33
  - Runtime config generated to `.claude/mcp-servers.json`
34
34
  - Environment variables in `.claude/.env`
@@ -1,8 +1,8 @@
1
- # Python Backend Agent Decision Matrix
1
+ # Python Backend Framework Selection Guide
2
2
 
3
3
  ## Quick Selection Guide
4
4
 
5
- Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on your project requirements:
5
+ The `python-backend-engineer` agent supports both **FastAPI** and **Flask** frameworks. Use this guide to choose the right framework for your project:
6
6
 
7
7
  | Requirement | FastAPI | Flask |
8
8
  |-------------|---------|-------|
@@ -27,9 +27,9 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
27
27
  - ⚙️ **Moderate/Possible**: Doable with some effort
28
28
  - ⚠️ **Limited**: Has constraints or limitations
29
29
 
30
- ## Detailed Agent Comparison
30
+ ## Detailed Framework Comparison
31
31
 
32
- ### fastapi-backend-engineer
32
+ ### FastAPI (use python-backend-engineer with framework=fastapi)
33
33
 
34
34
  **Best For:**
35
35
  - **Modern APIs**: REST/GraphQL APIs with auto-documentation
@@ -55,7 +55,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
55
55
  - IoT data ingestion APIs
56
56
  - Modern single-page app backends
57
57
 
58
- ### flask-backend-engineer
58
+ ### Flask (use python-backend-engineer with framework=flask)
59
59
 
60
60
  **Best For:**
61
61
  - **Traditional Web Applications**: Server-rendered applications
@@ -86,7 +86,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
86
86
  ### 1. What type of application are you building?
87
87
 
88
88
  #### API-Only Applications
89
- → **fastapi-backend-engineer**
89
+ → **FastAPI** (python-backend-engineer with framework=fastapi)
90
90
  **Reasoning:**
91
91
  - Auto-generated API documentation
92
92
  - Built-in request/response validation
@@ -94,7 +94,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
94
94
  - Native async support for database operations
95
95
 
96
96
  #### Web Applications with Templates
97
- → **flask-backend-engineer**
97
+ → **Flask** (python-backend-engineer with framework=flask)
98
98
  **Reasoning:**
99
99
  - Mature template engine (Jinja2)
100
100
  - Server-side rendering capabilities
@@ -103,13 +103,13 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
103
103
 
104
104
  #### Hybrid (API + Web)
105
105
  → **Consider both or choose based on primary focus:**
106
- - API-heavy → fastapi-backend-engineer
107
- - Web-heavy → flask-backend-engineer
106
+ - API-heavy → FastAPI (python-backend-engineer with framework=fastapi)
107
+ - Web-heavy → Flask (python-backend-engineer with framework=flask)
108
108
 
109
109
  ### 2. What are your performance requirements?
110
110
 
111
111
  #### High Performance Required
112
- → **fastapi-backend-engineer**
112
+ → **FastAPI** (python-backend-engineer with framework=fastapi)
113
113
  **Use When:**
114
114
  - 1000+ requests per second expected
115
115
  - Low latency requirements (< 100ms)
@@ -117,7 +117,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
117
117
  - Concurrent user handling important
118
118
 
119
119
  #### Standard Performance Acceptable
120
- → **flask-backend-engineer**
120
+ → **Flask** (python-backend-engineer with framework=flask)
121
121
  **Use When:**
122
122
  - < 1000 requests per second
123
123
  - Response time requirements moderate
@@ -127,7 +127,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
127
127
  ### 3. What is your team's experience level?
128
128
 
129
129
  #### Python Beginners to Intermediate
130
- → **flask-backend-engineer**
130
+ → **Flask** (python-backend-engineer with framework=flask)
131
131
  **Reasoning:**
132
132
  - Simpler concepts and patterns
133
133
  - Extensive tutorials and examples
@@ -135,7 +135,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
135
135
  - Gradual learning curve
136
136
 
137
137
  #### Python Advanced or Performance-Focused Teams
138
- → **fastapi-backend-engineer**
138
+ → **FastAPI** (python-backend-engineer with framework=fastapi)
139
139
  **Reasoning:**
140
140
  - Leverages advanced Python features
141
141
  - Type hints and modern patterns
@@ -145,7 +145,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
145
145
  ### 4. What are your integration requirements?
146
146
 
147
147
  #### Modern Stack (React, Vue, Mobile Apps)
148
- → **fastapi-backend-engineer**
148
+ → **FastAPI** (python-backend-engineer with framework=fastapi)
149
149
  **Features:**
150
150
  - Auto-generated API clients
151
151
  - OpenAPI specification
@@ -153,7 +153,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
153
153
  - CORS handling built-in
154
154
 
155
155
  #### Traditional Stack (Server-rendered, jQuery)
156
- → **flask-backend-engineer**
156
+ → **Flask** (python-backend-engineer with framework=flask)
157
157
  **Features:**
158
158
  - Template inheritance
159
159
  - Form handling with WTForms
@@ -165,7 +165,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
165
165
  ### API Development
166
166
 
167
167
  #### RESTful API for Mobile App
168
- **Choice**: fastapi-backend-engineer
168
+ **Choice**: FastAPI (python-backend-engineer with framework=fastapi)
169
169
  **Reasoning:**
170
170
  - Auto-generated API documentation
171
171
  - Request/response validation
@@ -173,7 +173,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
173
173
  - Easy async database operations
174
174
 
175
175
  #### Enterprise API with Complex Business Logic
176
- **Choice**: fastapi-backend-engineer
176
+ **Choice**: FastAPI (python-backend-engineer with framework=fastapi)
177
177
  **Reasoning:**
178
178
  - Type safety for complex data structures
179
179
  - Dependency injection for business services
@@ -183,7 +183,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
183
183
  ### Web Applications
184
184
 
185
185
  #### Content Management System
186
- **Choice**: flask-backend-engineer
186
+ **Choice**: Flask (python-backend-engineer with framework=flask)
187
187
  **Reasoning:**
188
188
  - Server-side rendering capabilities
189
189
  - Admin interface patterns
@@ -191,7 +191,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
191
191
  - Traditional web architecture
192
192
 
193
193
  #### E-commerce Platform
194
- **Choice**: flask-backend-engineer
194
+ **Choice**: Flask (python-backend-engineer with framework=flask)
195
195
  **Reasoning:**
196
196
  - Complex form handling (checkout, admin)
197
197
  - Server-side rendering for SEO
@@ -201,7 +201,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
201
201
  ### Hybrid Applications
202
202
 
203
203
  #### SaaS Platform (Web + API)
204
- **Primary Choice**: fastapi-backend-engineer
204
+ **Primary Choice**: FastAPI (python-backend-engineer with framework=fastapi)
205
205
  **Reasoning:**
206
206
  - API-first for modern frontend
207
207
  - WebSocket for real-time features
@@ -215,7 +215,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
215
215
  ### Specific Scenarios
216
216
 
217
217
  #### Microservices Architecture
218
- **Choice**: fastapi-backend-engineer
218
+ **Choice**: FastAPI (python-backend-engineer with framework=fastapi)
219
219
  **Features:**
220
220
  - Smaller, focused services
221
221
  - Async communication between services
@@ -223,7 +223,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
223
223
  - High performance per service
224
224
 
225
225
  #### Machine Learning API
226
- **Choice**: fastapi-backend-engineer
226
+ **Choice**: FastAPI (python-backend-engineer with framework=fastapi)
227
227
  **Features:**
228
228
  - Async model inference
229
229
  - Request validation for ML inputs
@@ -231,7 +231,7 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
231
231
  - WebSocket for real-time predictions
232
232
 
233
233
  #### Legacy System Integration
234
- **Choice**: flask-backend-engineer
234
+ **Choice**: Flask (python-backend-engineer with framework=flask)
235
235
  **Features:**
236
236
  - Established integration patterns
237
237
  - Flexible architecture for custom needs
@@ -240,8 +240,8 @@ Choose between `fastapi-backend-engineer` and `flask-backend-engineer` based on
240
240
 
241
241
  #### Startup MVP
242
242
  **Choice**: Depends on team and product
243
- - **Technical team building API**: fastapi-backend-engineer
244
- - **Mixed team building web app**: flask-backend-engineer
243
+ - **Technical team building API**: FastAPI (python-backend-engineer with framework=fastapi)
244
+ - **Mixed team building web app**: Flask (python-backend-engineer with framework=flask)
245
245
 
246
246
  ## Performance Comparison
247
247
 
@@ -31,26 +31,26 @@ Use this matrix to choose the right UI framework agent based on your project req
31
31
  ### Project Type
32
32
 
33
33
  #### Enterprise Applications
34
- **Primary Choice: antd-react-expert**
34
+ **Primary Choice: react-ui-expert**
35
35
  - Pre-built complex components (ProTable, ProForm)
36
36
  - Enterprise-grade data management
37
37
  - Professional design language
38
38
  - Built-in admin patterns
39
39
 
40
- **Alternative: mui-react-expert**
40
+ **Alternative: react-frontend-engineer**
41
41
  - Material Design consistency
42
42
  - DataGrid for complex tables
43
43
  - Strong TypeScript support
44
44
  - Large ecosystem
45
45
 
46
46
  #### Startup/MVP
47
- **Primary Choice: bootstrap-ui-expert**
47
+ **Primary Choice: react-ui-expert**
48
48
  - Fastest development time
49
49
  - Extensive pre-built templates
50
50
  - Strong community resources
51
51
  - Easy developer onboarding
52
52
 
53
- **Alternative: chakra-ui-expert**
53
+ **Alternative: react-frontend-engineer**
54
54
  - Modern developer experience
55
55
  - Excellent component composition
56
56
  - Built-in accessibility
@@ -63,7 +63,7 @@ Use this matrix to choose the right UI framework agent based on your project req
63
63
  - Utility-first approach
64
64
  - Optimal performance
65
65
 
66
- **Alternative: chakra-ui-expert**
66
+ **Alternative: react-frontend-engineer**
67
67
  - Styled-system approach
68
68
  - Design tokens
69
69
  - Easy customization
@@ -72,43 +72,43 @@ Use this matrix to choose the right UI framework agent based on your project req
72
72
  ### Team Expertise
73
73
 
74
74
  #### Junior Developers
75
- 1. **bootstrap-ui-expert** - Familiar patterns, extensive docs
76
- 2. **chakra-ui-expert** - Intuitive API, good defaults
77
- 3. **mui-react-expert** - Material Design guidelines
75
+ 1. **react-ui-expert** - Familiar patterns, extensive docs
76
+ 2. **react-frontend-engineer** - Intuitive API, good defaults
77
+ 3. **react-frontend-engineer** - Material Design guidelines
78
78
 
79
79
  #### Senior/Design Teams
80
80
  1. **tailwindcss-expert** - Full control, custom systems
81
- 2. **chakra-ui-expert** - Balanced flexibility/productivity
82
- 3. **mui-react-expert** - Advanced patterns, customization
81
+ 2. **react-frontend-engineer** - Balanced flexibility/productivity
82
+ 3. **react-frontend-engineer** - Advanced patterns, customization
83
83
 
84
84
  ### Technical Requirements
85
85
 
86
86
  #### Performance Critical
87
87
  1. **tailwindcss-expert** - Purged CSS, optimal bundles
88
- 2. **chakra-ui-expert** - Tree-shakeable, efficient
89
- 3. **bootstrap-ui-expert** - Minimal JS overhead
88
+ 2. **react-frontend-engineer** - Tree-shakeable, efficient
89
+ 3. **react-ui-expert** - Minimal JS overhead
90
90
 
91
91
  #### Accessibility Required
92
- 1. **chakra-ui-expert** - Accessibility-first design
93
- 2. **mui-react-expert** - ARIA compliance built-in
94
- 3. **antd-react-expert** - Enterprise accessibility
92
+ 1. **react-frontend-engineer** - Accessibility-first design
93
+ 2. **react-frontend-engineer** - ARIA compliance built-in
94
+ 3. **react-ui-expert** - Enterprise accessibility
95
95
 
96
96
  #### Mobile-First
97
97
  1. **tailwindcss-expert** - Mobile-first utilities
98
- 2. **bootstrap-ui-expert** - Mobile-first grid
99
- 3. **chakra-ui-expert** - Responsive design patterns
98
+ 2. **react-ui-expert** - Mobile-first grid
99
+ 3. **react-frontend-engineer** - Responsive design patterns
100
100
 
101
101
  ### Industry/Domain
102
102
 
103
103
  #### Financial Services
104
- **Primary: antd-react-expert**
104
+ **Primary: react-ui-expert**
105
105
  - Data-heavy interfaces
106
106
  - Professional appearance
107
107
  - Complex forms/tables
108
108
  - Enterprise features
109
109
 
110
110
  #### Healthcare
111
- **Primary: mui-react-expert**
111
+ **Primary: react-frontend-engineer**
112
112
  - Accessibility compliance
113
113
  - Professional UI standards
114
114
  - Form-heavy applications
@@ -122,7 +122,7 @@ Use this matrix to choose the right UI framework agent based on your project req
122
122
  - Marketing integration
123
123
 
124
124
  #### SaaS Products
125
- **Primary: chakra-ui-expert**
125
+ **Primary: react-frontend-engineer**
126
126
  - Modern user expectations
127
127
  - Dashboard interfaces
128
128
  - Component flexibility
@@ -138,13 +138,13 @@ Use this matrix to choose the right UI framework agent based on your project req
138
138
 
139
139
  #### From Material-UI v4 → v5
140
140
  - **Reason**: Keep existing investment
141
- - **Agent**: mui-react-expert
141
+ - **Agent**: react-frontend-engineer
142
142
  - **Effort**: Moderate (migration guide available)
143
143
  - **Benefits**: Better performance, new features
144
144
 
145
145
  #### From Custom CSS → Component Library
146
146
  - **Reason**: Faster development, consistency
147
- - **Agent**: chakra-ui-expert (modern) or bootstrap-ui-expert (familiar)
147
+ - **Agent**: react-frontend-engineer (modern) or react-ui-expert (familiar)
148
148
  - **Effort**: Moderate to High
149
149
  - **Benefits**: Accessibility, maintainability
150
150
 
@@ -153,41 +153,41 @@ Use this matrix to choose the right UI framework agent based on your project req
153
153
  Ask these questions to determine the best agent:
154
154
 
155
155
  1. **What is the primary use case?**
156
- - Admin dashboard → antd-react-expert
157
- - Marketing site → bootstrap-ui-expert or tailwindcss-expert
158
- - SaaS product → chakra-ui-expert or mui-react-expert
156
+ - Admin dashboard → react-ui-expert
157
+ - Marketing site → react-ui-expert or tailwindcss-expert
158
+ - SaaS product → react-frontend-engineer or react-frontend-engineer
159
159
 
160
160
  2. **What is the team's experience level?**
161
- - Junior team → bootstrap-ui-expert or chakra-ui-expert
162
- - Senior team → tailwindcss-expert or mui-react-expert
161
+ - Junior team → react-ui-expert or react-frontend-engineer
162
+ - Senior team → tailwindcss-expert or react-frontend-engineer
163
163
 
164
164
  3. **How important is design flexibility?**
165
165
  - Critical → tailwindcss-expert
166
- - Important → chakra-ui-expert
167
- - Standard → mui-react-expert or antd-react-expert
168
- - Basic → bootstrap-ui-expert
166
+ - Important → react-frontend-engineer
167
+ - Standard → react-frontend-engineer or react-ui-expert
168
+ - Basic → react-ui-expert
169
169
 
170
170
  4. **What are the performance requirements?**
171
- - Critical → tailwindcss-expert or chakra-ui-expert
172
- - Important → mui-react-expert (with optimization)
173
- - Standard → antd-react-expert or bootstrap-ui-expert
171
+ - Critical → tailwindcss-expert or react-frontend-engineer
172
+ - Important → react-frontend-engineer (with optimization)
173
+ - Standard → react-ui-expert or react-frontend-engineer
174
174
 
175
175
  5. **Is accessibility a requirement?**
176
- - Critical → chakra-ui-expert or mui-react-expert
177
- - Important → antd-react-expert
178
- - Standard → bootstrap-ui-expert or tailwindcss-expert (with extra work)
176
+ - Critical → react-frontend-engineer or react-ui-expert
177
+ - Important → react-ui-expert
178
+ - Standard → react-ui-expert or tailwindcss-expert (with extra work)
179
179
 
180
180
  6. **What type of data interfaces are needed?**
181
- - Complex tables → antd-react-expert or mui-react-expert
181
+ - Complex tables → react-ui-expert or react-frontend-engineer
182
182
  - Forms → All frameworks suitable
183
- - Charts/visualization → mui-react-expert or tailwindcss-expert
184
- - Simple content → bootstrap-ui-expert or chakra-ui-expert
183
+ - Charts/visualization → react-frontend-engineer or tailwindcss-expert
184
+ - Simple content → react-ui-expert or react-frontend-engineer
185
185
 
186
186
  ## Agent Selection Examples
187
187
 
188
188
  ### Example 1: B2B SaaS Dashboard
189
189
  **Requirements**: Professional look, complex data tables, user management, responsive
190
- **Choice**: antd-react-expert
190
+ **Choice**: react-ui-expert
191
191
  **Reasoning**: ProTable for data, enterprise components, professional design
192
192
 
193
193
  ### Example 2: Consumer Mobile App
@@ -197,15 +197,15 @@ Ask these questions to determine the best agent:
197
197
 
198
198
  ### Example 3: Startup MVP
199
199
  **Requirements**: Fast development, standard UI patterns, small team, limited budget
200
- **Choice**: bootstrap-ui-expert
200
+ **Choice**: react-ui-expert
201
201
  **Reasoning**: Fastest development, familiar patterns, extensive resources
202
202
 
203
203
  ### Example 4: Design System Creation
204
204
  **Requirements**: Component library, design tokens, accessibility, maintainability
205
- **Choice**: chakra-ui-expert
205
+ **Choice**: react-frontend-engineer
206
206
  **Reasoning**: Built for design systems, accessibility-first, component composition
207
207
 
208
208
  ### Example 5: Material Design Application
209
209
  **Requirements**: Google Material Design, complex components, data visualization
210
- **Choice**: mui-react-expert
210
+ **Choice**: react-frontend-engineer
211
211
  **Reasoning**: Official Material Design implementation, advanced components
@@ -300,7 +300,7 @@ Before delivering GitHub configurations:
300
300
 
301
301
  - **react-frontend-engineer**: Frontend deployment workflows
302
302
  - **python-backend-engineer**: Backend CI/CD pipelines
303
- - **playwright-test-engineer**: E2E testing in workflows
303
+ - **frontend-testing-engineer**: E2E testing in workflows
304
304
  - **kubernetes-orchestrator**: Deployment to K8s clusters
305
305
  - **azure-devops-specialist**: Cross-platform integration
306
306
 
@@ -9,22 +9,22 @@ Specialized agents for specific frameworks and libraries. These agents understan
9
9
  - **Styling**: Tailwind CSS, CSS-in-JS, responsive design
10
10
  - **Features**: SSR/SSG, performance optimization, accessibility
11
11
 
12
- ### 🎭 playwright-test-engineer
12
+ ### 🎭 frontend-testing-engineer
13
13
  - **Expertise**: Playwright, E2E testing, visual regression
14
14
  - **Features**: Cross-browser testing, parallel execution
15
15
  - **Integration**: MCP browser control, CI/CD pipelines
16
16
 
17
- ### 🎭 playwright-mcp-frontend-tester
17
+ ### 🎭 frontend-testing-engineer
18
18
  - **Expertise**: Advanced Playwright with MCP browser control
19
19
  - **Features**: Visual testing, accessibility audits, UX validation
20
20
  - **Specialties**: Real browser control, performance monitoring, WCAG compliance
21
21
 
22
- ### 🚀 fastapi-backend-engineer
22
+ ### 🚀 python-backend-engineer
23
23
  - **Expertise**: FastAPI, Pydantic, async Python, OpenAPI
24
24
  - **Features**: High-performance APIs, WebSockets, background tasks
25
25
  - **Integration**: SQLAlchemy, Redis, Celery, authentication
26
26
 
27
- ### 🍶 flask-backend-engineer
27
+ ### 🍶 python-backend-engineer
28
28
  - **Expertise**: Flask, Blueprints, Flask extensions ecosystem
29
29
  - **Features**: Web apps, REST APIs, Jinja2 templates
30
30
  - **Integration**: Flask-SQLAlchemy, Flask-Login, Flask-RESTful
@@ -43,7 +43,7 @@ Specialized agents for specific frameworks and libraries. These agents understan
43
43
  - **Expertise**: Next.js 14+, App Router, Server Components
44
44
  - **Features**: ISR, API routes, middleware
45
45
 
46
- ### 🔥 fastapi-backend-engineer
46
+ ### 🔥 python-backend-engineer
47
47
  - **Expertise**: FastAPI, Pydantic, async Python
48
48
  - **Features**: OpenAPI, WebSocket, background tasks
49
49
 
@@ -192,7 +192,7 @@ test('visual regression', async ({ page }) => {
192
192
  - mcp__playwright__fill
193
193
 
194
194
  ## Integration Points
195
- - Tests applications from: react-ui-expert, python-backend-expert
195
+ - Tests applications from: react-frontend-engineer, python-backend-engineer
196
196
  - Validates deployments by: kubernetes-orchestrator
197
197
  - Reports to: github-operations-specialist
198
198
  - Uses infrastructure from: docker-containerization-expert
@@ -130,7 +130,7 @@ Use these queries:
130
130
 
131
131
  ## Integration Points
132
132
 
133
- - Works with: kubernetes-orchestrator, docker-expert, nodejs-backend-engineer, python-backend-engineer, github-operations-specialist
133
+ - Works with: kubernetes-orchestrator, docker-containerization-expert, nodejs-backend-engineer, python-backend-engineer, github-operations-specialist
134
134
  - Provides to: Microservices, event systems, real-time apps, distributed systems
135
135
  - Client libraries: Go, Python, Node.js, Java, C#, Rust
136
136
 
@@ -191,7 +191,7 @@ Before delivering code:
191
191
  **Integration with Other Agents:**
192
192
 
193
193
  - **python-backend-engineer**: API contract definition and type generation
194
- - **playwright-test-engineer**: E2E test scenarios and component interaction testing
194
+ - **frontend-testing-engineer**: E2E test scenarios and component interaction testing
195
195
  - **azure-devops-specialist**: CI/CD pipeline for build and deployment
196
196
  - **github-operations-specialist**: PR workflows and code review automation
197
197
 
@@ -137,9 +137,9 @@ accessibility_level:
137
137
  - Agent
138
138
 
139
139
  ## Integration Points
140
- - Works with: react-frontend-engineer, playwright-test-engineer
141
- - Provides UI for: python-backend-expert, nodejs-backend-engineer
142
- - Tested by: e2e-test-engineer
140
+ - Works with: react-frontend-engineer, frontend-testing-engineer
141
+ - Provides UI for: python-backend-engineer, nodejs-backend-engineer
142
+ - Tested by: frontend-testing-engineer
143
143
 
144
144
  ## Example Invocation
145
145