Full-Stack Development Workflows

/api-endpoint - Create REST API endpoint

markdown

`# /api-endpoint Create REST API endpoint: $ARGUMENTS with full testing and documentation.

Implementation Checklist

1. Route Setup

   • Create route file in /routes/api/$ARGUMENTS.js
   • Implement CRUD operations (GET, POST, PUT, DELETE)
   • Add request validation with Joi or Yup
   • Include proper error handling with status codes

2. Database Integration

   • Create/update Sequelize/Prisma models
   • Add database migrations if schema changes needed
   • Implement proper indexing for performance
   • Add database transaction support

3. Testing Suite

   • Create integration tests in /tests/api/$ARGUMENTS.test.js
   • Test all HTTP methods and status codes
   • Add edge case testing (invalid data, auth failures)
   • Include performance testing for large datasets

4. Documentation

   • Generate OpenAPI/Swagger documentation
   • Add example requests and responses
   • Document authentication requirements
   • Include rate limiting information

Validation

• All tests pass with 100% coverage
• API documentation is auto-generated
• Rate limiting configured appropriately
• Security middleware (helmet, cors) applied`

/react-component - Full React component creation

markdown

`# /react-component
Create React component: $ARGUMENTS with TypeScript, tests, and Storybook.

Component Structure

1. Core Implementation

   // src/components/$ARGUMENTS/$ARGUMENTS.tsx
   import React from 'react';
   import './styles.css';
   
   interface ${ARGUMENTS}Props {
     // Define props with JSDoc comments
   }
   
   export const $ARGUMENTS: React.FC<${ARGUMENTS}Props> = ({}) => {
     // Implementation with proper error boundaries
     return <div></div>;
   };`
   
   

2. Testing Strategy

   • Unit tests: /tests/components/$ARGUMENTS.test.tsx
   • Integration tests with React Testing Library
   • Accessibility tests with jest-axe
   • Visual regression tests with Chromatic

3. Storybook Stories

   • Default story with all props
   • Edge case stories (empty state, error state)
   • Interactive controls for all props
   • Documentation with best practices

4. Styling & Accessibility

   • CSS modules or styled-components
   • Responsive design breakpoints
   • WCAG 2.1 AA compliance
   • Keyboard navigation support
   • Screen reader optimization

Quality Gates

• TypeScript compilation without errors
• All tests pass with >95% coverage
• Lighthouse accessibility score >95
• Storybook builds without warnings

#### /database-migration` - Comprehensive migration workflow

# /database-migration
Create database migration: $ARGUMENTS with rollback and testing.

## Migration Planning
1. **Analysis Phase**
   - Review current schema with `describe` commands
   - Identify potential breaking changes
   - Plan data migration strategy for existing records
   - Estimate migration time for production data volume

2. **Migration Files**
   ```sql
   -- migrations/$(date +%Y%m%d_%H%M%S)_$ARGUMENTS.up.sql
   BEGIN TRANSACTION;
   -- Forward migration
   COMMIT;`

sql

- `*- migrations/$(date +%Y%m%d_%H%M%S)_$ARGUMENTS.down.sql*
BEGIN TRANSACTION;
*- Rollback migration*
COMMIT;`
1. **Testing Protocol**
    - Test on development database with production data copy
    - Verify migration performance with EXPLAIN ANALYZE
    - Test rollback procedure completely
    - Validate data integrity with checksums
2. **Production Deployment**
    - Create database backup before migration
    - Run migration during low-traffic window
    - Monitor application health post-migration
    - Document any manual steps required