proagents 1.6.20 → 1.6.22

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 (136) hide show
  1. package/.claude/settings.local.json +3 -1
  2. package/.proagents/.cursorrules +1 -1
  3. package/.proagents/.windsurfrules +1 -1
  4. package/.proagents/AGENTS.md +1 -1
  5. package/.proagents/AI_INSTRUCTIONS.md +29 -1
  6. package/.proagents/BOLT.md +1 -1
  7. package/.proagents/CLAUDE.md +1 -1
  8. package/.proagents/GEMINI.md +1 -1
  9. package/.proagents/KIRO.md +1 -1
  10. package/.proagents/LOVABLE.md +1 -1
  11. package/.proagents/REPLIT.md +1 -1
  12. package/.proagents/custom-commands.yaml +1 -2
  13. package/.proagents/docs/command-details.md +1 -2
  14. package/.proagents/getting-started/ai-training-setup.md +0 -1
  15. package/.proagents/performance/README.md +59 -0
  16. package/.proagents/performance/bundle-analysis.md +375 -0
  17. package/.proagents/performance/load-testing.md +563 -0
  18. package/.proagents/performance/runtime-metrics.md +489 -0
  19. package/.proagents/performance/web-vitals.md +425 -0
  20. package/.proagents/proagents.config.yaml +55 -1
  21. package/.proagents/prompts/11-session-tracking.md +100 -0
  22. package/.proagents/prompts/13-commit.md +426 -0
  23. package/.proagents/workflow-modes/entry-modes.md +1 -6
  24. package/COMMANDS.md +19 -0
  25. package/lib/commands/init.js +62 -11
  26. package/package.json +1 -1
  27. package/.proagents/api-versioning/README.md +0 -257
  28. package/.proagents/api-versioning/changelog-template.md +0 -225
  29. package/.proagents/api-versioning/deprecation-workflow.md +0 -470
  30. package/.proagents/api-versioning/versioning-strategy.md +0 -291
  31. package/.proagents/automation/README.md +0 -38
  32. package/.proagents/automation/ai-behavior-rules.md +0 -339
  33. package/.proagents/automation/ai-prompt-injection.md +0 -331
  34. package/.proagents/automation/auto-decisions.md +0 -535
  35. package/.proagents/automation/decision-defaults.yaml +0 -317
  36. package/.proagents/cache/README.md +0 -110
  37. package/.proagents/cache/analysis-metadata.json +0 -76
  38. package/.proagents/cache/conventions.json +0 -125
  39. package/.proagents/cache/dependencies.json +0 -85
  40. package/.proagents/cache/features.json +0 -115
  41. package/.proagents/cache/patterns.json +0 -105
  42. package/.proagents/cache/schemas/conventions-schema.json +0 -138
  43. package/.proagents/cache/schemas/dependencies-schema.json +0 -95
  44. package/.proagents/cache/schemas/features-schema.json +0 -104
  45. package/.proagents/cache/schemas/metadata-schema.json +0 -83
  46. package/.proagents/cache/schemas/patterns-schema.json +0 -136
  47. package/.proagents/cache/schemas/structure-schema.json +0 -72
  48. package/.proagents/cache/structure.json +0 -109
  49. package/.proagents/checklists/README.md +0 -261
  50. package/.proagents/checklists/code-quality.md +0 -137
  51. package/.proagents/checklists/code-review.md +0 -148
  52. package/.proagents/checklists/pr-checklist.md +0 -78
  53. package/.proagents/checklists/pre-deployment.md +0 -132
  54. package/.proagents/checklists/pre-implementation.md +0 -80
  55. package/.proagents/checklists/testing.md +0 -120
  56. package/.proagents/checkpoints.json +0 -13
  57. package/.proagents/cicd/README.md +0 -338
  58. package/.proagents/cicd/azure-devops.md +0 -267
  59. package/.proagents/cicd/github-actions.md +0 -375
  60. package/.proagents/cicd/gitlab-ci.md +0 -278
  61. package/.proagents/cicd/jenkins.md +0 -317
  62. package/.proagents/collaboration/README.md +0 -143
  63. package/.proagents/collaboration/roles.md +0 -248
  64. package/.proagents/collaboration/sessions.md +0 -390
  65. package/.proagents/collaboration/sync.md +0 -358
  66. package/.proagents/cost/README.md +0 -48
  67. package/.proagents/cost/cost-template.md +0 -283
  68. package/.proagents/cost/estimation-framework.md +0 -287
  69. package/.proagents/database/README.md +0 -72
  70. package/.proagents/database/examples/001-create-users.sql +0 -129
  71. package/.proagents/database/examples/002-add-preferences.sql +0 -94
  72. package/.proagents/database/examples/003-add-index.sql +0 -105
  73. package/.proagents/database/examples/004-rename-column.sql +0 -122
  74. package/.proagents/database/examples/005-add-foreign-key.sql +0 -142
  75. package/.proagents/database/examples/006-data-migration.sql +0 -196
  76. package/.proagents/database/examples/007-drop-column.sql +0 -163
  77. package/.proagents/database/examples/README.md +0 -89
  78. package/.proagents/database/migration-workflow.md +0 -478
  79. package/.proagents/database/rollback-scripts.md +0 -487
  80. package/.proagents/database/safety-checks.md +0 -447
  81. package/.proagents/git/README.md +0 -68
  82. package/.proagents/git/branch-strategy.md +0 -164
  83. package/.proagents/git/commit-conventions.md +0 -241
  84. package/.proagents/git/pr-workflow.md +0 -286
  85. package/.proagents/git/rollback-procedures.md +0 -416
  86. package/.proagents/ide-integration/README.md +0 -124
  87. package/.proagents/ide-integration/cline-config.md +0 -429
  88. package/.proagents/ide-integration/continue-config.md +0 -380
  89. package/.proagents/ide-integration/cursor-rules.md +0 -280
  90. package/.proagents/ide-integration/github-copilot.md +0 -384
  91. package/.proagents/ide-integration/windsurf-rules.md +0 -314
  92. package/.proagents/integrations/README.md +0 -97
  93. package/.proagents/integrations/pm/README.md +0 -344
  94. package/.proagents/learning/README.md +0 -136
  95. package/.proagents/learning/adaptation.md +0 -305
  96. package/.proagents/learning/data-collection.md +0 -283
  97. package/.proagents/learning/implementation-guide.md +0 -865
  98. package/.proagents/learning/reports.md +0 -306
  99. package/.proagents/mcp/README.md +0 -133
  100. package/.proagents/mcp/context-providers.md +0 -442
  101. package/.proagents/mcp/server-config.md +0 -306
  102. package/.proagents/mcp/tools-definition.md +0 -513
  103. package/.proagents/pm-integration/README.md +0 -151
  104. package/.proagents/pm-integration/asana.md +0 -346
  105. package/.proagents/pm-integration/github-issues.md +0 -308
  106. package/.proagents/pm-integration/gitlab-issues.md +0 -482
  107. package/.proagents/pm-integration/jira.md +0 -364
  108. package/.proagents/pm-integration/linear.md +0 -409
  109. package/.proagents/pm-integration/notion.md +0 -275
  110. package/.proagents/pm-integration/sync-config.md +0 -533
  111. package/.proagents/pm-integration/trello.md +0 -159
  112. package/.proagents/rules/README.md +0 -179
  113. package/.proagents/rules/custom-rules-template.yaml +0 -286
  114. package/.proagents/rules/custom-rules.md +0 -754
  115. package/.proagents/rules/validation-rules-template.yaml +0 -517
  116. package/.proagents/runbooks/README.md +0 -219
  117. package/.proagents/runbooks/dependency-vulnerability.md +0 -505
  118. package/.proagents/runbooks/incident-response.md +0 -451
  119. package/.proagents/runbooks/performance-degradation.md +0 -584
  120. package/.proagents/runbooks/production-debugging.md +0 -489
  121. package/.proagents/sessions/README.md +0 -5
  122. package/.proagents/sprints/README.md +0 -58
  123. package/.proagents/team/README.md +0 -256
  124. package/.proagents/team/code-ownership.md +0 -306
  125. package/.proagents/team/communication-templates.md +0 -441
  126. package/.proagents/team/handoff-protocol.md +0 -380
  127. package/.proagents/team/ide-setup/README.md +0 -103
  128. package/.proagents/team/ide-setup/cursor.md +0 -276
  129. package/.proagents/team/ide-setup/jetbrains.md +0 -330
  130. package/.proagents/team/ide-setup/neovim.md +0 -640
  131. package/.proagents/team/ide-setup/vscode.md +0 -348
  132. package/.proagents/team/onboarding.md +0 -278
  133. package/.proagents/time-tracking.json +0 -19
  134. package/.proagents/troubleshooting/README.md +0 -730
  135. package/.proagents/troubleshooting/ai-issues.md +0 -601
  136. 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