proagents 1.6.9 → 1.6.11
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.
- package/.proagents/.active-files +4 -0
- package/.proagents/.cursorrules +10 -0
- package/.proagents/.windsurfrules +10 -0
- package/.proagents/AI_INSTRUCTIONS.md +391 -3246
- package/.proagents/ANTIGRAVITY.md +10 -0
- package/.proagents/BOLT.md +10 -0
- package/.proagents/CHATGPT.md +10 -0
- package/.proagents/CLAUDE.md +10 -0
- package/.proagents/GEMINI.md +10 -0
- package/.proagents/GROQ.md +10 -0
- package/.proagents/KIRO.md +10 -0
- package/.proagents/LOVABLE.md +10 -0
- package/.proagents/PROAGENTS.md +16 -2
- package/.proagents/REPLIT.md +10 -0
- package/.proagents/changelog/_recent.md +24 -0
- package/.proagents/changelog/features/README.md +68 -0
- package/.proagents/changelog/modules/README.md +62 -0
- package/.proagents/docs/README.md +27 -0
- package/.proagents/docs/command-details.md +1115 -0
- package/.proagents/docs/testing.md +241 -0
- package/.proagents/prompts/06-testing.md +172 -0
- package/.proagents/prompts/07-documentation.md +166 -0
- package/.proagents/prompts/10-debug-logs.md +1130 -0
- package/.proagents/prompts/11-session-tracking.md +510 -0
- package/.proagents/worklog/README.md +114 -0
- package/.proagents/worklog/_context.md +43 -0
- package/README.md +57 -12
- package/package.json +1 -1
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
4
|
|
|
5
|
+
## CRITICAL: Auto-Log Every Code Change
|
|
6
|
+
|
|
7
|
+
**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
|
|
8
|
+
|
|
9
|
+
1. `.proagents/changelog/_recent.md` - Prepend change summary
|
|
10
|
+
2. `.proagents/changelog/modules/[module].md` - Based on file path
|
|
11
|
+
3. `.proagents/worklog/_context.md` - Update current state
|
|
12
|
+
|
|
13
|
+
Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
|
|
14
|
+
|
|
5
15
|
## Essential Commands
|
|
6
16
|
|
|
7
17
|
| Command | Action |
|
package/.proagents/BOLT.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
4
|
|
|
5
|
+
## CRITICAL: Auto-Log Every Code Change
|
|
6
|
+
|
|
7
|
+
**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
|
|
8
|
+
|
|
9
|
+
1. `.proagents/changelog/_recent.md` - Prepend change summary
|
|
10
|
+
2. `.proagents/changelog/modules/[module].md` - Based on file path
|
|
11
|
+
3. `.proagents/worklog/_context.md` - Update current state
|
|
12
|
+
|
|
13
|
+
Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
|
|
14
|
+
|
|
5
15
|
## Essential Commands
|
|
6
16
|
|
|
7
17
|
| Command | Action |
|
package/.proagents/CHATGPT.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
4
|
|
|
5
|
+
## CRITICAL: Auto-Log Every Code Change
|
|
6
|
+
|
|
7
|
+
**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
|
|
8
|
+
|
|
9
|
+
1. `.proagents/changelog/_recent.md` - Prepend change summary
|
|
10
|
+
2. `.proagents/changelog/modules/[module].md` - Based on file path
|
|
11
|
+
3. `.proagents/worklog/_context.md` - Update current state
|
|
12
|
+
|
|
13
|
+
Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
|
|
14
|
+
|
|
5
15
|
## Essential Commands
|
|
6
16
|
|
|
7
17
|
| Command | Action |
|
package/.proagents/CLAUDE.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
4
|
|
|
5
|
+
## CRITICAL: Auto-Log Every Code Change
|
|
6
|
+
|
|
7
|
+
**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
|
|
8
|
+
|
|
9
|
+
1. `.proagents/changelog/_recent.md` - Prepend change summary
|
|
10
|
+
2. `.proagents/changelog/modules/[module].md` - Based on file path
|
|
11
|
+
3. `.proagents/worklog/_context.md` - Update current state
|
|
12
|
+
|
|
13
|
+
Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
|
|
14
|
+
|
|
5
15
|
## Essential Commands
|
|
6
16
|
|
|
7
17
|
| Command | Action |
|
package/.proagents/GEMINI.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
4
|
|
|
5
|
+
## CRITICAL: Auto-Log Every Code Change
|
|
6
|
+
|
|
7
|
+
**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
|
|
8
|
+
|
|
9
|
+
1. `.proagents/changelog/_recent.md` - Prepend change summary
|
|
10
|
+
2. `.proagents/changelog/modules/[module].md` - Based on file path
|
|
11
|
+
3. `.proagents/worklog/_context.md` - Update current state
|
|
12
|
+
|
|
13
|
+
Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
|
|
14
|
+
|
|
5
15
|
## Essential Commands
|
|
6
16
|
|
|
7
17
|
| Command | Action |
|
package/.proagents/GROQ.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
4
|
|
|
5
|
+
## CRITICAL: Auto-Log Every Code Change
|
|
6
|
+
|
|
7
|
+
**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
|
|
8
|
+
|
|
9
|
+
1. `.proagents/changelog/_recent.md` - Prepend change summary
|
|
10
|
+
2. `.proagents/changelog/modules/[module].md` - Based on file path
|
|
11
|
+
3. `.proagents/worklog/_context.md` - Update current state
|
|
12
|
+
|
|
13
|
+
Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
|
|
14
|
+
|
|
5
15
|
## Essential Commands
|
|
6
16
|
|
|
7
17
|
| Command | Action |
|
package/.proagents/KIRO.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
4
|
|
|
5
|
+
## CRITICAL: Auto-Log Every Code Change
|
|
6
|
+
|
|
7
|
+
**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
|
|
8
|
+
|
|
9
|
+
1. `.proagents/changelog/_recent.md` - Prepend change summary
|
|
10
|
+
2. `.proagents/changelog/modules/[module].md` - Based on file path
|
|
11
|
+
3. `.proagents/worklog/_context.md` - Update current state
|
|
12
|
+
|
|
13
|
+
Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
|
|
14
|
+
|
|
5
15
|
## Essential Commands
|
|
6
16
|
|
|
7
17
|
| Command | Action |
|
package/.proagents/LOVABLE.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
4
|
|
|
5
|
+
## CRITICAL: Auto-Log Every Code Change
|
|
6
|
+
|
|
7
|
+
**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
|
|
8
|
+
|
|
9
|
+
1. `.proagents/changelog/_recent.md` - Prepend change summary
|
|
10
|
+
2. `.proagents/changelog/modules/[module].md` - Based on file path
|
|
11
|
+
3. `.proagents/worklog/_context.md` - Update current state
|
|
12
|
+
|
|
13
|
+
Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
|
|
14
|
+
|
|
5
15
|
## Essential Commands
|
|
6
16
|
|
|
7
17
|
| Command | Action |
|
package/.proagents/PROAGENTS.md
CHANGED
|
@@ -7,6 +7,18 @@ Execute these commands when user types them (prefix: `pa:`):
|
|
|
7
7
|
|
|
8
8
|
> **Multi-AI Note:** Multiple AIs may work on this project. Always read `./.proagents/activity.log` before executing commands, and log your actions after completing them.
|
|
9
9
|
|
|
10
|
+
## CRITICAL: Auto-Log Every Code Change
|
|
11
|
+
|
|
12
|
+
**After EVERY file edit/create/delete, AI MUST immediately update:**
|
|
13
|
+
|
|
14
|
+
1. `.proagents/changelog/_recent.md` - Prepend change summary
|
|
15
|
+
2. `.proagents/changelog/modules/[module].md` - Based on file path
|
|
16
|
+
3. `.proagents/worklog/_context.md` - Update current state
|
|
17
|
+
|
|
18
|
+
**Module detection:** `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui, `src/services/*`→services
|
|
19
|
+
|
|
20
|
+
**Do NOT wait for user prompt. Log automatically after every change.**
|
|
21
|
+
|
|
10
22
|
## Commands
|
|
11
23
|
|
|
12
24
|
| Command | What to Do |
|
|
@@ -46,7 +58,7 @@ Execute these commands when user types them (prefix: `pa:`):
|
|
|
46
58
|
| Command | What to Do |
|
|
47
59
|
|---------|------------|
|
|
48
60
|
| `pa:next` | Show next step in current workflow |
|
|
49
|
-
| `pa:resume` |
|
|
61
|
+
| `pa:resume` | Quick resume - load last session + show next action |
|
|
50
62
|
| `pa:skip` | Skip current phase, move to next |
|
|
51
63
|
| `pa:back` | Go back to previous phase |
|
|
52
64
|
| `pa:progress` | Show visual progress bar |
|
|
@@ -59,7 +71,9 @@ Execute these commands when user types them (prefix: `pa:`):
|
|
|
59
71
|
| `pa:diff` | Show changes since last session |
|
|
60
72
|
| `pa:history` | Show command history with results |
|
|
61
73
|
| `pa:checkpoint` | Create snapshot/restore point |
|
|
62
|
-
| `pa:undo` | Undo last AI action (git revert)
|
|
74
|
+
| `pa:undo` | Undo last AI action (git revert)
|
|
75
|
+
| `pa:conflict-check` | Check if files modified by other AI |
|
|
76
|
+
| `pa:changelog --from-git` | Auto-populate changelog from git commits | |
|
|
63
77
|
|
|
64
78
|
## Sprint & Estimation
|
|
65
79
|
|
package/.proagents/REPLIT.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
4
|
|
|
5
|
+
## CRITICAL: Auto-Log Every Code Change
|
|
6
|
+
|
|
7
|
+
**After EVERY file edit, IMMEDIATELY update these files (no user prompt needed):**
|
|
8
|
+
|
|
9
|
+
1. `.proagents/changelog/_recent.md` - Prepend change summary
|
|
10
|
+
2. `.proagents/changelog/modules/[module].md` - Based on file path
|
|
11
|
+
3. `.proagents/worklog/_context.md` - Update current state
|
|
12
|
+
|
|
13
|
+
Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
|
|
14
|
+
|
|
5
15
|
## Essential Commands
|
|
6
16
|
|
|
7
17
|
| Command | Action |
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Recent Changes
|
|
2
|
+
|
|
3
|
+
> Last 10 changes across all features/modules.
|
|
4
|
+
> Auto-updated by AI after each code change.
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Latest Changes
|
|
9
|
+
|
|
10
|
+
No changes recorded yet.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
<!--
|
|
15
|
+
Format for entries (AI adds above this line):
|
|
16
|
+
|
|
17
|
+
### YYYY-MM-DD - [Change Type]
|
|
18
|
+
**Module:** [auto-detected from file path]
|
|
19
|
+
**AI:** [Platform] ([model])
|
|
20
|
+
**Files:** path/to/file.ts (+lines, -lines)
|
|
21
|
+
**Summary:** Brief description of change
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
-->
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
# Feature Changelogs
|
|
2
|
+
|
|
3
|
+
One file per feature tracking all changes.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Structure
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
features/
|
|
11
|
+
├── README.md # This file
|
|
12
|
+
├── user-auth.md # All changes to user-auth feature
|
|
13
|
+
├── payment-flow.md # All changes to payment feature
|
|
14
|
+
└── dashboard.md # All changes to dashboard feature
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## File Format
|
|
20
|
+
|
|
21
|
+
Each feature changelog follows this format:
|
|
22
|
+
|
|
23
|
+
```markdown
|
|
24
|
+
# Feature: [Feature Name]
|
|
25
|
+
|
|
26
|
+
Created: YYYY-MM-DD
|
|
27
|
+
Status: [active | completed | paused]
|
|
28
|
+
Branch: feature/feature-name
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## Changelog
|
|
33
|
+
|
|
34
|
+
### YYYY-MM-DD - [AI Platform]
|
|
35
|
+
**Phase:** implementation
|
|
36
|
+
**Changes:**
|
|
37
|
+
- Added login validation
|
|
38
|
+
- Created LoginForm component
|
|
39
|
+
**Files:**
|
|
40
|
+
- src/auth/login.ts (+50, -10)
|
|
41
|
+
- src/components/LoginForm.tsx (new)
|
|
42
|
+
**Decisions:**
|
|
43
|
+
- Used Formik for form handling
|
|
44
|
+
**Next:** Add password reset flow
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
### YYYY-MM-DD - [AI Platform]
|
|
49
|
+
...
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## Auto-Creation
|
|
55
|
+
|
|
56
|
+
When AI runs `pa:feature "user-auth"`:
|
|
57
|
+
1. Creates `features/user-auth.md`
|
|
58
|
+
2. Initializes with template
|
|
59
|
+
3. Updates on every change
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## Commands
|
|
64
|
+
|
|
65
|
+
| Command | Action |
|
|
66
|
+
|---------|--------|
|
|
67
|
+
| `pa:changelog` | Update root + feature changelog |
|
|
68
|
+
| `pa:changelog-feature X` | View feature X changelog |
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Module Changelogs
|
|
2
|
+
|
|
3
|
+
Track changes by code module/component.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Structure
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
modules/
|
|
11
|
+
├── README.md # This file
|
|
12
|
+
├── api.md # All API changes
|
|
13
|
+
├── auth.md # All auth module changes
|
|
14
|
+
├── ui.md # All UI component changes
|
|
15
|
+
└── database.md # All database changes
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## File Format
|
|
21
|
+
|
|
22
|
+
```markdown
|
|
23
|
+
# Module: [Module Name]
|
|
24
|
+
|
|
25
|
+
Path: src/[module]/
|
|
26
|
+
Type: [api | service | component | utility]
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Changelog
|
|
31
|
+
|
|
32
|
+
### YYYY-MM-DD - [AI Platform]
|
|
33
|
+
**Context:** [Feature or Fix name]
|
|
34
|
+
**Changes:**
|
|
35
|
+
- Added rate limiting middleware
|
|
36
|
+
- Updated error responses
|
|
37
|
+
**Files:**
|
|
38
|
+
- src/api/middleware/rateLimit.ts (new)
|
|
39
|
+
- src/api/errors.ts (+20, -5)
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## Auto-Detection
|
|
47
|
+
|
|
48
|
+
AI automatically detects module from file path:
|
|
49
|
+
- `src/api/*` → modules/api.md
|
|
50
|
+
- `src/auth/*` → modules/auth.md
|
|
51
|
+
- `src/components/*` → modules/ui.md
|
|
52
|
+
- `src/services/*` → modules/services.md
|
|
53
|
+
- `src/utils/*` → modules/utils.md
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Commands
|
|
58
|
+
|
|
59
|
+
| Command | Action |
|
|
60
|
+
|---------|--------|
|
|
61
|
+
| `pa:changelog-module X` | View module X changelog |
|
|
62
|
+
| `pa:modules` | List all modules with change counts |
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# ProAgents Detailed Documentation
|
|
2
|
+
|
|
3
|
+
This folder contains detailed documentation for AI assistants.
|
|
4
|
+
|
|
5
|
+
## Files
|
|
6
|
+
|
|
7
|
+
| File | Description |
|
|
8
|
+
|------|-------------|
|
|
9
|
+
| `command-details.md` | Detailed execution instructions for all `pa:` commands |
|
|
10
|
+
| `testing.md` | Testing configuration and mobile testing setup |
|
|
11
|
+
|
|
12
|
+
## When to Read These
|
|
13
|
+
|
|
14
|
+
AI should read these files when:
|
|
15
|
+
- User asks for detailed help on a command
|
|
16
|
+
- Executing a complex command for the first time
|
|
17
|
+
- Troubleshooting issues with command execution
|
|
18
|
+
|
|
19
|
+
## Quick Access
|
|
20
|
+
|
|
21
|
+
Tell the AI:
|
|
22
|
+
- "Read command-details.md" for detailed command instructions
|
|
23
|
+
- "Read testing.md" for testing configuration help
|
|
24
|
+
|
|
25
|
+
Or use:
|
|
26
|
+
- `pa:docs commands` - AI reads command-details.md
|
|
27
|
+
- `pa:docs testing` - AI reads testing.md
|