proagents 1.6.19 → 1.6.20

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.
@@ -2,29 +2,44 @@
2
2
 
3
3
  This project uses ProAgents - an AI-agnostic development workflow framework.
4
4
 
5
- ## ⚠️ MANDATORY: Every pa: Command Flow
5
+ > **IMPORTANT:** `pa:` commands are **AI directives**, NOT shell/terminal commands.
6
+ > When user types ANY `pa:` command (e.g., `pa:feature`, `pa:fix`, `pa:status`),
7
+ > DO NOT try to run it in terminal. Instead, follow the instructions below.
6
8
 
7
- ### BEFORE Any pa: Command (Auto-Sync)
9
+ ## Auto-Sync Protocol
8
10
 
9
- **Read these files FIRST before doing anything:**
11
+ ### Rule: Sync for commands that WRITE, skip for commands that READ
10
12
 
13
+ ### Workflow Commands (Auto-Sync Required)
14
+
15
+ Commands that CREATE or MODIFY code/content need context:
16
+
17
+ **BEFORE these commands, read:**
11
18
  ```bash
12
19
  cat .proagents/worklog/_context.md # Current state
13
20
  cat .proagents/changelog/_recent.md # Recent changes
14
21
  tail -10 .proagents/activity.log # Recent activity
15
22
  ```
16
23
 
17
- **This applies to EVERY command:** `pa:fix`, `pa:feature`, `pa:test`, `pa:doc`, etc.
24
+ **Examples:** `pa:feature`, `pa:fix`, `pa:implement`, `pa:analyze`,
25
+ `pa:design`, `pa:plan`, `pa:test`, `pa:review`, `pa:doc`, `pa:deploy`,
26
+ `pa:rnd`, `pa:refactor`, `pa:debug`, `pa:qa`, `pa:changelog`, `pa:release`, `pa:resume`,
27
+ `pa:session-start`, `pa:session-end`
18
28
 
19
- ### AFTER Any pa: Command (Auto-Log)
29
+ ### Utility Commands (No Sync Required)
20
30
 
21
- **After EVERY file edit, IMMEDIATELY update these files:**
31
+ Commands that only READ, DISPLAY, or CONFIGURE:
32
+ - **Skip BEFORE step** - No context reading needed
33
+ - **Skip AFTER step** - No logging needed
22
34
 
23
- 1. `.proagents/changelog/_recent.md` - Prepend change summary
24
- 2. `.proagents/changelog/modules/[module].md` - Based on file path
25
- 3. `.proagents/worklog/_context.md` - Update current state
35
+ **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
36
+ `pa:ai-*`, `pa:config-*`, `pa:sync`
26
37
 
27
- Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
38
+ ### AFTER Workflow Commands (Auto-Log)
39
+
40
+ **After commands that CHANGE files, update:**
41
+ 1. `.proagents/changelog/_recent.md` - Prepend change summary
42
+ 2. `.proagents/worklog/_context.md` - Update current state
28
43
 
29
44
  ## Essential Commands
30
45
 
@@ -1,373 +1,126 @@
1
1
  # ProAgents Commands
2
2
 
3
- Execute these commands when user types them (prefix: `pa:`):
3
+ Quick reference for all `pa:` commands.
4
4
 
5
5
  ## Quick Aliases
6
- `pa:f` → feature | `pa:s` → status | `pa:h` → help | `pa:d` → doc | `pa:t` → test | `pa:q` → qa | `pa:a` → analyze | `pa:r` → requirements | `pa:p` → plan | `pa:i` → implement
7
-
8
- > **Multi-AI Note:** Multiple AIs may work on this project. Context loading and logging is AUTOMATIC.
9
-
10
- ---
11
-
12
- ## ⚠️ MANDATORY: Every pa: Command Flow
13
-
14
- ### BEFORE Any pa: Command (Auto-Sync)
15
-
16
- **AI MUST read these files FIRST before doing anything:**
17
-
18
- ```bash
19
- cat .proagents/worklog/_context.md # Current state
20
- cat .proagents/changelog/_recent.md # Recent changes
21
- tail -10 .proagents/activity.log # Recent activity
22
- ```
23
-
24
- **This applies to EVERY command:** `pa:fix`, `pa:feature`, `pa:test`, `pa:doc`, etc.
25
6
 
