proagents 1.0.0

package/proagents/standards/testing-standards-template.md

@@ -0,0 +1,220 @@
+# Testing Standards Template
+
+Copy this file to `testing-standards.md` and customize for your project.
+
+---
+
+## Testing Framework
+
+**Unit Tests:** [Jest | Vitest | Mocha | pytest]
+**Integration Tests:** [Jest | Supertest | pytest]
+**E2E Tests:** [Playwright | Cypress | Selenium]
+**Component Tests:** [Testing Library | Enzyme]
+
+---
+
+## Coverage Requirements
+
+| Type | Minimum Coverage |
+|------|------------------|
+| Overall | [80% | 85% | 90%] |
+| Critical paths | [95% | 100%] |
+| New code | [80% | 90%] |
+| Utilities | [90% | 100%] |
+
+---
+
+## Test File Organization
+
+```
+src/
+├── components/
+│   ├── UserCard.tsx
+│   └── UserCard.test.tsx      # Co-located
+└── __tests__/                  # Or centralized
+    └── integration/
+        └── user-flow.test.ts
+```
+
+**Approach:** [Co-located | Centralized | Both]
+
+---
+
+## Unit Test Structure
+
+```typescript
+describe('ComponentName', () => {
+  // Setup
+  beforeEach(() => {
+    // Common setup
+  });
+
+  // Group related tests
+  describe('when [condition]', () => {
+    it('should [expected behavior]', () => {
+      // Arrange
+      // Act
+      // Assert
+    });
+  });
+});
+```
+
+---
+
+## What to Test
+
+### Components
+- [ ] Renders without crashing
+- [ ] Renders correct content based on props
+- [ ] Handles user interactions
+- [ ] Shows correct states (loading, error, empty)
+- [ ] Accessibility (labels, roles)
+
+### Hooks
+- [ ] Returns correct initial state
+- [ ] Updates state correctly
+- [ ] Handles edge cases
+- [ ] Cleans up properly
+
+### Services/API
+- [ ] Makes correct API calls
+- [ ] Handles success responses
+- [ ] Handles error responses
+- [ ] Handles loading states
+
+### Utilities
+- [ ] Returns correct output for valid input
+- [ ] Handles edge cases
+- [ ] Throws/returns appropriate errors for invalid input
+
+---
+
+## Mocking Guidelines
+
+### Do Mock
+- External API calls
+- Third-party services
+- Time/date functions
+- Random values
+- File system operations
+
+### Don't Mock
+- The component/function under test
+- Simple utility functions
+- React hooks (use Testing Library's approach)
+
+---
+
+## Test Data
+
+```typescript
+// Use factories for test data
+const createUser = (overrides = {}): User => ({
+  id: 'user-1',
+  name: 'Test User',
+  email: 'test@example.com',
+  ...overrides,
+});
+
+// Usage
+const user = createUser({ name: 'Custom Name' });
+```
+
+---
+
+## Async Testing
+
+```typescript
+// Always await async operations
+it('fetches user data', async () => {
+  render(<UserProfile userId="1" />);
+
+  // Wait for loading to finish
+  await waitFor(() => {
+    expect(screen.getByText('John Doe')).toBeInTheDocument();
+  });
+});
+```
+
+---
+
+## Integration Test Patterns
+
+```typescript
+describe('User Authentication Flow', () => {
+  it('allows user to log in and view dashboard', async () => {
+    // 1. Navigate to login
+    // 2. Fill in credentials
+    // 3. Submit form
+    // 4. Verify redirect to dashboard
+    // 5. Verify user data displayed
+  });
+});
+```
+
+---
+
+## E2E Test Patterns
+
+```typescript
+// Playwright example
+test('complete checkout flow', async ({ page }) => {
+  // 1. Add item to cart
+  await page.goto('/products/1');
+  await page.click('[data-testid="add-to-cart"]');
+
+  // 2. Go to checkout
+  await page.click('[data-testid="checkout"]');
+
+  // 3. Fill shipping info
+  // 4. Complete payment
+  // 5. Verify confirmation
+});
+```
+
+---
+
+## Snapshot Testing
+
+**When to use:**
+- UI components with stable output
+- Error messages
+- Generated content
+
+**When NOT to use:**
+- Dynamic content
+- Frequently changing components
+- Large component trees
+
+---
+
+## Performance Testing
+
+- Measure render times for critical components
+- Test with realistic data volumes
+- Monitor bundle size changes
+- Set performance budgets
+
+---
+
+## CI/CD Integration
+
+```yaml
+# Example CI config
+test:
+  script:
+    - npm run test:unit
+    - npm run test:integration
+    - npm run test:e2e
+  coverage:
+    minimum: 80%
+    fail_under: true
+```
+
+---
+
+## Related Files
+
+- [config/standards/testing-standards.template.md](../config/standards/testing-standards.template.md) - Alternative location
+- [testing-standards/](../testing-standards/) - Detailed testing guides

package/proagents/team/README.md

@@ -0,0 +1,256 @@
+# Team Collaboration
+
+Code ownership, handoffs, IDE setup, and team onboarding.
+
+---
+
+## Overview
+
+ProAgents supports multi-developer workflows with clear ownership, communication templates, and comprehensive onboarding. This directory contains everything needed for effective team collaboration.
+
+---
+
+## Documentation
+
+### Collaboration
+
+| Document | Description |
+|----------|-------------|
+| [Code Ownership](./code-ownership.md) | CODEOWNERS and module ownership |
+| [Handoff Protocol](./handoff-protocol.md) | Transferring work between developers |
+| [Communication Templates](./communication-templates.md) | Standard messages and notifications |
+
+### Onboarding
+
+| Document | Description |
+|----------|-------------|
+| [Team Onboarding](./onboarding.md) | Complete guide for new team members |
+| [IDE Setup](./ide-setup/README.md) | Development environment configuration |
+
+### IDE Setup Guides
+
+| IDE | Guide |
+|-----|-------|
+| VS Code | [vscode.md](./ide-setup/vscode.md) |
+| Cursor | [cursor.md](./ide-setup/cursor.md) |
+| JetBrains | [jetbrains.md](./ide-setup/jetbrains.md) |
+
+---
+
+## Quick Start
+
+### For New Team Members
+
+1. Follow the [Onboarding Guide](./onboarding.md)
+2. Set up your IDE with [IDE Setup](./ide-setup/README.md)
+3. Review [Coding Standards](../standards/README.md)
+4. Read the [Workflow Guide](../WORKFLOW.md)
+
+### For Existing Team
+
+```bash
+# View code owners for a path
+proagents team owners src/auth/
+
+# Create handoff document
+proagents team handoff feature-123
+
+# Notify team
+proagents team notify "Feature ready for review"
+
+# Check team assignments
+proagents team status
+```
+
+---
+
+## Code Ownership
+
+### CODEOWNERS Integration
+
+```
+# CODEOWNERS file
+/src/auth/*       @security-team
+/src/payments/*   @payments-team
+/src/ui/*         @frontend-team
+/src/api/*        @backend-team
+*.md              @docs-team
+```
+
+### Ownership Commands
+
+```bash
+# Check who owns a file
+proagents team owners src/auth/login.ts
+
+# Assign reviewer based on ownership
+proagents team assign-reviewers
+
+# View all ownership mappings
+proagents team ownership-report
+```
+
+---
+
+## Handoff Protocol
+
+When transferring work between developers:
+
+### Handoff Checklist
+
+- [ ] Document current status (phase, progress percentage)
+- [ ] List remaining tasks
+- [ ] Note any blockers or dependencies
+- [ ] Provide context (decisions made, alternatives considered)
+- [ ] Update issue/task assignments
+- [ ] Notify stakeholders
+
+### Create Handoff Document
+
+```bash
+proagents team handoff feature-user-auth
+```
+
+This generates a handoff document with:
+- Current status
+- Work completed
+- Work remaining
+- Important context
+- Known issues
+
+---
+
+## Communication
+
+### Templates Available
+
+| Template | Use Case |
+|----------|----------|
+| Feature Start | Announce new feature work |
+| Feature Complete | Announce completion |
+| Blocker Alert | Report blocking issue |
+| Review Request | Request code review |
+| Deploy Notification | Announce deployment |
+
+### Using Templates
+
+```bash
+# Use a template
+proagents team notify --template feature-complete
+
+# Custom message
+proagents team notify "Custom message here"
+```
+
+---
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+team:
+  # Code ownership
+  codeowners:
+    enabled: true
+    file: "CODEOWNERS"
+    enforce_reviews: true
+
+  # Handoff requirements
+  handoffs:
+    require_document: true
+    notify_stakeholders: true
+    include_checklist: true
+
+  # Notifications
+  notifications:
+    enabled: true
+    channels:
+      default: "slack:#dev-team"
+      urgent: "slack:#dev-alerts"
+      deployments: "slack:#deployments"
+
+  # Onboarding
+  onboarding:
+    mentor_assignment: true
+    buddy_system: true
+    checklist_tracking: true
+
+  # Collaboration settings
+  collaboration:
+    require_reviewers: 1
+    auto_assign_reviewers: true
+    use_codeowners: true
+```
+
+---
+
+## Team Workflows
+
+### Daily Standups
+
+```bash
+# Generate standup summary
+proagents team standup
+
+# Shows:
+# - Features in progress
+# - Blockers
+# - PRs awaiting review
+```
+
+### Weekly Reports
+
+```bash
+# Generate weekly report
+proagents team weekly-report
+
+# Shows:
+# - Features completed
+# - PRs merged
+# - Code coverage changes
+# - Velocity metrics
+```
+
+---
+
+## Best Practices
+
+### Code Reviews
+
+1. Review within 24 hours
+2. Provide constructive feedback
+3. Use ProAgents checklists
+4. Focus on patterns and standards
+
+### Handoffs
+
+1. Document everything
+2. Schedule walkthrough if complex
+3. Ensure all context is captured
+4. Verify new owner has access
+
+### Communication
+
+1. Use templates for consistency
+2. Include relevant links
+3. Tag appropriate people
+4. Keep updates concise
+
+---
+
+## Troubleshooting
+
+### Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| No reviewers assigned | Check CODEOWNERS file |
+| Handoff document incomplete | Use checklist template |
+| Notifications not sending | Check integration config |
+| Onboarding steps unclear | Follow step-by-step guide |
+
+### Getting Help
+
+- **Team channel**: #dev-help
+- **Documentation**: This directory
+- **Escalation**: Tech lead