agileflow 2.61.0 → 2.62.0

package/src/core/skills/agileflow-tech-debt/SKILL.md

@@ -1,215 +0,0 @@
----
-name: agileflow-tech-debt
-description: Identifies and tracks technical debt items with impact/effort matrix and prioritization. Loads when discussing code quality, refactoring, or long-term maintenance.
----
-
-# AgileFlow Tech Debt
-
-Identifies, documents, prioritizes, and tracks technical debt using impact/effort matrix and priority scoring to manage debt systematically.
-
-## When to Use
-
-This skill activates when:
-- Discussing code quality, refactoring, maintenance issues
-- Keywords: "tech debt", "needs cleanup", "messy code", "technical debt"
-- Team pain points from retrospectives
-- Developer complaints about specific code areas
-- During code reviews when debt is identified
-
-## What This Does
-
-1. Identifies technical debt from user descriptions
-2. Classifies type (Code Quality, Performance, Security, Maintainability, Testing)
-3. Assesses impact/urgency/effort (1-5 scale)
-4. Calculates priority score: (Impact × Urgency) / Effort
-5. Documents in docs/08-quality/tech-debt.md
-6. Suggests actions (create story for high-priority items)
-
-## Instructions
-
-1. **Identify tech debt** from user description or code analysis:
-   - What specific code/system is problematic?
-   - Why is this debt (not just "messy" but concrete issues)?
-   - What pain does it cause?
-
-2. **Classify type**:
-   - Code Quality | Performance | Security | Maintainability | Testing
-
-3. **Assess dimensions** (1-5 scale):
-   - **Impact**: How much does this hurt us?
-   - **Urgency**: How soon must we fix?
-   - **Effort**: How hard to fix?
-
-4. **Calculate priority score**: (Impact × Urgency) / Effort
-   - Score >10: High Priority (DO NOW)
-   - Score 3-10: Medium Priority (PLAN)
-   - Score <3: Low Priority (LATER)
-
-5. **Document item** in docs/08-quality/tech-debt.md:
-   - ID: TD-### (next sequential number)
-   - Include: Problem, Impact, Proposed Solution, Effort, Priority Score, Status
-
-6. **Suggest actions**:
-   - **High priority (>10)**: Create story via `/agileflow:story`
-   - **Major refactoring**: Document via `/agileflow:adr-new`
-   - **Blocking features**: Update status.json with blocked stories
-
-## Tech Debt Item Template
-
-```markdown
-### [TD-###] Descriptive Title
-
-**Impact**: 1-5 (Low/Medium/High)
-**Urgency**: 1-5 (Low/Medium/High)
-**Effort**: 1-5 (Low <1 sprint / Medium 1-2 sprints / High >2 sprints)
-**Priority Score**: (Impact × Urgency) / Effort = X.X
-**Type**: Code Quality | Performance | Security | Maintainability | Testing
-**Status**: Identified | Planned | In Progress | Resolved
-
-**Problem**:
-[What's wrong? Be specific, not vague.]
-
-**Impact**:
-- [How does this hurt us? Specific pain points]
-- [What can't we do because of this?]
-
-**Proposed Solution**:
-- [What should we do to address this?]
-- [What tools/patterns to use?]
-
-**Estimated Effort**: X story points
-```
-
-## Priority Score Formula
-
-```
-Priority = (Impact × Urgency) / Effort
-
-Impact:  1 (Low), 3 (Medium), 5 (High)
-Urgency: 1 (Low), 3 (Medium), 5 (High)
-Effort:  1 (Low <1 sprint), 3 (Medium 1-2 sprints), 5 (High >2 sprints)
-```
-
-**Examples**:
-- TD-042: (3 × 3) / 1 = 9 (High Priority - duplicate code, easy fix)
-- TD-067: (5 × 5) / 1 = 25 (Critical Priority - slow query, add index)
-- TD-089: (1 × 1) / 5 = 0.2 (Low Priority - minor cleanup, major refactor)
-
-## Impact/Effort Matrix
-
-```
-High Impact,  │ DO NOW │ DO NOW │        │
-Low Effort    │        │        │        │
-              ├────────┼────────┼────────┤
-High Impact,  │ PLAN   │ PLAN   │        │
-Med Effort    │        │        │        │
-              ├────────┼────────┼────────┤
-Low Impact,   │ LATER  │ LATER  │ NEVER  │
-Any Effort    │        │        │        │
-              └────────┴────────┴────────┘
-              Low      Medium    High
-                    EFFORT
-```
-
-## Types of Tech Debt
-
-**Code Quality**: Duplicate code, complex logic, poor naming, missing docs
-- Example: User validation copy-pasted in 8 files
-
-**Performance**: Slow queries, N+1 problems, inefficient algorithms, missing caching
-- Example: Login query takes 500ms due to missing index
-
-**Security**: Outdated dependencies, vulnerable packages, missing auth, insufficient validation
-- Example: Package X has known CVE, needs update
-
-**Maintainability**: Tightly coupled code, missing tests, unclear architecture
-- Example: Module X has 0 tests, 300 LOC
-
-**Testing**: Low coverage, flaky tests, slow suite, missing integration tests
-- Example: Test coverage at 45%, target is 80%
-
-## When to Address Tech Debt
-
-**Continuous** (Every Sprint):
-- Allocate 10-20% of sprint capacity for debt reduction
-- Boy Scout Rule: Leave code cleaner than you found it
-
-**Scheduled** (Quarterly):
-- Tech debt sprint (full sprint dedicated to quality)
-- Major refactoring initiatives
-
-**Opportunistic**:
-- While working on nearby code
-- When adding related features
-- During bug fixes in affected areas
-
-**Strategic**:
-- Before major new features (clean foundation)
-- When debt blocks progress (unblock development)
-- When quality metrics decline
-
-## Tech Debt Metrics
-
-Track in docs/08-quality/tech-debt.md:
-
-```markdown
-## Tech Debt Health (Q4 2025)
-
-**Total Items**: 24 (🔴 6 High, 🟡 11 Medium, 🟢 7 Low)
-**Total Estimated Effort**: 156 story points
-**Resolved This Quarter**: 8 items (42 story points)
-**New This Quarter**: 5 items (18 story points)
-**Net Change**: -3 items (-24 points) ✅ Improving
-```
-
-## Quality Checklist
-
-Before creating tech debt item:
-- [ ] Problem clearly described (specific code/system, not vague)
-- [ ] Impact explained with concrete pain points
-- [ ] Proposed solution is specific and actionable
-- [ ] Effort estimated realistically
-- [ ] Priority score calculated: (Impact × Urgency) / Effort
-- [ ] Type assigned correctly
-- [ ] Owner or responsible team identified
-- [ ] Status set appropriately
-- [ ] TD-### ID is next sequential number
-
-## Priority Tiers
-
-- **🔴 High Priority (score >10)**: DO NOW - High impact, low-medium effort
-- **🟡 Medium Priority (score 3-10)**: PLAN - Mixed impact/effort
-- **🟢 Low Priority (score <3)**: LATER - Low impact or high effort
-
-## Integration
-
-- **agileflow-story**: Convert high-priority debt (>10) to stories
-- **agileflow-adr**: Document major refactoring decisions
-- **agileflow-retro**: Retrospectives surface new tech debt
-- **agileflow-sprint**: Allocate 10-20% sprint capacity for debt reduction
-
-## Preventing Tech Debt
-
-**Best Practices**:
-- Code reviews catch issues early
-- Automated testing prevents regressions (80%+ coverage)
-- Regular refactoring (Boy Scout Rule)
-- Document intentional decisions (ADRs)
-- Allocate time for quality work
-
-**Warning Signs**:
-- Slowing velocity (stories taking longer)
-- Increasing bug rate
-- Developers avoiding certain code
-- Long PR review times
-- New developer onboarding difficulty
-
-## Notes
-
-- Track tech debt, don't let it hide (visibility is key)
-- Make it visible (metrics, reviews)
-- Allocate consistent capacity (10-20% per sprint)
-- Celebrate debt reduction
-- Prevent new debt through code review
-- Balance new features with quality
-- Not all "ugly code" is debt - document intentional trade-offs as ADRs

