claude-autopm 2.8.2 → 2.8.4

package/packages/plugin-pm/commands/azure/import-us.md

@@ -0,0 +1,269 @@
+---
+allowed-tools: Task, Bash, Read, Write, Edit, WebFetch, Glob, Grep
+---
+
+# Azure DevOps Import User Stories
+
+Import User Stories from PRDs or Epics into Azure DevOps with automatic task breakdown.
+
+**Usage**: `/azure:import-us <prd-name|epic-name>`
+
+**Example**: `/azure:import-us authentication-system`
+
+## Required Environment Variables
+
+Ensure `.claude/.env` contains:
+
+```bash
+AZURE_DEVOPS_PAT=<your-pat-token>
+AZURE_DEVOPS_ORG=<your-organization>
+AZURE_DEVOPS_PROJECT=<your-project>
+```
+
+## Preflight Checklist
+
+### Input Validation
+
+1. **Check source document exists:**
+   - First check `.claude/prds/$ARGUMENTS.md`
+   - Then check `.claude/epics/$ARGUMENTS.md`
+   - If neither exists, tell user: "❌ No PRD or Epic found: $ARGUMENTS"
+
+2. **Verify Azure DevOps connectivity:**
+   - Validate PAT token
+   - Verify organization and project exist
+   - If fails, provide specific error
+
+3. **Check for existing imports:**
+   - Look for `.claude/azure/imports/$ARGUMENTS.log`
+   - If exists, ask: "⚠️ Already imported on [date]. Re-import? (yes/no)"
+
+## Required Documentation Access
+
+**MANDATORY:** Before Azure DevOps integration and agile workflows, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/azure-devops/boards` - boards best practices
+- `mcp://context7/agile/user-stories` - user stories best practices
+- `mcp://context7/project-management/work-items` - work items best practices
+- `mcp://context7/agile/sprint-planning` - sprint planning best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
+## Instructions
+
+### 1. Parse Source Document
+
+Use the file-analyzer agent to:
+- Extract user stories/requirements from PRD
+- Extract tasks from Epic issues
+- Identify acceptance criteria
+- Map dependencies
+
+### 2. Transform to Azure DevOps Structure
+
+#### From PRD
+
+Convert each requirement section to User Story:
+
+```markdown
+PRD Section: "User Authentication"
+→ User Story: "As a user, I want to authenticate securely"
+→ Tasks: Design, Implementation, Testing, Documentation
+```
+
+#### From Epic
+
+Convert each issue to User Story with subtasks:
+
+```markdown
+Epic Issue: "#123 - Implement login flow"
+→ User Story: "As a user, I want to log in to the system"
+→ Tasks: From issue checklist and description
+```
+
+### 3. Batch Creation Strategy
+
+Use azure-devops-specialist agent to:
+
+1. **Create Epic/Feature** (if not exists):
+   - Parent container for all User Stories
+   - Link to source PRD/Epic
+
+2. **Create User Stories in batches:**
+   - Process 5 stories at a time
+   - Each with standard tasks
+   - Maintain relationships
+
+3. **Link Dependencies:**
+   - Predecessor/successor links
+   - Blocked by relationships
+   - Related work items
+
+### 4. Mapping Rules
+
+#### Field Mappings
+
+| Source (PRD/Epic) | Azure DevOps Field |
+|-------------------|-------------------|
+| Section Title | Story Title |
+| Requirements | Acceptance Criteria |
+| Technical Notes | Description |
+| Priority | Priority (1-4) |
+| Complexity | Story Points |
+| Dependencies | Links/Relations |
+
+#### Task Templates
+
+For each User Story, create:
+
+1. **Analysis Task** (4h)
+   - Review requirements
+   - Technical design
+
+2. **Development Task** (8-16h)
+   - Implementation
+   - Unit tests
+
+3. **Testing Task** (4-8h)
+   - Integration tests
+   - Manual testing
+
+4. **Documentation Task** (2h)
+   - Code documentation
+   - User documentation
+
+5. **Review Task** (2h)
+   - Code review
+   - Approval
+
+### 5. Import Tracking
+
+Create import log at `.claude/azure/imports/$ARGUMENTS.log`:
+
+```markdown
+# Import Log: $ARGUMENTS
+
+## Import Details
+- **Source**: [PRD|Epic] - $ARGUMENTS
+- **Date**: [ISO timestamp]
+- **Azure DevOps URL**: [Parent item URL]
+
+## Created Items
+
+### Epic/Feature
+- ID: [Azure ID]
+- Title: [Title]
+- URL: [Direct link]
+
+### User Stories
+1. [ID] - [Title] - [Story Points]pts - [N tasks]
+2. [ID] - [Title] - [Story Points]pts - [N tasks]
+...
+
+### Summary
+- Total User Stories: [N]
+- Total Tasks: [N]
+- Total Story Points: [N]
+- Total Estimated Hours: [N]
+
+## Field Mappings Used
+[Document any custom mappings]
+
+## Skipped Items
+[List any sections not imported and why]
+```
+
+### 6. Incremental Import Support
+
+If re-importing:
+- Check existing Azure items
+- Skip duplicates
+- Update changed items only
+- Add new items
+- Report what was updated
+
+### 7. Validation & Rollback
+
+Before committing import:
+- Preview all items to be created
+- Estimate total work (hours/points)
+- Get user confirmation for large imports (>10 stories)
+
+If import fails:
+- Save progress to log
+- Provide rollback instructions
+- List successfully created items
+
+### 8. Success Output
+
+After successful import:
+
+```
+✅ Import Complete: $ARGUMENTS → Azure DevOps
+
+📊 Summary:
+- Created 1 Epic/Feature
+- Created [N] User Stories  
+- Created [N] Tasks
+- Total Story Points: [N]
+- Total Hours: [N]
+
+📋 View in Azure DevOps:
+[URL to parent Epic/Feature]
+
+📁 Import log saved:
+.claude/azure/imports/$ARGUMENTS.log
+
+🚀 Next steps:
+- Review imported items in Azure DevOps
+- Assign team members to tasks
+- Add to current/next sprint
+- Run: /azure:us-status $ARGUMENTS
+```
+
+## Advanced Options
+
+### Custom Field Mapping
+
+Support custom field mappings via configuration:
+
+```yaml
+# .claude/azure/config.yml
+field_mappings:
+  custom_field_1: "Custom.ProjectCode"
+  risk_level: "Custom.RiskAssessment"
+```
+
+### Sprint Assignment
+
+- If current sprint detected, ask to assign stories
+- Otherwise, assign to backlog
+
+### Team Assignment
+
+- If team members configured, suggest assignments
+- Based on expertise areas if defined
+
+## Error Handling
+
+- **Partial import failure**: Continue with remaining items
+- **API rate limits**: Implement exponential backoff
+- **Invalid data**: Skip item, log reason, continue
+- **Network issues**: Retry 3 times before failing
+
+## Quality Checks
+
+Before import:
+
+- [ ] All User Stories have clear titles
+- [ ] Acceptance criteria defined
+- [ ] Story points estimated
+- [ ] Tasks have hour estimates
+- [ ] No duplicate stories
+- [ ] Parent Epic/Feature identified

