proagents 1.6.20 → 1.6.21

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 (121) hide show
  1. package/.proagents/custom-commands.yaml +0 -1
  2. package/.proagents/docs/command-details.md +1 -2
  3. package/.proagents/getting-started/ai-training-setup.md +0 -1
  4. package/.proagents/performance/README.md +59 -0
  5. package/.proagents/performance/bundle-analysis.md +375 -0
  6. package/.proagents/performance/load-testing.md +563 -0
  7. package/.proagents/performance/runtime-metrics.md +489 -0
  8. package/.proagents/performance/web-vitals.md +425 -0
  9. package/.proagents/proagents.config.yaml +0 -1
  10. package/.proagents/workflow-modes/entry-modes.md +1 -6
  11. package/lib/commands/init.js +57 -8
  12. package/package.json +1 -1
  13. package/.proagents/api-versioning/README.md +0 -257
  14. package/.proagents/api-versioning/changelog-template.md +0 -225
  15. package/.proagents/api-versioning/deprecation-workflow.md +0 -470
  16. package/.proagents/api-versioning/versioning-strategy.md +0 -291
  17. package/.proagents/automation/README.md +0 -38
  18. package/.proagents/automation/ai-behavior-rules.md +0 -339
  19. package/.proagents/automation/ai-prompt-injection.md +0 -331
  20. package/.proagents/automation/auto-decisions.md +0 -535
  21. package/.proagents/automation/decision-defaults.yaml +0 -317
  22. package/.proagents/cache/README.md +0 -110
  23. package/.proagents/cache/analysis-metadata.json +0 -76
  24. package/.proagents/cache/conventions.json +0 -125
  25. package/.proagents/cache/dependencies.json +0 -85
  26. package/.proagents/cache/features.json +0 -115
  27. package/.proagents/cache/patterns.json +0 -105
  28. package/.proagents/cache/schemas/conventions-schema.json +0 -138
  29. package/.proagents/cache/schemas/dependencies-schema.json +0 -95
  30. package/.proagents/cache/schemas/features-schema.json +0 -104
  31. package/.proagents/cache/schemas/metadata-schema.json +0 -83
  32. package/.proagents/cache/schemas/patterns-schema.json +0 -136
  33. package/.proagents/cache/schemas/structure-schema.json +0 -72
  34. package/.proagents/cache/structure.json +0 -109
  35. package/.proagents/checklists/README.md +0 -261
  36. package/.proagents/checklists/code-quality.md +0 -137
  37. package/.proagents/checklists/code-review.md +0 -148
  38. package/.proagents/checklists/pr-checklist.md +0 -78
  39. package/.proagents/checklists/pre-deployment.md +0 -132
  40. package/.proagents/checklists/pre-implementation.md +0 -80
  41. package/.proagents/checklists/testing.md +0 -120
  42. package/.proagents/checkpoints.json +0 -13
  43. package/.proagents/cicd/README.md +0 -338
  44. package/.proagents/cicd/azure-devops.md +0 -267
  45. package/.proagents/cicd/github-actions.md +0 -375
  46. package/.proagents/cicd/gitlab-ci.md +0 -278
  47. package/.proagents/cicd/jenkins.md +0 -317
  48. package/.proagents/collaboration/README.md +0 -143
  49. package/.proagents/collaboration/roles.md +0 -248
  50. package/.proagents/collaboration/sessions.md +0 -390
  51. package/.proagents/collaboration/sync.md +0 -358
  52. package/.proagents/cost/README.md +0 -48
  53. package/.proagents/cost/cost-template.md +0 -283
  54. package/.proagents/cost/estimation-framework.md +0 -287
  55. package/.proagents/database/README.md +0 -72
  56. package/.proagents/database/examples/001-create-users.sql +0 -129
  57. package/.proagents/database/examples/002-add-preferences.sql +0 -94
  58. package/.proagents/database/examples/003-add-index.sql +0 -105
  59. package/.proagents/database/examples/004-rename-column.sql +0 -122
  60. package/.proagents/database/examples/005-add-foreign-key.sql +0 -142
  61. package/.proagents/database/examples/006-data-migration.sql +0 -196
  62. package/.proagents/database/examples/007-drop-column.sql +0 -163
  63. package/.proagents/database/examples/README.md +0 -89
  64. package/.proagents/database/migration-workflow.md +0 -478
  65. package/.proagents/database/rollback-scripts.md +0 -487
  66. package/.proagents/database/safety-checks.md +0 -447
  67. package/.proagents/git/README.md +0 -68
  68. package/.proagents/git/branch-strategy.md +0 -164
  69. package/.proagents/git/commit-conventions.md +0 -241
  70. package/.proagents/git/pr-workflow.md +0 -286
  71. package/.proagents/git/rollback-procedures.md +0 -416
  72. package/.proagents/ide-integration/README.md +0 -124
  73. package/.proagents/ide-integration/cline-config.md +0 -429
  74. package/.proagents/ide-integration/continue-config.md +0 -380
  75. package/.proagents/ide-integration/cursor-rules.md +0 -280
  76. package/.proagents/ide-integration/github-copilot.md +0 -384
  77. package/.proagents/ide-integration/windsurf-rules.md +0 -314
  78. package/.proagents/integrations/README.md +0 -97
  79. package/.proagents/integrations/pm/README.md +0 -344
  80. package/.proagents/learning/README.md +0 -136
  81. package/.proagents/learning/adaptation.md +0 -305
  82. package/.proagents/learning/data-collection.md +0 -283
  83. package/.proagents/learning/implementation-guide.md +0 -865
  84. package/.proagents/learning/reports.md +0 -306
  85. package/.proagents/mcp/README.md +0 -133
  86. package/.proagents/mcp/context-providers.md +0 -442
  87. package/.proagents/mcp/server-config.md +0 -306
  88. package/.proagents/mcp/tools-definition.md +0 -513
  89. package/.proagents/pm-integration/README.md +0 -151
  90. package/.proagents/pm-integration/asana.md +0 -346
  91. package/.proagents/pm-integration/github-issues.md +0 -308
  92. package/.proagents/pm-integration/gitlab-issues.md +0 -482
  93. package/.proagents/pm-integration/jira.md +0 -364
  94. package/.proagents/pm-integration/linear.md +0 -409
  95. package/.proagents/pm-integration/notion.md +0 -275
  96. package/.proagents/pm-integration/sync-config.md +0 -533
  97. package/.proagents/pm-integration/trello.md +0 -159
  98. package/.proagents/rules/README.md +0 -179
  99. package/.proagents/rules/custom-rules-template.yaml +0 -286
  100. package/.proagents/rules/custom-rules.md +0 -754
  101. package/.proagents/rules/validation-rules-template.yaml +0 -517
  102. package/.proagents/runbooks/README.md +0 -219
  103. package/.proagents/runbooks/dependency-vulnerability.md +0 -505
  104. package/.proagents/runbooks/incident-response.md +0 -451
  105. package/.proagents/runbooks/performance-degradation.md +0 -584
  106. package/.proagents/runbooks/production-debugging.md +0 -489
  107. package/.proagents/sprints/README.md +0 -58
  108. package/.proagents/team/README.md +0 -256
  109. package/.proagents/team/code-ownership.md +0 -306
  110. package/.proagents/team/communication-templates.md +0 -441
  111. package/.proagents/team/handoff-protocol.md +0 -380
  112. package/.proagents/team/ide-setup/README.md +0 -103
  113. package/.proagents/team/ide-setup/cursor.md +0 -276
  114. package/.proagents/team/ide-setup/jetbrains.md +0 -330
  115. package/.proagents/team/ide-setup/neovim.md +0 -640
  116. package/.proagents/team/ide-setup/vscode.md +0 -348
  117. package/.proagents/team/onboarding.md +0 -278
  118. package/.proagents/time-tracking.json +0 -19
  119. package/.proagents/troubleshooting/README.md +0 -730
  120. package/.proagents/troubleshooting/ai-issues.md +0 -601
  121. package/.proagents/troubleshooting/workflow-issues.md +0 -571