package/src/core/skills/api-documentation-generator/SKILL.md

@@ -1,65 +0,0 @@
----
-name: api-documentation-generator
-description: Generate OpenAPI/Swagger documentation with request/response schemas
----
-
-# api-documentation-generator
-
-Generate OpenAPI/Swagger snippets with proper schemas.
-
-## Activation Keywords
-- "API doc", "OpenAPI", "Swagger", "endpoint docs", "endpoint documentation"
-
-## When to Use
-- Documenting REST API endpoints
-- Creating OpenAPI/Swagger specifications
-- Need endpoint documentation with request/response examples
-
-## What This Does
-Generates OpenAPI 3.0 specification snippets including:
-- **Endpoint path and method** (GET, POST, etc.)
-- **Summary and description**
-- **Request body** with schema and examples
-- **Response schemas** (success and error cases)
-- **Parameters** (query, path, header)
-- **Authentication** requirements
-- **Status codes** and descriptions
-
-Coordinates with documentation agent for full API docs.
-
-## Output
-OpenAPI YAML/JSON snippet ready for integration into spec
-
-## Example Activation
-User: "Document POST /api/auth/login endpoint"
-Skill: Generates:
-```yaml
-/api/auth/login:
-  post:
-    summary: User login with email and password
-    tags: [Authentication]
-    requestBody:
-      required: true
-      content:
-        application/json:
-          schema:
-            type: object
-            properties:
-              email:
-                type: string
-                format: email
-              password:
-                type: string
-    responses:
-      '200':
-        description: Login successful
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                token:
-                  type: string
-      '401':
-        description: Invalid credentials
-```

