proagents 1.0.7 → 1.0.8
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/lib/commands/init.js +48 -12
- package/package.json +1 -1
- package/proagents/.github/copilot-instructions.md +45 -0
- package/proagents/CHATGPT.md +79 -0
- package/proagents/GEMINI.md +70 -0
package/lib/commands/init.js
CHANGED
|
@@ -89,6 +89,8 @@ const FRAMEWORK_FILES = [
|
|
|
89
89
|
'CLAUDE.md',
|
|
90
90
|
'.cursorrules',
|
|
91
91
|
'AI_INSTRUCTIONS.md',
|
|
92
|
+
'GEMINI.md',
|
|
93
|
+
'CHATGPT.md',
|
|
92
94
|
];
|
|
93
95
|
|
|
94
96
|
/**
|
|
@@ -257,18 +259,32 @@ For detailed commands, see \`./proagents/PROAGENTS.md\`
|
|
|
257
259
|
}
|
|
258
260
|
|
|
259
261
|
// Copy AI instruction files to project root (for AI platform recognition)
|
|
260
|
-
const
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
262
|
+
const aiFiles = [
|
|
263
|
+
{ src: 'CLAUDE.md', target: 'CLAUDE.md', desc: 'Claude AI' },
|
|
264
|
+
{ src: '.cursorrules', target: '.cursorrules', desc: 'Cursor AI' },
|
|
265
|
+
{ src: 'GEMINI.md', target: 'GEMINI.md', desc: 'Gemini AI' },
|
|
266
|
+
{ src: 'CHATGPT.md', target: 'CHATGPT.md', desc: 'ChatGPT/Codex' },
|
|
267
|
+
];
|
|
268
|
+
|
|
269
|
+
for (const file of aiFiles) {
|
|
270
|
+
const sourcePath = join(sourceDir, file.src);
|
|
271
|
+
const targetPath = join(targetDir, file.target);
|
|
272
|
+
if (existsSync(sourcePath) && !existsSync(targetPath)) {
|
|
273
|
+
cpSync(sourcePath, targetPath);
|
|
274
|
+
console.log(chalk.green(`✓ Created ${file.target} (for ${file.desc} recognition)`));
|
|
275
|
+
}
|
|
265
276
|
}
|
|
266
277
|
|
|
267
|
-
|
|
268
|
-
const
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
278
|
+
// Copy .github/copilot-instructions.md for GitHub Copilot
|
|
279
|
+
const copilotSource = join(sourceDir, '.github', 'copilot-instructions.md');
|
|
280
|
+
const githubDir = join(targetDir, '.github');
|
|
281
|
+
const copilotTarget = join(githubDir, 'copilot-instructions.md');
|
|
282
|
+
if (existsSync(copilotSource) && !existsSync(copilotTarget)) {
|
|
283
|
+
if (!existsSync(githubDir)) {
|
|
284
|
+
mkdirSync(githubDir, { recursive: true });
|
|
285
|
+
}
|
|
286
|
+
cpSync(copilotSource, copilotTarget);
|
|
287
|
+
console.log(chalk.green('✓ Created .github/copilot-instructions.md (for GitHub Copilot)'));
|
|
272
288
|
}
|
|
273
289
|
|
|
274
290
|
// Success message
|
|
@@ -384,7 +400,13 @@ async function smartUpdate(sourceDir, targetDir) {
|
|
|
384
400
|
|
|
385
401
|
// Copy AI instruction files to project root (for AI platform recognition)
|
|
386
402
|
const projectRoot = join(targetDir, '..');
|
|
387
|
-
const aiFiles = [
|
|
403
|
+
const aiFiles = [
|
|
404
|
+
'CLAUDE.md',
|
|
405
|
+
'.cursorrules',
|
|
406
|
+
'AI_INSTRUCTIONS.md',
|
|
407
|
+
'GEMINI.md',
|
|
408
|
+
'CHATGPT.md',
|
|
409
|
+
];
|
|
388
410
|
let aiFilesUpdated = 0;
|
|
389
411
|
|
|
390
412
|
for (const file of aiFiles) {
|
|
@@ -397,8 +419,22 @@ async function smartUpdate(sourceDir, targetDir) {
|
|
|
397
419
|
}
|
|
398
420
|
}
|
|
399
421
|
|
|
422
|
+
// Handle .github/copilot-instructions.md separately (needs directory creation)
|
|
423
|
+
const copilotSource = join(sourceDir, '.github', 'copilot-instructions.md');
|
|
424
|
+
const githubDir = join(projectRoot, '.github');
|
|
425
|
+
const copilotTarget = join(githubDir, 'copilot-instructions.md');
|
|
426
|
+
|
|
427
|
+
if (existsSync(copilotSource)) {
|
|
428
|
+
if (!existsSync(githubDir)) {
|
|
429
|
+
mkdirSync(githubDir, { recursive: true });
|
|
430
|
+
}
|
|
431
|
+
cpSync(copilotSource, copilotTarget, { force: true });
|
|
432
|
+
aiFilesUpdated++;
|
|
433
|
+
}
|
|
434
|
+
|
|
400
435
|
if (aiFilesUpdated > 0) {
|
|
401
|
-
console.log(chalk.green(`✓ Updated ${aiFilesUpdated} AI instruction files
|
|
436
|
+
console.log(chalk.green(`✓ Updated ${aiFilesUpdated} AI instruction files`));
|
|
437
|
+
console.log(chalk.gray(' (CLAUDE.md, .cursorrules, GEMINI.md, CHATGPT.md, .github/copilot-instructions.md)'));
|
|
402
438
|
}
|
|
403
439
|
}
|
|
404
440
|
|
package/package.json
CHANGED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# ProAgents Commands for GitHub Copilot
|
|
2
|
+
|
|
3
|
+
This project uses ProAgents workflow framework. Recognize `pa:` prefix commands.
|
|
4
|
+
|
|
5
|
+
## Commands
|
|
6
|
+
|
|
7
|
+
### Core
|
|
8
|
+
- `pa:help` - Show all commands
|
|
9
|
+
- `pa:feature "name"` - Start feature (read ./proagents/WORKFLOW.md)
|
|
10
|
+
- `pa:fix "bug"` - Bug fix mode (read ./proagents/workflow-modes/entry-modes.md)
|
|
11
|
+
- `pa:status` - Show progress
|
|
12
|
+
|
|
13
|
+
### Documentation
|
|
14
|
+
- `pa:doc` - Documentation options
|
|
15
|
+
- `pa:doc-full` - Full docs (read ./proagents/prompts/07-documentation.md)
|
|
16
|
+
- `pa:doc-moderate` - Balanced docs
|
|
17
|
+
- `pa:doc-lite` - Quick reference
|
|
18
|
+
- `pa:doc-module [name]` - Document module
|
|
19
|
+
- `pa:doc-file [path]` - Document file
|
|
20
|
+
- `pa:doc-api` - API documentation
|
|
21
|
+
- `pa:readme` - Generate README
|
|
22
|
+
- `pa:changelog` - Update CHANGELOG
|
|
23
|
+
- `pa:release` - Release notes
|
|
24
|
+
- `pa:release [ver]` - Version-specific notes
|
|
25
|
+
|
|
26
|
+
### Quality
|
|
27
|
+
- `pa:qa` - Quality checks (read ./proagents/checklists/code-quality.md)
|
|
28
|
+
- `pa:test` - Test workflow (read ./proagents/prompts/06-testing.md)
|
|
29
|
+
- `pa:review` - Code review
|
|
30
|
+
|
|
31
|
+
### Deployment
|
|
32
|
+
- `pa:deploy` - Deployment (read ./proagents/prompts/08-deployment.md)
|
|
33
|
+
- `pa:rollback` - Rollback procedures
|
|
34
|
+
|
|
35
|
+
## On `pa:` Command
|
|
36
|
+
|
|
37
|
+
1. Read corresponding file in `./proagents/prompts/` or `./proagents/workflow-modes/`
|
|
38
|
+
2. Follow the workflow instructions
|
|
39
|
+
3. Use config from `./proagents/proagents.config.yaml`
|
|
40
|
+
|
|
41
|
+
## Key Files
|
|
42
|
+
|
|
43
|
+
- `./proagents/WORKFLOW.md` - Full workflow
|
|
44
|
+
- `./proagents/PROAGENTS.md` - Command reference
|
|
45
|
+
- `./proagents/prompts/` - Phase prompts
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# ProAgents Commands for ChatGPT / Codex
|
|
2
|
+
|
|
3
|
+
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
|
+
|
|
5
|
+
## Command Recognition
|
|
6
|
+
|
|
7
|
+
When user types commands starting with `pa:`, recognize and execute them:
|
|
8
|
+
|
|
9
|
+
## Available Commands
|
|
10
|
+
|
|
11
|
+
### Core Commands
|
|
12
|
+
| Command | Action |
|
|
13
|
+
|---------|--------|
|
|
14
|
+
| `pa:help` | Show all available commands |
|
|
15
|
+
| `pa:feature "name"` | Start new feature workflow |
|
|
16
|
+
| `pa:fix "description"` | Quick bug fix mode |
|
|
17
|
+
| `pa:status` | Show current progress |
|
|
18
|
+
|
|
19
|
+
### Documentation Commands
|
|
20
|
+
| Command | Action |
|
|
21
|
+
|---------|--------|
|
|
22
|
+
| `pa:doc` | Show documentation options |
|
|
23
|
+
| `pa:doc-full` | Generate full project documentation |
|
|
24
|
+
| `pa:doc-moderate` | Generate balanced documentation |
|
|
25
|
+
| `pa:doc-lite` | Generate quick reference |
|
|
26
|
+
| `pa:doc-module [name]` | Document specific module |
|
|
27
|
+
| `pa:doc-file [path]` | Document specific file |
|
|
28
|
+
| `pa:doc-api` | Generate API documentation |
|
|
29
|
+
| `pa:readme` | Generate/update README |
|
|
30
|
+
| `pa:changelog` | Update CHANGELOG.md |
|
|
31
|
+
| `pa:release` | Generate release notes |
|
|
32
|
+
| `pa:release [version]` | Version-specific release notes |
|
|
33
|
+
|
|
34
|
+
### Quality Commands
|
|
35
|
+
| Command | Action |
|
|
36
|
+
|---------|--------|
|
|
37
|
+
| `pa:qa` | Run quality assurance checks |
|
|
38
|
+
| `pa:test` | Run test workflow |
|
|
39
|
+
| `pa:review` | Code review workflow |
|
|
40
|
+
|
|
41
|
+
### Deployment Commands
|
|
42
|
+
| Command | Action |
|
|
43
|
+
|---------|--------|
|
|
44
|
+
| `pa:deploy` | Deployment preparation |
|
|
45
|
+
| `pa:rollback` | Rollback procedures |
|
|
46
|
+
|
|
47
|
+
## Execution Instructions
|
|
48
|
+
|
|
49
|
+
When user types a `pa:` command:
|
|
50
|
+
|
|
51
|
+
1. **Read the corresponding prompt file** from `./proagents/prompts/`
|
|
52
|
+
2. **Follow the workflow** defined in that prompt
|
|
53
|
+
3. **Use project config** from `./proagents/proagents.config.yaml`
|
|
54
|
+
|
|
55
|
+
## Prompt File Mapping
|
|
56
|
+
|
|
57
|
+
- `pa:feature` → Read `./proagents/prompts/00-init.md` and `./proagents/WORKFLOW.md`
|
|
58
|
+
- `pa:fix` → Read `./proagents/workflow-modes/entry-modes.md` (Bug Fix Fast Track section)
|
|
59
|
+
- `pa:doc*` → Read `./proagents/prompts/07-documentation.md`
|
|
60
|
+
- `pa:qa` → Read `./proagents/checklists/code-quality.md`
|
|
61
|
+
- `pa:test` → Read `./proagents/prompts/06-testing.md`
|
|
62
|
+
- `pa:deploy` → Read `./proagents/prompts/08-deployment.md`
|
|
63
|
+
- `pa:release` → Read `./proagents/prompts/07-documentation.md` (Release Notes section)
|
|
64
|
+
|
|
65
|
+
## Key Reference Files
|
|
66
|
+
|
|
67
|
+
| File | Purpose |
|
|
68
|
+
|------|---------|
|
|
69
|
+
| `./proagents/WORKFLOW.md` | Full 10-phase workflow documentation |
|
|
70
|
+
| `./proagents/PROAGENTS.md` | Quick command reference |
|
|
71
|
+
| `./proagents/prompts/` | Phase-specific AI prompts |
|
|
72
|
+
| `./proagents/proagents.config.yaml` | Project configuration |
|
|
73
|
+
|
|
74
|
+
## Important Notes
|
|
75
|
+
|
|
76
|
+
- Always check `./proagents/` folder for project-specific configurations
|
|
77
|
+
- Preserve user's `proagents.config.yaml` settings
|
|
78
|
+
- Follow existing code patterns found in the project
|
|
79
|
+
- Use the checklists in `./proagents/checklists/` for quality gates
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# ProAgents Commands for Gemini
|
|
2
|
+
|
|
3
|
+
This project uses ProAgents - an AI-agnostic development workflow framework.
|
|
4
|
+
|
|
5
|
+
## Command Recognition
|
|
6
|
+
|
|
7
|
+
When user types commands starting with `pa:`, recognize and execute them:
|
|
8
|
+
|
|
9
|
+
## Core Commands
|
|
10
|
+
```
|
|
11
|
+
pa:help → Show all available commands
|
|
12
|
+
pa:feature "name" → Start new feature workflow
|
|
13
|
+
pa:fix "description" → Quick bug fix mode
|
|
14
|
+
pa:status → Show current progress
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Documentation Commands
|
|
18
|
+
```
|
|
19
|
+
pa:doc → Show documentation options
|
|
20
|
+
pa:doc-full → Generate full project documentation
|
|
21
|
+
pa:doc-moderate → Generate balanced documentation
|
|
22
|
+
pa:doc-lite → Generate quick reference
|
|
23
|
+
pa:doc-module [name] → Document specific module
|
|
24
|
+
pa:doc-file [path] → Document specific file
|
|
25
|
+
pa:doc-api → Generate API documentation
|
|
26
|
+
pa:readme → Generate/update README
|
|
27
|
+
pa:changelog → Update CHANGELOG.md
|
|
28
|
+
pa:release → Generate release notes
|
|
29
|
+
pa:release [version] → Version-specific release notes
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Quality & Testing Commands
|
|
33
|
+
```
|
|
34
|
+
pa:qa → Run quality assurance checks
|
|
35
|
+
pa:test → Run test workflow
|
|
36
|
+
pa:review → Code review workflow
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Deployment Commands
|
|
40
|
+
```
|
|
41
|
+
pa:deploy → Deployment preparation
|
|
42
|
+
pa:rollback → Rollback procedures
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## How to Execute
|
|
46
|
+
|
|
47
|
+
When user types a `pa:` command:
|
|
48
|
+
|
|
49
|
+
1. Read the corresponding prompt file from `./proagents/prompts/`
|
|
50
|
+
2. Follow the workflow instructions in that file
|
|
51
|
+
3. Use project configuration from `./proagents/proagents.config.yaml`
|
|
52
|
+
|
|
53
|
+
## Prompt File Mapping
|
|
54
|
+
|
|
55
|
+
| Command | Prompt File |
|
|
56
|
+
|---------|-------------|
|
|
57
|
+
| `pa:feature` | `./proagents/prompts/00-init.md` + `./proagents/WORKFLOW.md` |
|
|
58
|
+
| `pa:fix` | `./proagents/workflow-modes/entry-modes.md` (Bug Fix section) |
|
|
59
|
+
| `pa:doc*` | `./proagents/prompts/07-documentation.md` |
|
|
60
|
+
| `pa:qa` | `./proagents/checklists/code-quality.md` |
|
|
61
|
+
| `pa:test` | `./proagents/prompts/06-testing.md` |
|
|
62
|
+
| `pa:deploy` | `./proagents/prompts/08-deployment.md` |
|
|
63
|
+
| `pa:release` | `./proagents/prompts/07-documentation.md` (Release Notes section) |
|
|
64
|
+
|
|
65
|
+
## Key Files
|
|
66
|
+
|
|
67
|
+
- `./proagents/WORKFLOW.md` - Full 10-phase workflow documentation
|
|
68
|
+
- `./proagents/PROAGENTS.md` - Quick command reference
|
|
69
|
+
- `./proagents/prompts/` - Phase-specific AI prompts
|
|
70
|
+
- `./proagents/proagents.config.yaml` - Project configuration
|