@@ -1,306 +0,0 @@
1
- # Learning Reports
2
-
3
- Progress reports showing how ProAgents has improved over time.
4
-
5
- ---
6
-
7
- ## Report Types
8
-
9
- ### 1. Weekly Learning Report
10
-
11
- ```
12
- ┌─────────────────────────────────────────────────────────────────┐
13
- │ ProAgents Learning Report - Week of Jan 15, 2024 │
14
- ├─────────────────────────────────────────────────────────────────┤
15
- │ │
16
- │ SUMMARY │
17
- │ ─────── │
18
- │ Features Completed: 5 │
19
- │ Total Development Time: 18 hours │
20
- │ Time Saved by Learning: ~2.5 hours (estimated) │
21
- │ │
22
- ├─────────────────────────────────────────────────────────────────┤
23
- │ │
24
- │ NEW PATTERNS LEARNED │
25
- │ ──────────────────── │
26
- │ • Component structure pattern (confidence: 95%) │
27
- │ • API error handling pattern (confidence: 88%) │
28
- │ • Test file organization (confidence: 92%) │
29
- │ │
30
- ├─────────────────────────────────────────────────────────────────┤
31
- │ │
32
- │ AUTO-CORRECTIONS APPLIED │
33
- │ ──────────────────────── │
34
- │ • "Use Zustand" applied 8 times │
35
- │ • "Functional components" applied 12 times │
36
- │ • "Colocate tests" applied 6 times │
37
- │ │
38
- ├─────────────────────────────────────────────────────────────────┤
39
- │ │
40
- │ CHECKPOINT OPTIMIZATIONS │
41
- │ ──────────────────────── │
42
- │ • Skipped 15 unnecessary checkpoints │
43
- │ • Estimated time saved: 45 minutes │
44
- │ │
45
- ├─────────────────────────────────────────────────────────────────┤
46
- │ │
47
- │ DECISION ACCURACY │
48
- │ ───────────────── │
49
- │ Auto-decisions made: 45 │
50
- │ ├── Accepted without change: 42 (93%) │
51
- │ ├── Minor adjustments: 2 (4%) │
52
- │ └── Required correction: 1 (3%) │
53
- │ │
54
- └─────────────────────────────────────────────────────────────────┘
55
- ```
56
-
57
- ---
58
-
59
- ### 2. Monthly Progress Report
60
-
61
- ```
62
- ┌─────────────────────────────────────────────────────────────────┐
63
- │ ProAgents Monthly Progress - January 2024 │
64
- ├─────────────────────────────────────────────────────────────────┤
65
- │ │
66
- │ PRODUCTIVITY METRICS │
67
- │ ──────────────────── │
68
- │ │
69
- │ Features Completed ████████████████████ 20 │
70
- │ Bugs Fixed ████████████ 12 │
71
- │ Quick Changes ██████████████████████████ 35 │
72
- │ │
73
- │ Average Feature Time: 3.2 hours (↓ 25% from first month) │
74
- │ Average Bug Fix Time: 35 minutes (↓ 30% from first month) │
75
- │ │
76
- ├─────────────────────────────────────────────────────────────────┤
77
- │ │
78
- │ LEARNING GROWTH │
79
- │ ─────────────── │
80
- │ │
81
- │ Patterns Learned: │
82
- │ Week 1 ████████ 8 │
83
- │ Week 2 ████████████ 12 │
84
- │ Week 3 ██████████ 10 │
85
- │ Week 4 ██████ 6 (stabilizing) │
86
- │ │
87
- │ Total Active Patterns: 36 │
88
- │ Pattern Confidence: 89% average │
89
- │ │
90
- ├─────────────────────────────────────────────────────────────────┤
91
- │ │
92
- │ TIME SAVINGS │
93
- │ ──────────── │
94
- │ │
95
- │ Auto-corrections saved: ~4 hours │
96
- │ Checkpoint skips saved: ~3 hours │
97
- │ Pattern following saved: ~5 hours │
98
- │ Decision automation saved: ~2 hours │
99
- │ ───────────────────────────────────── │
100
- │ Total Estimated Savings: ~14 hours │
101
- │ │
102
- ├─────────────────────────────────────────────────────────────────┤
103
- │ │
104
- │ CORRECTION TRENDS │
105
- │ ───────────────── │
106
- │ │
107
- │ Corrections Needed: │
108
- │ Week 1 ████████████████ 16 │
109
- │ Week 2 ████████████ 12 │
110
- │ Week 3 ████████ 8 │
111
- │ Week 4 ████ 4 │
112
- │ │
113
- │ Trend: ↓ 75% reduction in corrections needed │
114
- │ │
115
- └─────────────────────────────────────────────────────────────────┘
116
- ```
117
-
118
- ---
119
-
120
- ### 3. Pattern Confidence Report
121
-
122
- ```
123
- ┌─────────────────────────────────────────────────────────────────┐
124
- │ Pattern Confidence Report │
125
- ├─────────────────────────────────────────────────────────────────┤
126
- │ │
127
- │ HIGH CONFIDENCE (90%+) - Auto-applied │
128
- │ ───────────────────────────────────── │
129
- │ • Component style: functional ████████████████ 98% │
130
- │ • State management: zustand ████████████████ 96% │
131
- │ • File structure: feature-based ███████████████ 95% │
132
- │ • Styling: tailwind ███████████████ 94% │
133
- │ • Testing: vitest + testing-library ███████████████ 93% │
134
- │ │
135
- ├─────────────────────────────────────────────────────────────────┤
136
- │ │
137
- │ MEDIUM CONFIDENCE (70-89%) - Suggested │
138
- │ ────────────────────────────────────── │
139
- │ • Error handling: error boundaries ██████████████ 85% │
140
- │ • API calls: react-query hooks █████████████ 82% │
141
- │ • Form handling: react-hook-form ████████████ 78% │
142
- │ • Animation: framer-motion ███████████ 72% │
143
- │ │
144
- ├─────────────────────────────────────────────────────────────────┤
145
- │ │
146
- │ LEARNING (Below 70%) - Still gathering data │
147
- │ ─────────────────────────────────────────── │
148
- │ • Caching strategy ████████ 55% │
149
- │ • WebSocket patterns ██████ 45% │
150
- │ • Pagination approach █████ 40% │
151
- │ │
152
- └─────────────────────────────────────────────────────────────────┘
153
- ```
154
-
155
- ---
156
-
157
- ### 4. Decision Accuracy Report
158
-
159
- ```
160
- ┌─────────────────────────────────────────────────────────────────┐
161
- │ Decision Accuracy Report - Last 30 Days │
162
- ├─────────────────────────────────────────────────────────────────┤
163
- │ │
164
- │ OVERALL ACCURACY: 94% │
165
- │ │
166
- │ BY CATEGORY │
167
- │ ─────────── │
168
- │ │
169
- │ Architecture Decisions │
170
- │ ├── Total: 25 │
171
- │ ├── Correct: 24 (96%) │
172
- │ └── Corrected: 1 (4%) │
173
- │ │
174
- │ Code Style Decisions │
175
- │ ├── Total: 120 │
176
- │ ├── Correct: 115 (96%) │
177
- │ └── Corrected: 5 (4%) │
178
- │ │
179
- │ File Location Decisions │
180
- │ ├── Total: 45 │
181
- │ ├── Correct: 42 (93%) │
182
- │ └── Corrected: 3 (7%) │
183
- │ │
184
- │ Implementation Approach │
185
- │ ├── Total: 30 │
186
- │ ├── Correct: 27 (90%) │
187
- │ └── Corrected: 3 (10%) │
188
- │ │
189
- ├─────────────────────────────────────────────────────────────────┤
190
- │ │
191
- │ IMPROVEMENT TREND │
192
- │ ───────────────── │
193
- │ │
194
- │ Month 1: 78% accuracy │
195
- │ Month 2: 87% accuracy (+9%) │
196
- │ Month 3: 94% accuracy (+7%) │
197
- │ │
198
- └─────────────────────────────────────────────────────────────────┘
199
- ```
200
-
201
- ---
202
-
203
- ## Report Generation
204
-
205
- ### Automatic Reports
206
-
207
- ```yaml
208
- reports:
209
- automatic:
210
- weekly:
211
- enabled: true
212
- day: "monday"
213
- notify: true
214
-
215
- monthly:
216
- enabled: true
217
- day: 1
218
- notify: true
219
-
220
- location: ".proagents/reports/"
221
- format: "markdown" # markdown | html | json
222
- ```
223
-
224
- ### On-Demand Reports
225
-
226
- ```bash
227
- # Generate reports via commands
228
- pa:report-learning weekly
229
- pa:report-learning monthly
230
- pa:report-learning patterns
231
- pa:report-learning decisions
232
- pa:report-learning all
233
- ```
234
-
235
- ---
236
-
237
- ## Report Export
238
-
239
- ```yaml
240
- export:
241
- formats:
242
- - markdown
243
- - html
244
- - pdf
245
- - json
246
-
247
- destinations:
248
- - local: ".proagents/reports/"
249
- - notion: false # If Notion integration enabled
250
- - slack: false # If Slack integration enabled
251
- ```
252
-
253
- ---
254
-
255
- ## Insights & Recommendations
256
-
257
- Reports include actionable insights:
258
-
259
- ```
260
- ┌─────────────────────────────────────────────────────────────────┐
261
- │ INSIGHTS & RECOMMENDATIONS │
262
- ├─────────────────────────────────────────────────────────────────┤
263
- │ │
264
- │ 💡 INSIGHTS │
265
- │ │
266
- │ 1. Your component patterns are highly consistent (98%) │
267
- │ → ProAgents can now auto-generate components with │
268
- │ high confidence │
269
- │ │
270
- │ 2. Test file organization varies between features │
271
- │ → Consider standardizing to improve pattern learning │
272
- │ │
273
- │ 3. API error handling has 3 different patterns │
274
- │ → Consolidating would improve auto-decisions │
275
- │ │
276
- ├─────────────────────────────────────────────────────────────────┤
277
- │ │
278
- │ 📋 RECOMMENDATIONS │
279
- │ │
280
- │ 1. Consider disabling "after_testing" checkpoint │
281
- │ → You've skipped it 95% of the time │
282
- │ → Run: pa:config set checkpoints.after_testing false │
283
- │ │
284
- │ 2. Document your preferred caching strategy │
285
- │ → Only 45% confidence, frequently corrected │
286
- │ → Add to: .proagents/standards/architecture-rules.md │
287
- │ │
288
- │ 3. Your features are getting faster to complete! │
289
- │ → Average time down 25% from first month │
290
- │ → Keep using consistent patterns │
291
- │ │
292
- └─────────────────────────────────────────────────────────────────┘
293
- ```
294
-
295
- ---
296
-
297
- ## Commands
298
-
299
- | Command | Description |
300
- |---------|-------------|
301
- | `pa:report-learning` | Show learning summary |
302
- | `pa:report-learning weekly` | Generate weekly report |
303
- | `pa:report-learning monthly` | Generate monthly report |
304
- | `pa:report-patterns` | Pattern confidence report |
305
- | `pa:report-decisions` | Decision accuracy report |
306
- | `pa:report-export [format]` | Export reports |
@@ -1,133 +0,0 @@
1
- # MCP (Model Context Protocol) Integration
2
-
3
- Integrate ProAgents with AI tools that support the Model Context Protocol.
4
-
5
- ---
6
-
7
- ## Overview
8
-
9
- MCP (Model Context Protocol) enables AI assistants like Claude to interact with external tools and data sources. ProAgents provides MCP servers that expose workflow capabilities directly to AI assistants.
10
-
11
- ---
12
-
13
- ## Quick Start
14
-
15
- ### 1. Install the MCP Server
16
-
17
- ```bash
18
- npm install -g @proagents/mcp-server
19
- ```
20
-
21
- ### 2. Configure Claude Desktop
22
-
23
- Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
24
-
25
- ```json
26
- {
27
- "mcpServers": {
28
- "proagents": {
29
- "command": "npx",
30
- "args": ["-y", "@proagents/mcp-server"],
31
- "env": {
32
- "PROAGENTS_PROJECT_PATH": "/path/to/your/project"
33
- }
34
- }
35
- }
36
- }
37
- ```
38
-
39
- ### 3. Restart Claude Desktop
40
-
41
- The ProAgents tools will now be available in Claude.
42
-
43
- ---
44
-
45
- ## Available MCP Tools
46
-
47
- | Tool | Description |
48
- |------|-------------|
49
- | `proagents_init` | Initialize ProAgents in a project |
50
- | `proagents_analyze` | Analyze codebase structure and patterns |
51
- | `proagents_feature_start` | Start a new feature workflow |
52
- | `proagents_feature_status` | Check current feature status |
53
- | `proagents_fix` | Start bug fix workflow |
54
- | `proagents_test` | Run tests |
55
- | `proagents_doc` | Generate documentation |
56
- | `proagents_deploy` | Start deployment workflow |
57
- | `proagents_rollback` | Execute rollback procedures |
58
-
59
- ---
60
-
61
- ## MCP Resources
62
-
63
- ProAgents exposes these resources via MCP:
64
-
65
- | Resource | URI | Description |
66
- |----------|-----|-------------|
67
- | Project Config | `proagents://config` | Current configuration |
68
- | Feature Status | `proagents://features` | Active features |
69
- | Codebase Analysis | `proagents://analysis` | Cached analysis |
70
- | Changelog | `proagents://changelog` | Recent changes |
71
- | Todo List | `proagents://todos` | Current tasks |
72
-
73
- ---
74
-
75
- ## Configuration
76
-
77
- ```yaml
78
- # proagents.config.yaml
79
- mcp:
80
- enabled: true
81
-
82
- # Server settings
83
- server:
84
- port: 3100
85
- host: "localhost"
86
-
87
- # Exposed tools
88
- tools:
89
- - init
90
- - analyze
91
- - feature
92
- - fix
93
- - test
94
- - doc
95
- - deploy
96
- - rollback
97
-
98
- # Exposed resources
99
- resources:
100
- - config
101
- - features
102
- - analysis
103
- - changelog
104
- - todos
105
-
106
- # Security
107
- security:
108
- require_confirmation: true
109
- allowed_operations:
110
- - read
111
- - analyze
112
- - generate
113
- restricted_operations:
114
- - deploy
115
- - delete
116
- ```
117
-
118
- ---
119
-
120
- ## Documentation
121
-
122
- - [Server Configuration](./server-config.md)
123
- - [Tools Definition](./tools-definition.md)
124
- - [Context Providers](./context-providers.md)
125
-
126
- ---
127
-
128
- ## Security Considerations
129
-
130
- 1. **Project Scope**: MCP server only accesses configured project paths
131
- 2. **Confirmation**: Destructive operations require confirmation
132
- 3. **Audit Logging**: All MCP operations are logged
133
- 4. **Rate Limiting**: Configurable rate limits for operations