package/src/core/skills/changelog-entry/SKILL.md

@@ -1,55 +0,0 @@
----
-name: changelog-entry
-description: Generate Keep a Changelog format entries for version releases
----
-
-# changelog-entry
-
-Generate Keep a Changelog format entries.
-
-## Activation Keywords
-- "changelog", "release notes", "version notes", "changelog entry"
-
-## When to Use
-- Creating release notes for new version
-- Documenting changes for changelog
-- Preparing version announcement
-
-## What This Does
-Generates changelog entries in Keep a Changelog format:
-- **Version header** with date (YYYY-MM-DD)
-- **Categories**: Added, Changed, Fixed, Improved, Deprecated, Removed, Security
-- **Detailed descriptions** of each change
-- **Breaking changes** clearly marked
-- **Links to related issues/PRs**
-- **Migration guides** for breaking changes
-
-Can auto-extract changes from commit messages if provided.
-
-## Output
-Ready-to-add section for CHANGELOG.md
-
-## Example Activation
-User: "Version 2.18.0 - Added 8 new agents"
-Skill: Generates:
-```markdown
-## [2.18.0] - 2025-10-28
-
-### Added
-- **Documentation Agent** - Technical docs, API documentation, user guides
-- **Monitoring Agent** - Observability, logging, metrics, alerting
-- **Compliance Agent** - GDPR, HIPAA, SOC2 compliance
-- **Design Agent** - Design systems, component specs
-- **Accessibility Agent** - WCAG compliance, a11y testing
-- **Analytics Agent** - Event tracking, product analytics
-- **Data Migration Agent** - Zero-downtime migrations
-- **QA Agent** - Test strategy, release gates
-
-### Changed
-- Expanded agent ecosystem from 17 to 25 agents
-- Improved agent coverage for enterprise features
-
-### Improved
-- Added comprehensive monitoring and compliance support
-- Enhanced quality assurance gates
-```

