proagents 1.6.16 → 1.6.18

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 (170) hide show
  1. package/.claude/settings.local.json +169 -0
  2. package/COMMANDS.md +595 -0
  3. package/README.md +22 -64
  4. package/bin/proagents.js +0 -2
  5. package/lib/commands/init.js +4 -174
  6. package/package.json +2 -7
  7. package/.proagents/ai-models/README.md +0 -141
  8. package/.proagents/ai-models/cost-management.md +0 -362
  9. package/.proagents/ai-models/fallbacks.md +0 -342
  10. package/.proagents/ai-models/model-config.md +0 -318
  11. package/.proagents/ai-models/task-routing.md +0 -503
  12. package/.proagents/ai-training/README.md +0 -155
  13. package/.proagents/ai-training/continuous-learning.md +0 -413
  14. package/.proagents/ai-training/domain-knowledge.md +0 -378
  15. package/.proagents/ai-training/pattern-learning.md +0 -455
  16. package/.proagents/ai-training/training-data.md +0 -337
  17. package/.proagents/ai-training/user-preferences.md +0 -346
  18. package/.proagents/approval-workflows/README.md +0 -146
  19. package/.proagents/approval-workflows/approval-config.md +0 -332
  20. package/.proagents/approval-workflows/approval-stages.md +0 -503
  21. package/.proagents/approval-workflows/emergency-bypass.md +0 -351
  22. package/.proagents/approval-workflows/examples.md +0 -859
  23. package/.proagents/approval-workflows/notifications.md +0 -320
  24. package/.proagents/compliance/README.md +0 -206
  25. package/.proagents/compliance/access-control.md +0 -310
  26. package/.proagents/compliance/audit-logging.md +0 -444
  27. package/.proagents/compliance/compliance-frameworks.md +0 -429
  28. package/.proagents/compliance/reports.md +0 -491
  29. package/.proagents/compliance/retention-policies.md +0 -454
  30. package/.proagents/config-versioning/README.md +0 -120
  31. package/.proagents/config-versioning/changelog.md +0 -300
  32. package/.proagents/config-versioning/rollback.md +0 -283
  33. package/.proagents/config-versioning/versioning.md +0 -330
  34. package/.proagents/contract-testing/README.md +0 -223
  35. package/.proagents/contract-testing/contract-testing.md +0 -614
  36. package/.proagents/contract-testing/pact-integration.md +0 -507
  37. package/.proagents/contract-testing/schema-validation.md +0 -565
  38. package/.proagents/dependency-management/README.md +0 -140
  39. package/.proagents/dependency-management/automation.md +0 -363
  40. package/.proagents/dependency-management/compatibility.md +0 -319
  41. package/.proagents/dependency-management/security-scanning.md +0 -413
  42. package/.proagents/dependency-management/update-policies.md +0 -374
  43. package/.proagents/disaster-recovery/README.md +0 -247
  44. package/.proagents/disaster-recovery/automation.md +0 -366
  45. package/.proagents/disaster-recovery/backup-recovery.md +0 -571
  46. package/.proagents/disaster-recovery/incident-response.md +0 -565
  47. package/.proagents/disaster-recovery/rollback-procedures.md +0 -499
  48. package/.proagents/disaster-recovery/runbooks.md +0 -603
  49. package/.proagents/disaster-recovery/scenarios.md +0 -892
  50. package/.proagents/disaster-recovery/testing.md +0 -438
  51. package/.proagents/environments/README.md +0 -244
  52. package/.proagents/environments/configuration.md +0 -437
  53. package/.proagents/environments/promotion.md +0 -434
  54. package/.proagents/environments/setup.md +0 -420
  55. package/.proagents/examples/README.md +0 -55
  56. package/.proagents/examples/backend-nodejs/README.md +0 -188
  57. package/.proagents/examples/backend-nodejs/complete-conversation.md +0 -601
  58. package/.proagents/examples/backend-nodejs/proagents.config.yaml +0 -415
  59. package/.proagents/examples/backend-nodejs/workflow-example.md +0 -909
  60. package/.proagents/examples/fullstack-nextjs/README.md +0 -155
  61. package/.proagents/examples/fullstack-nextjs/complete-conversation.md +0 -604
  62. package/.proagents/examples/fullstack-nextjs/proagents.config.yaml +0 -287
  63. package/.proagents/examples/fullstack-nextjs/workflow-example.md +0 -553
  64. package/.proagents/examples/mobile-react-native/README.md +0 -171
  65. package/.proagents/examples/mobile-react-native/complete-conversation.md +0 -825
  66. package/.proagents/examples/mobile-react-native/proagents.config.yaml +0 -330
  67. package/.proagents/examples/mobile-react-native/workflow-example.md +0 -723
  68. package/.proagents/examples/web-frontend-react/README.md +0 -125
  69. package/.proagents/examples/web-frontend-react/complete-conversation.md +0 -556
  70. package/.proagents/examples/web-frontend-react/proagents.config.yaml +0 -183
  71. package/.proagents/examples/web-frontend-react/workflow-example.md +0 -603
  72. package/.proagents/existing-projects/README.md +0 -65
  73. package/.proagents/existing-projects/challenges.md +0 -861
  74. package/.proagents/existing-projects/coexistence-mode.md +0 -483
  75. package/.proagents/existing-projects/compatibility-assessment.md +0 -541
  76. package/.proagents/existing-projects/gradual-adoption.md +0 -515
  77. package/.proagents/existing-projects/migration-strategies.md +0 -788
  78. package/.proagents/existing-projects/pattern-reconciliation.md +0 -489
  79. package/.proagents/existing-projects/team-onboarding.md +0 -617
  80. package/.proagents/existing-projects/technical-debt-handling.md +0 -644
  81. package/.proagents/feature-flags/README.md +0 -263
  82. package/.proagents/feature-flags/ab-testing.md +0 -413
  83. package/.proagents/feature-flags/configuration.md +0 -420
  84. package/.proagents/feature-flags/kill-switches.md +0 -444
  85. package/.proagents/feature-flags/rollout-strategies.md +0 -392
  86. package/.proagents/history.log +0 -12
  87. package/.proagents/i18n/README.md +0 -133
  88. package/.proagents/i18n/extraction.md +0 -433
  89. package/.proagents/i18n/tms-integration.md +0 -332
  90. package/.proagents/i18n/translation-workflow.md +0 -413
  91. package/.proagents/i18n/validation.md +0 -355
  92. package/.proagents/logging/README.md +0 -276
  93. package/.proagents/logging/aggregation.md +0 -475
  94. package/.proagents/logging/log-levels.md +0 -376
  95. package/.proagents/logging/sensitive-data.md +0 -423
  96. package/.proagents/logging/structured-logging.md +0 -406
  97. package/.proagents/metrics/README.md +0 -69
  98. package/.proagents/metrics/code-quality-kpis.md +0 -461
  99. package/.proagents/metrics/deployment-metrics.md +0 -517
  100. package/.proagents/metrics/developer-productivity.md +0 -368
  101. package/.proagents/metrics/learning-effectiveness.md +0 -478
  102. package/.proagents/migrations/README.md +0 -77
  103. package/.proagents/migrations/from-claude-projects.md +0 -313
  104. package/.proagents/migrations/from-cursor-rules.md +0 -345
  105. package/.proagents/migrations/from-custom-workflows.md +0 -410
  106. package/.proagents/monitoring/README.md +0 -308
  107. package/.proagents/monitoring/alerting.md +0 -449
  108. package/.proagents/monitoring/dashboards.md +0 -454
  109. package/.proagents/monitoring/health-checks.md +0 -436
  110. package/.proagents/monitoring/metrics.md +0 -434
  111. package/.proagents/multi-project/README.md +0 -170
  112. package/.proagents/multi-project/coordinated-deploy.md +0 -510
  113. package/.proagents/multi-project/cross-project-deps.md +0 -395
  114. package/.proagents/multi-project/unified-changelog.md +0 -477
  115. package/.proagents/multi-project/walkthroughs/monorepo-setup.md +0 -787
  116. package/.proagents/multi-project/workspace-config.md +0 -408
  117. package/.proagents/notifications/README.md +0 -151
  118. package/.proagents/notifications/channels.md +0 -457
  119. package/.proagents/notifications/preferences.md +0 -415
  120. package/.proagents/notifications/routing.md +0 -449
  121. package/.proagents/notifications/scheduling.md +0 -425
  122. package/.proagents/notifications/templates.md +0 -446
  123. package/.proagents/offline-mode/README.md +0 -145
  124. package/.proagents/offline-mode/caching.md +0 -344
  125. package/.proagents/offline-mode/offline-operations.md +0 -312
  126. package/.proagents/offline-mode/queue-specifications.md +0 -679
  127. package/.proagents/offline-mode/sync.md +0 -475
  128. package/.proagents/parallel-features/README.md +0 -85
  129. package/.proagents/parallel-features/conflict-detection.md +0 -226
  130. package/.proagents/parallel-features/dependency-management.md +0 -392
  131. package/.proagents/parallel-features/merge-coordination.md +0 -506
  132. package/.proagents/parallel-features/tracking-system.md +0 -416
  133. package/.proagents/performance/README.md +0 -59
  134. package/.proagents/performance/bundle-analysis.md +0 -375
  135. package/.proagents/performance/load-testing.md +0 -563
  136. package/.proagents/performance/runtime-metrics.md +0 -489
  137. package/.proagents/performance/web-vitals.md +0 -425
  138. package/.proagents/plugins/README.md +0 -139
  139. package/.proagents/plugins/creating-plugins.md +0 -504
  140. package/.proagents/plugins/plugin-api.md +0 -467
  141. package/.proagents/plugins/plugin-registry.md +0 -276
  142. package/.proagents/reporting/README.md +0 -158
  143. package/.proagents/reporting/dashboards.md +0 -366
  144. package/.proagents/reporting/exports.md +0 -524
  145. package/.proagents/reporting/quality-metrics.md +0 -385
  146. package/.proagents/reporting/templates/README.md +0 -56
  147. package/.proagents/reporting/templates/dashboard-config.json +0 -187
  148. package/.proagents/reporting/templates/metrics-queries.md +0 -427
  149. package/.proagents/reporting/templates/react-dashboard.tsx +0 -544
  150. package/.proagents/reporting/templates/widgets.md +0 -451
  151. package/.proagents/reporting/velocity-metrics.md +0 -340
  152. package/.proagents/reverse-engineering/README.md +0 -151
  153. package/.proagents/reverse-engineering/architecture-extraction.md +0 -325
  154. package/.proagents/reverse-engineering/code-analysis.md +0 -377
  155. package/.proagents/reverse-engineering/dependency-mapping.md +0 -567
  156. package/.proagents/reverse-engineering/diagram-generation.md +0 -586
  157. package/.proagents/reverse-engineering/documentation-generation.md +0 -468
  158. package/.proagents/reverse-engineering/pattern-detection.md +0 -569
  159. package/.proagents/reverse-engineering/quality-assessment.md +0 -733
  160. package/.proagents/secrets/README.md +0 -278
  161. package/.proagents/secrets/access-control.md +0 -443
  162. package/.proagents/secrets/rotation.md +0 -403
  163. package/.proagents/secrets/scanning.md +0 -487
  164. package/.proagents/secrets/storage.md +0 -394
  165. package/.proagents/webhooks/README.md +0 -126
  166. package/.proagents/webhooks/endpoints.md +0 -298
  167. package/.proagents/webhooks/events.md +0 -316
  168. package/.proagents/webhooks/payloads.md +0 -325
  169. package/.proagents/webhooks/reliability.md +0 -363
  170. package/.proagents/webhooks/security.md +0 -380
