@thierrynakoa/fire-flow 12.2.2 → 13.0.1

package/skills-library/SKILLS_LIBRARY_INDEX.md

@@ -0,0 +1,532 @@
+# 📚 Skills Library Index
+
+## Overview
+
+This Skills Library contains **76 hard-earned skills and lessons-learned** from challenging Claude agent development experiences. These are documented solutions to problems that agents struggled with—the things that took time, research, and problem-solving to figure out.
+
+**Location:** `skills-library/`
+
+**For Agents:** When you encounter a problem or need to implement a feature, always check this library first. Someone has likely solved this before and documented it here.
+
+---
+
+## 🎓 Beginner Skills (Start Here)
+
+Practical, self-contained skills for students and new developers. Read one, apply it, move on.
+
+### Tier 1 — Basics
+
+Every project needs these. Learn these first.
+
+| Skill | What You Learn |
+|-------|---------------|
+| [env-variables](basics/env-variables.md) | Keep secrets out of your code using `.env` files |
+| [git-commit-conventions](basics/git-commit-conventions.md) | Write clear, readable commit messages |
+| [readme-template](basics/readme-template.md) | Document your project so others can use it |
+| [error-handling-basics](basics/error-handling-basics.md) | Catch errors gracefully instead of crashing |
+| [api-rest-basics](basics/api-rest-basics.md) | Build and call REST APIs the right way |
+
+### Tier 2 — Common Tasks
+
+Things you'll build in almost every real project.
+
+| Skill | What You Learn |
+|-------|---------------|
+| [auth-jwt-basics](common-tasks/auth-jwt-basics.md) | User login with JWT tokens and protected routes |
+| [database-schema-design](common-tasks/database-schema-design.md) | Design tables that don't break as you grow |
+| [async-await-patterns](common-tasks/async-await-patterns.md) | Write async code without callback hell |
+| [form-validation](common-tasks/form-validation.md) | Validate user input on both client and server |
+| [file-upload-basics](common-tasks/file-upload-basics.md) | Handle file uploads safely |
+
+### Tier 3 — Quality & Safety
+
+The difference between hobbyist code and professional code.
+
+| Skill | What You Learn |
+|-------|---------------|
+| [testing-basics](quality-safety/testing-basics.md) | Write tests that actually catch bugs |
+| [security-checklist](quality-safety/security-checklist.md) | The most common security mistakes and how to avoid them |
+| [debugging-steps](quality-safety/debugging-steps.md) | Systematic debugging — stop guessing, start finding |
+| [deployment-checklist](quality-safety/deployment-checklist.md) | What to verify before going live |
+
+---
+
+## 📂 Skills by Domain
+
+### 1. **Methodology** (28 files)
+Core processes and completion frameworks learned through experience.
+
+| Skill | Purpose | Size |
+|-------|---------|------|
+| `CRITICAL_PATTERNS_DOCUMENTATION_COMPLETE.md` | Critical coding patterns and standards | 20KB |
+| `DELIVERABLES_RECORD.md` | Delivery framework and requirements | - |
+| `SESSION_COMPLETION_RECORD.md` | How to complete sessions professionally | - |
+| `MASTER_SESSION_COMPLETION.md` | Complete session methodology | 25KB |
+| `MASTER_COMPLETION_RECORD.md` | Completion summary standards | 12KB |
+| `SESSION_RECORD.md` | Session documentation template | - |
+| `MERN_QUICK_REFERENCE.md` | Quick reference for MERN projects | - |
+| `MULTI_PERSPECTIVE_CODE_REVIEW.md` | 14-persona parallel code review pattern | 15KB |
+| `EVIDENCE_BASED_VALIDATION.md` | Verification before completion claims | 10KB |
+| `SABBATH_REST_PATTERN.md` | AI context persistence (like human sleep) | 12KB |
+| `CONFIDENCE_ANNOTATION_PATTERN.md` | Dual-process uncertainty engine with confidence decay | 8KB |
+| `HEARTBEAT_PROTOCOL.md` | Real-time agent health monitoring with mood tracking | 10KB |
+| `EVOLUTIONARY_SKILL_SYNTHESIS.md` | Auto-generating skills from execution patterns | 12KB |
+| `DIFFICULTY_AWARE_AGENT_ROUTING.md` | Smart model selection (Haiku/Sonnet/Opus) by task difficulty | 10KB |
+| `SELF_QUESTIONING_TASK_GENERATION.md` | Curiosity-driven post-implementation quality assurance | 10KB |
+| `BIBLICAL_WARFARE_PATTERNS.md` | Strategic framework: 7 biblical warfare patterns mapped to agent architecture | 15KB |
+| `HIBERNATION_SYSTEM.md` | 3-layer sleep architecture: heartbeat, dream agent, growth | 12KB |
+| `PORTAL_MEMORY_ARCHITECTURE.md` | Pinpoint anchor memory model with revisitation ladder | 10KB |
+| `AGENT_SELF_DISCOVERY_KENOSIS.md` | Agent identity discovery pattern (Psalm 40:7 / Philippians 2:7) | 12KB |
+| `CLEANSING_CYCLE.md` | Biological waste elimination: 12 organs, YHVH breathing, pee/poop/shower modes | 15KB |
+| `YHVH_BREATHING_PATTERN.md` | Divine 26-tick rhythm (Yod-Hey-Vav-Hey) for all agent timing cycles | 10KB |
+| `ORGAN_AGENT_MAPPING.md` | 12 human organs mapped to AI agent subsystems with cooperation patterns | 12KB |
+| `GLOMERULUS_DECISION_GATE.md` | Reusable 3-layer filter (size→relevance→recency) for any filtering decision | 10KB |
+| `REVIEW_FIX_LOOP.md` | Automated subagent review-fix loop with circuit breaker escapes | 8KB |
+| `OBSERVATION_MASKING.md` | Strip raw output from agent messages, keep action summaries (50% token savings) | 5KB |
+| `RESEARCH_BACKED_WORKFLOW_UPGRADE.md` | 7-step pipeline: parallel research → scoring → waves → implementation | 6KB |
+| `VOTING_VERDICT_ARBITRATION.md` | Independent voting for multi-reviewer conflicts (+13.2% reasoning) | 6KB |
+| `HIERARCHICAL_REVIEW_MARS.md` | Author self-check before expensive external review (~50% verification savings) | 5KB |
+
+**When to use:** Before starting or completing any work session, or when reviewing code.
+
+#### New in v4.0.0: Research-Backed Agent Intelligence (2026-02-17)
+| Skill | Description | Research Source |
+|-------|-------------|----------------|
+| `CONFIDENCE_ANNOTATION_PATTERN.md` | Dual-process uncertainty with System1/System2 confidence propagation and decay | Agentic UQ (arxiv:2601.15703) |
+| `HEARTBEAT_PROTOCOL.md` | Real-time agent health monitoring with mood tracking (novel - no paper) | Novel contribution |
+| `EVOLUTIONARY_SKILL_SYNTHESIS.md` | Auto-generate skills from execution patterns with lineage tracking | CASCADE + GEA |
+| `DIFFICULTY_AWARE_AGENT_ROUTING.md` | Route tasks to Haiku/Sonnet/Opus based on complexity (64% cost reduction) | DAAO (arxiv:2509.11079) |
+| `SELF_QUESTIONING_TASK_GENERATION.md` | Generate challenge questions and test stubs after implementation | AgentEvolver (arxiv:2511.10395) |
+| `BIBLICAL_WARFARE_PATTERNS.md` | 7 warfare patterns (Daniel 10x, Jericho Protocol, Gideon's 300, Nehemiah's Wall, David's Stones, Elijah's Fire, Full Armor) + 3 hermeneutical principles (Law of First Mention, Distributed Redundancy, Expositional Consistency) | Biblical theology + user's original framework |
+| `HIBERNATION_SYSTEM.md` | 3-layer sleep architecture (heartbeat tick + dream agent + dashboard) with Windows scheduled tasks | Novel contribution (Thierry's "spirit awake while body sleeps") |
+| `PORTAL_MEMORY_ARCHITECTURE.md` | Sparse encoding (John 21:25), revisitation ladder (1x→3x→5x), portal anchor reconstruction | Novel contribution (Thierry's pinpoint memory insight) + neuroscience |
+| `AGENT_SELF_DISCOVERY_KENOSIS.md` | Agent discovers its identity through documentation, The Scroll Test validation | Novel contribution (Philippians 2:7 + Psalm 40:7) |
+| `CLEANSING_CYCLE.md` | 12-organ biological waste elimination, YHVH 26-tick breathing, Glomerulus 3-layer filter, pee/poop/shower modes | Novel contribution (Thierry's "compaction is constipation" + YHVH breathing + organ research) |
+| `YHVH_BREATHING_PATTERN.md` | Divine 26-tick rhythm (10+5+6+5), waste-responsive acceleration, cross-system timing | Novel contribution (Thierry's Tetragrammaton breathing discovery) |
+| `ORGAN_AGENT_MAPPING.md` | 12 organs → agent subsystems, 4 cross-system cooperation patterns, priority triage | Novel contribution (Thierry's organ research + biological architecture) |
+| `GLOMERULUS_DECISION_GATE.md` | 3-layer non-destructive filter: size gate, relevance gate, recency gate | Novel contribution (kidney glomerulus → reusable decision pattern) |
+
+**Research sources:** 15+ arxiv papers (2025-2026) + Anthropic 2026 Agentic Coding Trends Report.
+See full research index: `~/.claude/projects/C--Windows-System32/memory/research-papers-2026.md`
+
+#### New in v1.4.0: Power Loop (Ralph-Style Iteration)
+| Command | Description | Key Feature |
+|---------|-------------|-------------|
+| `/fire-loop` | Self-iterating loop until completion | Sabbath Rest context rot warnings |
+| `/fire-loop-stop` | Cancel active loop with progress save | Full state preservation |
+| `/fire-loop-resume` | Resume from Sabbath Rest snapshot | Fresh context restoration |
+
+**Sabbath Rest Warning:** Automatically detects context rot and saves state for clean resume.
+
+#### New in v1.3.0: Dominion Flow Command Parity
+| Command | Description | Dominion Equivalent |
+|---------|-------------|----------------|
+| `/fire-debug` | Systematic debugging with persistent state | `/fire-debug` |
+| `/fire-complete-milestone` | Archive milestone and prepare for next | `/fire-complete-milestone` |
+| `/fire-map-codebase` | Parallel codebase analysis (7 documents) | `/fire-map-codebase` |
+| `/fire-new-milestone` | Start new milestone cycle | `/fire-new-milestone` |
+| `/fire-todos` | Capture and manage tasks | `/fire-todos`, `/fire-todos` |
+
+#### New in v1.2.0: Orientation & Discussion Commands
+| Command | Description | Use Case |
+|---------|-------------|----------|
+| `/fire-0-orient` | Orient on existing project | New agent, no handoff |
+| `/fire-1a-discuss` | Gather context before planning | Before `/fire-2-plan` |
+
+#### New in v1.1.0: Quality Enhancement Patterns
+| Skill | Description | Command |
+|-------|-------------|---------|
+| `MULTI_PERSPECTIVE_CODE_REVIEW.md` | Use 14 specialized reviewer personas in parallel | `/fire-7-review` |
+| `EVIDENCE_BASED_VALIDATION.md` | Require proof before claiming completion | `/fire-double-check` |
+| `SABBATH_REST_PATTERN.md` | AI context persistence - survive context resets | All commands |
+
+---
+
+### 2. **Video & Media** (7 files)
+Everything about video playback, integration, and media handling that took time to figure out.
+
+| Skill | Purpose | Problem Solved |
+|-------|---------|-----------------|
+| `fix-reactplayer-youtube-playback.md` | React Player YouTube integration fixes | Playback issues |
+| `fix-youtube-bookmark-timestamps.md` | Bookmark timestamp handling | Time sync problems |
+| `importing-youtube-videos.md` | YouTube import workflow | Data migration |
+| `importing-youtube-videos-mern.md` | MERN-specific YouTube import | MERN integration |
+| `video-player-integration-guide.md` | General video player setup | Player configuration |
+| `bookmark-chapters-system.md` | Chapter/bookmark system implementation | Feature complexity |
+| `COMPLETE_VIDEO_IMPLEMENTATION.md` | Full video feature implementation | Complete solution |
+
+**When to use:** Implementing any video features or handling media playback.
+
+---
+
+### 3. **E-Commerce** (8 files)
+Complete e-commerce implementation patterns and solutions.
+
+| Skill | Purpose | Coverage |
+|-------|---------|----------|
+| `ECOMMERCE_WORKFLOW_GUIDE.md` | Complete e-commerce workflow | ⭐⭐⭐ Full |
+| `ECOMMERCE_IMPLEMENTATION_GUIDE.md` | Step-by-step implementation | Complete guide |
+| `ECOMMERCE_API_REFERENCE.md` | API endpoints and schemas | All endpoints |
+| `ECOMMERCE_TESTING_CHECKLIST.md` | Testing procedures | Complete checklist |
+| `ECOMMERCE_COMPLETION_RECORD.md` | Completion standards | Final verification |
+| `ECOMMERCE_QUICK_REFERENCE.md` | Quick lookup reference | Fast reference |
+| `ADMIN_PRODUCTS_GUIDE.md` | Admin product management | Admin features |
+| `cart-item-count-indicator.md` | Cart counter implementation | UI component |
+
+**When to use:** Building any e-commerce or shopping cart features.
+
+---
+
+### 4. **Integrations** (15 files)
+Third-party API integrations that required deep research and testing.
+
+#### Zoom Integration (13 files)
+| Skill | Purpose | Difficulty |
+|-------|---------|-----------|
+| `ZOOM_API_INTEGRATION_GUIDE.md` | Complete Zoom integration | ⭐⭐⭐ Hard |
+| `ZOOM_WEBHOOK_INTEGRATION_AUTO_PUBLISH.md` | Auto-publish recordings to lessons via webhooks | ⭐⭐⭐⭐ Hard |
+| `ZOOM_API_TESTING_GUIDE.md` | Comprehensive testing procedures | Testing |
+| `ZOOM_MEETING_LIFECYCLE.md` | Meeting state management | State complexity |
+| `ZOOM_OAUTH2_SETUP.md` | OAuth2 authentication setup | Auth flow |
+| `ZOOM_REQUIRED_SCOPES.md` | Scope definitions and requirements | Permissions |
+| `ZOOM_INTEGRATION_RECORD.md` | Integration overview | Summary |
+| `ZOOM_CREDENTIAL_FIX.md` | Credential-related fixes | Common issues |
+| `ZOOM_CREDENTIALS_VERIFICATION.md` | Credential verification process | Verification |
+| `ZOOM_SCOPES_CLEANUP.md` | Scope cleanup and management | Maintenance |
+| `ZOOM_TESTING_CHECKLIST.md` | Testing checklist | Validation |
+| `ZOOM_NEXT_STEPS.md` | Post-integration steps | Continuation |
+| `zoom-meetings-crud-imported.md` | CRUD operations imported | Database ops |
+
+#### Other Integrations (5 files)
+| Skill | Purpose |
+|-------|---------|
+| `stripe-payment-integration-complete.md` | Stripe payment processing | ⭐⭐⭐ Hard |
+| `STRIPE_SESSION_PACKAGE_CHECKOUT.md` | Stripe Checkout for session package purchases | ⭐⭐⭐ Medium |
+| `zoom-meetings-import.md` | Meeting import procedures | - |
+| `rss-podcast-integration.md` | RSS podcast feeds (Castos/generic) | ⭐⭐ Medium |
+| `WORDPRESS_LMS_DATA_RECOVERY.md` | Extract courses/audio from LMS exports | ⭐⭐⭐ Medium |
+
+**When to use:** Integrating with external APIs like Zoom, Stripe, or podcast RSS feeds.
+
+---
+
+### 5. **Deployment & Security** (5 files)
+Production deployment and security best practices.
+
+| Skill | Purpose | Scope | Size |
+|-------|---------|-------|------|
+| `react-production-deployment-desktop-guide.md` | React production deployment | React + Desktop | ⭐⭐⭐ 50KB |
+| `self-hosted-supabase-coolify-guide.md` | Self-hosted Supabase with Coolify | Infrastructure | ⭐⭐⭐ 44KB |
+| `unique-features-ai-strategy-plaid-security.md` | Plaid security & AI strategy | Security + APIs | ⭐⭐⭐ 44KB |
+| `PRODUCTION_DEPLOYMENT_GUIDE.md` | General production deployment | All stacks | - |
+| `VERCEL_GITHUB_DEPLOYMENT_GUIDE.md` | Vercel + GitHub deployment with VS Code | CI/CD + VS Code | ⭐⭐⭐ 25KB |
+
+**When to use:** Deploying to production or implementing security features.
+
+---
+
+### 6. **Document Processing** (4 files)
+File handling, document generation, and secure downloads.
+
+| Skill | Purpose | Use Case |
+|-------|---------|----------|
+| `document-ai-landingai-integration.md` | Document AI/LandingAI integration | Document analysis |
+| `pdf-forms-integration.md` | PDF form handling and generation | PDF manipulation |
+| `express-secure-file-downloads.md` | Secure file download implementation | File serving |
+| `express-secure-file-downloads-mern.md` | MERN-specific secure downloads | MERN pattern |
+
+**When to use:** Handling files, PDFs, or secure document operations.
+
+---
+
+### 7. **Patterns & Standards** (5 files)
+Coding patterns, standards, and best practices learned through experience.
+
+| Skill | Purpose | Applies To |
+|-------|---------|-----------|
+| `CRITICAL_CODING_PATTERNS.md` | Critical patterns to use/avoid | All code |
+| `ORDERED_DETECTOR_PIPELINE_GRACEFUL_FALLBACK.md` | Priority-ordered detectors with per-detector try/catch for missing tables | Incremental rollouts, gamification, milestones |
+| `irs-tax-calculations-official-language.md` | Tax calculation standards | Financial code |
+| `react-i18next-setup.md` | Internationalization setup | i18n |
+| `thesys-c1-generative-ui-integration.md` | Generative UI integration | Modern UI |
+
+**When to use:** Writing any new code or setting up projects.
+
+---
+
+### 8. **Database Solutions** (3 files)
+PostgreSQL patterns, migrations, and seed scripts that solved hard problems.
+
+| Skill | Purpose | Difficulty |
+|-------|---------|-----------|
+| `POSTGRES_SQL_TEMPLATE_BINDING_ERROR.md` | Fix postgres.js template binding errors | ⭐⭐⭐ Hard |
+| `ES_MODULE_SEED_SCRIPT_PATTERN.md` | ES Module seed scripts for PostgreSQL | ⭐⭐ Medium |
+| `CONDITIONAL_SQL_MIGRATION_PATTERN.md` | Idempotent migrations (IF NOT EXISTS) | ⭐⭐ Medium |
+
+**When to use:** Building seed scripts, writing migrations, or debugging SQL binding errors.
+
+---
+
+### 9. **Advanced Features** (6 files)
+Complex system architecture patterns and extensibility solutions.
+
+| Skill | Purpose | Complexity |
+|-------|---------|-----------|
+| `PLUGIN_SYSTEM_ARCHITECTURE.md` | WordPress-style plugin/hook system for Node.js | ⭐⭐⭐ Hard |
+| `PUCK_PAGE_TEMPLATES_SYSTEM.md` | Reusable page templates for Puck visual builder | ⭐⭐⭐ Hard |
+| `wordpress-style-theme-components.md` | Complete UI override system (Header, Footer, etc.) | ⭐⭐⭐ Hard |
+| `SEO_SETTINGS_MANAGEMENT.md` | Dynamic SEO, Open Graph, Twitter Card admin settings | ⭐⭐ Medium |
+| `HOME_PAGE_BUILDER_GUIDE.md` | Puck setup and component configuration | ⭐⭐ Medium |
+| `GAMIFICATION_SYSTEM.md` | Points, badges, and achievements system | ⭐⭐ Medium |
+
+**Contents:**
+- HookSystem implementation (actions & filters)
+- PluginManager lifecycle management
+- Page Templates (create, use, save as template)
+- QuestionnaireButton Puck component
+- Converting React pages to Puck-editable format
+- Database schemas for templates and plugins
+- Admin UI integration
+- **SEO Settings:** Dynamic meta tags, OG/Twitter cards, social share preview
+- **Theme Components:** Dynamic component overrides, Puck integration, CSS injection, HMR gotchas
+
+**When to use:** Building extensibility systems, visual page builders, plugin systems, theme component overrides, or SEO management.
+
+---
+
+### 10. **Form Solutions** (1 file)
+Dynamic form building, questionnaires, and survey implementations.
+
+| Skill | Purpose | Technology |
+|-------|---------|-----------|
+| `SURVEYJS_QUESTIONNAIRE_SYSTEM.md` | Complete SurveyJS integration for forms/surveys | SurveyJS + React |
+
+**Contents:**
+- SurveyJS JSON schema format
+- QuestionnaireRenderer component
+- Database schema for questionnaires & responses
+- Course integration patterns
+- Admin management UI
+- Question types reference
+
+**When to use:** Building dynamic forms, surveys, questionnaires, or course assessments.
+
+---
+
+### 11. **Theology & Biblical Studies** (1 file)
+Biblical pattern analysis, hermeneutics, and theological LLM systems.
+
+| Skill | Purpose | Difficulty |
+|-------|---------|-----------|
+| `BIBLICAL_PATTERN_ANALYSIS_LLM.md` | Building AI for biblical pattern detection | ⭐⭐⭐⭐⭐ Expert |
+
+**Contents:**
+- Law of First Mention pattern detection
+- Equidistant Letter Sequences (ELS) in Hebrew
+- Typological parallels (Abraham→Father, Isaac→Son, etc.)
+- Hidden acrostics (YHVH in Esther)
+- Torah YHVH patterns at intervals
+- Hebrew poetic structures (parallelism, chiasm)
+- Intertextual quotation mapping (Revelation→OT)
+- Heptadic/jubilee cycle structures
+- Original language processing requirements
+- LLM architecture for theological understanding
+
+**When to use:** Building biblical analysis tools, theological LLMs, or Scripture pattern detection systems.
+
+---
+
+## 🎯 How Agents Should Use This Library
+
+### 1. **Before Starting a Task**
+```
+Check: Is there a related skill in the library?
+Read: The relevant skill file(s)
+Learn: The pattern and gotchas documented
+Apply: The proven approach in your implementation
+```
+
+### 2. **When You Get Stuck**
+```
+Search: This library for your problem domain
+Read: The complete skill file
+Follow: The documented solution
+Reference: Code examples from the skill
+```
+
+### 3. **When Implementing Features**
+```
+Domain: E-commerce? → Read `/ecommerce/*`
+Domain: Video? → Read `/video-media/*`
+Domain: Integration? → Read `/integrations/*`
+Uncertain? → Check `/patterns-standards/*`
+```
+
+### 4. **After Discovering New Patterns**
+```
+Document: Your solution in a skill file
+Add: To appropriate domain directory
+Commit: With explanation of what was difficult
+Share: With the team
+```
+
+---
+
+## 📊 Skills Statistics
+
+```
+Total Skills:      75 files
+Domains:          11 categories
+Total Content:    ~420KB of documented solutions
+Difficulty:       ⭐⭐⭐ Hard problems solved
+Coverage:         E-commerce, Video, Integrations, Deployment, Security,
+                  Patterns, Database Solutions, Advanced Features, Form Solutions, SEO,
+                  Theology & Biblical Studies
+
+Most Complex:
+- react-production-deployment-desktop-guide.md (50KB)
+- unique-features-ai-strategy-plaid-security.md (44KB)
+- self-hosted-supabase-coolify-guide.md (44KB)
+- VERCEL_GITHUB_DEPLOYMENT_GUIDE.md (25KB, VS Code + Git workflows)
+- ZOOM_API_INTEGRATION_GUIDE.md (Complete API coverage)
+- ECOMMERCE_WORKFLOW_GUIDE.md (Complete system)
+- PLUGIN_SYSTEM_ARCHITECTURE.md (WordPress-style hooks)
+- SURVEYJS_QUESTIONNAIRE_SYSTEM.md (Dynamic forms)
+- PUCK_PAGE_TEMPLATES_SYSTEM.md (Visual page builder templates)
+- SEO_SETTINGS_MANAGEMENT.md (Complete SEO admin system)
+```
+
+---
+
+## ⚠️ Critical Skills (Must Know)
+
+**Every agent should be familiar with:**
+1. `CRITICAL_CODING_PATTERNS.md` - Fundamental standards
+2. `CRITICAL_PATTERNS_DOCUMENTATION_COMPLETE.md` - What's expected
+3. `SESSION_COMPLETION_RECORD.md` - How to hand off work
+4. `MASTER_SESSION_COMPLETION.md` - Professional standards
+
+---
+
+## 🔍 Finding Skills by Problem Type
+
+### Payment Processing
+- `stripe-payment-integration-complete.md`
+- `integrations/STRIPE_SESSION_PACKAGE_CHECKOUT.md` (Session packages with Checkout Sessions)
+
+### Video Features
+- `fix-reactplayer-youtube-playback.md`
+- `COMPLETE_VIDEO_IMPLEMENTATION.md`
+- `video-player-integration-guide.md`
+
+### Podcast/Audio Integration
+- `rss-podcast-integration.md` (Castos, RSS feeds, membership access)
+
+### Meeting/Calendar Integration
+- `ZOOM_API_INTEGRATION_GUIDE.md` (complete)
+- `ZOOM_MEETING_LIFECYCLE.md`
+
+### Shopping Cart/E-Commerce
+- `ECOMMERCE_WORKFLOW_GUIDE.md`
+- `ECOMMERCE_IMPLEMENTATION_GUIDE.md`
+- `cart-item-count-indicator.md`
+
+### Production Deployment
+- `react-production-deployment-desktop-guide.md`
+- `PRODUCTION_DEPLOYMENT_GUIDE.md`
+- `VERCEL_GITHUB_DEPLOYMENT_GUIDE.md` (Vercel + GitHub CI/CD with VS Code)
+
+### Security
+- `unique-features-ai-strategy-plaid-security.md`
+- `ZOOM_OAUTH2_SETUP.md`
+
+### Coding Standards
+- `CRITICAL_CODING_PATTERNS.md`
+- `CRITICAL_PATTERNS_DOCUMENTATION_COMPLETE.md`
+
+### Database / PostgreSQL / Migrations
+- `database-solutions/POSTGRES_SQL_TEMPLATE_BINDING_ERROR.md` (SQL binding errors)
+- `database-solutions/ES_MODULE_SEED_SCRIPT_PATTERN.md` (Seed scripts)
+- `database-solutions/CONDITIONAL_SQL_MIGRATION_PATTERN.md` (Idempotent migrations)
+
+### WordPress / LMS Migration
+- `integrations/WORDPRESS_LMS_DATA_RECOVERY.md` (Course data extraction)
+
+### SEO / Meta Tags / Social Sharing
+- `advanced-features/SEO_SETTINGS_MANAGEMENT.md` (Complete SEO admin system)
+- Covers: Meta title/description, Open Graph, Twitter Cards, favicon, verification codes, social share preview
+
+### Plugin/Extension Systems
+- `advanced-features/PLUGIN_SYSTEM_ARCHITECTURE.md` (WordPress-style hooks)
+- Covers: Actions, Filters, Plugin lifecycle, Admin UI
+
+### Theme Component Override System
+- `wordpress-style-theme-components.md` (Complete UI transformation)
+- Covers: ThemeManager, componentOverrides Map, dynamic imports via import.meta.glob
+- Covers: Puck editor integration, CSS injection, HMR gotchas, production builds
+- Covers: Error boundaries for theme components, dark mode integration
+
+### Visual Page Builder / Templates
+- `advanced-features/PUCK_PAGE_TEMPLATES_SYSTEM.md` (Complete templates system)
+- `advanced-features/HOME_PAGE_BUILDER_GUIDE.md` (Puck setup)
+- Covers: Page templates, Template Library UI, Save as Template, QuestionnaireButton component, Converting React pages to Puck
+
+### Forms/Questionnaires/Surveys
+- `form-solutions/SURVEYJS_QUESTIONNAIRE_SYSTEM.md` (SurveyJS integration)
+- Covers: Dynamic forms, Course questionnaires, Response storage
+
+### Biblical / Theological Analysis
+- `theology/BIBLICAL_PATTERN_ANALYSIS_LLM.md` (Complete biblical LLM architecture)
+- Covers: Law of First Mention, ELS patterns, typology, acrostics, Hebrew poetic structures
+- Covers: Intertextual quotation mapping, heptadic structures, original language processing
+- Covers: LLM architecture for theological understanding (compute + understand + connect)
+
+---
+
+## 💡 These Skills Exist Because
+
+These aren't generic documentation. Each skill exists because:
+
+✅ **It was difficult** - Took time and research to figure out
+✅ **It caused confusion** - Multiple agents struggled with it
+✅ **It has edge cases** - Simple solutions don't work
+✅ **It requires integration** - Multiple systems work together
+✅ **It has security implications** - Careful implementation needed
+✅ **It's easy to do wrong** - Common mistakes documented
+✅ **It's best-practice** - Professional standards matter
+
+---
+
+## 📌 Navigation
+
+**Main Documentation:**
+- [README.md](../README.md) - Plugin overview
+- [SKILL.md](../skills/warrior-workflow/SKILL.md) - Warrior methodology
+- [AGENT_PREREQUISITES_AND_ONBOARDING.md](../skills/warrior-workflow/AGENT_PREREQUISITES_AND_ONBOARDING.md) - Agent prep
+
+**Training Materials:**
+- [WARRIOR_WORKFLOW_GUIDE.md](../skills/warrior-workflow/WARRIOR_WORKFLOW_GUIDE.md) - Complete guide
+- [CRITICAL_CODING_PATTERNS.md](../skills/warrior-workflow/CRITICAL_CODING_PATTERNS.md) - Must-know patterns
+
+**This File:**
+- [SKILLS_LIBRARY_INDEX.md](./SKILLS_LIBRARY_INDEX.md) - You are here
+
+---
+
+## 🚀 Using the Skills Library
+
+The Skills Library is your **training ground for Claude agents**. It represents:
+
+- 3+ years of development experience
+- Solutions to 48+ unique problems
+- Best practices and patterns
+- Security and production standards
+- Professional quality indicators
+
+**Before you implement anything, check here first.**
+
+---
+
+**Last Updated:** February 17, 2026
+**Total Skills:** 75
+**Status:** ✅ Complete and organized for agent training

package/skills-library/_general/api-patterns/api-field-name-mismatch.md

@@ -0,0 +1,107 @@
+---
+name: api-field-name-mismatch
+category: api-patterns
+version: 1.0.0
+contributed: 2026-03-12
+contributor: claude-mission-control
+last_updated: 2026-03-12
+contributors:
+  - claude-mission-control
+tags: [api, debugging, fetch, express, silent-errors, 400]
+difficulty: easy
+usage_count: 0
+success_rate: 100
+---
+
+# API Field Name Mismatch — Silent 400 Errors from Request Body Mismatches
+
+## Problem
+
+Frontend sends `{ id: "action-1" }` but backend expects `{ actionId: "action-1" }`. The backend returns a 400 error, but the frontend's catch block shows a generic "Failed" status with no output. The user sees the button flash "Done" or "Failed" but never sees any command output. The root cause — a field name mismatch — is invisible without checking the Network tab.
+
+**Symptoms:**
+- Quick action / API call appears to work (no crash) but returns no data
+- Status briefly shows "error" then resets to idle
+- Network tab shows 400 response: `{ error: "actionId is required" }`
+- Output area is empty (because the response was an error, not command results)
+- No TypeScript error because both frontend and backend compile independently
+
+## Solution Pattern
+
+**Diagnosis:** Open browser DevTools → Network tab → find the POST request → check the request body vs what the server destructures.
+
+**Prevention:** Share types between frontend and backend. If that's not possible, document the API contract clearly and test with curl first.
+
+## Code Example
+
+```typescript
+// Frontend (BROKEN — sends "id" instead of "actionId")
+const res = await fetch('/api/commands/execute', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ id: action.id })  // WRONG field name
+})
+
+// Backend (expects "actionId")
+app.post('/api/commands/execute', (req, res) => {
+  const { actionId } = req.body  // undefined!
+  if (!actionId) return res.status(400).json({ error: 'actionId is required' })
+})
+
+// Frontend (FIXED)
+body: JSON.stringify({ actionId: action.id })  // Matches server expectation
+```
+
+## Implementation Steps
+
+1. Check Network tab for non-200 responses on the endpoint
+2. Compare request body field names with server-side destructuring
+3. Fix the mismatch
+4. Add output display so errors are visible to the user (not silently swallowed)
+
+## When to Use
+
+- API calls that return no data but don't crash
+- "It works but nothing happens" debugging
+- Any time frontend and backend are developed independently
+- After refactoring either frontend or backend API contracts
+
+## When NOT to Use
+
+- When the error is clearly shown in the UI
+- Auth failures (different root cause)
+- CORS issues (different symptoms)
+
+## Common Mistakes
+
+- Assuming "no crash = working" — a 400 response is still a successful HTTP fetch
+- Not checking `res.ok` before parsing the response as success
+- Catching errors but not displaying the error message to the user
+- Not validating request bodies with schemas (Zod, Joi) that would surface the mismatch immediately
+
+## Prevention Patterns
+
+```typescript
+// 1. Shared types (best)
+// shared/api-types.ts
+interface ExecuteCommandRequest { actionId: string; args?: string }
+
+// 2. Zod validation on server (second best)
+const schema = z.object({ actionId: z.string() })
+const parsed = schema.safeParse(req.body)
+if (!parsed.success) return res.status(400).json({ error: parsed.error.message })
+
+// 3. Always check res.ok on frontend
+if (!res.ok) {
+  const error = await res.json()
+  throw new Error(error.error || `HTTP ${res.status}`)
+}
+```
+
+## Related Skills
+
+- streaming-command-timeout - Another silent failure pattern with process execution
+
+## References
+
+- Contributed from: claude-mission-control QuickActions panel (actions appeared to work but never showed output)