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.
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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` | Resume paused feature from last checkpoint |
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
 
@@ -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