@@ -1,416 +0,0 @@
1
- # Feature Tracking System
2
-
3
- Track multiple features simultaneously with clear status visibility.
4
-
5
- ---
6
-
7
- ## Overview
8
-
9
- The tracking system provides:
10
- - Real-time feature status
11
- - Progress tracking per phase
12
- - Resource allocation visibility
13
- - Blocker identification
14
- - Timeline management
15
-
16
- ---
17
-
18
- ## Tracking Structure
19
-
20
- ### Feature Directory
21
-
22
- ```
23
- /.proagents/active-features/
24
- ├── _index.json # Master index
25
- ├── _dashboard.md # Human-readable dashboard
26
- ├── feature-user-auth/
27
- │ ├── status.json # Machine-readable status
28
- │ ├── status.md # Human-readable status
29
- │ ├── requirements.md # Requirements document
30
- │ ├── design.md # Design document
31
- │ ├── implementation-plan.md # Implementation plan
32
- │ ├── files-modified.json # Files touched by feature
33
- │ ├── dependencies.json # Feature dependencies
34
- │ └── timeline.json # Phase timeline
35
- ├── feature-dashboard/
36
- │ └── ...
37
- └── feature-notifications/
38
- └── ...
39
- ```
40
-
41
- ---
42
-
43
- ## Master Index
44
-
45
- ```json
46
- // _index.json
47
- {
48
- "last_updated": "2024-01-15T14:30:00Z",
49
- "active_features": [
50
- {
51
- "id": "feature-user-auth",
52
- "name": "User Authentication",
53
- "status": "in_progress",
54
- "current_phase": "implementation",
55
- "phase_progress": 60,
56
- "branch": "feature/user-auth",
57
- "assignee": "developer-1",
58
- "started": "2024-01-10T09:00:00Z",
59
- "estimated_completion": "2024-01-20",
60
- "blockers": [],
61
- "priority": "high"
62
- },
63
- {
64
- "id": "feature-dashboard",
65
- "name": "User Dashboard",
66
- "status": "blocked",
67
- "current_phase": "implementation",
68
- "phase_progress": 30,
69
- "branch": "feature/dashboard",
70
- "assignee": "developer-2",
71
- "started": "2024-01-12T09:00:00Z",
72
- "blockers": ["Waiting for user-auth API"],
73
- "priority": "medium"
74
- }
75
- ],
76
- "completed_features": [
77
- {
78
- "id": "feature-login-page",
79
- "name": "Login Page",
80
- "completed": "2024-01-08",
81
- "branch": "feature/login-page",
82
- "merged_to": "main"
83
- }
84
- ],
85
- "paused_features": []
86
- }
87
- ```
88
-
89
- ---
90
-
91
- ## Feature Status
92
-
93
- ```json
94
- // feature-user-auth/status.json
95
- {
96
- "id": "feature-user-auth",
97
- "name": "User Authentication",
98
- "description": "Implement user login, registration, and session management",
99
-
100
- "status": "in_progress",
101
- "priority": "high",
102
- "assignee": "developer-1",
103
-
104
- "branch": {
105
- "name": "feature/user-auth",
106
- "base": "develop",
107
- "commits": 15,
108
- "behind_base": 2
109
- },
110
-
111
- "phases": {
112
- "init": { "status": "completed", "completed_at": "2024-01-10T10:00:00Z" },
113
- "analysis": { "status": "completed", "completed_at": "2024-01-10T12:00:00Z" },
114
- "requirements": { "status": "completed", "completed_at": "2024-01-10T14:00:00Z" },
115
- "design": { "status": "completed", "completed_at": "2024-01-11T12:00:00Z" },
116
- "planning": { "status": "completed", "completed_at": "2024-01-11T16:00:00Z" },
117
- "implementation": { "status": "in_progress", "progress": 60 },
118
- "testing": { "status": "pending" },
119
- "review": { "status": "pending" },
120
- "documentation": { "status": "pending" },
121
- "deployment": { "status": "pending" }
122
- },
123
-
124
- "current_task": "Implementing password reset flow",
125
-
126
- "timeline": {
127
- "started": "2024-01-10T09:00:00Z",
128
- "estimated_completion": "2024-01-20T17:00:00Z",
129
- "actual_hours": 24,
130
- "estimated_remaining_hours": 16
131
- },
132
-
133
- "files_modified": [
134
- "src/features/auth/components/LoginForm.tsx",
135
- "src/features/auth/hooks/useAuth.ts",
136
- "src/features/auth/services/authService.ts",
137
- "src/lib/api.ts"
138
- ],
139
-
140
- "dependencies": {
141
- "depends_on": [],
142
- "blocks": ["feature-dashboard", "feature-notifications"]
143
- },
144
-
145
- "blockers": [],
146
- "risks": [
147
- {
148
- "description": "OAuth provider integration may take longer",
149
- "impact": "medium",
150
- "mitigation": "Start with email/password first"
151
- }
152
- ],
153
-
154
- "notes": [
155
- {
156
- "date": "2024-01-12",
157
- "author": "developer-1",
158
- "content": "Decided to use JWT instead of sessions"
159
- }
160
- ]
161
- }
162
- ```
163
-
164
- ---
165
-
166
- ## Human-Readable Status
167
-
168
- ```markdown
169
- <!-- feature-user-auth/status.md -->
170
- # Feature: User Authentication
171
-
172
- ## Quick Status
173
-
174
- | Attribute | Value |
175
- |-----------|-------|
176
- | **Status** | 🔄 In Progress |
177
- | **Phase** | Implementation (60%) |
178
- | **Assignee** | developer-1 |
179
- | **Branch** | feature/user-auth |
180
- | **Started** | 2024-01-10 |
181
- | **ETA** | 2024-01-20 |
182
-
183
- ## Phase Progress
184
-
185
- ```
186
- ✅ Init ██████████ 100%
187
- ✅ Analysis ██████████ 100%
188
- ✅ Requirements ██████████ 100%
189
- ✅ Design ██████████ 100%
190
- ✅ Planning ██████████ 100%
191
- 🔄 Implementation ██████░░░░ 60%
192
- ⏳ Testing ░░░░░░░░░░ 0%
193
- ⏳ Review ░░░░░░░░░░ 0%
194
- ⏳ Documentation ░░░░░░░░░░ 0%
195
- ⏳ Deployment ░░░░░░░░░░ 0%
196
- ```
197
-
198
- ## Current Task
199
- Implementing password reset flow
200
-
201
- ## Files Modified
202
- - `src/features/auth/components/LoginForm.tsx`
203
- - `src/features/auth/hooks/useAuth.ts`
204
- - `src/features/auth/services/authService.ts`
205
- - `src/lib/api.ts`
206
-
207
- ## Blockers
208
- None
209
-
210
- ## Dependencies
211
- - **Blocks:** feature-dashboard, feature-notifications
212
- - **Depends on:** None
213
-
214
- ## Timeline
215
- - Started: 2024-01-10
216
- - Actual hours: 24h
217
- - Remaining: ~16h
218
- - On track: ✅ Yes
219
-
220
- ## Notes
221
- - 2024-01-12: Decided to use JWT instead of sessions
222
- ```
223
-
224
- ---
225
-
226
- ## Dashboard View
227
-
228
- ```markdown
229
- <!-- _dashboard.md -->
230
- # ProAgents Feature Dashboard
231
-
232
- **Last Updated:** 2024-01-15 14:30 UTC
233
-
234
- ## Active Features: 3 / 5 (max)
235
-
236
- ### 🔄 In Progress
237
-
238
- | Feature | Phase | Progress | Assignee | ETA | Status |
239
- |---------|-------|----------|----------|-----|--------|
240
- | User Auth | Implementation | 60% | dev-1 | Jan 20 | ✅ On track |
241
- | Dashboard | Implementation | 30% | dev-2 | Jan 25 | ⚠️ Blocked |
242
- | Settings | Design | 80% | dev-3 | Jan 22 | ✅ On track |
243
-
244
- ### ⏸️ Blocked
245
-
246
- | Feature | Blocked By | Since |
247
- |---------|------------|-------|
248
- | Dashboard | Waiting for User Auth API | 2 days |
249
-
250
- ### ✅ Recently Completed
251
-
252
- | Feature | Completed | Merged |
253
- |---------|-----------|--------|
254
- | Login Page | Jan 8 | ✅ |
255
- | Footer | Jan 5 | ✅ |
256
-
257
- ---
258
-
259
- ## Dependency Graph
260
-
261
- ```
262
- user-auth ─────┬──▶ dashboard ──▶ notifications
263
-
264
- └──▶ settings
265
- ```
266
-
267
- ## Conflict Alerts
268
-
269
- ⚠️ **1 potential conflict detected:**
270
- - `src/lib/api.ts` modified by both `user-auth` and `dashboard`
271
-
272
- ## Recommended Actions
273
-
274
- 1. Merge `user-auth` first to unblock `dashboard`
275
- 2. Review potential conflict in `api.ts`
276
- 3. Consider starting `notifications` after `dashboard` unblocked
277
- ```
278
-
279
- ---
280
-
281
- ## Progress Tracking
282
-
283
- ### Phase Completion
284
-
285
- ```typescript
286
- // Update phase status
287
- async function updatePhaseStatus(
288
- featureId: string,
289
- phase: string,
290
- status: 'completed' | 'in_progress' | 'pending',
291
- progress?: number
292
- ) {
293
- const statusFile = `active-features/${featureId}/status.json`;
294
- const featureStatus = await readJSON(statusFile);
295
-
296
- featureStatus.phases[phase] = {
297
- status,
298
- progress,
299
- ...(status === 'completed' && { completed_at: new Date().toISOString() }),
300
- };
301
-
302
- // Update current phase
303
- if (status === 'in_progress') {
304
- featureStatus.current_phase = phase;
305
- }
306
-
307
- await writeJSON(statusFile, featureStatus);
308
- await updateIndex();
309
- await generateDashboard();
310
- }
311
- ```
312
-
313
- ### Time Tracking
314
-
315
- ```yaml
316
- time_tracking:
317
- feature_id: "feature-user-auth"
318
-
319
- by_phase:
320
- init: { hours: 0.5 }
321
- analysis: { hours: 2 }
322
- requirements: { hours: 1.5 }
323
- design: { hours: 4 }
324
- planning: { hours: 2 }
325
- implementation: { hours: 16, in_progress: true }
326
- testing: { hours: 0, estimated: 6 }
327
- review: { hours: 0, estimated: 2 }
328
- documentation: { hours: 0, estimated: 2 }
329
- deployment: { hours: 0, estimated: 1 }
330
-
331
- totals:
332
- actual: 26
333
- estimated_remaining: 11
334
- original_estimate: 40
335
- variance: "-3 hours"
336
- ```
337
-
338
- ---
339
-
340
- ## Notifications
341
-
342
- ```yaml
343
- notifications:
344
- triggers:
345
- - event: "phase_completed"
346
- notify: ["assignee", "team_lead"]
347
- channel: "slack"
348
-
349
- - event: "blocker_added"
350
- notify: ["assignee", "blocking_feature_owner"]
351
- channel: "slack"
352
- priority: "high"
353
-
354
- - event: "behind_schedule"
355
- notify: ["assignee", "team_lead"]
356
- channel: "email"
357
-
358
- - event: "ready_for_review"
359
- notify: ["reviewers"]
360
- channel: "slack"
361
-
362
- templates:
363
- phase_completed: |
364
- ✅ Feature "{{feature_name}}" completed phase: {{phase}}
365
- Progress: {{overall_progress}}%
366
-
367
- blocker_added: |
368
- ⚠️ Feature "{{feature_name}}" is now blocked
369
- Blocker: {{blocker_description}}
370
- Blocked by: {{blocking_feature}}
371
- ```
372
-
373
- ---
374
-
375
- ## Configuration
376
-
377
- ```yaml
378
- # proagents.config.yaml
379
-
380
- tracking:
381
- enabled: true
382
-
383
- features:
384
- max_concurrent: 5
385
- require_assignee: true
386
- require_estimate: true
387
-
388
- phases:
389
- track_time: true
390
- require_completion: true
391
-
392
- dashboard:
393
- auto_generate: true
394
- refresh_interval: "5m"
395
-
396
- notifications:
397
- enabled: true
398
- channels: ["slack"]
399
-
400
- reporting:
401
- daily_summary: true
402
- weekly_report: true
403
- ```
404
-
405
- ---
406
-
407
- ## Commands
408
-
409
- | Command | Description |
410
- |---------|-------------|
411
- | `pa:feature-status` | View all features status |
412
- | `pa:feature-status [id]` | View specific feature |
413
- | `pa:feature-update [id]` | Update feature status |
414
- | `pa:feature-block [id]` | Mark feature as blocked |
415
- | `pa:feature-unblock [id]` | Remove blocker |
416
- | `pa:feature-dashboard` | View dashboard |
@@ -1,59 +0,0 @@
1
- # Performance Monitoring
2
-
3
- Bundle analysis, runtime metrics, and load testing.
4
-
5
- ---
6
-
7
- ## Overview
8
-
9
- Track and optimize application performance throughout development.
10
-
11
- ## Documentation
12
-
13
- | Document | Description |
14
- |----------|-------------|
15
- | [Bundle Analysis](./bundle-analysis.md) | JavaScript bundle size optimization |
16
- | [Web Vitals](./web-vitals.md) | Core Web Vitals monitoring |
17
- | [Runtime Metrics](./runtime-metrics.md) | Application performance metrics |
18
- | [Load Testing](./load-testing.md) | Stress testing and benchmarks |
19
-
20
- ## Quick Start
21
-
22
- ```bash
23
- # Analyze bundle size
24
- proagents perf bundle
25
-
26
- # Check Web Vitals
27
- proagents perf vitals
28
-
29
- # Run load test
30
- proagents perf load-test --users 100
31
- ```
32
-
33
- ## Key Metrics
34
-
35
- | Metric | Target | Tool |
36
- |--------|--------|------|
37
- | FCP | < 1.8s | Lighthouse |
38
- | LCP | < 2.5s | Core Web Vitals |
39
- | CLS | < 0.1 | Core Web Vitals |
40
- | Bundle Size | < 200KB | webpack-bundle-analyzer |
41
-
42
- ## Configuration
43
-
44
- ```yaml
45
- # proagents.config.yaml
46
- performance:
47
- bundle:
48
- max_size: "200KB"
49
- warn_at: "150KB"
50
-
51
- vitals:
52
- fcp_target: 1800
53
- lcp_target: 2500
54
- cls_target: 0.1
55
-
56
- regression:
57
- block_on_regression: true
58
- threshold: 10 # percent
59
- ```