package/src/core/skills/commit-message-formatter/SKILL.md

@@ -1,50 +0,0 @@
----
-name: commit-message-formatter
-description: Generate conventional commit messages following Conventional Commits standard
----
-
-# commit-message-formatter
-
-Generate conventional commit messages with detailed descriptions.
-
-## Activation Keywords
-- "commit", "git commit", "conventional commit", "commit message"
-
-## When to Use
-- User is about to commit code changes
-- Need to format commit in conventional commits style
-- Writing clear, searchable commit messages
-
-## What This Does
-Generates properly-formatted commit messages following Conventional Commits standard:
-- Type: feat, fix, chore, docs, style, refactor, perf, test
-- Scope: module or component affected
-- Subject: concise description (imperative mood, <50 chars)
-- Body: detailed explanation of change (wrapped at 72 chars)
-- Footer: references to issues, breaking changes, co-authorship
-
-Automatically includes:
-- Claude Code co-authorship footer
-- Link to related story/issue if mentioned
-- Breaking change notation if applicable
-
-## Output
-Ready-to-use commit message for `git commit -m`
-
-## Example Activation
-User: "I implemented user login endpoint with JWT auth and rate limiting"
-Skill: Generates:
-```
-feat(auth): implement JWT-based user login endpoint
-
-Implemented POST /api/auth/login endpoint with:
-- Email/password validation
-- JWT token generation (24h expiration)
-- Rate limiting (5 attempts per 15 minutes)
-- Proper error handling and logging
-
-Matches acceptance criteria from US-0001.
-
-🤖 Generated with Claude Code
-Co-Authored-By: Claude <noreply@anthropic.com>
-```

package/src/core/skills/deployment-guide-generator/SKILL.md

@@ -1,84 +0,0 @@
----
-name: deployment-guide-generator
-description: Generate deployment guides with rollback procedures and verification steps
----
-
-# deployment-guide-generator
-
-Generate deployment guides with rollback procedures.
-
-## Activation Keywords
-- "deployment", "release guide", "deploy steps", "deployment procedure"
-
-## When to Use
-- Preparing to deploy a feature
-- Creating release runbook
-- Documenting deployment steps
-
-## What This Does
-Generates deployment guide including:
-- **Pre-deployment checklist** (tests passing, staging verified)
-- **Deployment steps** (database migrations, code deployment)
-- **Verification steps** (health checks, smoke tests)
-- **Rollback procedure** (how to revert if issues)
-- **Post-deployment monitoring** (watch metrics/logs)
-- **Communication plan** (who to notify)
-- **Estimated timeline**
-
-References monitoring for setup and rollback procedures.
-
-## Output
-Ready-to-follow deployment guide
-
-## Example Activation
-User: "Create deployment guide for user login feature"
-Skill: Generates:
-```markdown
-## Deployment Guide: User Login Feature (v2.18.0)
-
-### Pre-Deployment Checklist
-- [ ] All tests passing (npm test)
-- [ ] Staging environment verified
-- [ ] Database backup taken
-- [ ] Monitoring alerts configured
-- [ ] Team notified
-
-### Deployment Steps
-1. Run database migrations
-   \`\`\`bash
-   npm run migrate:up
-   \`\`\`
-
-2. Deploy new code
-   \`\`\`bash
-   git push production main
-   \`\`\`
-
-3. Verify deployment
-   - Check /health endpoint returns 200
-   - Verify JWT tokens working
-   - Check rate limiting active
-
-### Monitoring (Watch these metrics)
-- Login success rate (target: >95%)
-- Login latency (target: <200ms p95)
-- Error rate (alert if >1%)
-- Rate limiting hits (expected: <5%)
-
-### Rollback Procedure (if issues)
-1. Revert database migrations:
-   \`\`\`bash
-   npm run migrate:down
-   \`\`\`
-
-2. Revert code:
-   \`\`\`bash
-   git revert <commit-hash>
-   git push production main
-   \`\`\`
-
-3. Verify rollback successful
-
-**Estimated Timeline**: 15 minutes (10 min deploy + 5 min verify)
-**Rollback Time**: 10 minutes
-```

