agileflow 2.61.0 → 2.63.0

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)
-```

package/src/core/skills/pr-description/SKILL.md

@@ -1,65 +0,0 @@
----
-name: pr-description
-description: Generate pull request description with testing instructions and comprehensive checklist
----
-
-# pr-description
-
-Generate pull request description with testing instructions.
-
-## Activation Keywords
-- "pull request", "create PR", "merge request", "pr description", "pr body"
-
-## When to Use
-- Creating pull request on GitHub/GitLab
-- Need comprehensive PR description with testing steps
-- Documenting changes for code review
-
-## What This Does
-Generates complete PR description including:
-- **Summary**: 2-3 sentence overview of changes
-- **Related Issues**: Links to GitHub issues/stories
-- **Changes Made**: Bulleted list of modifications
-- **Testing Instructions**: Step-by-step testing guide
-- **Checklist**: Pre-merge verification items
-- **Migration Guide**: Steps for deploying if needed
-- **Screenshots/Links**: If UI changes or demos
-
-Coordinates with relevant agents (testing, documentation, etc.).
-
-## Output
-Ready-to-paste PR description
-
-## Example Activation
-User: "Create PR for user login feature"
-Skill: Generates:
-```markdown
-## Summary
-Implements user authentication system with JWT tokens and rate limiting.
-Includes login endpoint, password reset flow, and token refresh.
-
-## Related Issues
-Closes #42 (User Authentication Epic)
-Relates to: US-0001, US-0002, US-0003
-
-## Changes Made
-- ✨ POST /api/auth/login endpoint with JWT generation
-- ✨ POST /api/auth/logout endpoint
-- ✨ Password reset flow with email verification
-- 🐛 Fixed rate limiting to prevent brute force
-- 📝 Updated API documentation
-- ✅ Added 45 test cases (98% coverage)
-
-## Testing Instructions
-1. Start dev server: `npm run dev`
-2. Test login: curl -X POST http://localhost:3000/api/auth/login
-3. Verify JWT: Check token expiration (24h)
-4. Test rate limiting: 5+ failed attempts should block
-
-## Checklist
-- [x] Tests passing
-- [x] Code coverage >80%
-- [x] No console errors
-- [x] API docs updated
-- [x] Database migrations run
-```

package/src/core/skills/sql-schema-generator/SKILL.md

@@ -1,69 +0,0 @@
----
-name: sql-schema-generator
-description: Generate SQL schemas with migrations and database table definitions
----
-
-# sql-schema-generator
-
-Generate SQL schemas with migrations.
-
-## Activation Keywords
-- "SQL", "schema", "database design", "CREATE TABLE", "migration"
-
-## When to Use
-- Designing database schemas
-- Creating migrations for new features
-- Defining table structures and relationships
-
-## What This Does
-Generates SQL DDL statements including:
-- **CREATE TABLE** statements with data types
-- **Indexes** for performance
-- **Foreign keys** for relationships
-- **Constraints** (NOT NULL, UNIQUE, CHECK)
-- **Default values** where applicable
-- **Comments** explaining purpose
-
-Also generates:
-- **Migration files** (with up/down versions)
-- **Rollback procedures**
-- **Data migration scripts** if needed
-
-Coordinates with database agent.
-
-## Output
-SQL migration files in migrations/ directory
-
-## Example Activation
-User: "Create users and sessions tables"
-Skill: Generates:
-```sql
--- Migration: 2025-10-28_create_users_table
-
--- UP: Create tables
-CREATE TABLE users (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  email VARCHAR(255) NOT NULL UNIQUE,
-  password_hash VARCHAR(255) NOT NULL,
-  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-  is_active BOOLEAN DEFAULT true,
-  INDEX idx_email (email),
-  INDEX idx_created_at (created_at)
-);
-
-CREATE TABLE sessions (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  user_id UUID NOT NULL,
-  token VARCHAR(500) NOT NULL UNIQUE,
-  expires_at TIMESTAMP NOT NULL,
-  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-  FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE,
-  INDEX idx_user_id (user_id),
-  INDEX idx_expires_at (expires_at)
-);
-
--- DOWN: Drop tables (for rollback)
-DROP TABLE IF EXISTS sessions;
-DROP TABLE IF EXISTS users;
-```

package/src/core/skills/story-skeleton/SKILL.md

@@ -1,34 +0,0 @@
----
-name: story-skeleton
-description: Auto-generate story template with boilerplate sections pre-filled
----
-
-# story-skeleton
-
-Auto-generate story template with boilerplate sections pre-filled.
-
-## Activation Keywords
-- "create story", "new story", "story template", "story skeleton"
-
-## When to Use
-- User requests to create a new user story
-- Need to quickly scaffold a story structure
-- Starting epic implementation
-
-## What This Does
-Generates story YAML frontmatter + markdown template with:
-- Story ID (auto-generated from epic context)
-- Epic reference
-- Title and description sections
-- Acceptance Criteria (Given/When/Then format stubs)
-- Architecture Context section with 6 subsections
-- Previous Story Insights section
-- Testing Strategy section
-- Dev Agent Record template
-
-## Output
-Complete story file ready for population by epic-planner agent.
-
-## Example Activation
-User: "Create a story for user login API"
-Skill: Generates story skeleton with all sections, ready for epic-planner to fill in details

package/src/core/skills/test-case-generator/SKILL.md

@@ -1,63 +0,0 @@
----
-name: test-case-generator
-description: Generate test cases from acceptance criteria with unit, integration, and E2E scenarios
----
-
-# test-case-generator
-
-Generate test cases from acceptance criteria.
-
-## Activation Keywords
-- "test cases", "test plan", "from AC", "test from acceptance"
-
-## When to Use
-- Converting acceptance criteria to test cases
-- Creating test stubs for new features
-- Planning test coverage
-
-## What This Does
-Converts Given/When/Then acceptance criteria into:
-- **Unit test cases** (if applicable)
-- **Integration test cases** (API, database)
-- **E2E test cases** (full user workflow)
-- **Negative test cases** (error scenarios)
-- **Edge cases** (boundary conditions)
-
-Generates test case names, setup steps, assertions, and expected results.
-
-Coordinates with testing and qa agents.
-
-## Output
-Test case stub at docs/07-testing/test-cases/<STORY_ID>.md
-
-## Example Activation
-User: "Generate test cases from user login AC"
-Skill: Generates:
-```markdown
-## Test Cases for User Login (US-0001)
-
-### TC-001: Valid login succeeds
-Given: Valid user registered with email/password
-When: POST to /api/auth/login with valid credentials
-Then: Returns 200 with JWT token (24h expiration)
-
-### TC-002: Wrong password fails
-Given: User exists, wrong password provided
-When: POST to /api/auth/login
-Then: Returns 401 with error message
-
-### TC-003: Rate limiting active
-Given: User failed login 5 times
-When: Attempt 6th login
-Then: Returns 429 Too Many Requests
-
-### TC-004: Invalid email format
-Given: Malformed email address
-When: POST to /api/auth/login
-Then: Returns 400 Bad Request
-
-### Edge Cases
-- Empty email/password
-- SQL injection attempts
-- Token validation after expiration
-```

package/src/core/skills/type-definitions/SKILL.md

@@ -1,65 +0,0 @@
----
-name: type-definitions
-description: Generate TypeScript interfaces and types from data structure descriptions
----
-
-# type-definitions
-
-Generate TypeScript interfaces and types from descriptions.
-
-## Activation Keywords
-- "TypeScript", "types", "@interface", "type definition", "interface definition"
-
-## When to Use
-- Creating TypeScript interfaces for data structures
-- Defining function signatures
-- Type-safe API request/response types
-
-## What This Does
-Generates TypeScript/TypeScript-compatible types including:
-- **Interfaces** for data structures
-- **Type aliases** for unions and primitives
-- **Enums** for fixed sets of values
-- **Generic types** for reusable patterns
-- **JSDoc comments** for IDE intellisense
-- **Type guards** for runtime validation
-
-Includes proper typing with optionals, required fields, and readonly modifiers.
-
-## Output
-TypeScript code ready to add to types/ directory
-
-## Example Activation
-User: "Create types for User and LoginRequest"
-Skill: Generates:
-```typescript
-/** User account information */
-export interface User {
-  id: string;
-  email: string;
-  passwordHash: string;
-  createdAt: Date;
-  updatedAt: Date;
-  isActive: boolean;
-}
-
-/** Login request payload */
-export interface LoginRequest {
-  email: string;
-  password: string;
-}
-
-/** Login response payload */
-export interface LoginResponse {
-  token: string;
-  expiresIn: number;
-  user: Omit<User, 'passwordHash'>;
-}
-
-/** Authentication error response */
-export interface AuthError {
-  code: 'INVALID_CREDENTIALS' | 'USER_NOT_FOUND' | 'RATE_LIMITED';
-  message: string;
-  retryAfter?: number;
-}
-```

package/src/core/skills/validation-schema-generator/SKILL.md

@@ -1,64 +0,0 @@
----
-name: validation-schema-generator
-description: Generate input validation schemas for Joi, Zod, Yup, or Pydantic
----
-
-# validation-schema-generator
-
-Generate input validation schemas (Joi, Zod, Yup).
-
-## Activation Keywords
-- "validation", "schema", "joi", "zod", "yup", "validate input"
-
-## When to Use
-- Creating request body validation
-- Form validation schemas
-- Input sanitization and validation
-
-## What This Does
-Generates validation schemas for popular libraries:
-- **Joi** (Node.js)
-- **Zod** (TypeScript)
-- **Yup** (React forms)
-- **Pydantic** (Python)
-
-Includes:
-- **Required/optional fields**
-- **Type validation** (string, number, email, etc.)
-- **Length constraints** (min, max)
-- **Pattern validation** (regex)
-- **Custom validators**
-- **Error messages** (user-friendly)
-- **Transformation rules** (trim, lowercase, etc.)
-
-## Output
-Validation schema code ready for integration
-
-## Example Activation
-User: "Create Zod validation for login request"
-Skill: Generates:
-```typescript
-import { z } from 'zod';
-
-export const loginRequestSchema = z.object({
-  email: z
-    .string('Email is required')
-    .email('Invalid email format')
-    .toLowerCase()
-    .trim(),
-  password: z
-    .string('Password is required')
-    .min(8, 'Password must be at least 8 characters')
-    .regex(/[A-Z]/, 'Password must contain uppercase')
-    .regex(/[0-9]/, 'Password must contain number'),
-});
-
-export type LoginRequest = z.infer<typeof loginRequestSchema>;
-
-// Usage
-const validateLogin = (data: unknown) => {
-  return loginRequestSchema.parse(data);
-};
-```
-
-Also generates Joi, Yup, Pydantic versions.