proagents 1.0.0

package/proagents/team/handoff-protocol.md

@@ -0,0 +1,380 @@
+# Handoff Protocol Guide
+
+Guidelines for handing off work between developers.
+
+---
+
+## Overview
+
+Handoffs occur when:
+- Developer goes on leave
+- Task reassignment
+- Shift change (global teams)
+- Role change
+- Project phase transition
+
+---
+
+## Handoff Types
+
+### 1. Planned Handoff
+
+Scheduled transfer with preparation time.
+- Vacation coverage
+- Project transitions
+- Team restructuring
+
+### 2. Emergency Handoff
+
+Unplanned transfer requiring quick action.
+- Sick leave
+- Urgent reassignment
+- Personal emergency
+
+### 3. Partial Handoff
+
+Sharing work without full transfer.
+- Collaboration
+- Knowledge sharing
+- Temporary coverage
+
+---
+
+## Handoff Checklist
+
+### Before Handoff
+
+```markdown
+## Pre-Handoff Checklist
+
+**Handoff Type:** [Planned / Emergency / Partial]
+**From:** @current-dev
+**To:** @receiving-dev
+**Date:** [YYYY-MM-DD]
+**Duration:** [Temporary / Permanent]
+
+### Preparation
+- [ ] Identify all active work items
+- [ ] Document current status of each
+- [ ] Update all task trackers
+- [ ] Commit and push all code
+- [ ] Create work-in-progress branches
+- [ ] Write handoff document
+- [ ] Schedule handoff meeting
+- [ ] Update calendar/availability
+```
+
+### During Handoff
+
+```markdown
+### Handoff Meeting
+- [ ] Walk through active tasks
+- [ ] Review codebase areas
+- [ ] Explain ongoing issues
+- [ ] Share context and decisions
+- [ ] Introduce to stakeholders
+- [ ] Transfer access/credentials (if needed)
+- [ ] Answer questions
+- [ ] Agree on check-in schedule
+```
+
+### After Handoff
+
+```markdown
+### Post-Handoff
+- [ ] Receiving dev has all access
+- [ ] Team notified of change
+- [ ] Stakeholders informed
+- [ ] Documentation updated
+- [ ] First check-in scheduled
+- [ ] Emergency contact shared
+```
+
+---
+
+## Handoff Document Template
+
+```markdown
+# Work Handoff Document
+
+**Date:** [YYYY-MM-DD]
+**From:** [Name] (@username)
+**To:** [Name] (@username)
+**Return Date:** [Date or Permanent]
+
+---
+
+## Contact Information
+
+### During Handoff Period
+- Emergency contact: [phone/email]
+- Available times: [if any]
+- Escalation path: [manager/tech-lead]
+
+---
+
+## Active Work Items
+
+### In Progress
+
+#### 1. [Feature/Task Name]
+- **Status:** [X% complete]
+- **Branch:** `feature/branch-name`
+- **PR:** [link if exists]
+- **Priority:** [High/Medium/Low]
+- **Deadline:** [date]
+- **Description:** [what it is]
+- **Current State:** [where you left off]
+- **Next Steps:**
+  1. [Step 1]
+  2. [Step 2]
+  3. [Step 3]
+- **Blockers:** [any blockers]
+- **Key Files:**
+  - `/src/feature/file.ts` - [description]
+  - `/src/feature/another.ts` - [description]
+- **Related Docs:** [links]
+- **Stakeholders:** @person1, @person2
+- **Notes:** [important context]
+
+#### 2. [Another Task]
+...
+
+### Pending (Not Started)
+
+| Task | Priority | Deadline | Notes |
+|------|----------|----------|-------|
+| [Task 1] | High | [date] | [notes] |
+| [Task 2] | Medium | [date] | [notes] |
+
+### On Hold
+
+| Task | Reason | Resume When |
+|------|--------|-------------|
+| [Task] | [reason] | [condition] |
+
+---
+
+## Ongoing Responsibilities
+
+### Daily Tasks
+- [ ] [Task 1] - [frequency/time]
+- [ ] [Task 2] - [frequency/time]
+
+### Weekly Tasks
+- [ ] [Task 1] - [day/time]
+- [ ] [Task 2] - [day/time]
+
+### Meetings to Attend
+| Meeting | Time | Role | Notes |
+|---------|------|------|-------|
+| [Meeting] | [time] | [role] | [notes] |
+
+---
+
+## Key Context
+
+### Recent Decisions
+| Decision | Rationale | Date |
+|----------|-----------|------|
+| [Decision] | [Why] | [Date] |
+
+### Known Issues
+| Issue | Impact | Workaround |
+|-------|--------|------------|
+| [Issue] | [Impact] | [Workaround] |
+
+### Important Relationships
+| Person | Role | Context |
+|--------|------|---------|
+| @person | [role] | [relationship context] |
+
+---
+
+## Access & Credentials
+
+### Required Access
+- [ ] GitHub repo access
+- [ ] Jira/Project board
+- [ ] Slack channels: #channel1, #channel2
+- [ ] AWS/Cloud console
+- [ ] Database access
+
+### Shared Credentials
+⚠️ **Never include actual credentials here**
+- Secret location: [vault path]
+- Access request: [process]
+
+---
+
+## Documentation Links
+
+- Project README: [link]
+- Architecture docs: [link]
+- API documentation: [link]
+- Runbooks: [link]
+
+---
+
+## Emergency Procedures
+
+### If Something Breaks
+1. [Step 1]
+2. [Step 2]
+3. Escalate to: @manager, @tech-lead
+
+### Critical Contacts
+| Area | Contact | Phone |
+|------|---------|-------|
+| [Area] | @person | [if emergency] |
+
+---
+
+## Questions & Answers
+
+**Q: [Anticipated question]?**
+A: [Answer]
+
+**Q: [Another question]?**
+A: [Answer]
+
+---
+
+## Acknowledgment
+
+**Handoff Completed:**
+- [ ] From: @current-dev (Date: ________)
+- [ ] To: @receiving-dev (Date: ________)
+```
+
+---
+
+## Quick Handoff (Emergency)
+
+For urgent handoffs with minimal prep time:
+
+```markdown
+# Emergency Handoff
+
+**From:** @dev  **To:** @backup  **Date:** [now]
+
+## Immediate Priorities
+1. [Most critical task] - [status] - [next step]
+2. [Second priority] - [status] - [next step]
+3. [Third priority] - [status] - [next step]
+
+## Current Branches
+- `feature/xyz` - In progress, needs [X]
+- `fix/abc` - Ready for review
+
+## Blockers
+- [Blocker 1] - Contact @person
+
+## Today's Meetings
+- [Time] - [Meeting] - [Action needed]
+
+## Emergency Contact
+[Phone number] - only if critical
+
+## More Details
+I'll send full handoff doc ASAP / Check [location]
+```
+
+---
+
+## Best Practices
+
+### For Handing Off
+
+1. **Document continuously** - Don't wait for handoff
+2. **Commit frequently** - Push WIP to branches
+3. **Use descriptive commits** - Future context
+4. **Update tickets** - Keep tracker current
+5. **Write for others** - Assume no context
+6. **Face-to-face when possible** - Video if remote
+
+### For Receiving
+
+1. **Ask questions** - Don't assume
+2. **Take notes** - Document answers
+3. **Verify access** - Test before handoff ends
+4. **Start small** - Begin with context-building tasks
+5. **Check in regularly** - Especially first few days
+6. **Update docs** - Fix anything unclear
+
+---
+
+## Handoff Meeting Agenda
+
+```markdown
+## Handoff Meeting
+
+**Duration:** 1-2 hours
+**Attendees:** @from-dev, @to-dev, [@manager optional]
+
+### Agenda
+
+1. **Overview** (10 min)
+   - Current role/responsibilities
+   - Team structure
+   - Key stakeholders
+
+2. **Active Work** (30-45 min)
+   - Walk through each active task
+   - Show code and branches
+   - Explain decisions and context
+
+3. **Codebase Tour** (15-20 min)
+   - Key directories
+   - Important files
+   - Common patterns
+
+4. **Processes** (10 min)
+   - Daily/weekly routines
+   - Meeting schedule
+   - Communication norms
+
+5. **Access Verification** (10 min)
+   - Test all access
+   - Verify permissions
+
+6. **Q&A** (15 min)
+   - Open questions
+   - Clarifications
+
+7. **Next Steps** (5 min)
+   - First tasks for receiver
+   - Check-in schedule
+```
+
+---
+
+## Configuration
+
+```yaml
+# proagents.config.yaml
+handoff:
+  templates:
+    full: "templates/handoff-full.md"
+    emergency: "templates/handoff-emergency.md"
+
+  requirements:
+    planned:
+      notice_days: 5
+      documentation: true
+      meeting: true
+
+    emergency:
+      quick_doc: true
+      async_ok: true
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/handoff-create` | Create handoff document |
+| `/handoff-emergency` | Quick emergency handoff |
+| `/handoff-checklist` | Show handoff checklist |

