claude-autopm 2.8.1 → 2.8.2

package/autopm/.claude/commands/azure/import-us.md

@@ -1,269 +0,0 @@
----
-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/autopm/.claude/commands/azure/init.md

@@ -1,211 +0,0 @@
----
-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!
-```