package/packages/plugin-pm/commands/azure/init.md

@@ -0,0 +1,211 @@
+---
+allowed-tools: Task, Bash, Read, Write, Edit, WebFetch, Glob, Grep
+---
+
+# Azure DevOps Init
+
+Initialize Azure DevOps integration for the project.
+
+**Usage**: `/azure:init`
+
+## Required Documentation Access
+
+**MANDATORY:** Before Azure DevOps integration and agile workflows, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/azure-devops/boards` - boards best practices
+- `mcp://context7/agile/user-stories` - user stories best practices
+- `mcp://context7/project-management/work-items` - work items best practices
+- `mcp://context7/agile/sprint-planning` - sprint planning best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
+## Instructions
+
+### 1. Configuration Wizard
+
+```
+🔧 Azure DevOps Integration Setup
+═══════════════════════════════════════════════════════════════
+
+Step 1: Azure DevOps Credentials
+─────────────────────────────────────────────────────────────
+Personal Access Token (PAT): [Enter PAT]
+Organization: [rafal0387]
+Project: [Speacher]
+
+Testing connection... ✓ Connected
+
+Step 2: Project Configuration
+─────────────────────────────────────────────────────────────
+Default Area Path: [Speacher]
+Default Iteration: [Speacher\Sprint 2]
+Work Item Types:
+  ✓ Feature/Epic
+  ✓ User Story
+  ✓ Task
+  ✓ Bug
+
+Step 3: Team Configuration
+─────────────────────────────────────────────────────────────
+Team Name: [Development Team]
+Team Members:
+  - john@example.com (Developer)
+  - sarah@example.com (Developer)
+  - mike@example.com (Tech Lead)
+  - lisa@example.com (QA)
+
+Step 4: Integration Options
+─────────────────────────────────────────────────────────────
+✓ Enable bi-directional sync
+✓ Auto-create branches for tasks
+✓ Link commits to work items
+✓ Sync PR status
+□ Auto-assign based on expertise
+□ Time tracking integration
+
+Step 5: Local Setup
+─────────────────────────────────────────────────────────────
+Creating directories...
+✓ .claude/azure/
+✓ .claude/azure/user-stories/
+✓ .claude/azure/tasks/
+✓ .claude/azure/features/
+✓ .claude/azure/cache/
+✓ .claude/azure/imports/
+
+Saving configuration...
+✓ .claude/.env updated
+✓ .claude/azure/config.yml created
+```
+
+### 2. Create Configuration Files
+
+`.claude/.env`:
+```bash
+AZURE_DEVOPS_PAT=xxx
+AZURE_DEVOPS_ORG=rafal0387
+AZURE_DEVOPS_PROJECT=Speacher
+```
+
+`.claude/azure/config.yml`:
+```yaml
+azure_devops:
+  organization: rafal0387
+  project: Speacher
+  
+defaults:
+  area_path: Speacher
+  iteration_path: Speacher\Sprint 2
+  
+team:
+  name: Development Team
+  members:
+    - email: john@example.com
+      role: Developer
+      expertise: [backend, auth]
+    - email: sarah@example.com
+      role: Developer
+      expertise: [frontend, ui]
+      
+sync:
+  enabled: true
+  interval: 5m
+  bidirectional: true
+  
+git:
+  auto_branch: true
+  branch_prefix: "azure"
+  link_commits: true
+  
+features:
+  time_tracking: false
+  auto_assign: false
+  notifications: true
+```
+
+### 3. Validation & Import
+
+```
+📊 Existing Work Items Found
+─────────────────────────────────────────────────────────────
+Found in Azure DevOps:
+- 3 Features
+- 12 User Stories
+- 45 Tasks
+
+Would you like to:
+[1] Import all to local cache
+[2] Import active items only
+[3] Start fresh (no import)
+[4] Select items to import
+
+Choice: 2
+
+Importing active items...
+✓ Imported 1 Feature
+✓ Imported 4 User Stories
+✓ Imported 12 Tasks
+
+Cache populated: .claude/azure/cache/
+```
+
+### 4. Git Hooks Setup
+
+```bash
+#!/bin/bash
+# .git/hooks/commit-msg
+# Auto-link commits to Azure DevOps items
+
+commit_regex="(#[0-9]+)"
+if grep -qE "$commit_regex" "$1"; then
+  echo "Azure DevOps work item detected"
+  # Add work item link
+fi
+```
+
+### 5. Success Summary
+
+```
+✅ Azure DevOps Integration Initialized!
+
+📋 Configuration Summary:
+- Organization: rafal0387
+- Project: Speacher
+- Team: 4 members
+- Active Items: 17 imported
+
+🔧 Available Commands:
+- /azure:us-new - Create User Story
+- /azure:task-start - Start task
+- /azure:sprint-status - Sprint dashboard
+- /azure:standup - Daily standup
+- /azure:help - Full command list
+
+🚀 Quick Start:
+1. View current sprint: /azure:sprint-status
+2. See your tasks: /azure:task-list --my-tasks
+3. Start work: /azure:next-task
+
+📚 Documentation: .claude/commands/azure/README.md
+
+Happy coding! 🎉
+```
+
+### 6. Health Check
+
+```
+Running health check...
+✓ API connection: OK
+✓ Permissions: Read/Write
+✓ Git integration: Configured
+✓ Local cache: Ready
+✓ Sync service: Running
+
+All systems operational!
+```