package/proagents/team/ide-setup/README.md

@@ -0,0 +1,103 @@
+# IDE Setup Guides
+
+Configure your development environment for optimal ProAgents integration.
+
+---
+
+## Overview
+
+ProAgents works with any IDE, but optimal setup ensures:
+- Seamless AI integration
+- Consistent code formatting
+- Automatic standard enforcement
+- Efficient development workflow
+
+---
+
+## Available Guides
+
+| IDE | Guide |
+|-----|-------|
+| VS Code | [vscode.md](./vscode.md) |
+| JetBrains (WebStorm, IntelliJ) | [jetbrains.md](./jetbrains.md) |
+| Cursor | [cursor.md](./cursor.md) |
+| Neovim | [neovim.md](./neovim.md) |
+
+---
+
+## Universal Setup
+
+Regardless of IDE, ensure these are configured:
+
+### 1. EditorConfig
+
+Create `.editorconfig` in project root:
+
+```ini
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab
+```
+
+### 2. Git Configuration
+
+```bash
+# Set up consistent line endings
+git config core.autocrlf input  # Mac/Linux
+git config core.autocrlf true   # Windows
+
+# Set up commit hooks
+npx husky install
+```
+
+### 3. Environment Variables
+
+Create `.env.local` for local development:
+
+```bash
+# ProAgents
+PROAGENTS_AI_MODEL=auto
+PROAGENTS_VERBOSE=false
+
+# Development
+NODE_ENV=development
+```
+
+---
+
+## Quick Start
+
+1. **Install IDE extension/plugin** (if available)
+2. **Run setup command**:
+   ```bash
+   proagents ide setup
+   ```
+3. **Verify installation**:
+   ```bash
+   proagents doctor
+   ```
+
+---
+
+## Troubleshooting
+
+### Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| Extensions not loading | Restart IDE after install |
+| Formatting conflicts | Disable conflicting formatters |
+| Slow performance | Exclude `node_modules` from indexing |
+| TypeScript errors | Run `npm install` and restart TS server |