jettypod 3.0.1

package/docs/core-jettypod-methodology/deprecated/jettypod-comprehensive-standards.md

@@ -0,0 +1,1222 @@
+# Vibe Coding Project Standardization Checklist
+
+## The Complete Guide to What AI Assistants Need to Know
+
+### 🎯 Why This Matters
+
+Every time you start a new conversation with Claude, you risk:
+
+- Inconsistent naming conventions (userId vs user_id vs userID)
+- Different state management approaches (useState vs Context vs Redux)
+- Conflicting architectural patterns (where does business logic live?)
+- Reimplemented utilities (date formatting, validation, etc.)
+- Schema drift (different field names for same concept)
+
+This checklist ensures every AI conversation follows YOUR standards, not defaults.
+
+### 📊 Priority Levels
+
+- **🔴 CORE** - Decide these immediately (affects every file/feature)
+- **🟡 SECONDARY** - Decide when you encounter them (situational but common)
+- **🟢 ADVANCED** - Decide when scaling (optimization and enterprise concerns)
+
+---
+
+# 🔴 CORE STANDARDS
+
+*Decide these before writing any code - they affect every file*
+
+## Project Structure & Organization
+
+### Directory Structure
+
+```jsx
+{
+  "structure": "feature-based", // or "layer-based" or "domain-based"
+  "example": {
+    "/features": "Feature modules with all related code",
+    "/shared": "Shared components and utilities",
+    "/core": "Core business logic and infrastructure"
+  },
+  "rules": [
+    "Features contain their own components, hooks, utils",
+    "Shared must be used by 2+ features",
+    "Core is for auth, db, config only"
+  ]
+}
+
+```
+
+### File Naming Conventions
+
+```jsx
+{
+  "components": "PascalCase.tsx",      // UserProfile.tsx
+  "utilities": "camelCase.ts",         // formatDate.ts
+  "hooks": "useCamelCase.ts",         // useAuth.ts
+  "constants": "SCREAMING_SNAKE.ts",   // API_ENDPOINTS.ts
+  "types": "PascalCase.types.ts",      // User.types.ts
+  "tests": "same-as-source.test.ts",   // UserProfile.test.tsx
+  "styles": "same-as-component.css",   // UserProfile.module.css
+}
+
+```
+
+## Data & Schema Standards
+
+### Database Schema Conventions
+
+```jsx
+{
+  "naming": {
+    "tables": "snake_case_plural",      // users, order_items
+    "columns": "snake_case",             // created_at, user_id
+    "indexes": "idx_table_columns",      // idx_users_email
+    "foreign_keys": "fk_table_column",   // fk_orders_user_id
+  },
+  "required_columns": [
+    "id: UUID primary key",
+    "created_at: timestamp with timezone",
+    "updated_at: timestamp with timezone"
+  ],
+  "soft_deletes": true,  // Use deleted_at instead of DELETE
+  "json_columns": "Use JSONB for PostgreSQL, JSON for MySQL"
+}
+
+```
+
+### API Response Format
+
+```jsx
+// STANDARDIZE: What every API response looks like
+{
+  "success_response": {
+    "success": true,
+    "data": "{{actual data}}",
+    "meta": {
+      "timestamp": "ISO 8601",
+      "version": "1.0"
+    }
+  },
+  "error_response": {
+    "success": false,
+    "error": {
+      "code": "VALIDATION_ERROR",
+      "message": "Human readable message",
+      "details": {}, // Optional detailed errors
+      "trace_id": "uuid-for-debugging"
+    }
+  },
+  "pagination": {
+    "data": [],
+    "pagination": {
+      "page": 1,
+      "limit": 20,
+      "total": 100,
+      "hasMore": true
+    }
+  }
+}
+
+```
+
+### Frontend Data Structures
+
+```jsx
+{
+  "id_format": "string (UUID)",        // Never use number IDs
+  "date_format": "ISO 8601 strings",   // Not Date objects
+  "money_format": "cents as integer",  // 1999 = $19.99
+  "phone_format": "E.164",             // +14155552671
+  "empty_states": {
+    "lists": "[] not null",
+    "objects": "null not {}",
+    "strings": "'' not null",
+    "numbers": "0 not null"
+  }
+}
+
+```
+
+## React & State Patterns
+
+### Component Structure
+
+```jsx
+// STANDARDIZE: How every component is organized
+{
+  "order": [
+    "imports",
+    "type definitions",
+    "constants",
+    "component definition",
+    "export"
+  ],
+  "example": `
+    // 1. Imports
+    import React, { useState } from 'react';
+
+    // 2. Types
+    interface Props {
+      userId: string;
+      onSave: (data: FormData) => void;
+    }
+
+    // 3. Constants
+    const MAX_LENGTH = 100;
+
+    // 4. Component
+    export function UserForm({ userId, onSave }: Props) {
+      const [name, setName] = useState('');
+
+      return <form>...</form>;
+    }
+
+    // 5. NO default export (named exports only)
+  `
+}
+
+```
+
+### State Management Rules
+
+```jsx
+{
+  "local_state": "useState for component-specific UI state",
+  "shared_state": "Context for feature-wide state",
+  "global_state": "Zustand for app-wide state",
+  "server_state": "TanStack Query for API data",
+
+  "rules": [
+    "Never put server data in useState",
+    "Form state stays local unless explicitly shared",
+    "Use optimistic updates for better UX",
+    "Derive state when possible, don't sync"
+  ],
+
+  "naming": {
+    "boolean": "is/has/should prefix",  // isLoading, hasError
+    "handlers": "handle prefix",        // handleSubmit
+    "callbacks": "on prefix"           // onSave, onClick
+  }
+}
+
+```
+
+### Custom Hooks Patterns
+
+```jsx
+{
+  "structure": {
+    "data_hooks": "useUser, useProducts - return {data, error, isLoading}",
+    "action_hooks": "useSaveUser - return {mutate, isLoading, error}",
+    "ui_hooks": "useModal - return {isOpen, open, close}",
+    "compound_hooks": "useUserProfile - combines multiple hooks"
+  },
+  "rules": [
+    "Always return consistent shape",
+    "Handle loading and error states",
+    "Clean up subscriptions/timers",
+    "Memoize expensive computations"
+  ]
+}
+
+```
+
+## Styling & UI Conventions
+
+### CSS/Styling Approach
+
+```jsx
+{
+  "method": "Tailwind CSS", // or "CSS Modules" or "styled-components"
+  "rules": [
+    "Mobile-first responsive design",
+    "Dark mode support from start",
+    "Use design tokens for consistency"
+  ],
+  "spacing": "4px base unit (1=4px, 2=8px, 4=16px)",
+  "breakpoints": {
+    "sm": "640px",
+    "md": "768px",
+    "lg": "1024px",
+    "xl": "1280px"
+  },
+  "color_naming": {
+    "semantic": "primary, secondary, danger, success",
+    "not": "blue, red, green"
+  }
+}
+
+```
+
+### Component Library Decisions
+
+```jsx
+{
+  "base": "Radix UI primitives",
+  "styling": "Tailwind CSS",
+  "icons": "Lucide React",
+  "forms": "React Hook Form + Zod",
+  "tables": "TanStack Table",
+  "dates": "date-fns",
+  "animations": "Framer Motion",
+
+  "custom_components": [
+    "Button - always use our custom version",
+    "Input - with built-in validation",
+    "Modal - consistent across app",
+    "Toast - for notifications"
+  ]
+}
+
+```
+
+## Technical Decisions
+
+### API & Backend Patterns
+
+```jsx
+{
+  "api_style": "REST", // or "GraphQL" or "tRPC"
+  "endpoints": {
+    "format": "/api/v1/resources",
+    "verbs": {
+      "GET /users": "list",
+      "GET /users/:id": "retrieve",
+      "POST /users": "create",
+      "PUT /users/:id": "full update",
+      "PATCH /users/:id": "partial update",
+      "DELETE /users/:id": "soft delete"
+    }
+  },
+  "authentication": "JWT in httpOnly cookie",
+  "authorization": "RBAC with permissions",
+  "rate_limiting": "100 requests per minute per IP",
+  "cors": "Explicit whitelist only"
+}
+
+```
+
+### Error Handling Patterns
+
+```jsx
+{
+  "frontend": {
+    "network_errors": "Show toast, log to Sentry",
+    "validation_errors": "Inline field errors",
+    "auth_errors": "Redirect to login",
+    "unexpected_errors": "Error boundary fallback"
+  },
+  "backend": {
+    "validation": "Return 400 with field errors",
+    "auth": "Return 401/403 with clear message",
+    "not_found": "Return 404 with resource type",
+    "server_error": "Return 500 with trace ID, log details"
+  },
+  "logging": {
+    "errors": "Always include user ID, trace ID, stack",
+    "warnings": "Include context and suggested action",
+    "info": "Structured JSON for parsing"
+  }
+}
+
+```
+
+## Testing Strategy
+
+```jsx
+{
+  "unit_tests": {
+    "what": "Pure functions, utilities, hooks",
+    "tool": "Vitest",
+    "coverage": "> 80%"
+  },
+  "integration_tests": {
+    "what": "API endpoints, database operations",
+    "tool": "Supertest + Vitest",
+    "coverage": "All critical paths"
+  },
+  "e2e_tests": {
+    "what": "User journeys, critical flows",
+    "tool": "Playwright",
+    "coverage": "Happy path + major error cases"
+  },
+  "naming": "describe('Component', () => { it('should behavior', () => {}) })",
+  "mocking": "Mock external services, not internal modules"
+}
+
+```
+
+## Code Style & Formatting
+
+### TypeScript Configuration
+
+```jsx
+{
+  "strict": true,
+  "rules": {
+    "no_any": "Error - use unknown",
+    "explicit_return_types": "Required for exported functions",
+    "interface_vs_type": "Interface for objects, type for unions",
+    "enums": "Avoid - use const objects"
+  },
+  "naming": {
+    "types": "PascalCase",
+    "interfaces": "PascalCase, no I prefix",
+    "generics": "T, K, V or descriptive names"
+  }
+}
+
+```
+
+### Code Formatting
+
+```jsx
+{
+  "formatter": "Prettier",
+  "settings": {
+    "printWidth": 80,
+    "tabWidth": 2,
+    "semi": true,
+    "singleQuote": true,
+    "trailingComma": "es5",
+    "bracketSpacing": true,
+    "arrowParens": "always"
+  },
+  "imports": "Auto-sort with organize imports",
+  "file_size": "Max 300 lines, split if larger"
+}
+
+```
+
+## Git & Version Control
+
+### Branch Strategy
+
+```jsx
+{
+  "main": "Production-ready code only",
+  "develop": "Integration branch",
+  "feature/*": "New features",
+  "fix/*": "Bug fixes",
+  "hotfix/*": "Production emergency fixes",
+  "release/*": "Release preparation"
+}
+
+```
+
+### Commit Message Format
+
+```jsx
+{
+  "format": "[type]([scope]): [subject]",
+  "types": [
+    "feat: New feature",
+    "fix: Bug fix",
+    "docs: Documentation",
+    "style: Formatting",
+    "refactor: Code restructure",
+    "test: Testing",
+    "chore: Maintenance"
+  ],
+  "example": "feat(auth): add password reset flow"
+}
+
+```
+
+## Environment Variables
+
+```jsx
+{
+  "naming": "SCREAMING_SNAKE_CASE",
+  "prefixes": {
+    "public": "NEXT_PUBLIC_* or VITE_*",
+    "private": "No prefix",
+    "feature_flags": "FEATURE_*"
+  },
+  "required": [
+    "NODE_ENV",
+    "DATABASE_URL",
+    "API_URL",
+    "JWT_SECRET"
+  ]
+}
+
+```
+
+## Code Comments
+
+```jsx
+{
+  "when": "Why, not what - code shows what",
+  "format": {
+    "todo": "// TODO: [owner] - description",
+    "fixme": "// FIXME: [issue-link] - description",
+    "hack": "// HACK: explanation of why",
+    "note": "// NOTE: important context"
+  },
+  "jsdoc": "For all exported functions and complex logic"
+}
+
+```
+
+---
+
+# 🟡 SECONDARY STANDARDS
+
+*Decide these as you encounter them*
+
+## Import Order & Aliases
+
+```jsx
+// STANDARDIZE: Import order and path aliases
+{
+  "order": [
+    "// External imports",
+    "import React from 'react'",
+    "import { useState } from 'react'",
+    "// Internal imports",
+    "import { Button } from '@/components'",
+    "// Relative imports",
+    "import { helper } from './utils'",
+    "// Types",
+    "import type { User } from '@/types'"
+  ],
+  "aliases": {
+    "@/": "src/",
+    "@components": "src/components",
+    "@utils": "src/utils",
+    "@hooks": "src/hooks"
+  }
+}
+
+```
+
+## Data Validation & Transformation
+
+```jsx
+{
+  "validation": {
+    "email": "RFC 5322 compliant",
+    "phone": "E.164 format with country code",
+    "url": "Include protocol (https://)",
+    "money": "Always validate cents/smallest unit",
+    "dates": "ISO 8601 or Unix timestamp"
+  },
+  "sanitization": {
+    "html": "DOMPurify for user content",
+    "sql": "Parameterized queries only",
+    "filenames": "Alphanumeric + dash/underscore only",
+    "json": "Strip undefined, convert NaN to null"
+  },
+  "transformations": {
+    "case": "Transform at API boundary, not in components",
+    "dates": "UTC in database, local in UI",
+    "money": "Cents in API/DB, formatted in UI",
+    "enums": "String literals, not numbers"
+  }
+}
+
+```
+
+## Form Handling Patterns
+
+```jsx
+{
+  "library": "react-hook-form", // or "formik" or "native"
+  "validation": "zod", // or "yup" or "native"
+  "patterns": {
+    "controlled": "Only for custom components",
+    "uncontrolled": "Default for inputs",
+    "submission": "Disable button while submitting",
+    "errors": "Show on blur or submit, not onChange"
+  },
+  "field_standards": {
+    "required_marker": "* after label",
+    "error_display": "Below field in red",
+    "helper_text": "Below field in gray",
+    "character_count": "Show when > 70% of max"
+  },
+  "complex_forms": {
+    "multi_step": "Keep state in parent",
+    "conditional": "Hide via conditional rendering",
+    "arrays": "Use fieldArray pattern",
+    "autosave": "Debounce 2 seconds"
+  }
+}
+
+```
+
+## Accessibility Standards
+
+```jsx
+{
+  "minimum_requirements": [
+    "Keyboard navigable",
+    "Screen reader labels",
+    "WCAG AA color contrast",
+    "Focus indicators visible"
+  ],
+  "patterns": {
+    "images": "Alt text required",
+    "forms": "Labels associated with inputs",
+    "buttons": "Descriptive text, not just icons",
+    "modals": "Focus trap and escape key",
+    "errors": "Announced to screen readers"
+  },
+  "testing": {
+    "automated": "axe-core in tests",
+    "manual": "Keyboard navigation check",
+    "screen_reader": "Test with NVDA/JAWS"
+  }
+}
+
+```
+
+## Animation & Interaction Patterns
+
+```jsx
+{
+  "library": "Framer Motion", // or "CSS transitions" or "React Spring"
+  "principles": {
+    "duration": "200-300ms for micro, 400-600ms for macro",
+    "easing": "ease-out for enter, ease-in for exit",
+    "reduced_motion": "Respect prefers-reduced-motion"
+  },
+  "patterns": {
+    "hover": "Subtle scale or color change",
+    "click": "Scale down briefly",
+    "loading": "Skeleton screens over spinners",
+    "transitions": "Crossfade between states",
+    "scroll": "Parallax sparingly"
+  }
+}
+
+```
+
+## Performance Standards
+
+```jsx
+{
+  "targets": {
+    "page_load": "< 3 seconds on 3G",
+    "api_response": "< 200ms p50, < 500ms p95",
+    "bundle_size": "< 200KB gzipped initial",
+    "lighthouse": "> 90 score"
+  },
+  "techniques": {
+    "images": "WebP with fallback, lazy loading",
+    "code_splitting": "Route-based + heavy libraries",
+    "caching": "SWR strategy, 5 minute stale time",
+    "pagination": "20 items default, virtual scroll > 100"
+  }
+}
+
+```
+
+## File Upload & Storage Patterns
+
+```jsx
+{
+  "client_validation": {
+    "max_size": "10MB default, 100MB for video",
+    "allowed_types": "Whitelist, not blacklist",
+    "image_dimensions": "Max 4000x4000",
+    "filename": "Sanitize and add UUID"
+  },
+  "upload_pattern": {
+    "small_files": "Base64 in JSON (< 100KB)",
+    "large_files": "Multipart form data",
+    "huge_files": "Direct to S3 presigned URL"
+  },
+  "storage": {
+    "temporary": "Server temp folder, auto-cleanup",
+    "permanent": "S3/Cloudinary/CDN",
+    "database": "Store URL only, never blob"
+  },
+  "processing": {
+    "images": "Resize, compress, generate thumbnails",
+    "documents": "Virus scan, extract metadata",
+    "validation": "Server-side type verification"
+  }
+}
+
+```
+
+## Real-time & WebSocket Patterns
+
+```jsx
+{
+  "library": "Socket.io", // or "native WebSocket" or "Pusher"
+  "patterns": {
+    "connection": "Authenticate on connect",
+    "reconnection": "Exponential backoff",
+    "heartbeat": "Ping every 30 seconds",
+    "rooms": "One per resource (e.g., document-123)"
+  },
+  "events": {
+    "naming": "verb:noun (update:user, delete:comment)",
+    "payload": "Same format as REST API",
+    "acknowledgment": "Required for critical actions",
+    "ordering": "Include sequence numbers"
+  },
+  "fallbacks": {
+    "offline": "Queue actions, sync on reconnect",
+    "polling": "Fall back to polling if WS fails",
+    "conflict": "Last-write-wins or CRDT"
+  }
+}
+
+```
+
+## Test Data Management
+
+```jsx
+{
+  "fixtures": {
+    "location": "/tests/fixtures",
+    "format": "JSON or factory functions",
+    "naming": "valid-user.json, invalid-email.json"
+  },
+  "factories": {
+    "library": "Faker.js or custom",
+    "pattern": "createUser({ overrides })",
+    "defaults": "Valid data by default"
+  },
+  "database": {
+    "strategy": "Isolated test database",
+    "seeding": "Before each test suite",
+    "cleanup": "Transaction rollback or truncate"
+  },
+  "external_services": {
+    "strategy": "Mock by default",
+    "integration": "Separate test suite",
+    "contracts": "Record and replay"
+  }
+}
+
+```
+
+## Code Review Standards
+
+```jsx
+{
+  "pr_requirements": {
+    "description": "What and why",
+    "testing": "How it was tested",
+    "screenshots": "For UI changes",
+    "breaking": "Call out breaking changes"
+  },
+  "review_checklist": [
+    "Logic correctness",
+    "Edge cases handled",
+    "Performance impact",
+    "Security implications",
+    "Test coverage",
+    "Documentation updated"
+  ],
+  "approval": {
+    "required": "1 for normal, 2 for critical",
+    "self_merge": "After 24h if no response",
+    "emergency": "Merge, review after"
+  }
+}
+
+```
+
+## Deployment Strategy
+
+```jsx
+{
+  "environments": {
+    "local": "Development machine",
+    "dev": "Latest commits, unstable",
+    "staging": "Production mirror",
+    "production": "Live users"
+  },
+  "pipeline": {
+    "trigger": "Push to main",
+    "steps": [
+      "Lint and format check",
+      "Run tests",
+      "Build application",
+      "Deploy to staging",
+      "Smoke tests",
+      "Deploy to production"
+    ]
+  },
+  "rollback": {
+    "strategy": "Keep 3 previous versions",
+    "trigger": "Error rate > 5%",
+    "procedure": "Revert to last known good"
+  }
+}
+
+```
+
+## Documentation Requirements
+
+```jsx
+{
+  "readme": {
+    "sections": [
+      "What it does (one paragraph)",
+      "Quick start (< 5 steps)",
+      "Tech stack",
+      "Project structure",
+      "Environment setup",
+      "Common tasks",
+      "Troubleshooting"
+    ]
+  },
+  "api_docs": {
+    "tool": "OpenAPI/Swagger",
+    "location": "/docs/api",
+    "examples": "Required for each endpoint",
+    "versioning": "Document breaking changes"
+  },
+  "component_docs": {
+    "tool": "Storybook", // or "Docusaurus"
+    "requirements": [
+      "Props documentation",
+      "Usage examples",
+      "Edge cases",
+      "Accessibility notes"
+    ]
+  },
+  "architecture": {
+    "decisions": "ADRs in /docs/adr",
+    "diagrams": "Mermaid or draw.io",
+    "update": "With significant changes"
+  }
+}
+
+```
+
+---
+
+# 🟢 ADVANCED STANDARDS
+
+*Decide these when scaling or optimizing*
+
+## Internationalization (i18n)
+
+```jsx
+{
+  "enabled": false, // Set true when needed
+  "library": "react-i18next",
+  "structure": {
+    "files": "/locales/[lang]/[namespace].json",
+    "defaultLanguage": "en",
+    "fallback": "en"
+  },
+  "patterns": {
+    "keys": "dot.notation.lowercase",
+    "plurals": "Use ICU format",
+    "dates": "Use date-fns locales",
+    "numbers": "Intl.NumberFormat"
+  },
+  "content": {
+    "static": "In locale files",
+    "dynamic": "From CMS/database",
+    "user_generated": "Never translate automatically"
+  }
+}
+
+```
+
+## Performance Optimization Patterns
+
+```jsx
+{
+  "memoization": {
+    "when": "Expensive calculations or stable references",
+    "React.memo": "For pure components with complex props",
+    "useMemo": "For expensive computations",
+    "useCallback": "For stable function references"
+  },
+  "code_splitting": {
+    "routes": "Always lazy load routes",
+    "modals": "Lazy load modal content",
+    "heavy_libs": "Dynamic import for charts, editors",
+    "threshold": "Split bundles > 50KB"
+  },
+  "virtualization": {
+    "lists": "> 100 items use virtual scroll",
+    "tables": "> 50 rows use virtual table",
+    "library": "TanStack Virtual"
+  },
+  "optimistic_updates": {
+    "when": "User actions with network delay",
+    "pattern": "Update UI, rollback on error",
+    "indication": "Subtle visual cue while pending"
+  }
+}
+
+```
+
+## Caching Strategies
+
+```jsx
+{
+  "client_side": {
+    "react_query": {
+      "staleTime": "5 minutes default",
+      "cacheTime": "10 minutes default",
+      "refetchOnWindowFocus": false,
+      "refetchOnReconnect": true
+    },
+    "localStorage": {
+      "user_preferences": "No expiry",
+      "draft_content": "7 days expiry",
+      "cache": "1 day expiry"
+    }
+  },
+  "api_cache": {
+    "CDN": "Static assets, long cache",
+    "browser": "Cache-Control headers",
+    "redis": {
+      "sessions": "15 minute TTL",
+      "api_responses": "5 minute TTL",
+      "computed": "1 hour TTL"
+    }
+  },
+  "invalidation": {
+    "pattern": "Tag-based (user:123, post:456)",
+    "strategy": "Invalidate on mutation",
+    "cascade": "Parent invalidates children"
+  }
+}
+
+```
+
+## Security Patterns
+
+```jsx
+{
+  "authentication": {
+    "passwords": "Argon2id hashing",
+    "sessions": "HttpOnly secure cookies",
+    "tokens": "Short-lived (15min) + refresh",
+    "2fa": "TOTP, backup codes"
+  },
+  "authorization": {
+    "pattern": "RBAC with permissions",
+    "checking": "Every endpoint, every query",
+    "caching": "5 minute permission cache",
+    "audit": "Log all permission checks"
+  },
+  "data_protection": {
+    "pii": "Encrypt at rest",
+    "exports": "Audit log + rate limit",
+    "deletion": "Soft delete → hard delete after 30d",
+    "backups": "Encrypted, separate location"
+  },
+  "api_security": {
+    "rate_limiting": "By IP and user",
+    "cors": "Whitelist origins explicitly",
+    "csrf": "Double submit cookie",
+    "headers": "Helmet.js defaults"
+  }
+}
+
+```
+
+## Business Logic Patterns
+
+```jsx
+{
+  "architecture": {
+    "pattern": "Service layer", // or "Domain driven" or "Simple MVC"
+    "location": "/services or /domain or /lib",
+    "principle": "Thin controllers, rich services"
+  },
+  "service_patterns": {
+    "naming": "UserService, OrderService",
+    "methods": "Verbs: createUser, calculateTotal",
+    "dependencies": "Inject, don't import directly",
+    "testing": "Unit test services, integration test controllers"
+  },
+  "domain_modeling": {
+    "entities": "Classes with methods",
+    "value_objects": "Immutable data classes",
+    "aggregates": "Transactional boundaries",
+    "repositories": "Data access abstraction"
+  },
+  "complex_operations": {
+    "transactions": "Service method boundaries",
+    "workflows": "State machines (XState)",
+    "events": "Event emitter or message queue",
+    "scheduling": "Cron jobs or queue workers"
+  }
+}
+
+```
+
+## Monitoring & Observability
+
+```jsx
+{
+  "error_tracking": {
+    "service": "Sentry", // or "Rollbar" or "Bugsnag"
+    "environments": ["staging", "production"],
+    "user_context": "ID only, no PII",
+    "source_maps": "Upload on deploy"
+  },
+  "performance": {
+    "service": "DataDog", // or "New Relic" or "Custom"
+    "metrics": [
+      "Response time (p50, p95, p99)",
+      "Error rate",
+      "Database query time",
+      "External API latency"
+    ]
+  },
+  "logging": {
+    "levels": "ERROR, WARN, INFO, DEBUG",
+    "structure": "JSON for parsing",
+    "retention": "7 days debug, 30 days info, 90 days error",
+    "pii": "Never log passwords, tokens, or PII"
+  },
+  "alerts": {
+    "error_rate": "> 1% for 5 minutes",
+    "response_time": "p95 > 1 second",
+    "disk_space": "< 10% free",
+    "custom": "Business metrics thresholds"
+  }
+}
+
+```
+
+## Feature Flags & Experimentation
+
+```jsx
+{
+  "service": "LaunchDarkly", // or "Unleash" or "custom"
+  "patterns": {
+    "naming": "kebab-case descriptive",
+    "types": {
+      "release": "Enable new features",
+      "experiment": "A/B testing",
+      "ops": "Circuit breakers",
+      "permission": "User access control"
+    }
+  },
+  "lifecycle": {
+    "creation": "Off by default",
+    "rollout": "Percentage or user groups",
+    "cleanup": "Remove after 30 days stable"
+  },
+  "implementation": {
+    "frontend": "Hook: useFeatureFlag",
+    "backend": "Middleware check",
+    "fallback": "Default to safe behavior"
+  }
+}
+
+```
+
+## Analytics & Tracking
+
+```jsx
+{
+  "service": "Google Analytics", // or "Mixpanel" or "Posthog"
+  "implementation": {
+    "page_views": "Automatic",
+    "events": "Explicit tracking",
+    "user_properties": "ID only, no PII",
+    "consent": "Required before loading"
+  },
+  "event_naming": {
+    "pattern": "object_action",
+    "examples": [
+      "button_clicked",
+      "form_submitted",
+      "page_viewed",
+      "error_occurred"
+    ]
+  },
+  "data_layer": {
+    "structure": {
+      "event": "event_name",
+      "properties": {},
+      "user": { id: "uuid" },
+      "session": { id: "uuid" }
+    }
+  },
+  "privacy": {
+    "pii": "Never track personal info",
+    "retention": "90 days default",
+    "anonymization": "IP anonymization on",
+    "opt_out": "Respect DNT header"
+  }
+}
+
+```
+
+## Email & Notifications
+
+```jsx
+{
+  "email": {
+    "service": "SendGrid", // or "AWS SES" or "Postmark"
+    "templates": {
+      "location": "/templates/emails",
+      "engine": "Handlebars or React Email",
+      "testing": "Preview in Storybook"
+    },
+    "patterns": {
+      "transactional": "Immediate send",
+      "batch": "Queue and send hourly",
+      "marketing": "Requires consent"
+    },
+    "requirements": [
+      "Unsubscribe link",
+      "Plain text version",
+      "Mobile responsive",
+      "SPF/DKIM configured"
+    ]
+  },
+  "push_notifications": {
+    "service": "OneSignal", // or "Firebase"
+    "opt_in": "Explicit user consent",
+    "frequency": "Max 3 per day",
+    "quiet_hours": "10pm - 8am user timezone"
+  },
+  "in_app": {
+    "pattern": "Toast for actions, banner for system",
+    "duration": "5 seconds auto-dismiss",
+    "priority": "Error > Warning > Success > Info"
+  }
+}
+
+```
+
+---
+
+## 🎯 USAGE WITH AI ASSISTANTS
+
+### Project Context File Template
+
+```markdown
+# Project: [Name]
+# Mode: [Speed/Discovery/Production]
+# Last Updated: [Date]
+
+## Quick Context
+- Purpose: [One sentence what this does]
+- Users: [Who uses this]
+- Stage: [Prototype/MVP/Production]
+
+## Technical Stack
+- Frontend: [React/Next.js/etc]
+- Backend: [Node/Python/etc]
+- Database: [PostgreSQL/MongoDB/etc]
+- Auth: [Auth0/Clerk/Custom]
+- Hosting: [Vercel/AWS/etc]
+
+## Key Decisions Made
+1. [Decision]: [Reasoning]
+2. Using localStorage because single user (Speed Mode)
+3. No TypeScript yet, will add in Production Mode
+
+## Current Conventions
+[Paste relevant sections from this checklist]
+
+## Known Issues/Tech Debt
+- [ ] No error handling in API calls
+- [ ] Components over 500 lines need splitting
+- [ ] No tests yet
+
+## Do NOT:
+- Change naming conventions without asking
+- Add new state management libraries
+- Refactor working code unless requested
+- Suggest optimizations in Speed Mode
+
+```
+
+### Prompt Prefix Template
+
+```markdown
+@Claude - Continue with project standards:
+- File naming: [PascalCase components]
+- State: [useState only, no Redux]
+- API format: [REST, see response format]
+- Current file: [filename]
+- Mode: [Speed/Production]
+
+Task: [Your actual request]
+
+```
+
+---
+
+## ✅ STANDARDIZATION CHECKLIST
+
+### 🔴 CORE: Minimum Viable Standards (Speed Mode)
+
+**Must decide immediately - affects every file:**
+
+- [ ]  File naming convention
+- [ ]  Component structure
+- [ ]  State management approach
+- [ ]  API response format
+- [ ]  Error handling pattern
+- [ ]  Database/data naming conventions
+- [ ]  Git branch and commit strategy
+
+### 🟡 SECONDARY: Common Decisions (Discovery/Speed Mode)
+
+**Decide when you encounter them:**
+
+- [ ]  Import order and aliases
+- [ ]  Form handling approach
+- [ ]  Data validation patterns
+- [ ]  Performance thresholds
+- [ ]  Accessibility minimums
+- [ ]  Animation patterns
+- [ ]  File upload approach
+- [ ]  Real-time/WebSocket patterns
+- [ ]  Test data management
+- [ ]  Code review process
+- [ ]  Deployment pipeline
+- [ ]  Documentation requirements
+
+### 🟢 ADVANCED: Scale Decisions (Production Mode)
+
+**Decide when optimizing/scaling:**
+
+- [ ]  Internationalization
+- [ ]  Caching strategies
+- [ ]  Security implementations
+- [ ]  Business logic patterns
+- [ ]  Performance optimization tactics
+- [ ]  Monitoring and alerting
+- [ ]  Feature flags
+- [ ]  Analytics implementation
+- [ ]  Email/notification systems
+- [ ]  Advanced testing strategies
+- [ ]  Microservices boundaries
+- [ ]  CI/CD sophistication
+
+### Signs You Need More Standardization
+
+- Every AI conversation suggests different approaches
+- You spend time debating conventions instead of building
+- Files look like they were written by different people
+- Refactoring requires changing patterns everywhere
+- New team members/AI assistants are confused
+
+---
+
+## 🔄 KEEPING STANDARDS ALIVE
+
+1. **Document as you decide** - Don't wait for perfect standards
+2. **Include in every prompt** - Reference your standards file
+3. **Update when you learn** - Standards should evolve
+4. **Be explicit about exceptions** - "Breaking convention because..."
+5. **Review periodically** - What's causing friction?
+
+Remember: The goal isn't perfect standards, it's consistent standards that prevent re-litigation of solved problems.