package/src/core/skills/diagram-generator/SKILL.md

@@ -1,65 +0,0 @@
----
-name: diagram-generator
-description: Generate Mermaid/ASCII diagrams for workflows, architecture, and sequence diagrams
----
-
-# diagram-generator
-
-Generate Mermaid/ASCII diagrams from descriptions.
-
-## Activation Keywords
-- "diagram", "ASCII", "Mermaid", "flowchart", "architecture", "sequence diagram"
-
-## When to Use
-- Creating architecture diagrams
-- Visualizing user workflows
-- Drawing sequence diagrams
-- System design documentation
-
-## What This Does
-Generates diagrams in Mermaid format (renders in GitHub/Markdown):
-- **Flowcharts** (user flows, decision trees)
-- **Sequence diagrams** (API interactions, service calls)
-- **Architecture diagrams** (system components, data flow)
-- **ER diagrams** (database relationships)
-- **Gantt charts** (timeline/roadmap)
-- **State diagrams** (state machines)
-
-Also supports ASCII art for simple diagrams.
-
-## Output
-Mermaid code blocks ready for markdown files
-
-## Example Activation
-User: "Draw user login flow"
-Skill: Generates:
-```mermaid
-flowchart TD
-    A[User opens login page] --> B[Enter email & password]
-    B --> C[Click submit]
-    C --> D{Valid credentials?}
-    D -->|No| E[Show error message]
-    E --> B
-    D -->|Yes| F[Generate JWT token]
-    F --> G[Redirect to dashboard]
-    G --> H[User logged in]
-
-    style D fill:#ff9999
-    style H fill:#99ff99
-```
-
-Architecture diagram example:
-```mermaid
-graph LR
-    Client[Frontend Client]
-    API[API Server]
-    DB[(Database)]
-    Cache[Redis Cache]
-    Auth[Auth Service]
-
-    Client -->|HTTP Request| API
-    API -->|Query| DB
-    API -->|Lookup| Cache
-    API -->|Verify Token| Auth
-    Auth -->|Check User| DB
-```

package/src/core/skills/error-handler-template/SKILL.md

@@ -1,78 +0,0 @@
----
-name: error-handler-template
-description: Generate error handling boilerplate with custom error classes and try/catch patterns
----
-
-# error-handler-template
-
-Generate error handling boilerplate for different languages.
-
-## Activation Keywords
-- "error handling", "try catch", "error handler", "exception handling"
-
-## When to Use
-- Implementing error handling for new features
-- Standardizing error responses across API
-- Creating error logging patterns
-
-## What This Does
-Generates language-specific error handling code including:
-- **Error classes** with custom fields
-- **Try/catch patterns** for common scenarios
-- **Error middleware** for API servers
-- **Logging integration** for errors
-- **User-friendly error messages**
-- **HTTP status code mapping**
-- **Stack trace and context capture**
-
-Supports: JavaScript/TypeScript, Python, Java, Go, Rust
-
-## Output
-Error handling code ready to integrate
-
-## Example Activation
-User: "Create error handling for login endpoint"
-Skill: Generates (TypeScript):
-```typescript
-// Custom error class
-class AuthError extends Error {
-  constructor(
-    public code: string,
-    public statusCode: number,
-    message: string,
-    public context?: Record<string, any>
-  ) {
-    super(message);
-  }
-}
-
-// Try/catch pattern
-async function login(email: string, password: string) {
-  try {
-    const user = await findUserByEmail(email);
-    if (!user) {
-      throw new AuthError('USER_NOT_FOUND', 404, 'User not found', { email });
-    }
-
-    const isValid = await verifyPassword(password, user.passwordHash);
-    if (!isValid) {
-      logger.warn('Invalid password attempt', { email });
-      throw new AuthError(
-        'INVALID_CREDENTIALS',
-        401,
-        'Invalid email or password'
-      );
-    }
-
-    return generateToken(user);
-  } catch (error) {
-    if (error instanceof AuthError) {
-      logger.error(error.message, { code: error.code, context: error.context });
-      throw error;
-    }
-    // Handle unexpected errors
-    logger.error('Unexpected error in login', { error });
-    throw new AuthError('INTERNAL_ERROR', 500, 'Internal server error');
-  }
-}
-```

