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
package/proagents/WORKFLOW.md
CHANGED
|
@@ -32,7 +32,7 @@ ProAgents is a 10-phase development workflow that guides you from idea to deploy
|
|
|
32
32
|
│ ProAgents Workflow Overview │
|
|
33
33
|
├─────────────────────────────────────────────────────────────────────┤
|
|
34
34
|
│ │
|
|
35
|
-
│
|
|
35
|
+
│ pa:init ──► Phase 0: Initialization │
|
|
36
36
|
│ │ │
|
|
37
37
|
│ ▼ │
|
|
38
38
|
│ Phase 1: Deep Analysis (existing projects) │
|
|
@@ -104,7 +104,7 @@ The system continuously improves by learning:
|
|
|
104
104
|
|
|
105
105
|
### Phase 0: Initialization & Context Gathering
|
|
106
106
|
|
|
107
|
-
**
|
|
107
|
+
**Command:** `pa:init` or `pa:feature "Feature name"`
|
|
108
108
|
|
|
109
109
|
**Purpose:** Set up the context for a new feature or task.
|
|
110
110
|
|
|
@@ -128,7 +128,7 @@ The system continuously improves by learning:
|
|
|
128
128
|
|
|
129
129
|
**Example:**
|
|
130
130
|
```bash
|
|
131
|
-
|
|
131
|
+
pa:feature "Add user authentication with OAuth2"
|
|
132
132
|
|
|
133
133
|
# Output:
|
|
134
134
|
# ✓ Project type: Next.js full-stack
|
|
@@ -141,7 +141,7 @@ The system continuously improves by learning:
|
|
|
141
141
|
# - src/components/auth/
|
|
142
142
|
# - src/lib/auth.ts
|
|
143
143
|
#
|
|
144
|
-
# Ready for Phase 1: Analysis (or skip with
|
|
144
|
+
# Ready for Phase 1: Analysis (or skip with pa:skip-to requirements)
|
|
145
145
|
```
|
|
146
146
|
|
|
147
147
|
**Configuration:**
|
|
@@ -158,7 +158,7 @@ phase_0:
|
|
|
158
158
|
|
|
159
159
|
### Phase 1: Deep Analysis (Existing Projects)
|
|
160
160
|
|
|
161
|
-
**
|
|
161
|
+
**Command:** `pa:analyze` or `pa:analyze-full`
|
|
162
162
|
|
|
163
163
|
**Purpose:** Thoroughly understand the existing codebase before making changes.
|
|
164
164
|
|
|
@@ -217,14 +217,14 @@ Detected patterns:
|
|
|
217
217
|
|
|
218
218
|
| Level | Command | Use Case | Duration |
|
|
219
219
|
|-------|---------|----------|----------|
|
|
220
|
-
| Lite |
|
|
221
|
-
| Moderate |
|
|
222
|
-
| Full |
|
|
220
|
+
| Lite | `pa:analyze-lite` | Quick overview | 1-2 min |
|
|
221
|
+
| Moderate | `pa:analyze` | Standard analysis | 5-10 min |
|
|
222
|
+
| Full | `pa:analyze-full` | Comprehensive | 15-30 min |
|
|
223
223
|
|
|
224
224
|
**Caching:**
|
|
225
225
|
- Analysis results are cached for performance
|
|
226
226
|
- Cache invalidates on significant file changes
|
|
227
|
-
- Manual refresh:
|
|
227
|
+
- Manual refresh: `pa:analyze --refresh`
|
|
228
228
|
|
|
229
229
|
**Output:** Codebase Analysis Report
|
|
230
230
|
|
|
@@ -234,7 +234,7 @@ Detected patterns:
|
|
|
234
234
|
|
|
235
235
|
### Phase 2: Requirements Engineering
|
|
236
236
|
|
|
237
|
-
**
|
|
237
|
+
**Command:** `pa:requirements`
|
|
238
238
|
|
|
239
239
|
**Purpose:** Gather and document complete feature requirements.
|
|
240
240
|
|
|
@@ -291,7 +291,7 @@ Detected patterns:
|
|
|
291
291
|
|
|
292
292
|
### Phase 3: UI/UX Design Integration
|
|
293
293
|
|
|
294
|
-
**
|
|
294
|
+
**Command:** `pa:design`
|
|
295
295
|
|
|
296
296
|
**Purpose:** Integrate UI designs into implementation specifications.
|
|
297
297
|
|
|
@@ -299,7 +299,7 @@ Detected patterns:
|
|
|
299
299
|
|
|
300
300
|
#### Option A: Figma Integration
|
|
301
301
|
```bash
|
|
302
|
-
|
|
302
|
+
pa:design-figma --url "https://figma.com/file/..."
|
|
303
303
|
```
|
|
304
304
|
- Extracts design tokens (colors, typography, spacing)
|
|
305
305
|
- Identifies components and variants
|
|
@@ -308,7 +308,7 @@ Detected patterns:
|
|
|
308
308
|
|
|
309
309
|
#### Option B: Manual Export
|
|
310
310
|
```bash
|
|
311
|
-
|
|
311
|
+
pa:design-export --file "./designs/dashboard.png"
|
|
312
312
|
```
|
|
313
313
|
- AI analyzes design images
|
|
314
314
|
- Extracts layout structure
|
|
@@ -317,7 +317,7 @@ Detected patterns:
|
|
|
317
317
|
|
|
318
318
|
#### Option C: Sketches/Wireframes
|
|
319
319
|
```bash
|
|
320
|
-
|
|
320
|
+
pa:design-sketch --file "./sketches/login-flow.jpg"
|
|
321
321
|
```
|
|
322
322
|
- Interprets hand-drawn wireframes
|
|
323
323
|
- Generates component structure
|
|
@@ -341,7 +341,7 @@ Navigation → <Nav> with routes
|
|
|
341
341
|
|
|
342
342
|
### Phase 4: Implementation Planning
|
|
343
343
|
|
|
344
|
-
**
|
|
344
|
+
**Command:** `pa:plan`
|
|
345
345
|
|
|
346
346
|
**Purpose:** Create a detailed implementation plan before coding.
|
|
347
347
|
|
|
@@ -390,7 +390,7 @@ Files to modify:
|
|
|
390
390
|
|
|
391
391
|
### Phase 5: Code Implementation
|
|
392
392
|
|
|
393
|
-
**
|
|
393
|
+
**Command:** `pa:implement`
|
|
394
394
|
|
|
395
395
|
**Purpose:** Write the actual code following the plan.
|
|
396
396
|
|
|
@@ -422,10 +422,10 @@ export const UserProfile: FC<UserProfileProps> = ({ user }) => {
|
|
|
422
422
|
|
|
423
423
|
#### Implementation Commands
|
|
424
424
|
```bash
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
425
|
+
pa:implement # Start implementing current plan
|
|
426
|
+
pa:implement --step 1 # Implement specific step
|
|
427
|
+
pa:implement --file auth.ts # Implement specific file
|
|
428
|
+
pa:implement --continue # Continue from last point
|
|
429
429
|
```
|
|
430
430
|
|
|
431
431
|
**Output:** Implemented Feature Code
|
|
@@ -434,7 +434,7 @@ export const UserProfile: FC<UserProfileProps> = ({ user }) => {
|
|
|
434
434
|
|
|
435
435
|
### Phase 6: Comprehensive Testing
|
|
436
436
|
|
|
437
|
-
**
|
|
437
|
+
**Command:** `pa:test` or `pa:test-all`
|
|
438
438
|
|
|
439
439
|
**Purpose:** Ensure code quality through thorough testing.
|
|
440
440
|
|
|
@@ -442,7 +442,7 @@ export const UserProfile: FC<UserProfileProps> = ({ user }) => {
|
|
|
442
442
|
|
|
443
443
|
#### 6.1 Unit Tests
|
|
444
444
|
```bash
|
|
445
|
-
|
|
445
|
+
pa:test-unit
|
|
446
446
|
```
|
|
447
447
|
- Test individual functions/components
|
|
448
448
|
- Mock external dependencies
|
|
@@ -451,7 +451,7 @@ export const UserProfile: FC<UserProfileProps> = ({ user }) => {
|
|
|
451
451
|
|
|
452
452
|
#### 6.2 Integration Tests
|
|
453
453
|
```bash
|
|
454
|
-
|
|
454
|
+
pa:test-integration
|
|
455
455
|
```
|
|
456
456
|
- Test component interactions
|
|
457
457
|
- Test API integrations
|
|
@@ -460,7 +460,7 @@ export const UserProfile: FC<UserProfileProps> = ({ user }) => {
|
|
|
460
460
|
|
|
461
461
|
#### 6.3 End-to-End Tests
|
|
462
462
|
```bash
|
|
463
|
-
|
|
463
|
+
pa:test-e2e
|
|
464
464
|
```
|
|
465
465
|
- Test complete user flows
|
|
466
466
|
- Test critical paths
|
|
@@ -493,7 +493,7 @@ describe('AuthService', () => {
|
|
|
493
493
|
|
|
494
494
|
### Phase 6.5: Code Review
|
|
495
495
|
|
|
496
|
-
**
|
|
496
|
+
**Command:** `pa:review`
|
|
497
497
|
|
|
498
498
|
**Purpose:** Ensure code quality before deployment.
|
|
499
499
|
|
|
@@ -501,7 +501,7 @@ describe('AuthService', () => {
|
|
|
501
501
|
|
|
502
502
|
#### Automated Review
|
|
503
503
|
```bash
|
|
504
|
-
|
|
504
|
+
pa:review --auto
|
|
505
505
|
```
|
|
506
506
|
- Linting checks
|
|
507
507
|
- Static analysis
|
|
@@ -511,7 +511,7 @@ describe('AuthService', () => {
|
|
|
511
511
|
|
|
512
512
|
#### AI-Assisted Review
|
|
513
513
|
```bash
|
|
514
|
-
|
|
514
|
+
pa:review --ai
|
|
515
515
|
```
|
|
516
516
|
- Code quality assessment
|
|
517
517
|
- Pattern consistency check
|
|
@@ -533,7 +533,7 @@ describe('AuthService', () => {
|
|
|
533
533
|
|
|
534
534
|
#### Peer Review
|
|
535
535
|
```bash
|
|
536
|
-
|
|
536
|
+
pa:review --pr
|
|
537
537
|
```
|
|
538
538
|
- Creates pull request
|
|
539
539
|
- Assigns reviewers
|
|
@@ -547,7 +547,7 @@ describe('AuthService', () => {
|
|
|
547
547
|
|
|
548
548
|
### Phase 7: Documentation
|
|
549
549
|
|
|
550
|
-
**
|
|
550
|
+
**Command:** `pa:doc` or `pa:doc-full`
|
|
551
551
|
|
|
552
552
|
**Purpose:** Create comprehensive documentation.
|
|
553
553
|
|
|
@@ -555,18 +555,18 @@ describe('AuthService', () => {
|
|
|
555
555
|
|
|
556
556
|
| Mode | Command | Content Level |
|
|
557
557
|
|------|---------|---------------|
|
|
558
|
-
| Full |
|
|
559
|
-
| Moderate |
|
|
560
|
-
| Lite |
|
|
558
|
+
| Full | `pa:doc-full` | Complete docs with examples |
|
|
559
|
+
| Moderate | `pa:doc` | Balanced coverage |
|
|
560
|
+
| Lite | `pa:doc-lite` | Quick reference |
|
|
561
561
|
|
|
562
562
|
**Documentation Scopes:**
|
|
563
563
|
|
|
564
564
|
```bash
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
565
|
+
pa:doc # Full project documentation
|
|
566
|
+
pa:doc-module auth # Document auth module
|
|
567
|
+
pa:doc-file src/utils/api.ts # Document specific file
|
|
568
|
+
pa:doc-api # API documentation only
|
|
569
|
+
pa:doc-component Button # Component documentation
|
|
570
570
|
```
|
|
571
571
|
|
|
572
572
|
**Documentation Includes:**
|
|
@@ -582,7 +582,7 @@ describe('AuthService', () => {
|
|
|
582
582
|
|
|
583
583
|
### Phase 8: Deployment Preparation
|
|
584
584
|
|
|
585
|
-
**
|
|
585
|
+
**Command:** `pa:deploy` or `pa:deploy-staging`
|
|
586
586
|
|
|
587
587
|
**Purpose:** Prepare for deployment.
|
|
588
588
|
|
|
@@ -608,10 +608,10 @@ describe('AuthService', () => {
|
|
|
608
608
|
|
|
609
609
|
**Deployment Commands:**
|
|
610
610
|
```bash
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
611
|
+
pa:deploy-staging # Deploy to staging
|
|
612
|
+
pa:deploy-prod # Deploy to production
|
|
613
|
+
pa:deploy-check # Pre-deployment validation
|
|
614
|
+
pa:deploy-status # Check deployment status
|
|
615
615
|
```
|
|
616
616
|
|
|
617
617
|
**Output:** Deployment-Ready Package
|
|
@@ -620,7 +620,7 @@ describe('AuthService', () => {
|
|
|
620
620
|
|
|
621
621
|
### Phase 9: Rollback Strategy
|
|
622
622
|
|
|
623
|
-
**
|
|
623
|
+
**Command:** `pa:rollback-plan`
|
|
624
624
|
|
|
625
625
|
**Purpose:** Prepare for potential rollbacks.
|
|
626
626
|
|
|
@@ -634,18 +634,18 @@ describe('AuthService', () => {
|
|
|
634
634
|
|
|
635
635
|
#### Code Rollback
|
|
636
636
|
```bash
|
|
637
|
-
|
|
638
|
-
|
|
637
|
+
pa:rollback --to previous # Rollback to previous version
|
|
638
|
+
pa:rollback --to v1.2.3 # Rollback to specific version
|
|
639
639
|
```
|
|
640
640
|
|
|
641
641
|
#### Database Rollback
|
|
642
642
|
```bash
|
|
643
|
-
|
|
643
|
+
pa:rollback-db --to migration-5 # Rollback database migrations
|
|
644
644
|
```
|
|
645
645
|
|
|
646
646
|
#### Infrastructure Rollback
|
|
647
647
|
```bash
|
|
648
|
-
|
|
648
|
+
pa:rollback-infra # Revert infrastructure changes
|
|
649
649
|
```
|
|
650
650
|
|
|
651
651
|
**Rollback Time Targets:**
|
|
@@ -684,7 +684,7 @@ User: "Update the API endpoint URL"
|
|
|
684
684
|
|
|
685
685
|
#### 1. Full Workflow Mode (Default)
|
|
686
686
|
```bash
|
|
687
|
-
|
|
687
|
+
pa:feature "Feature name"
|
|
688
688
|
```
|
|
689
689
|
All 10 phases for new features:
|
|
690
690
|
```
|
|
@@ -694,8 +694,8 @@ Implement → Test → Review → Doc → Deploy
|
|
|
694
694
|
|
|
695
695
|
#### 2. Bug Fix Mode (Fast Track)
|
|
696
696
|
```bash
|
|
697
|
-
|
|
698
|
-
|
|
697
|
+
pa:fix "Bug description"
|
|
698
|
+
pa:fix-quick "Bug description"
|
|
699
699
|
```
|
|
700
700
|
Streamlined workflow:
|
|
701
701
|
```
|
|
@@ -709,8 +709,8 @@ Context Scan → Root Cause → Fix → Test → Commit
|
|
|
709
709
|
|
|
710
710
|
#### 3. Quick Change Mode (Hotfix)
|
|
711
711
|
```bash
|
|
712
|
-
|
|
713
|
-
|
|
712
|
+
pa:hotfix "Change description"
|
|
713
|
+
pa:quick "Change description"
|
|
714
714
|
```
|
|
715
715
|
Minimal workflow:
|
|
716
716
|
```
|
|
@@ -725,8 +725,8 @@ Change → Verify → Commit
|
|
|
725
725
|
|
|
726
726
|
#### 4. Resume Mode
|
|
727
727
|
```bash
|
|
728
|
-
|
|
729
|
-
|
|
728
|
+
pa:resume
|
|
729
|
+
pa:resume feature-auth
|
|
730
730
|
```
|
|
731
731
|
Continue work on a paused feature with full context.
|
|
732
732
|
|
|
@@ -736,10 +736,10 @@ You can switch modes mid-workflow:
|
|
|
736
736
|
|
|
737
737
|
```bash
|
|
738
738
|
# Started in bug fix mode, realized it's bigger
|
|
739
|
-
|
|
739
|
+
pa:upgrade-to-full
|
|
740
740
|
|
|
741
741
|
# Started full workflow, can simplify
|
|
742
|
-
|
|
742
|
+
pa:downgrade-to-quick
|
|
743
743
|
```
|
|
744
744
|
|
|
745
745
|
### Mode Configuration
|
|
@@ -820,9 +820,9 @@ Features can declare dependencies:
|
|
|
820
820
|
### Merge Coordination
|
|
821
821
|
|
|
822
822
|
```bash
|
|
823
|
-
|
|
824
|
-
|
|
825
|
-
|
|
823
|
+
pa:feature-status # View all active features
|
|
824
|
+
pa:feature-conflicts # Check for conflicts
|
|
825
|
+
pa:feature-merge-order # Recommended merge order
|
|
826
826
|
```
|
|
827
827
|
|
|
828
828
|
**Recommended Merge Order:**
|
|
@@ -889,13 +889,13 @@ Design Summary:
|
|
|
889
889
|
Override checkpoints when starting a feature:
|
|
890
890
|
```bash
|
|
891
891
|
# Skip all optional checkpoints
|
|
892
|
-
|
|
892
|
+
pa:feature "Feature" --auto
|
|
893
893
|
|
|
894
894
|
# Stop at every phase
|
|
895
|
-
|
|
895
|
+
pa:feature "Feature" --checkpoint=all
|
|
896
896
|
|
|
897
897
|
# Only critical checkpoints
|
|
898
|
-
|
|
898
|
+
pa:feature "Feature" --checkpoint=critical
|
|
899
899
|
```
|
|
900
900
|
|
|
901
901
|
### Custom Checkpoints
|
|
@@ -994,10 +994,10 @@ learning:
|
|
|
994
994
|
### Learning Reports
|
|
995
995
|
|
|
996
996
|
```bash
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
997
|
+
pa:learning report # View learning summary
|
|
998
|
+
pa:learning patterns # View learned patterns
|
|
999
|
+
pa:learning corrections # View auto-corrections
|
|
1000
|
+
pa:learning reset # Reset learning data
|
|
1001
1001
|
```
|
|
1002
1002
|
|
|
1003
1003
|
---
|
|
@@ -1087,62 +1087,62 @@ environments:
|
|
|
1087
1087
|
|
|
1088
1088
|
| Command | Description |
|
|
1089
1089
|
|---------|-------------|
|
|
1090
|
-
|
|
|
1091
|
-
|
|
|
1092
|
-
|
|
|
1093
|
-
|
|
|
1094
|
-
|
|
|
1090
|
+
| `pa:init` | Initialize ProAgents in project |
|
|
1091
|
+
| `pa:feature "name"` | Start new feature |
|
|
1092
|
+
| `pa:fix "description"` | Start bug fix mode |
|
|
1093
|
+
| `pa:hotfix "description"` | Start quick change mode |
|
|
1094
|
+
| `pa:resume` | Resume paused feature |
|
|
1095
1095
|
|
|
1096
1096
|
### Phase Commands
|
|
1097
1097
|
|
|
1098
1098
|
| Command | Description |
|
|
1099
1099
|
|---------|-------------|
|
|
1100
|
-
|
|
|
1101
|
-
|
|
|
1102
|
-
|
|
|
1103
|
-
|
|
|
1104
|
-
|
|
|
1105
|
-
|
|
|
1106
|
-
|
|
|
1107
|
-
|
|
|
1108
|
-
|
|
|
1109
|
-
|
|
|
1100
|
+
| `pa:analyze` | Run codebase analysis |
|
|
1101
|
+
| `pa:requirements` | Gather requirements |
|
|
1102
|
+
| `pa:design` | Start design phase |
|
|
1103
|
+
| `pa:plan` | Create implementation plan |
|
|
1104
|
+
| `pa:implement` | Start implementation |
|
|
1105
|
+
| `pa:test` | Run tests |
|
|
1106
|
+
| `pa:review` | Code review |
|
|
1107
|
+
| `pa:doc` | Generate documentation |
|
|
1108
|
+
| `pa:deploy` | Deploy preparation |
|
|
1109
|
+
| `pa:rollback-plan` | Create rollback plan |
|
|
1110
1110
|
|
|
1111
1111
|
### Navigation Commands
|
|
1112
1112
|
|
|
1113
1113
|
| Command | Description |
|
|
1114
1114
|
|---------|-------------|
|
|
1115
|
-
|
|
|
1116
|
-
|
|
|
1117
|
-
|
|
|
1118
|
-
|
|
|
1119
|
-
|
|
|
1115
|
+
| `pa:status` | View current status |
|
|
1116
|
+
| `pa:next` | Move to next phase |
|
|
1117
|
+
| `pa:back` | Go back to previous phase |
|
|
1118
|
+
| `pa:skip` | Skip current phase |
|
|
1119
|
+
| `pa:skip-to [phase]` | Skip to specific phase |
|
|
1120
1120
|
|
|
1121
1121
|
### Feature Management
|
|
1122
1122
|
|
|
1123
1123
|
| Command | Description |
|
|
1124
1124
|
|---------|-------------|
|
|
1125
|
-
|
|
|
1126
|
-
|
|
|
1127
|
-
|
|
|
1128
|
-
|
|
|
1129
|
-
|
|
|
1125
|
+
| `pa:feature-list` | List all features |
|
|
1126
|
+
| `pa:feature-status` | Feature status dashboard |
|
|
1127
|
+
| `pa:feature-conflicts` | Check for conflicts |
|
|
1128
|
+
| `pa:feature-pause` | Pause current feature |
|
|
1129
|
+
| `pa:feature-switch [name]` | Switch to another feature |
|
|
1130
1130
|
|
|
1131
1131
|
### Configuration Commands
|
|
1132
1132
|
|
|
1133
1133
|
| Command | Description |
|
|
1134
1134
|
|---------|-------------|
|
|
1135
|
-
|
|
|
1136
|
-
|
|
|
1137
|
-
|
|
|
1135
|
+
| `pa:config` | View configuration |
|
|
1136
|
+
| `pa:config set [key] [value]` | Set config value |
|
|
1137
|
+
| `pa:config reset` | Reset to defaults |
|
|
1138
1138
|
|
|
1139
1139
|
### Help Commands
|
|
1140
1140
|
|
|
1141
1141
|
| Command | Description |
|
|
1142
1142
|
|---------|-------------|
|
|
1143
|
-
|
|
|
1144
|
-
|
|
|
1145
|
-
|
|
|
1143
|
+
| `pa:help` | Show help |
|
|
1144
|
+
| `pa:help [command]` | Help for specific command |
|
|
1145
|
+
| `pa:commands` | List all commands |
|
|
1146
1146
|
|
|
1147
1147
|
---
|
|
1148
1148
|
|
|
@@ -1151,7 +1151,7 @@ environments:
|
|
|
1151
1151
|
### 1. Always Analyze First
|
|
1152
1152
|
For existing projects, run analysis before making changes:
|
|
1153
1153
|
```bash
|
|
1154
|
-
|
|
1154
|
+
pa:analyze
|
|
1155
1155
|
```
|
|
1156
1156
|
|
|
1157
1157
|
### 2. Use Appropriate Entry Mode
|
|
@@ -1171,18 +1171,18 @@ checkpoints:
|
|
|
1171
1171
|
Let the AI learn and follow existing patterns rather than introducing new ones.
|
|
1172
1172
|
|
|
1173
1173
|
### 5. Document as You Go
|
|
1174
|
-
Use
|
|
1174
|
+
Use `pa:doc` after significant changes, not just at the end.
|
|
1175
1175
|
|
|
1176
1176
|
### 6. Test Continuously
|
|
1177
1177
|
Run tests frequently during implementation:
|
|
1178
1178
|
```bash
|
|
1179
|
-
|
|
1179
|
+
pa:test --watch
|
|
1180
1180
|
```
|
|
1181
1181
|
|
|
1182
1182
|
### 7. Review Before Commit
|
|
1183
1183
|
Always run review before committing:
|
|
1184
1184
|
```bash
|
|
1185
|
-
|
|
1185
|
+
pa:review
|
|
1186
1186
|
```
|
|
1187
1187
|
|
|
1188
1188
|
---
|
|
@@ -1193,25 +1193,25 @@ Always run review before committing:
|
|
|
1193
1193
|
|
|
1194
1194
|
**Issue:** Analysis is too slow
|
|
1195
1195
|
```bash
|
|
1196
|
-
|
|
1196
|
+
pa:analyze-lite # Use lite analysis for quick overview
|
|
1197
1197
|
```
|
|
1198
1198
|
|
|
1199
1199
|
**Issue:** Conflicts with another feature
|
|
1200
1200
|
```bash
|
|
1201
|
-
|
|
1202
|
-
|
|
1201
|
+
pa:feature-conflicts # Check conflicts
|
|
1202
|
+
pa:feature-merge-order # Get recommended order
|
|
1203
1203
|
```
|
|
1204
1204
|
|
|
1205
1205
|
**Issue:** Wrong mode detected
|
|
1206
1206
|
```bash
|
|
1207
|
-
|
|
1208
|
-
|
|
1207
|
+
pa:upgrade-to-full # Switch to full workflow
|
|
1208
|
+
pa:downgrade-to-quick # Switch to quick mode
|
|
1209
1209
|
```
|
|
1210
1210
|
|
|
1211
1211
|
**Issue:** Learning gave wrong suggestion
|
|
1212
1212
|
```bash
|
|
1213
|
-
|
|
1214
|
-
|
|
1213
|
+
pa:learning correct # Provide correction
|
|
1214
|
+
pa:learning reset # Reset learned patterns
|
|
1215
1215
|
```
|
|
1216
1216
|
|
|
1217
1217
|
---
|
|
@@ -1219,8 +1219,8 @@ Always run review before committing:
|
|
|
1219
1219
|
## Next Steps
|
|
1220
1220
|
|
|
1221
1221
|
1. **Configure:** Set up [proagents.config.yaml](./proagents.config.yaml)
|
|
1222
|
-
2. **Learn Commands:** Review [
|
|
1223
|
-
3. **Start Building:** Run
|
|
1222
|
+
2. **Learn Commands:** Review [Commands Reference](./cli/slash-commands.md)
|
|
1223
|
+
3. **Start Building:** Run `pa:feature "Your first feature"`
|
|
1224
1224
|
4. **Customize:** Set up [Standards](./standards/) for your project
|
|
1225
1225
|
|
|
1226
1226
|
---
|
|
@@ -120,7 +120,7 @@ Recommendation: Coordinate before merge
|
|
|
120
120
|
|
|
121
121
|
### Start Feature Tracking
|
|
122
122
|
|
|
123
|
-
When you run
|
|
123
|
+
When you run `pa:feature "Feature Name"`:
|
|
124
124
|
1. Directory created: `active-features/feature-name/`
|
|
125
125
|
2. Status files initialized
|
|
126
126
|
3. Added to `_index.json`
|
|
@@ -128,7 +128,7 @@ When you run `/feature-start "Feature Name"`:
|
|
|
128
128
|
### Check Conflicts
|
|
129
129
|
|
|
130
130
|
```
|
|
131
|
-
|
|
131
|
+
pa:conflict-check
|
|
132
132
|
```
|
|
133
133
|
|
|
134
134
|
Shows any file conflicts with other active features.
|
|
@@ -136,7 +136,7 @@ Shows any file conflicts with other active features.
|
|
|
136
136
|
### View Status
|
|
137
137
|
|
|
138
138
|
```
|
|
139
|
-
|
|
139
|
+
pa:feature-status
|
|
140
140
|
```
|
|
141
141
|
|
|
142
142
|
Shows current feature progress and any blockers.
|
|
@@ -165,12 +165,12 @@ proagents/active-features/*/files-modified.json
|
|
|
165
165
|
|
|
166
166
|
---
|
|
167
167
|
|
|
168
|
-
##
|
|
168
|
+
## Commands
|
|
169
169
|
|
|
170
170
|
| Command | Description |
|
|
171
171
|
|---------|-------------|
|
|
172
|
-
|
|
|
173
|
-
|
|
|
174
|
-
|
|
|
175
|
-
|
|
|
176
|
-
|
|
|
172
|
+
| `pa:feature` | Start new feature tracking |
|
|
173
|
+
| `pa:feature-status` | View current status |
|
|
174
|
+
| `pa:feature-list` | List all active features |
|
|
175
|
+
| `pa:conflict-check` | Check for conflicts |
|
|
176
|
+
| `pa:feature-complete` | Mark feature complete |
|
package/proagents/adr/README.md
CHANGED
|
@@ -16,7 +16,7 @@ Architecture Decision Records (ADRs) capture important architectural decisions a
|
|
|
16
16
|
|
|
17
17
|
```bash
|
|
18
18
|
# Using ProAgents command
|
|
19
|
-
|
|
19
|
+
pa:adr new "Use PostgreSQL for primary database"
|
|
20
20
|
|
|
21
21
|
# Creates: adr/0001-use-postgresql-for-primary-database.md
|
|
22
22
|
```
|
|
@@ -25,13 +25,13 @@ Architecture Decision Records (ADRs) capture important architectural decisions a
|
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
27
|
# List all ADRs
|
|
28
|
-
|
|
28
|
+
pa:adr list
|
|
29
29
|
|
|
30
30
|
# Filter by status
|
|
31
|
-
|
|
31
|
+
pa:adr list --status accepted
|
|
32
32
|
|
|
33
33
|
# Search ADRs
|
|
34
|
-
|
|
34
|
+
pa:adr search "database"
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
---
|
|
@@ -152,33 +152,33 @@ See [template.md](./template.md) for the full template.
|
|
|
152
152
|
|
|
153
153
|
```bash
|
|
154
154
|
# Create new ADR
|
|
155
|
-
|
|
155
|
+
pa:adr new "Decision title"
|
|
156
156
|
|
|
157
157
|
# Create from template
|
|
158
|
-
|
|
158
|
+
pa:adr new --template security "Implement OAuth 2.0"
|
|
159
159
|
|
|
160
160
|
# List ADRs
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
161
|
+
pa:adr list
|
|
162
|
+
pa:adr list --status accepted
|
|
163
|
+
pa:adr list --tag database
|
|
164
164
|
|
|
165
165
|
# Search ADRs
|
|
166
|
-
|
|
166
|
+
pa:adr search "authentication"
|
|
167
167
|
|
|
168
168
|
# Show ADR
|
|
169
|
-
|
|
169
|
+
pa:adr show 0001
|
|
170
170
|
|
|
171
171
|
# Update status
|
|
172
|
-
|
|
172
|
+
pa:adr status 0001 --set deprecated
|
|
173
173
|
|
|
174
174
|
# Supersede ADR
|
|
175
|
-
|
|
175
|
+
pa:adr supersede 0001 --with 0015
|
|
176
176
|
|
|
177
177
|
# Generate index
|
|
178
|
-
|
|
178
|
+
pa:adr index
|
|
179
179
|
|
|
180
180
|
# Export ADRs
|
|
181
|
-
|
|
181
|
+
pa:adr export --format html
|
|
182
182
|
```
|
|
183
183
|
|
|
184
184
|
---
|
|
@@ -216,10 +216,10 @@ If breaking change, describe:
|
|
|
216
216
|
|
|
217
217
|
---
|
|
218
218
|
|
|
219
|
-
##
|
|
219
|
+
## Commands
|
|
220
220
|
|
|
221
221
|
| Command | Description |
|
|
222
222
|
|---------|-------------|
|
|
223
|
-
|
|
|
224
|
-
|
|
|
225
|
-
|
|
|
223
|
+
| `pa:api-changelog add` | Add changelog entry |
|
|
224
|
+
| `pa:api-changelog view` | View API changelog |
|
|
225
|
+
| `pa:api-changelog generate` | Auto-generate from changes |
|