proagents 1.0.0 → 1.0.1
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 +122 -11
- package/package.json +1 -1
- package/proagents/PROAGENTS.md +54 -0
- package/proagents/README.md +17 -17
- package/proagents/WORKFLOW.md +110 -110
- package/proagents/active-features/README.md +9 -9
- package/proagents/adr/README.md +15 -15
- package/proagents/api-versioning/changelog-template.md +4 -4
- package/proagents/api-versioning/deprecation-workflow.md +6 -6
- package/proagents/api-versioning/versioning-strategy.md +5 -5
- package/proagents/automation/ai-behavior-rules.md +1 -1
- package/proagents/automation/auto-decisions.md +6 -6
- package/proagents/cache/README.md +1 -1
- package/proagents/changelog/README.md +16 -16
- package/proagents/changelog/entry-template.md +4 -4
- package/proagents/cli/README.md +1 -1
- package/proagents/cli/slash-commands.md +202 -202
- package/proagents/collaboration/sessions.md +6 -6
- package/proagents/config/integrations/README.md +1 -1
- package/proagents/contract-testing/README.md +5 -5
- package/proagents/contract-testing/schema-validation.md +6 -6
- package/proagents/cost/cost-template.md +6 -6
- package/proagents/cost/estimation-framework.md +5 -5
- package/proagents/database/migration-workflow.md +6 -6
- package/proagents/database/rollback-scripts.md +6 -6
- package/proagents/database/safety-checks.md +6 -6
- package/proagents/examples/backend-nodejs/workflow-example.md +1 -1
- package/proagents/examples/web-frontend-react/workflow-example.md +1 -1
- package/proagents/existing-projects/README.md +3 -3
- package/proagents/existing-projects/challenges.md +1 -1
- package/proagents/existing-projects/coexistence-mode.md +8 -8
- package/proagents/existing-projects/compatibility-assessment.md +12 -12
- package/proagents/existing-projects/gradual-adoption.md +14 -14
- package/proagents/existing-projects/migration-strategies.md +7 -7
- package/proagents/existing-projects/pattern-reconciliation.md +10 -10
- package/proagents/existing-projects/team-onboarding.md +23 -23
- package/proagents/existing-projects/technical-debt-handling.md +24 -24
- package/proagents/getting-started/README.md +3 -3
- package/proagents/getting-started/ai-training-setup.md +24 -24
- package/proagents/getting-started/pm-integration.md +22 -22
- package/proagents/getting-started/prompt-engineering.md +4 -4
- package/proagents/getting-started/team-onboarding.md +5 -5
- package/proagents/git/branch-strategy.md +10 -10
- package/proagents/git/commit-conventions.md +5 -5
- package/proagents/git/pr-workflow.md +5 -5
- package/proagents/git/rollback-procedures.md +7 -7
- package/proagents/ide-integration/README.md +1 -1
- package/proagents/ide-integration/cline-config.md +10 -10
- package/proagents/ide-integration/continue-config.md +1 -1
- package/proagents/ide-integration/cursor-rules.md +10 -10
- package/proagents/ide-integration/github-copilot.md +4 -4
- package/proagents/ide-integration/windsurf-rules.md +9 -9
- package/proagents/learning/adaptation.md +10 -10
- package/proagents/learning/data-collection.md +9 -9
- package/proagents/learning/reports.md +14 -14
- package/proagents/metrics/README.md +6 -6
- package/proagents/metrics/code-quality-kpis.md +6 -6
- package/proagents/metrics/deployment-metrics.md +6 -6
- package/proagents/metrics/developer-productivity.md +5 -5
- package/proagents/metrics/learning-effectiveness.md +6 -6
- package/proagents/migrations/from-claude-projects.md +7 -6
- package/proagents/migrations/from-cursor-rules.md +1 -1
- package/proagents/notifications/templates.md +3 -3
- package/proagents/parallel-features/README.md +5 -5
- package/proagents/parallel-features/conflict-detection.md +6 -6
- package/proagents/parallel-features/dependency-management.md +7 -7
- package/proagents/parallel-features/merge-coordination.md +8 -8
- package/proagents/parallel-features/tracking-system.md +7 -7
- package/proagents/performance/bundle-analysis.md +4 -4
- package/proagents/performance/load-testing.md +7 -7
- package/proagents/performance/runtime-metrics.md +6 -6
- package/proagents/performance/web-vitals.md +6 -6
- package/proagents/plugins/README.md +1 -1
- package/proagents/plugins/creating-plugins.md +1 -1
- package/proagents/plugins/plugin-api.md +2 -2
- package/proagents/plugins/plugin-registry.md +3 -3
- package/proagents/proagents.config.yaml +32 -9
- package/proagents/prompts/00-init-wizard.md +18 -18
- package/proagents/prompts/00-init.md +93 -93
- package/proagents/prompts/01-analysis.md +5 -5
- package/proagents/prompts/02-requirements.md +8 -8
- package/proagents/prompts/03-ui-design.md +14 -14
- package/proagents/prompts/04-planning.md +10 -10
- package/proagents/prompts/05-implementation.md +10 -10
- package/proagents/prompts/06-testing.md +14 -14
- package/proagents/prompts/06.5-code-review.md +8 -8
- package/proagents/prompts/07-documentation.md +142 -20
- package/proagents/prompts/08-deployment.md +12 -12
- package/proagents/prompts/09-rollback.md +12 -12
- package/proagents/prompts/README.md +4 -4
- package/proagents/prompts/accessibility/README.md +6 -6
- package/proagents/prompts/accessibility/audit.md +3 -3
- package/proagents/prompts/accessibility/wcag.md +1 -1
- package/proagents/prompts/debugging/README.md +4 -4
- package/proagents/prompts/debugging/performance-debug.md +5 -5
- package/proagents/prompts/debugging/systematic.md +4 -4
- package/proagents/prompts/performance/README.md +4 -4
- package/proagents/prompts/performance/analyze.md +4 -4
- package/proagents/prompts/refactoring/README.md +4 -4
- package/proagents/prompts/refactoring/code-smells.md +9 -9
- package/proagents/prompts/refactoring/patterns.md +6 -6
- package/proagents/prompts/security-audit/README.md +6 -6
- package/proagents/prompts/security-audit/code-review.md +5 -5
- package/proagents/reverse-engineering/README.md +21 -21
- package/proagents/reverse-engineering/architecture-extraction.md +6 -6
- package/proagents/reverse-engineering/code-analysis.md +6 -6
- package/proagents/reverse-engineering/dependency-mapping.md +10 -10
- package/proagents/reverse-engineering/diagram-generation.md +9 -9
- package/proagents/reverse-engineering/documentation-generation.md +7 -7
- package/proagents/reverse-engineering/pattern-detection.md +8 -8
- package/proagents/reverse-engineering/quality-assessment.md +10 -10
- package/proagents/rules/README.md +7 -7
- package/proagents/rules/custom-rules.md +8 -8
- package/proagents/runbooks/README.md +9 -9
- package/proagents/runbooks/dependency-vulnerability.md +4 -4
- package/proagents/runbooks/incident-response.md +12 -12
- package/proagents/runbooks/performance-degradation.md +5 -5
- package/proagents/runbooks/production-debugging.md +5 -5
- package/proagents/scaffolding/nextjs/README.md +10 -10
- package/proagents/scaffolding/nodejs/README.md +10 -10
- package/proagents/scaffolding/project-types.md +7 -7
- package/proagents/scaffolding/react/README.md +6 -6
- package/proagents/scaffolding/react-native/README.md +10 -10
- package/proagents/security/owasp-checklist.md +3 -3
- package/proagents/security/sast-guide.md +6 -6
- package/proagents/security/security-report-template.md +5 -5
- package/proagents/security/vulnerability-scanning.md +6 -6
- package/proagents/slash-commands.json +50 -75
- package/proagents/standards/README.md +4 -4
- package/proagents/standards/architecture-patterns.md +10 -10
- package/proagents/standards/naming-conventions-template.md +4 -4
- package/proagents/standards/override-system.md +8 -8
- package/proagents/team/code-ownership.md +4 -4
- package/proagents/team/communication-templates.md +6 -6
- package/proagents/team/handoff-protocol.md +4 -4
- package/proagents/team/ide-setup/cursor.md +1 -1
- package/proagents/templates/README.md +1 -1
- package/proagents/templates/release-notes.md +214 -0
- package/proagents/ui-integration/figma-guide.md +3 -3
- package/proagents/ui-integration/manual-export-guide.md +2 -2
- package/proagents/ui-integration/sketch-interpretation.md +2 -2
- package/proagents/webhooks/events.md +3 -3
- package/proagents/workflow-modes/README.md +11 -11
- package/proagents/workflow-modes/deferred-tracking.md +12 -12
- package/proagents/workflow-modes/entry-modes.md +16 -16
- package/proagents/workflow-modes/guardrails.md +7 -7
- package/proagents/workflow-modes/mode-detection.md +7 -7
- package/proagents/workflow-modes/mode-switching.md +9 -9
|
@@ -54,9 +54,9 @@ proagents collab start \
|
|
|
54
54
|
│ https://proagents.io/collab/sess_abc123xyz │
|
|
55
55
|
│ │
|
|
56
56
|
│ Commands: │
|
|
57
|
-
│ •
|
|
58
|
-
│ •
|
|
59
|
-
│ •
|
|
57
|
+
│ • pa:invite <email> - Invite participant │
|
|
58
|
+
│ • pa:status - Show session status │
|
|
59
|
+
│ • pa:end - End session │
|
|
60
60
|
│ │
|
|
61
61
|
│ Waiting for participants... │
|
|
62
62
|
│ │
|
|
@@ -309,13 +309,13 @@ proagents collab export sess_abc123 --format markdown
|
|
|
309
309
|
|
|
310
310
|
```bash
|
|
311
311
|
# Send message (in session)
|
|
312
|
-
|
|
312
|
+
pa:chat Ready to switch roles?
|
|
313
313
|
|
|
314
314
|
# Send code reference
|
|
315
|
-
|
|
315
|
+
pa:chat Check line 45 in AuthService.ts
|
|
316
316
|
|
|
317
317
|
# React to message
|
|
318
|
-
|
|
318
|
+
pa:react 👍
|
|
319
319
|
```
|
|
320
320
|
|
|
321
321
|
### Voice/Video Integration
|
|
@@ -20,7 +20,7 @@ Configuration examples for integrating ProAgents with external tools.
|
|
|
20
20
|
|
|
21
21
|
1. **Copy the example config** to your `proagents.config.yaml`
|
|
22
22
|
2. **Set environment variables** for API keys (never commit secrets)
|
|
23
|
-
3. **Test the integration** with
|
|
23
|
+
3. **Test the integration** with `pa:integration test <name>`
|
|
24
24
|
|
|
25
25
|
---
|
|
26
26
|
|
|
@@ -136,19 +136,19 @@ describe('User Service Provider', () => {
|
|
|
136
136
|
|
|
137
137
|
```bash
|
|
138
138
|
# Run consumer tests
|
|
139
|
-
|
|
139
|
+
pa:contract test consumer
|
|
140
140
|
|
|
141
141
|
# Run provider tests
|
|
142
|
-
|
|
142
|
+
pa:contract test provider
|
|
143
143
|
|
|
144
144
|
# Publish contracts
|
|
145
|
-
|
|
145
|
+
pa:contract publish
|
|
146
146
|
|
|
147
147
|
# Verify contracts
|
|
148
|
-
|
|
148
|
+
pa:contract verify
|
|
149
149
|
|
|
150
150
|
# Generate contract documentation
|
|
151
|
-
|
|
151
|
+
pa:contract docs
|
|
152
152
|
```
|
|
153
153
|
|
|
154
154
|
---
|
|
@@ -505,22 +505,22 @@ app.post('/api/users', validate(CreateUserSchema), createUser);
|
|
|
505
505
|
|
|
506
506
|
```bash
|
|
507
507
|
# Validate schema files
|
|
508
|
-
|
|
508
|
+
pa:schema validate ./schemas/
|
|
509
509
|
|
|
510
510
|
# Generate JSON Schema from TypeScript
|
|
511
|
-
|
|
511
|
+
pa:schema generate --from types.ts --out schemas/
|
|
512
512
|
|
|
513
513
|
# Compare schemas for breaking changes
|
|
514
|
-
|
|
514
|
+
pa:schema diff ./old-schema.json ./new-schema.json
|
|
515
515
|
|
|
516
516
|
# Generate TypeScript from JSON Schema
|
|
517
|
-
|
|
517
|
+
pa:schema to-typescript ./schemas/user.json
|
|
518
518
|
|
|
519
519
|
# Validate OpenAPI spec
|
|
520
|
-
|
|
520
|
+
pa:schema openapi validate ./openapi.yaml
|
|
521
521
|
|
|
522
522
|
# Generate mock data from schema
|
|
523
|
-
|
|
523
|
+
pa:schema mock ./schemas/user.json
|
|
524
524
|
```
|
|
525
525
|
|
|
526
526
|
---
|
|
@@ -272,12 +272,12 @@ results:
|
|
|
272
272
|
|
|
273
273
|
---
|
|
274
274
|
|
|
275
|
-
##
|
|
275
|
+
## Commands
|
|
276
276
|
|
|
277
277
|
| Command | Description |
|
|
278
278
|
|---------|-------------|
|
|
279
|
-
|
|
|
280
|
-
|
|
|
281
|
-
|
|
|
282
|
-
|
|
|
283
|
-
|
|
|
279
|
+
| `pa:cost-estimate` | Start cost estimation wizard |
|
|
280
|
+
| `pa:cost-estimate --template` | Get blank template |
|
|
281
|
+
| `pa:cost-estimate --quick` | Quick estimate calculator |
|
|
282
|
+
| `pa:cost-report` | Generate cost report |
|
|
283
|
+
| `pa:cost-compare` | Compare actual vs estimated |
|
|
@@ -277,11 +277,11 @@ monitoring:
|
|
|
277
277
|
|
|
278
278
|
---
|
|
279
279
|
|
|
280
|
-
##
|
|
280
|
+
## Commands
|
|
281
281
|
|
|
282
282
|
| Command | Description |
|
|
283
283
|
|---------|-------------|
|
|
284
|
-
|
|
|
285
|
-
|
|
|
286
|
-
|
|
|
287
|
-
|
|
|
284
|
+
| `pa:cost-estimate` | Generate cost estimate for feature |
|
|
285
|
+
| `pa:cost-compare` | Compare costs across providers |
|
|
286
|
+
| `pa:cost-report` | View current costs |
|
|
287
|
+
| `pa:cost-optimize` | Get optimization suggestions |
|
|
@@ -467,12 +467,12 @@ database:
|
|
|
467
467
|
|
|
468
468
|
---
|
|
469
469
|
|
|
470
|
-
##
|
|
470
|
+
## Commands
|
|
471
471
|
|
|
472
472
|
| Command | Description |
|
|
473
473
|
|---------|-------------|
|
|
474
|
-
|
|
|
475
|
-
|
|
|
476
|
-
|
|
|
477
|
-
|
|
|
478
|
-
|
|
|
474
|
+
| `pa:migration-create [name]` | Create new migration |
|
|
475
|
+
| `pa:migration-run` | Run pending migrations |
|
|
476
|
+
| `pa:migration-rollback` | Rollback last migration |
|
|
477
|
+
| `pa:migration-status` | Show migration status |
|
|
478
|
+
| `pa:migration-test` | Test migration |
|
|
@@ -476,12 +476,12 @@ database:
|
|
|
476
476
|
|
|
477
477
|
---
|
|
478
478
|
|
|
479
|
-
##
|
|
479
|
+
## Commands
|
|
480
480
|
|
|
481
481
|
| Command | Description |
|
|
482
482
|
|---------|-------------|
|
|
483
|
-
|
|
|
484
|
-
|
|
|
485
|
-
|
|
|
486
|
-
|
|
|
487
|
-
|
|
|
483
|
+
| `pa:db-rollback` | Interactive rollback wizard |
|
|
484
|
+
| `pa:db-rollback --last` | Rollback last migration |
|
|
485
|
+
| `pa:db-rollback --to [version]` | Rollback to specific version |
|
|
486
|
+
| `pa:db-rollback --dry-run` | Preview rollback changes |
|
|
487
|
+
| `pa:db-rollback --generate [migration]` | Generate rollback script |
|
|
@@ -436,12 +436,12 @@ database:
|
|
|
436
436
|
|
|
437
437
|
---
|
|
438
438
|
|
|
439
|
-
##
|
|
439
|
+
## Commands
|
|
440
440
|
|
|
441
441
|
| Command | Description |
|
|
442
442
|
|---------|-------------|
|
|
443
|
-
|
|
|
444
|
-
|
|
|
445
|
-
|
|
|
446
|
-
|
|
|
447
|
-
|
|
|
443
|
+
| `pa:db-check` | Run safety checks on pending migrations |
|
|
444
|
+
| `pa:db-check --migration [name]` | Check specific migration |
|
|
445
|
+
| `pa:db-check --dry-run` | Preview changes without running |
|
|
446
|
+
| `pa:db-diff` | Show schema diff |
|
|
447
|
+
| `pa:db-locks` | Show active database locks |
|
|
@@ -23,13 +23,13 @@ This guide addresses each challenge with practical solutions.
|
|
|
23
23
|
|
|
24
24
|
```bash
|
|
25
25
|
# Initialize with existing project mode
|
|
26
|
-
|
|
26
|
+
pa:init --existing
|
|
27
27
|
|
|
28
28
|
# Run compatibility assessment first
|
|
29
|
-
|
|
29
|
+
pa:assess-compatibility
|
|
30
30
|
|
|
31
31
|
# Generate adoption plan
|
|
32
|
-
|
|
32
|
+
pa:adoption-plan
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
---
|
|
@@ -855,7 +855,7 @@ exceptions:
|
|
|
855
855
|
|
|
856
856
|
## Next Steps
|
|
857
857
|
|
|
858
|
-
1. Run
|
|
858
|
+
1. Run `pa:assess-compatibility` to identify which issues affect your project
|
|
859
859
|
2. Review `gradual-adoption.md` for step-by-step adoption
|
|
860
860
|
3. Use `pattern-reconciliation.md` to handle convention conflicts
|
|
861
861
|
4. See `coexistence-mode.md` for running alongside existing workflows
|
|
@@ -398,7 +398,7 @@ escape_hatches:
|
|
|
398
398
|
when: "Hook causing issues"
|
|
399
399
|
|
|
400
400
|
skip_analysis:
|
|
401
|
-
command: "
|
|
401
|
+
command: "pa:disable --temp"
|
|
402
402
|
when: "Need to move fast"
|
|
403
403
|
|
|
404
404
|
exempt_file:
|
|
@@ -406,7 +406,7 @@ escape_hatches:
|
|
|
406
406
|
when: "File should be excluded"
|
|
407
407
|
|
|
408
408
|
exempt_feature:
|
|
409
|
-
method: "
|
|
409
|
+
method: "pa:feature exempt [name]"
|
|
410
410
|
when: "Feature shouldn't be tracked"
|
|
411
411
|
```
|
|
412
412
|
|
|
@@ -472,12 +472,12 @@ coexistence_metrics:
|
|
|
472
472
|
|
|
473
473
|
---
|
|
474
474
|
|
|
475
|
-
##
|
|
475
|
+
## Commands
|
|
476
476
|
|
|
477
477
|
| Command | Description |
|
|
478
478
|
|---------|-------------|
|
|
479
|
-
|
|
|
480
|
-
|
|
|
481
|
-
|
|
|
482
|
-
|
|
|
483
|
-
|
|
|
479
|
+
| `pa:coexist-status` | View coexistence status |
|
|
480
|
+
| `pa:coexist-level [1-4]` | Set coexistence level |
|
|
481
|
+
| `pa:coexist-exempt [path]` | Exempt path from ProAgents |
|
|
482
|
+
| `pa:coexist-conflicts` | View any conflicts |
|
|
483
|
+
| `pa:proagents disable --temp` | Temporarily disable |
|
|
@@ -18,18 +18,18 @@ The compatibility assessment:
|
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
20
|
# Full compatibility assessment
|
|
21
|
-
|
|
21
|
+
pa:assess-compatibility
|
|
22
22
|
|
|
23
23
|
# Quick assessment (faster, less detailed)
|
|
24
|
-
|
|
24
|
+
pa:assess-compatibility --quick
|
|
25
25
|
|
|
26
26
|
# Assessment with report
|
|
27
|
-
|
|
27
|
+
pa:assess-compatibility --report
|
|
28
28
|
|
|
29
29
|
# Assessment for specific areas
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
30
|
+
pa:assess-compatibility --focus patterns
|
|
31
|
+
pa:assess-compatibility --focus security
|
|
32
|
+
pa:assess-compatibility --focus testing
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
---
|
|
@@ -530,12 +530,12 @@ adoption:
|
|
|
530
530
|
|
|
531
531
|
---
|
|
532
532
|
|
|
533
|
-
##
|
|
533
|
+
## Commands
|
|
534
534
|
|
|
535
535
|
| Command | Description |
|
|
536
536
|
|---------|-------------|
|
|
537
|
-
|
|
|
538
|
-
|
|
|
539
|
-
|
|
|
540
|
-
|
|
|
541
|
-
|
|
|
537
|
+
| `pa:assess-compatibility` | Run full assessment |
|
|
538
|
+
| `pa:assess-compatibility --quick` | Quick assessment |
|
|
539
|
+
| `pa:assess-compatibility --report` | Generate report |
|
|
540
|
+
| `pa:assess-compatibility --config` | Generate config |
|
|
541
|
+
| `pa:assess-compatibility --focus [area]` | Focus on specific area |
|
|
@@ -49,16 +49,16 @@ Gradual adoption allows:
|
|
|
49
49
|
|
|
50
50
|
```bash
|
|
51
51
|
# 1. Initialize ProAgents (non-invasive)
|
|
52
|
-
|
|
52
|
+
pa:init --existing --assess-only
|
|
53
53
|
|
|
54
54
|
# 2. Run compatibility assessment
|
|
55
|
-
|
|
55
|
+
pa:assess-compatibility --report
|
|
56
56
|
|
|
57
57
|
# 3. Review generated configuration
|
|
58
|
-
|
|
58
|
+
pa:config review
|
|
59
59
|
|
|
60
60
|
# 4. Identify pilot feature
|
|
61
|
-
|
|
61
|
+
pa:adoption-plan --suggest-pilot
|
|
62
62
|
```
|
|
63
63
|
|
|
64
64
|
### Deliverables
|
|
@@ -121,16 +121,16 @@ ideal_pilot_feature:
|
|
|
121
121
|
|
|
122
122
|
```bash
|
|
123
123
|
# 1. Start pilot feature with ProAgents
|
|
124
|
-
|
|
124
|
+
pa:feature start "User Preferences" --pilot
|
|
125
125
|
|
|
126
126
|
# 2. Follow full workflow
|
|
127
127
|
# ... (all phases)
|
|
128
128
|
|
|
129
129
|
# 3. Collect feedback
|
|
130
|
-
|
|
130
|
+
pa:pilot-feedback
|
|
131
131
|
|
|
132
132
|
# 4. Review and adjust
|
|
133
|
-
|
|
133
|
+
pa:config adjust --based-on pilot
|
|
134
134
|
```
|
|
135
135
|
|
|
136
136
|
### Configuration for Phase 2
|
|
@@ -503,13 +503,13 @@ rollback:
|
|
|
503
503
|
|
|
504
504
|
---
|
|
505
505
|
|
|
506
|
-
##
|
|
506
|
+
## Commands
|
|
507
507
|
|
|
508
508
|
| Command | Description |
|
|
509
509
|
|---------|-------------|
|
|
510
|
-
|
|
|
511
|
-
|
|
|
512
|
-
|
|
|
513
|
-
|
|
|
514
|
-
|
|
|
515
|
-
|
|
|
510
|
+
| `pa:adoption-plan` | Generate adoption plan |
|
|
511
|
+
| `pa:adoption-status` | View adoption phase |
|
|
512
|
+
| `pa:adoption-advance` | Move to next phase |
|
|
513
|
+
| `pa:adoption-rollback` | Move to previous phase |
|
|
514
|
+
| `pa:pilot-start [feature]` | Start pilot feature |
|
|
515
|
+
| `pa:pilot-feedback` | Submit pilot feedback |
|
|
@@ -776,13 +776,13 @@ migrations:
|
|
|
776
776
|
|
|
777
777
|
---
|
|
778
778
|
|
|
779
|
-
##
|
|
779
|
+
## Commands
|
|
780
780
|
|
|
781
781
|
| Command | Description |
|
|
782
782
|
|---------|-------------|
|
|
783
|
-
|
|
|
784
|
-
|
|
|
785
|
-
|
|
|
786
|
-
|
|
|
787
|
-
|
|
|
788
|
-
|
|
|
783
|
+
| `pa:migrate-status` | View migration progress |
|
|
784
|
+
| `pa:migrate-plan [type]` | Create migration plan |
|
|
785
|
+
| `pa:migrate-file [path]` | Migrate specific file |
|
|
786
|
+
| `pa:migrate-module [name]` | Migrate entire module |
|
|
787
|
+
| `pa:migrate-rollback [id]` | Rollback migration |
|
|
788
|
+
| `pa:migrate-report` | Generate migration report |
|
|
@@ -20,12 +20,12 @@ Existing projects often have multiple patterns for the same thing. Pattern recon
|
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
22
|
# Detect all patterns
|
|
23
|
-
|
|
23
|
+
pa:detect-patterns
|
|
24
24
|
|
|
25
25
|
# Focus on specific area
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
26
|
+
pa:detect-patterns --type state-management
|
|
27
|
+
pa:detect-patterns --type components
|
|
28
|
+
pa:detect-patterns --type api
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
### Detection Output
|
|
@@ -478,12 +478,12 @@ pattern_reconciliation:
|
|
|
478
478
|
|
|
479
479
|
---
|
|
480
480
|
|
|
481
|
-
##
|
|
481
|
+
## Commands
|
|
482
482
|
|
|
483
483
|
| Command | Description |
|
|
484
484
|
|---------|-------------|
|
|
485
|
-
|
|
|
486
|
-
|
|
|
487
|
-
|
|
|
488
|
-
|
|
|
489
|
-
|
|
|
485
|
+
| `pa:detect-patterns` | Detect all patterns |
|
|
486
|
+
| `pa:pattern-status` | View pattern usage |
|
|
487
|
+
| `pa:pattern-reconcile` | Start reconciliation |
|
|
488
|
+
| `pa:pattern-migrate [from] [to]` | Plan migration |
|
|
489
|
+
| `pa:pattern-document` | Generate pattern docs |
|
|
@@ -180,27 +180,27 @@ practice_feature:
|
|
|
180
180
|
exercises:
|
|
181
181
|
exercise_1:
|
|
182
182
|
name: "Start a Feature"
|
|
183
|
-
command: "
|
|
183
|
+
command: "pa:feature 'Practice Feature'"
|
|
184
184
|
learn: "Feature initialization"
|
|
185
185
|
|
|
186
186
|
exercise_2:
|
|
187
187
|
name: "Check Analysis"
|
|
188
|
-
command: "
|
|
188
|
+
command: "pa:analyze"
|
|
189
189
|
learn: "Codebase analysis"
|
|
190
190
|
|
|
191
191
|
exercise_3:
|
|
192
192
|
name: "Document Progress"
|
|
193
|
-
command: "
|
|
193
|
+
command: "pa:doc-moderate"
|
|
194
194
|
learn: "Documentation generation"
|
|
195
195
|
|
|
196
196
|
exercise_4:
|
|
197
197
|
name: "Run Quality Checks"
|
|
198
|
-
command: "
|
|
198
|
+
command: "pa:qa"
|
|
199
199
|
learn: "Quality assurance"
|
|
200
200
|
|
|
201
201
|
exercise_5:
|
|
202
202
|
name: "Complete Feature"
|
|
203
|
-
command: "
|
|
203
|
+
command: "pa:feature-complete"
|
|
204
204
|
learn: "Feature completion"
|
|
205
205
|
```
|
|
206
206
|
|
|
@@ -259,16 +259,16 @@ buddy_system:
|
|
|
259
259
|
## Troubleshooting Guide
|
|
260
260
|
|
|
261
261
|
### "Analysis is taking too long"
|
|
262
|
-
Solution: Use
|
|
262
|
+
Solution: Use `pa:analyze --depth moderate` for faster analysis
|
|
263
263
|
|
|
264
264
|
### "Conflict detected with another feature"
|
|
265
|
-
Solution: Check
|
|
265
|
+
Solution: Check `pa:feature-list` and coordinate with the other developer
|
|
266
266
|
|
|
267
267
|
### "Not sure which phase I'm in"
|
|
268
|
-
Solution: Run
|
|
268
|
+
Solution: Run `pa:status` to see current phase and progress
|
|
269
269
|
|
|
270
270
|
### "Want to skip a phase"
|
|
271
|
-
Solution: Use Bug Fix Mode (
|
|
271
|
+
Solution: Use Bug Fix Mode (`pa:fix`) or configure checkpoints
|
|
272
272
|
|
|
273
273
|
### "Generated code doesn't match our style"
|
|
274
274
|
Solution: Check if standards are configured in `proagents.config.yaml`
|
|
@@ -308,7 +308,7 @@ advanced_training:
|
|
|
308
308
|
duration: "30 min"
|
|
309
309
|
content:
|
|
310
310
|
- "CI/CD integration"
|
|
311
|
-
- "Custom
|
|
311
|
+
- "Custom commands"
|
|
312
312
|
- "PM tool integration"
|
|
313
313
|
|
|
314
314
|
session_4:
|
|
@@ -353,12 +353,12 @@ champion_program:
|
|
|
353
353
|
## Essential Commands
|
|
354
354
|
| Command | Description |
|
|
355
355
|
|---------|-------------|
|
|
356
|
-
|
|
|
357
|
-
|
|
|
358
|
-
|
|
|
359
|
-
|
|
|
360
|
-
|
|
|
361
|
-
|
|
|
356
|
+
| `pa:feature start [name]` | Start new feature |
|
|
357
|
+
| `pa:status` | Check current status |
|
|
358
|
+
| `pa:analyze` | Analyze codebase |
|
|
359
|
+
| `pa:qa` | Run quality checks |
|
|
360
|
+
| `pa:doc` | Generate docs |
|
|
361
|
+
| `pa:feature-complete` | Complete feature |
|
|
362
362
|
|
|
363
363
|
## Modes
|
|
364
364
|
| Mode | Use For |
|
|
@@ -415,7 +415,7 @@ video_library:
|
|
|
415
415
|
developer_onboarding:
|
|
416
416
|
focus:
|
|
417
417
|
- "Day-to-day workflow"
|
|
418
|
-
- "
|
|
418
|
+
- "Commands"
|
|
419
419
|
- "Writing code with ProAgents"
|
|
420
420
|
|
|
421
421
|
skip:
|
|
@@ -606,12 +606,12 @@ onboarding:
|
|
|
606
606
|
|
|
607
607
|
---
|
|
608
608
|
|
|
609
|
-
##
|
|
609
|
+
## Commands
|
|
610
610
|
|
|
611
611
|
| Command | Description |
|
|
612
612
|
|---------|-------------|
|
|
613
|
-
|
|
|
614
|
-
|
|
|
615
|
-
|
|
|
616
|
-
|
|
|
617
|
-
|
|
|
613
|
+
| `pa:help` | Show all available commands |
|
|
614
|
+
| `pa:tutorial` | Start interactive tutorial |
|
|
615
|
+
| `pa:tips` | Show contextual tips |
|
|
616
|
+
| `pa:feedback` | Submit feedback |
|
|
617
|
+
| `pa:support` | Get support resources |
|
|
@@ -56,15 +56,15 @@ ProAgents helps track and gradually reduce debt without blocking progress.
|
|
|
56
56
|
|
|
57
57
|
```bash
|
|
58
58
|
# Full technical debt assessment
|
|
59
|
-
|
|
59
|
+
pa:debt-assess
|
|
60
60
|
|
|
61
61
|
# Assess specific category
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
62
|
+
pa:debt-assess --category testing
|
|
63
|
+
pa:debt-assess --category security
|
|
64
|
+
pa:debt-assess --category patterns
|
|
65
65
|
|
|
66
66
|
# Quick assessment
|
|
67
|
-
|
|
67
|
+
pa:debt-assess --quick
|
|
68
68
|
```
|
|
69
69
|
|
|
70
70
|
### Assessment Output
|
|
@@ -345,11 +345,11 @@ testing_debt:
|
|
|
345
345
|
|
|
346
346
|
tools:
|
|
347
347
|
- name: "Coverage report"
|
|
348
|
-
command: "
|
|
348
|
+
command: "pa:test-coverage"
|
|
349
349
|
- name: "Untested code finder"
|
|
350
|
-
command: "
|
|
350
|
+
command: "pa:find-untested"
|
|
351
351
|
- name: "Test generator"
|
|
352
|
-
command: "
|
|
352
|
+
command: "pa:generate-tests [file]"
|
|
353
353
|
|
|
354
354
|
configuration:
|
|
355
355
|
block_pr_below: null # Don't block existing
|
|
@@ -375,10 +375,10 @@ security_debt:
|
|
|
375
375
|
timeline: "1 week"
|
|
376
376
|
|
|
377
377
|
process:
|
|
378
|
-
1_scan: "
|
|
378
|
+
1_scan: "pa:security-scan"
|
|
379
379
|
2_prioritize: "Critical → High → Medium → Low"
|
|
380
380
|
3_fix: "Dedicated security sprint if needed"
|
|
381
|
-
4_verify: "
|
|
381
|
+
4_verify: "pa:security-scan --verify"
|
|
382
382
|
|
|
383
383
|
automation:
|
|
384
384
|
dependency_scanning: "daily"
|
|
@@ -413,11 +413,11 @@ documentation_debt:
|
|
|
413
413
|
|
|
414
414
|
commands:
|
|
415
415
|
- name: "Generate all docs"
|
|
416
|
-
command: "
|
|
416
|
+
command: "pa:doc-full"
|
|
417
417
|
- name: "Update README"
|
|
418
|
-
command: "
|
|
418
|
+
command: "pa:doc-readme"
|
|
419
419
|
- name: "API documentation"
|
|
420
|
-
command: "
|
|
420
|
+
command: "pa:doc-api"
|
|
421
421
|
|
|
422
422
|
configuration:
|
|
423
423
|
auto_update: true
|
|
@@ -450,11 +450,11 @@ code_quality_debt:
|
|
|
450
450
|
|
|
451
451
|
tools:
|
|
452
452
|
- name: "Complexity report"
|
|
453
|
-
command: "
|
|
453
|
+
command: "pa:quality-complexity"
|
|
454
454
|
- name: "Duplication finder"
|
|
455
|
-
command: "
|
|
455
|
+
command: "pa:quality-duplicates"
|
|
456
456
|
- name: "Code smell detector"
|
|
457
|
-
command: "
|
|
457
|
+
command: "pa:quality-smells"
|
|
458
458
|
|
|
459
459
|
configuration:
|
|
460
460
|
block_new_smells: true
|
|
@@ -631,14 +631,14 @@ technical_debt:
|
|
|
631
631
|
|
|
632
632
|
---
|
|
633
633
|
|
|
634
|
-
##
|
|
634
|
+
## Commands
|
|
635
635
|
|
|
636
636
|
| Command | Description |
|
|
637
637
|
|---------|-------------|
|
|
638
|
-
|
|
|
639
|
-
|
|
|
640
|
-
|
|
|
641
|
-
|
|
|
642
|
-
|
|
|
643
|
-
|
|
|
644
|
-
|
|
|
638
|
+
| `pa:debt-assess` | Run debt assessment |
|
|
639
|
+
| `pa:debt-status` | View debt dashboard |
|
|
640
|
+
| `pa:debt-list` | List all debt items |
|
|
641
|
+
| `pa:debt-add` | Add debt item manually |
|
|
642
|
+
| `pa:debt-resolve [id]` | Mark item as resolved |
|
|
643
|
+
| `pa:debt-report` | Generate debt report |
|
|
644
|
+
| `pa:debt-trends` | View debt trends |
|