package/src/core/skills/migration-checklist/SKILL.md

@@ -1,82 +0,0 @@
----
-name: migration-checklist
-description: Generate data migration checklist with validation, rollback, and zero-downtime procedures
----
-
-# migration-checklist
-
-Generate data migration checklist.
-
-## Activation Keywords
-- "migration", "zero-downtime", "data migration", "migration checklist"
-
-## When to Use
-- Planning data migrations (schema changes, zero-downtime)
-- Moving data between systems
-- Large-scale data transformations
-
-## What This Does
-Generates comprehensive migration checklist including:
-- **Pre-migration validation** (backup, verify counts)
-- **Migration phases** (dual-write, backfill, switch)
-- **Rollback procedures** (tested and documented)
-- **Data validation rules** (checksums, counts, integrity)
-- **Monitoring during migration** (watch for anomalies)
-- **Post-migration verification** (smoke tests, queries)
-- **Cleanup procedures** (remove old schema/data)
-- **Communication timeline**
-
-Coordinates with datamigration agent for detailed migration planning.
-
-## Output
-Ready-to-execute migration checklist
-
-## Example Activation
-User: "Plan zero-downtime migration from sessions to JWT"
-Skill: Generates:
-```markdown
-## Migration Checklist: Session → JWT Migration
-
-### Phase 1: Preparation (pre-migration)
-- [ ] Create full database backup (test restore)
-- [ ] Verify staging matches production (data volume, schema)
-- [ ] Prepare rollback procedure (documented and tested)
-- [ ] Brief team on timeline and communication
-- [ ] Schedule 2-hour maintenance window
-- [ ] Set up monitoring dashboards
-
-### Phase 2: Dual-Write (no downtime)
-- [ ] Deploy code that writes to BOTH sessions + JWT
-- [ ] Monitor for errors (should be zero)
-- [ ] Backfill JWT for existing sessions (background job)
-- [ ] Track conversion progress (% of sessions migrated)
-- [ ] Once 100% converted: Wait 24h for safety
-
-### Phase 3: Verify
-- [ ] Check record counts match:
-  - SELECT COUNT(*) FROM sessions
-  - SELECT COUNT(*) FROM jwt_tokens
-  - Should be equal
-- [ ] Validate JWT expiration timestamps
-- [ ] Check no orphaned sessions
-- [ ] Spot-check 100 random sessions
-
-### Phase 4: Switch Reads
-- [ ] Deploy code to read from JWT instead of sessions
-- [ ] Monitor error rate (should be zero)
-- [ ] Keep writing to BOTH for 24h (safety)
-- [ ] Verify user experience
-
-### Phase 5: Cleanup
-- [ ] Stop writing to sessions table
-- [ ] Archive sessions (backup)
-- [ ] Drop sessions table
-- [ ] Update documentation
-
-### Rollback Point
-If issues during Phase 1-2: Revert to code writing sessions only (backward compatible)
-If issues during Phase 3-4: Switch reads back to sessions (keep JWT as backup)
-
-**Estimated Timeline**: 3-4 hours total
-**Expected Downtime**: 0 (zero-downtime migration)
-```