26
- ### AFTER Any pa: Command That Changes Files
27
-
28
- **AI MUST update these files IMMEDIATELY after any code change:**
29
-
30
- ```
31
- 1. .proagents/changelog/_recent.md ← Prepend change summary
32
- 2. .proagents/worklog/_context.md ← Update Quick Summary
33
- 3. .proagents/changelog/modules/X.md ← Based on file path
34
- 4. .proagents/activity.log ← Log the command
35
- ```
36
-
37
- ### Example: pa:fix "login bug"
38
-
39
- ```
40
- STEP 1: Read _context.md, _recent.md, activity.log ← SYNC FIRST
41
- STEP 2: Find and fix the bug ← DO THE WORK
42
- STEP 3: Prepend fix to _recent.md ← LOG CHANGE
43
- STEP 4: Update _context.md Quick Summary ← UPDATE CONTEXT
44
- STEP 5: Append to activity.log ← LOG ACTIVITY
45
- ```
46
-
47
- **Module detection:** `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui, `src/services/*`→services
7
+ `pa:f` feature | `pa:s` status | `pa:h` → help | `pa:d` → doc | `pa:t` → test | `pa:q` → qa | `pa:a` → analyze | `pa:r` → requirements | `pa:p` → plan | `pa:i` → implement
48
8
 
49
9
  ---
50
10
 
51
- ## Commands
52
-
53
- | Command | What to Do |
54
- |---------|------------|
55
- | `pa:help` | Comprehensive help with examples, categories, workflows |
56
- | `pa:feature "name"` | Create `./.proagents/active-features/feature-[name]/`, analyze codebase, implement feature |
57
- | `pa:project-setup` | Interactive project setup wizard with presets, idea-first mode, full automation |
58
- | `pa:rnd` | Research & Development workflow (compare, prototype, explore) |
59
- | `pa:fix "description"` | Find bug, fix it, update `./CHANGELOG.md` |
60
- | `pa:analyze` | Deep codebase analysis → `./.proagents/cache/` |
61
- | `pa:requirements` | Gather requirements → `./.proagents/active-features/` |
62
- | `pa:design` | UI/Architecture design phase |
63
- | `pa:plan` | Create implementation plan |
64
- | `pa:implement` | Execute implementation phase |
65
- | `pa:status` | Enhanced status: tasks, time, files, tests, git branch, contributors |
66
- | `pa:qa` | Quality dashboard: security, lint, coverage, bundle, docs, complexity |
67
- | `pa:test` | Run tests with coverage visualization, module breakdown, slow tests |
68
- | `pa:review` | Code review checklist: quality, security, testing, documentation |
69
- | `pa:fix "desc"` | Bug fix with before/after diff, affected tests, auto-verify |
70
- | `pa:doc` | Generate documentation |
71
- | `pa:deploy` | Interactive deployment checklist with real-time status, health checks |
72
- | `pa:release` | Generate release notes → `./RELEASE_NOTES.md` |
73
- | `pa:changelog` | Update `./CHANGELOG.md` |
74
- | `pa:ai-list` | Read config, show installed AI platforms |
75
- | `pa:ai-add` | Show platform options, create AI instruction files |
76
- | `pa:ai-remove` | Show installed platforms, remove selected files |
77
- | `pa:ai-sync` | Sync config with existing files (fix mismatches) |
78
- | `pa:activity` | Show ALL AI activity with icons, time groups, files changed |
79
- | `pa:lock` | Show lock status, check if another AI is working |
80
- | `pa:lock-release` | Release your lock after completing work |
81
- | `pa:handoff` | Create handoff notes → `./.proagents/handoff.md` |
82
- | `pa:handoff-read` | Read handoff notes before starting work |
83
- | `pa:session-end` | Generate session summary → `./.proagents/sessions/` |
84
- | `pa:decision "title"` | Log architectural decision → `./.proagents/decisions.md` |
85
- | `pa:error "desc"` | Log error & solution → `./.proagents/errors.md` |
86
- | `pa:feedback "desc"` | Log feedback for AI learning → `./.proagents/feedback.md` |
87
- | `pa:standup` | Daily standup: yesterday, today, blockers, team activity, stats |
88
- | `pa:tech-debt` | Scan for technical debt |
89
-
90
- ## Navigation & Flow
91
-
92
- | Command | What to Do |
93
- |---------|------------|
94
- | `pa:next` | Show next step in current workflow |
95
- | `pa:resume` | Compact resume: last session, what was done, next action, hot files |
96
- | `pa:skip` | Skip current phase, move to next |
97
- | `pa:back` | Go back to previous phase |
98
- | `pa:progress` | Show enhanced progress: tasks, duration, AI, phase timeline |
99
-
100
- ## Context & History
101
-
102
- | Command | What to Do |
103
- |---------|------------|
104
- | `pa:context` | View project context |
105
- | `pa:diff` | Show changes since last session |
106
- | `pa:history` | Command history with filters: --today, --ai, --command, --stats |
107
- | `pa:checkpoint` | Create snapshot/restore point |
108
- | `pa:undo` | Undo last AI action (git revert) |
109
- | `pa:undo-last` | Undo last AI's entire session (all changes) |
110
- | `pa:undo-file "path"` | Undo changes to specific file |
111
- | `pa:conflict-check` | Check if files modified by other AI |
112
- | `pa:changelog --from-git` | Auto-populate changelog from git commits | |
113
-
114
- ## Sprint & Estimation
115
-
116
- | Command | What to Do |
117
- |---------|------------|
118
- | `pa:sprint-start` | Start new sprint → `./.proagents/sprints/` |
119
- | `pa:sprint-end` | End sprint with summary |
120
- | `pa:estimate` | Estimate task complexity (S/M/L/XL) |
121
- | `pa:velocity` | Show velocity metrics |
122
-
123
- ## Integration
124
-
125
- | Command | What to Do |
126
- |---------|------------|
127
- | `pa:github` | GitHub commands (issue, PR) |
128
- | `pa:github-pr` | Create pull request |
129
- | `pa:jira` | Sync with Jira ticket |
130
- | `pa:notify` | Send notification (Slack/email) |
131
-
132
- ## Code Quality
133
-
134
- | Command | What to Do |
135
- |---------|------------|
136
- | `pa:metrics` | Show code quality metrics |
137
- | `pa:coverage` | Show test coverage report |
138
- | `pa:deps` | Analyze dependencies |
139
- | `pa:deps-outdated` | Find outdated packages |
140
- | `pa:deps-security` | Security scan dependencies |
11
+ ## Core Commands
12
+
13
+ | Command | Description |
14
+ |---------|-------------|
15
+ | `pa:help` | Show all commands with examples |
16
+ | `pa:feature "name"` | Start new feature workflow |
17
+ | `pa:fix "description"` | Quick bug fix |
18
+ | `pa:status` | Show current progress |
19
+ | `pa:project-setup` | Interactive project setup |
20
+
21
+ ## Workflow Phases
22
+
23
+ | Command | Description |
24
+ |---------|-------------|
25
+ | `pa:analyze` | Code analysis |
26
+ | `pa:requirements` | Gather requirements |
27
+ | `pa:design` | UI/Architecture design |
28
+ | `pa:plan` | Implementation plan |
29
+ | `pa:implement` | Write code |
30
+ | `pa:test` | Run tests |
31
+ | `pa:review` | Code review |
32
+ | `pa:doc` | Documentation |
33
+ | `pa:deploy` | Deployment checklist |
34
+
35
+ ## AI Platform Management
36
+
37
+ | Command | Prompt File |
38
+ |---------|-------------|
39
+ | `pa:ai-list` | `./prompts/ai-list.md` |
40
+ | `pa:ai-add` | `./prompts/ai-add.md` |
41
+ | `pa:ai-remove` | `./prompts/ai-remove.md` |
42
+ | `pa:ai-sync` | `./prompts/ai-sync.md` |
43
+
44
+ ## Navigation
45
+
46
+ | Command | Description |
47
+ |---------|-------------|
48
+ | `pa:next` | Next step in workflow |
49
+ | `pa:resume` | Resume last session |
50
+ | `pa:skip` | Skip current phase |
51
+ | `pa:back` | Go to previous phase |
52
+ | `pa:progress` | Show progress |
53
+
54
+ ## Multi-AI Collaboration
55
+
56
+ | Command | Description |
57
+ |---------|-------------|
58
+ | `pa:activity` | Show all AI activity |
59
+ | `pa:lock` | Check lock status |
60
+ | `pa:lock-release` | Release lock |
61
+ | `pa:handoff` | Create handoff notes |
62
+ | `pa:session-end` | End session with summary |
63
+
64
+ ## Quality & Testing
65
+
66
+ | Command | Description |
67
+ |---------|-------------|
68
+ | `pa:qa` | Quality dashboard |
69
+ | `pa:metrics` | Code metrics |
70
+ | `pa:coverage` | Test coverage |
71
+ | `pa:a11y` | Accessibility audit |
72
+ | `pa:perf` | Performance analysis |
141
73
 
142
74
  ## Code Generation
143
75
 
144
- | Command | What to Do |
145
- |---------|------------|
146
- | `pa:generate` | Show generation options |
147
- | `pa:generate-component "name"` | Generate component from template |
76
+ | Command | Description |
77
+ |---------|-------------|
78
+ | `pa:generate-component "name"` | Generate component |
148
79
  | `pa:generate-api "name"` | Generate API endpoint |
149
80
  | `pa:generate-test "file"` | Generate test file |
150
81
 
151
82
  ## Refactoring
152
83
 
153
- | Command | What to Do |
154
- |---------|------------|
155
- | `pa:refactor` | Suggest refactoring opportunities |
84
+ | Command | Description |
85
+ |---------|-------------|
86
+ | `pa:refactor` | Suggest refactoring |
156
87
  | `pa:rename "old" "new"` | Rename across codebase |
157
- | `pa:extract "name"` | Extract function/component |
158
- | `pa:cleanup` | Remove dead code, unused imports |
159
-
160
- ## Time Tracking
161
-
162
- | Command | What to Do |
163
- |---------|------------|
164
- | `pa:time-start` | Start tracking → `./.proagents/time-tracking.json` |
165
- | `pa:time-stop` | Stop tracking, save duration |
166
- | `pa:time-report` | Show time report by feature |
167
-
168
- ## Environment & Setup
169
-
170
- | Command | What to Do |
171
- |---------|------------|
172
- | `pa:env-check` | Verify environment setup |
173
- | `pa:env-setup` | Setup dev environment |
174
- | `pa:secrets-scan` | Scan for exposed secrets |
88
+ | `pa:cleanup` | Remove dead code |
175
89
 
176
- ## Database
177
-
178
- | Command | What to Do |
179
- |---------|------------|
180
- | `pa:db-migrate` | Run database migrations |
181
- | `pa:db-seed` | Seed with test data |
182
- | `pa:db-reset` | Reset database (caution!) |
183
-
184
- ## Accessibility & Performance
185
-
186
- | Command | What to Do |
187
- |---------|------------|
188
- | `pa:a11y` | Run accessibility audit |
189
- | `pa:lighthouse` | Run Lighthouse audit |
190
- | `pa:perf` | Performance analysis |
90
+ ## Git & Release
191
91
 
192
- ## Export & Backup
193
-
194
- | Command | What to Do |
195
- |---------|------------|
196
- | `pa:export` | Export config/data → JSON file |
197
- | `pa:import` | Import from export file |
198
- | `pa:backup` | Backup proagents folder |
199
-
200
- ## Learning & AI
201
-
202
- | Command | What to Do |
203
- |---------|------------|
204
- | `pa:learn "pattern"` | Teach AI a pattern → saves to `.proagents/.learning/` |
205
- | `pa:forget "pattern"` | Remove learned pattern from learning data |
206
- | `pa:learning` | Show learning report: patterns, corrections, preferences |
207
- | `pa:suggestions` | Show AI suggestions based on learned patterns |
208
-
209
- ## API & Documentation
210
-
211
- | Command | What to Do |
212
- |---------|------------|
213
- | `pa:api-docs` | Generate OpenAPI/Swagger documentation |
214
- | `pa:storybook` | Generate Storybook stories |
215
- | `pa:readme` | Auto-generate/update README.md |
216
- | `pa:types` | Generate TypeScript types/interfaces |
217
-
218
- ## Git Advanced
219
-
220
- | Command | What to Do |
221
- |---------|------------|
222
- | `pa:branch` | Branch management (list, create, clean) |
223
- | `pa:merge` | Smart merge with conflict preview |
224
- | `pa:conflict` | Resolve merge conflicts with AI |
225
- | `pa:changelog-gen` | Auto-generate changelog from commits |
226
-
227
- ## Search & Navigation
228
-
229
- | Command | What to Do |
230
- |---------|------------|
231
- | `pa:find "pattern"` | Find code patterns/usage |
232
- | `pa:todo` | Find and list all TODOs in code |
233
- | `pa:fixme` | Find FIXMEs and critical issues |
234
- | `pa:unused` | Find unused code/exports |
235
- | `pa:unused-deps` | Find unused dependencies |
236
-
237
- ## Code Analysis
238
-
239
- | Command | What to Do |
240
- |---------|------------|
241
- | `pa:complexity` | Cyclomatic complexity analysis |
242
- | `pa:duplication` | Find duplicate code blocks |
243
- | `pa:hotspots` | Find frequently changed files |
244
-
245
- ## Testing Advanced
246
-
247
- | Command | What to Do |
248
- |---------|------------|
249
- | `pa:test-e2e` | Create/run E2E tests |
250
- | `pa:test-unit` | Generate unit tests |
251
- | `pa:mock` | Generate mocks/stubs |
252
- | `pa:snapshot` | Snapshot testing management |
253
-
254
- ## DevOps & Infrastructure
255
-
256
- | Command | What to Do |
257
- |---------|------------|
258
- | `pa:docker` | Docker commands (build, compose) |
259
- | `pa:ci` | CI/CD pipeline status/management |
260
- | `pa:deploy-preview` | Deploy to preview environment |
261
-
262
- ## Release Management
263
-
264
- | Command | What to Do |
265
- |---------|------------|
92
+ | Command | Description |
93
+ |---------|-------------|
94
+ | `pa:changelog` | Update CHANGELOG.md |
95
+ | `pa:release` | Generate release notes |
266
96
  | `pa:version` | Show/bump version |
267
- | `pa:tag` | Create git tag for release |
268
- | `pa:publish` | Publish package to registry |
269
-
270
- ## Code Review & PR
271
-
272
- | Command | What to Do |
273
- |---------|------------|
274
- | `pa:review-request` | Request code review from team |
275
- | `pa:review-comments` | Show PR review comments |
276
- | `pa:review-approve` | Approve current PR |
277
-
278
- ## Architecture
279
-
280
- | Command | What to Do |
281
- |---------|------------|
282
- | `pa:architecture` | Show architecture overview |
283
- | `pa:architecture-diagram` | Generate architecture diagram (Mermaid) |
284
- | `pa:architecture-export` | Export diagram (SVG/PNG) |
285
-
286
- ## API Testing
287
-
288
- | Command | What to Do |
289
- |---------|------------|
290
- | `pa:api-test` | Test API endpoints |
291
- | `pa:curl` | Generate curl commands for endpoints |
292
- | `pa:postman` | Generate Postman collection |
97
+ | `pa:github-pr` | Create pull request |
293
98
 
294
- ## Health & Monitoring
99
+ ## Research & Development
295
100
 
296
- | Command | What to Do |
297
- |---------|------------|
298
- | `pa:health` | Project health check |
299
- | `pa:monitor` | Show monitoring status |
300
- | `pa:uptime` | Service uptime check |
101
+ | Command | Description |
102
+ |---------|-------------|
103
+ | `pa:rnd` | R&D workflow |
104
+ | `pa:rnd-compare` | Compare solutions |
105
+ | `pa:rnd-poc` | Build prototype |
301
106
 
302
- ## Quick Actions
107
+ ## Learning & Feedback
303
108
 
304
- | Command | What to Do |
305
- |---------|------------|
306
- | `pa:quick` | Show quick actions menu |
307
- | `pa:alias` | Manage command aliases |
308
- | `pa:alias-add` | Add custom alias |
309
- | `pa:alias-remove` | Remove custom alias |
109
+ | Command | Description |
110
+ |---------|-------------|
111
+ | `pa:learn "pattern"` | Teach AI a pattern |
112
+ | `pa:feedback "desc"` | Log feedback |
113
+ | `pa:decision "title"` | Log decision |
114
+ | `pa:error "desc"` | Log error & solution |
310
115
 
311
- ## Mobile Test Suite (React Native)
116
+ ---
312
117
 
313
- | Command | What to Do |
314
- |---------|------------|
315
- | `pa:test-mobile` | Run full mobile test suite (unit, component, E2E, visual) |
316
- | `pa:test-mobile "feature"` | Test specific feature only |
317
- | `pa:test-visual` | Visual/design comparison testing |
318
- | `pa:test-auto-fix` | Auto-fix failing tests |
319
- | `pa:test-loop` | Test → Fix → Retest loop until all pass |
320
- | `pa:compare-figma` | Compare UI against Figma design |
321
- | `pa:compare-image "path"` | Compare UI against image/sketch |
322
- | `pa:screenshot` | Take app screenshots for comparison |
118
+ ## Full Documentation
323
119
 
324
- ## Key Files to Read
120
+ For complete instructions, auto-sync protocol, and workflows:
325
121
 
326
122
  | File | Purpose |
327
123
  |------|---------|
328
- | `./.proagents/context.md` | Persistent project context (READ FIRST!) |
329
- | `./.proagents/feedback.md` | Past corrections - don't repeat mistakes |
330
- | `./.proagents/watchlist.yaml` | Files requiring confirmation before changes |
331
- | `./.proagents/errors.md` | Past errors and solutions |
332
- | `./.proagents/decisions.md` | Architectural decisions and reasoning |
333
-
334
- ## Feature Workflow
335
-
336
- `pa:feature` runs all phases, or run individually:
337
-
338
- | Phase | Command | Action |
339
- |-------|---------|--------|
340
- | 1. Init | `pa:feature "name"` | Create tracking files |
341
- | 2. Analysis | `pa:analyze` | Understand existing code |
342
- | 3. Requirements | `pa:requirements` | Define what to build |
343
- | 4. Design | `pa:design` | Plan UI/architecture |
344
- | 5. Planning | `pa:plan` | Create implementation plan |
345
- | 6. Implementation | `pa:implement` | Write code |
346
- | 7. Testing | `pa:test` | Create/run tests |
347
- | 8. Review | `pa:review` | Quality check |
348
- | 9. Documentation | `pa:doc` | Update docs |
349
- | 10. Deployment | `pa:deploy` | Interactive deployment checklist |
350
-
351
- ## Save Locations
352
-
353
- | Document | Location |
354
- |----------|----------|
355
- | Changelog | `./CHANGELOG.md` |
356
- | Release Notes | `./RELEASE_NOTES.md` |
357
- | Feature Status | `./.proagents/active-features/` |
358
-
359
- ## Examples
360
-
361
- ```
362
- User: pa:feature "add user login"
363
- → Create feature, analyze codebase, guide implementation
364
-
365
- User: pa:fix "submit button not working"
366
- → Find issue, fix it, update changelog
367
-
368
- User: pa:status
369
- → Show active features and progress
370
-
371
- User: pa:help
372
- → Show all available commands
373
- ```
124
+ | `.proagents/AI_INSTRUCTIONS.md` | Complete AI instructions |
125
+ | `.proagents/WORKFLOW.md` | Full 10-phase workflow |
126
+ | `.proagents/prompts/` | Phase-specific prompts |
@@ -2,29 +2,44 @@
2
2
 
3
3
  This project uses ProAgents - an AI-agnostic development workflow framework.
4
4
 
5
- ## ⚠️ MANDATORY: Every pa: Command Flow
5
+ > **IMPORTANT:** `pa:` commands are **AI directives**, NOT shell/terminal commands.
6
+ > When user types ANY `pa:` command (e.g., `pa:feature`, `pa:fix`, `pa:status`),
7
+ > DO NOT try to run it in terminal. Instead, follow the instructions below.
6
8
 
7
- ### BEFORE Any pa: Command (Auto-Sync)
9
+ ## Auto-Sync Protocol
8
10
 
9
- **Read these files FIRST before doing anything:**
11
+ ### Rule: Sync for commands that WRITE, skip for commands that READ
10
12
 
13
+ ### Workflow Commands (Auto-Sync Required)
14
+
15
+ Commands that CREATE or MODIFY code/content need context:
16
+
17
+ **BEFORE these commands, read:**
11
18
  ```bash
12
19
  cat .proagents/worklog/_context.md # Current state
13
20
  cat .proagents/changelog/_recent.md # Recent changes
14
21
  tail -10 .proagents/activity.log # Recent activity
15
22
  ```
16
23
 
17
- **This applies to EVERY command:** `pa:fix`, `pa:feature`, `pa:test`, `pa:doc`, etc.
24
+ **Examples:** `pa:feature`, `pa:fix`, `pa:implement`, `pa:analyze`,
25
+ `pa:design`, `pa:plan`, `pa:test`, `pa:review`, `pa:doc`, `pa:deploy`,
26
+ `pa:rnd`, `pa:refactor`, `pa:debug`, `pa:qa`, `pa:changelog`, `pa:release`, `pa:resume`,
27
+ `pa:session-start`, `pa:session-end`
18
28
 
19
- ### AFTER Any pa: Command (Auto-Log)
29
+ ### Utility Commands (No Sync Required)
20
30
 
21
- **After EVERY file edit, IMMEDIATELY update these files:**
31
+ Commands that only READ, DISPLAY, or CONFIGURE:
32
+ - **Skip BEFORE step** - No context reading needed
33
+ - **Skip AFTER step** - No logging needed
22
34
 
23
- 1. `.proagents/changelog/_recent.md` - Prepend change summary
24
- 2. `.proagents/changelog/modules/[module].md` - Based on file path
25
- 3. `.proagents/worklog/_context.md` - Update current state
35
+ **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
36
+ `pa:ai-*`, `pa:config-*`, `pa:sync`
26
37
 
27
- Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
38
+ ### AFTER Workflow Commands (Auto-Log)
39
+
40
+ **After commands that CHANGE files, update:**
41
+ 1. `.proagents/changelog/_recent.md` - Prepend change summary
42
+ 2. `.proagents/worklog/_context.md` - Update current state
28
43
 
29
44
  ## Essential Commands
30
45
 
@@ -9,3 +9,4 @@
9
9
  #
10
10
  # --- Activity Log Start ---
11
11
 
12
+
@@ -0,0 +1,66 @@
1
+ # ProAgents Supported AI Platforms
2
+ # Single source of truth - used by code and AI assistants
3
+ #
4
+ # To add a new platform:
5
+ # 1. Add entry below with id, name, file, desc
6
+ # 2. Create the instruction file in .proagents/
7
+ # 3. Run: proagents ai add
8
+
9
+ ide:
10
+ label: "IDE-based AI Assistants"
11
+ platforms:
12
+ - id: claude
13
+ name: Claude Code
14
+ file: CLAUDE.md
15
+ desc: Anthropic Claude in terminal/IDE
16
+
17
+ - id: cursor
18
+ name: Cursor
19
+ file: .cursorrules
20
+ desc: Cursor AI IDE
21
+
22
+ - id: windsurf
23
+ name: Windsurf
24
+ file: .windsurfrules
25
+ desc: Codeium Windsurf IDE
26
+
27
+ - id: copilot
28
+ name: GitHub Copilot
29
+ file: .github/copilot-instructions.md
30
+ desc: GitHub Copilot
31
+
32
+ - id: kiro
33
+ name: AWS Kiro
34
+ file: KIRO.md
35
+ desc: AWS Kiro IDE
36
+
37
+ - id: gemini
38
+ name: Gemini
39
+ file: GEMINI.md
40
+ desc: Google Gemini / AI Studio
41
+
42
+ web:
43
+ label: "Web-based AI Platforms"
44
+ platforms:
45
+ - id: replit
46
+ name: Replit AI
47
+ file: REPLIT.md
48
+ desc: Replit Ghostwriter
49
+
50
+ - id: bolt
51
+ name: Bolt.new
52
+ file: BOLT.md
53
+ desc: StackBlitz Bolt
54
+
55
+ - id: lovable
56
+ name: Lovable
57
+ file: LOVABLE.md
58
+ desc: Lovable (GPT Engineer)
59
+
60
+ # Auto-handled platforms (use AGENTS.md, no separate file needed)
61
+ auto_handled:
62
+ - ChatGPT
63
+ - Groq
64
+ - Antigravity
65
+ - Codex CLI
66
+ - OpenAI API