proagents 1.6.20 → 1.6.21

package/.proagents/team/README.md

@@ -1,256 +0,0 @@
-# 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

package/.proagents/team/code-ownership.md

@@ -1,306 +0,0 @@
-# Code Ownership Guide
-
-Define and manage code ownership for effective collaboration.
-
----
-
-## Overview
-
-Code ownership helps:
-- Ensure quality through accountability
-- Route PRs to right reviewers
-- Maintain consistent standards per area
-- Enable faster decision making
-
----
-
-## CODEOWNERS File
-
-### Setup
-
-Create `.github/CODEOWNERS` file:
-
-```
-# CODEOWNERS file
-
-# Default owners (required reviewers for all PRs)
-*                       @tech-lead
-
-# Frontend
-/src/components/        @frontend-team
-/src/pages/             @frontend-team
-/src/styles/            @frontend-team @design-team
-
-# Backend API
-/api/                   @backend-team
-/src/services/          @backend-team
-
-# Database
-/migrations/            @backend-team @dba-team
-/prisma/                @backend-team @dba-team
-
-# Infrastructure
-/.github/               @devops-team
-/terraform/             @devops-team
-/docker/                @devops-team
-Dockerfile              @devops-team
-
-# Authentication/Security
-/src/auth/              @security-team @backend-team
-/src/middleware/auth*   @security-team
-
-# Documentation
-*.md                    @docs-team
-/docs/                  @docs-team
-
-# Configuration
-package.json            @tech-lead
-tsconfig.json           @tech-lead
-.env.example            @devops-team
-
-# Tests
-/tests/                 @qa-team
-/__tests__/             @qa-team
-*.test.ts               @qa-team
-*.spec.ts               @qa-team
-
-# Critical paths (multiple approvers)
-/src/payments/          @backend-team @security-team @tech-lead
-```
-
-### Rules
-
-- Later rules override earlier ones
-- Use `@username` or `@org/team`
-- Each owner must approve
-- Empty pattern matches all files
-
----
-
-## Ownership Responsibilities
-
-### Code Owner Duties
-
-| Responsibility | Description |
-|---------------|-------------|
-| Review PRs | Review all PRs to owned area within SLA |
-| Maintain Quality | Ensure code meets standards |
-| Documentation | Keep docs for owned area current |
-| On-call | Be available for issues in owned area |
-| Mentoring | Help others understand the code |
-
-### Review SLAs
-
-| PR Size | Review Time |
-|---------|-------------|
-| Small (< 100 lines) | 4 hours |
-| Medium (100-500 lines) | 1 business day |
-| Large (> 500 lines) | 2 business days |
-| Critical (security/breaking) | 2 hours |
-
----
-
-## Ownership Matrix
-
-### By Feature Area
-
-| Area | Primary Owner | Secondary | Escalation |
-|------|---------------|-----------|------------|
-| Authentication | @auth-lead | @backend-team | @security-team |
-| User Management | @user-lead | @backend-team | @tech-lead |
-| Payments | @payment-lead | @backend-team | @finance-team |
-| Dashboard | @frontend-lead | @frontend-team | @tech-lead |
-| API Gateway | @api-lead | @backend-team | @tech-lead |
-| Mobile App | @mobile-lead | @mobile-team | @tech-lead |
-
-### By Service
-
-| Service | Team | Owner | Backup |
-|---------|------|-------|--------|
-| web-frontend | Frontend | @alice | @bob |
-| api-gateway | Backend | @carol | @dave |
-| user-service | Backend | @eve | @frank |
-| payment-service | Backend | @grace | @henry |
-| mobile-app | Mobile | @iris | @jack |
-
----
-
-## Assigning Ownership
-
-### New Code
-
-When creating new modules:
-
-1. Identify appropriate team/owner
-2. Add to CODEOWNERS file
-3. Document ownership in README
-4. Set up monitoring alerts
-
-```markdown
-<!-- Module README.md -->
-# User Service
-
-## Ownership
-
-| Role | Contact |
-|------|---------|
-| Owner | @user-team |
-| Primary Contact | @alice |
-| Escalation | @tech-lead |
-
-## On-call Rotation
-- Week 1: @alice
-- Week 2: @bob
-- Week 3: @carol
-```
-
-### Transferring Ownership
-
-```markdown
-## Ownership Transfer Checklist
-
-**From:** @current-owner
-**To:** @new-owner
-**Area:** /src/feature/
-
-- [ ] Knowledge transfer sessions completed
-- [ ] Documentation reviewed and updated
-- [ ] Access permissions updated
-- [ ] CODEOWNERS file updated
-- [ ] On-call rotation updated
-- [ ] Alerts/monitoring updated
-- [ ] Team notified
-```
-
----
-
-## PR Review Process
-
-### Automatic Assignment
-
-GitHub automatically assigns reviewers based on CODEOWNERS:
-
-```yaml
-# .github/workflows/assign-reviewers.yml
-name: Auto Assign Reviewers
-
-on:
-  pull_request:
-    types: [opened, ready_for_review]
-
-jobs:
-  assign:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-
-      - name: Assign reviewers
-        uses: kentaro-m/auto-assign-action@v1.2.4
-        with:
-          configuration-path: '.github/auto-assign.yml'
-```
-
-### Review Requirements
-
-```yaml
-# Branch protection rules
-main:
-  required_reviews: 2
-  require_code_owner_reviews: true
-  dismiss_stale_reviews: true
-  require_review_from_maintainers: true
-```
-
----
-
-## Conflict Resolution
-
-### When Owners Disagree
-
-1. **Discussion** - Owners discuss in PR comments
-2. **Sync Meeting** - Schedule quick call if needed
-3. **Escalation** - Tech lead makes final decision
-4. **Documentation** - Document decision rationale
-
-### Ownership Disputes
-
-| Scenario | Resolution |
-|----------|------------|
-| Unclear ownership | Tech lead decides |
-| Overlapping areas | Define boundaries, update CODEOWNERS |
-| Abandoned ownership | Reassign with knowledge transfer |
-| New team structure | Update all ownership docs |
-
----
-
-## Metrics
-
-### Ownership Health
-
-```markdown
-## Code Ownership Report
-
-### Coverage
-- Total files: 1,234
-- Files with owners: 1,200 (97%)
-- Orphaned files: 34 (3%)
-
-### Review Performance (Last 30 Days)
-| Team | Avg Review Time | Reviews Completed |
-|------|-----------------|-------------------|
-| Frontend | 6 hours | 45 |
-| Backend | 8 hours | 62 |
-| Mobile | 12 hours | 23 |
-
-### Areas Needing Attention
-- /src/legacy/ - No owner assigned
-- /src/utils/ - Owner on leave, need backup
-```
-
----
-
-## Best Practices
-
-1. **Clear Boundaries** - Define ownership precisely
-2. **Backup Owners** - Always have secondary owner
-3. **Regular Review** - Review ownership quarterly
-4. **Documentation** - Keep ownership docs current
-5. **Knowledge Sharing** - Avoid single point of failure
-6. **Responsive** - Meet review SLAs
-7. **Collaborative** - Work with other owners on overlap
-
----
-
-## Configuration
-
-```yaml
-# proagents.config.yaml
-ownership:
-  enabled: true
-  file: ".github/CODEOWNERS"
-
-  review_sla:
-    small: "4h"
-    medium: "1d"
-    large: "2d"
-    critical: "2h"
-
-  alerts:
-    stale_review: true
-    orphaned_code: true
-    ownership_gaps: true
-
-  reporting:
-    frequency: "weekly"
-    notify: ["tech-lead@company.com"]
-```
-
----
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `pa:owner [path]` | Show owner for path |
-| `pa:ownership-report` | Generate ownership report |
-| `pa:assign-owner` | Assign ownership |