autoworkflow 3.1.4 → 3.5.0

package/.claude/skills/openapi.md

@@ -0,0 +1,489 @@
+# OpenAPI Skill
+
+## Complete Specification
+\`\`\`yaml
+openapi: 3.1.0
+info:
+  title: My API
+  description: RESTful API for user management
+  version: 1.0.0
+  contact:
+    name: API Support
+    email: support@example.com
+  license:
+    name: MIT
+    url: https://opensource.org/licenses/MIT
+
+servers:
+  - url: https://api.example.com/v1
+    description: Production
+  - url: https://staging-api.example.com/v1
+    description: Staging
+  - url: http://localhost:3000/v1
+    description: Development
+
+tags:
+  - name: Users
+    description: User management operations
+  - name: Posts
+    description: Blog post operations
+  - name: Auth
+    description: Authentication endpoints
+
+paths:
+  /users:
+    get:
+      tags: [Users]
+      summary: List users
+      description: Returns a paginated list of users
+      operationId: listUsers
+      parameters:
+        - $ref: '#/components/parameters/PageParam'
+        - $ref: '#/components/parameters/LimitParam'
+        - name: status
+          in: query
+          schema:
+            type: string
+            enum: [active, inactive, pending]
+        - name: search
+          in: query
+          schema:
+            type: string
+          description: Search by name or email
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UserListResponse'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+      security:
+        - BearerAuth: []
+
+    post:
+      tags: [Users]
+      summary: Create user
+      operationId: createUser
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateUserInput'
+            examples:
+              basic:
+                summary: Basic user
+                value:
+                  email: user@example.com
+                  name: John Doe
+                  password: securepassword123
+      responses:
+        '201':
+          description: User created
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UserResponse'
+          headers:
+            Location:
+              schema:
+                type: string
+              description: URL of created resource
+        '400':
+          $ref: '#/components/responses/ValidationError'
+        '409':
+          description: Email already exists
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+
+  /users/{id}:
+    get:
+      tags: [Users]
+      summary: Get user by ID
+      operationId: getUserById
+      parameters:
+        - $ref: '#/components/parameters/UserIdParam'
+      responses:
+        '200':
+          description: User found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UserResponse'
+        '404':
+          $ref: '#/components/responses/NotFound'
+
+    patch:
+      tags: [Users]
+      summary: Update user
+      operationId: updateUser
+      parameters:
+        - $ref: '#/components/parameters/UserIdParam'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpdateUserInput'
+      responses:
+        '200':
+          description: User updated
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UserResponse'
+        '404':
+          $ref: '#/components/responses/NotFound'
+      security:
+        - BearerAuth: []
+
+    delete:
+      tags: [Users]
+      summary: Delete user
+      operationId: deleteUser
+      parameters:
+        - $ref: '#/components/parameters/UserIdParam'
+      responses:
+        '204':
+          description: User deleted
+        '404':
+          $ref: '#/components/responses/NotFound'
+      security:
+        - BearerAuth: []
+
+  /auth/login:
+    post:
+      tags: [Auth]
+      summary: Login
+      operationId: login
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [email, password]
+              properties:
+                email:
+                  type: string
+                  format: email
+                password:
+                  type: string
+                  format: password
+      responses:
+        '200':
+          description: Login successful
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  accessToken:
+                    type: string
+                  refreshToken:
+                    type: string
+                  expiresIn:
+                    type: integer
+        '401':
+          description: Invalid credentials
+
+components:
+  schemas:
+    User:
+      type: object
+      required: [id, email, name, createdAt]
+      properties:
+        id:
+          type: string
+          format: uuid
+          readOnly: true
+        email:
+          type: string
+          format: email
+        name:
+          type: string
+          minLength: 2
+          maxLength: 100
+        bio:
+          type: string
+          maxLength: 500
+          nullable: true
+        role:
+          type: string
+          enum: [user, admin, moderator]
+          default: user
+        status:
+          type: string
+          enum: [active, inactive, pending]
+        createdAt:
+          type: string
+          format: date-time
+          readOnly: true
+        updatedAt:
+          type: string
+          format: date-time
+          readOnly: true
+
+    CreateUserInput:
+      type: object
+      required: [email, name, password]
+      properties:
+        email:
+          type: string
+          format: email
+        name:
+          type: string
+          minLength: 2
+        password:
+          type: string
+          format: password
+          minLength: 8
+
+    UpdateUserInput:
+      type: object
+      properties:
+        name:
+          type: string
+          minLength: 2
+        bio:
+          type: string
+          maxLength: 500
+
+    UserResponse:
+      type: object
+      properties:
+        data:
+          $ref: '#/components/schemas/User'
+
+    UserListResponse:
+      type: object
+      properties:
+        data:
+          type: array
+          items:
+            $ref: '#/components/schemas/User'
+        meta:
+          $ref: '#/components/schemas/PaginationMeta'
+
+    PaginationMeta:
+      type: object
+      properties:
+        page:
+          type: integer
+        limit:
+          type: integer
+        total:
+          type: integer
+        totalPages:
+          type: integer
+
+    Error:
+      type: object
+      required: [code, message]
+      properties:
+        code:
+          type: string
+        message:
+          type: string
+        details:
+          type: array
+          items:
+            type: object
+            properties:
+              field:
+                type: string
+              message:
+                type: string
+
+  parameters:
+    UserIdParam:
+      name: id
+      in: path
+      required: true
+      schema:
+        type: string
+        format: uuid
+      description: User ID
+
+    PageParam:
+      name: page
+      in: query
+      schema:
+        type: integer
+        minimum: 1
+        default: 1
+
+    LimitParam:
+      name: limit
+      in: query
+      schema:
+        type: integer
+        minimum: 1
+        maximum: 100
+        default: 20
+
+  responses:
+    NotFound:
+      description: Resource not found
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+          example:
+            code: NOT_FOUND
+            message: Resource not found
+
+    Unauthorized:
+      description: Authentication required
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+
+    ValidationError:
+      description: Validation failed
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+
+  securitySchemes:
+    BearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+
+    ApiKeyAuth:
+      type: apiKey
+      in: header
+      name: X-API-Key
+
+    OAuth2:
+      type: oauth2
+      flows:
+        authorizationCode:
+          authorizationUrl: https://auth.example.com/authorize
+          tokenUrl: https://auth.example.com/token
+          scopes:
+            read:users: Read user data
+            write:users: Modify user data
+\`\`\`
+
+## Code Generation
+\`\`\`bash
+# Generate TypeScript types
+npx openapi-typescript openapi.yaml -o types/api.d.ts
+
+# Generate client SDK
+npx @openapitools/openapi-generator-cli generate \\
+  -i openapi.yaml \\
+  -g typescript-fetch \\
+  -o src/api-client
+
+# Generate server stubs
+npx @openapitools/openapi-generator-cli generate \\
+  -i openapi.yaml \\
+  -g typescript-express-server \\
+  -o src/server
+
+# Validate spec
+npx @redocly/cli lint openapi.yaml
+\`\`\`
+
+## TypeScript Integration
+\`\`\`typescript
+// Using generated types
+import type { paths, components } from './types/api';
+
+type User = components['schemas']['User'];
+type CreateUserInput = components['schemas']['CreateUserInput'];
+
+// Type-safe fetch with openapi-fetch
+import createClient from 'openapi-fetch';
+import type { paths } from './types/api';
+
+const client = createClient<paths>({ baseUrl: '/api' });
+
+// Fully typed request/response
+const { data, error } = await client.GET('/users/{id}', {
+  params: { path: { id: '123' } },
+});
+
+// data is typed as User | undefined
+// error is typed as Error | undefined
+\`\`\`
+
+## Schema Patterns
+\`\`\`yaml
+# Inheritance with allOf
+components:
+  schemas:
+    BaseEntity:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+        createdAt:
+          type: string
+          format: date-time
+
+    User:
+      allOf:
+        - $ref: '#/components/schemas/BaseEntity'
+        - type: object
+          properties:
+            email:
+              type: string
+
+# Polymorphism with oneOf
+    Pet:
+      oneOf:
+        - $ref: '#/components/schemas/Cat'
+        - $ref: '#/components/schemas/Dog'
+      discriminator:
+        propertyName: type
+        mapping:
+          cat: '#/components/schemas/Cat'
+          dog: '#/components/schemas/Dog'
+
+# Nullable fields
+    Profile:
+      type: object
+      properties:
+        bio:
+          type: string
+          nullable: true
+\`\`\`
+
+## Documentation Tools
+\`\`\`bash
+# Swagger UI
+npx swagger-ui-express  # Express middleware
+
+# Redoc (static docs)
+npx @redocly/cli build-docs openapi.yaml -o docs/index.html
+
+# Stoplight Elements (React component)
+npm install @stoplight/elements
+\`\`\`
+
+## ❌ DON'T
+- Skip required fields in schemas
+- Use generic names (data, item, object)
+- Forget error responses
+- Leave descriptions empty
+- Use inconsistent naming conventions
+
+## ✅ DO
+- Use \$ref for reusable components
+- Include examples for all schemas
+- Document all error responses
+- Add operationId for code generation
+- Use semantic versioning
+- Validate spec before deployment
+- Generate types from spec

package/.claude/skills/performance.md

@@ -0,0 +1,199 @@
+# Performance Skill
+
+## Core Web Vitals
+\`\`\`
+LCP (Largest Contentful Paint): < 2.5s
+  - Optimize images, fonts, critical CSS
+  - Preload key resources
+
+FID (First Input Delay): < 100ms
+  - Minimize JavaScript execution
+  - Break up long tasks
+
+CLS (Cumulative Layout Shift): < 0.1
+  - Set dimensions on images/videos
+  - Avoid inserting content above existing content
+\`\`\`
+
+## Code Splitting & Lazy Loading
+\`\`\`tsx
+// ✅ React lazy loading
+import { lazy, Suspense } from 'react';
+
+const Dashboard = lazy(() => import('./Dashboard'));
+const Settings = lazy(() => import('./Settings'));
+
+function App() {
+  return (
+    <Suspense fallback={<Loading />}>
+      <Routes>
+        <Route path="/dashboard" element={<Dashboard />} />
+        <Route path="/settings" element={<Settings />} />
+      </Routes>
+    </Suspense>
+  );
+}
+
+// ✅ Next.js dynamic import
+import dynamic from 'next/dynamic';
+
+const HeavyChart = dynamic(() => import('./HeavyChart'), {
+  loading: () => <Skeleton />,
+  ssr: false // Skip server-side rendering
+});
+\`\`\`
+
+## Image Optimization
+\`\`\`tsx
+// ✅ Next.js Image (automatic optimization)
+import Image from 'next/image';
+
+<Image
+  src="/hero.jpg"
+  width={1200}
+  height={600}
+  alt="Hero"
+  priority // Preload above-the-fold images
+  placeholder="blur"
+  blurDataURL={blurHash}
+/>
+
+// ✅ Responsive images
+<Image
+  src="/photo.jpg"
+  sizes="(max-width: 768px) 100vw, 50vw"
+  fill
+  style={{ objectFit: 'cover' }}
+/>
+\`\`\`
+
+## React Memoization
+\`\`\`tsx
+// ✅ Memoize expensive computations
+const sortedItems = useMemo(
+  () => items.sort((a, b) => b.score - a.score),
+  [items]
+);
+
+// ✅ Memoize callbacks passed to children
+const handleClick = useCallback(
+  (id: string) => dispatch({ type: 'SELECT', id }),
+  [dispatch]
+);
+
+// ✅ Memoize components that receive objects/arrays
+const MemoizedList = memo(function List({ items }: Props) {
+  return items.map(item => <Item key={item.id} {...item} />);
+});
+\`\`\`
+
+## Database Performance
+\`\`\`typescript
+// ❌ N+1 Problem
+const users = await prisma.user.findMany();
+for (const user of users) {
+  const posts = await prisma.post.findMany({ where: { authorId: user.id } });
+}
+
+// ✅ Single query with include
+const users = await prisma.user.findMany({
+  include: { posts: true }
+});
+
+// ✅ Select only needed fields
+const users = await prisma.user.findMany({
+  select: { id: true, name: true, email: true }
+});
+
+// ✅ Add database indexes
+// schema.prisma
+model User {
+  id    String @id
+  email String @unique
+  name  String
+
+  @@index([name]) // Add index for frequent lookups
+}
+\`\`\`
+
+## Redis Caching
+\`\`\`typescript
+import Redis from 'ioredis';
+
+const redis = new Redis(process.env.REDIS_URL);
+
+async function getUser(id: string) {
+  // Check cache first
+  const cached = await redis.get(\`user:\${id}\`);
+  if (cached) return JSON.parse(cached);
+
+  // Fetch from DB
+  const user = await prisma.user.findUnique({ where: { id } });
+
+  // Cache for 1 hour
+  await redis.set(\`user:\${id}\`, JSON.stringify(user), 'EX', 3600);
+
+  return user;
+}
+
+// Invalidate on update
+async function updateUser(id: string, data: UpdateData) {
+  await prisma.user.update({ where: { id }, data });
+  await redis.del(\`user:\${id}\`); // Clear cache
+}
+\`\`\`
+
+## Bundle Analysis
+\`\`\`bash
+# Next.js
+ANALYZE=true npm run build
+
+# Webpack (add to package.json)
+npx webpack-bundle-analyzer stats.json
+
+# Vite
+npx vite-bundle-visualizer
+\`\`\`
+
+## Performance Budgets
+\`\`\`json
+// package.json or bundlesize config
+{
+  "bundlesize": [
+    { "path": "./dist/main.js", "maxSize": "150 kB" },
+    { "path": "./dist/vendor.js", "maxSize": "300 kB" }
+  ]
+}
+\`\`\`
+
+## Monitoring
+\`\`\`typescript
+// Send Web Vitals to analytics
+import { onCLS, onFID, onLCP } from 'web-vitals';
+
+function sendToAnalytics({ name, delta, id }) {
+  fetch('/api/vitals', {
+    method: 'POST',
+    body: JSON.stringify({ name, delta, id })
+  });
+}
+
+onCLS(sendToAnalytics);
+onFID(sendToAnalytics);
+onLCP(sendToAnalytics);
+\`\`\`
+
+## ❌ DON'T
+- Optimize without measuring
+- Load unused JavaScript
+- Use large unoptimized images
+- Forget to cache database queries
+- Skip lazy loading for heavy components
+
+## ✅ DO
+- Measure before optimizing
+- Set performance budgets
+- Use caching strategically
+- Optimize critical path first
+- Monitor Core Web Vitals
+- Use CDN for static assets