ENGINEERING HANDBOOK

Manual de cómo desarrollar software — no un conjunto de prompts sueltos. Cada dominio (01_Frontend, 02_Backend, ...) tiene sus propios documentos de estándares, escritos para que una IA (o yo) tome las mismas decisiones que tomaría un ingeniero senior consistente, en cualquier proyecto nuevo.

Antes de leer cualquier dominio, leer 00_HANDBOOK_FORMAT.md — define las convenciones que todos los documentos siguen: reglas REQUIRED/RECOMMENDED, capa agnóstica + implementación de referencia, y la jerarquía de especialización (dominio → patrón → vertical).

Estado por dominio

#	Dominio	Estado	Documentos
00	Fundamentos	✅ Completo	HISTORIA_INGENIERIA_SOFTWARE.md — Historia de la Ingeniería de Software (1945–2026) · HISTORIA_INTERNET.md — Historia de Internet (1962–2026)
01	Frontend	✅ Nivel 1 completo	FRONTEND_ENGINEERING_STANDARD.md (17 secciones)
	↳ Nivel 2	✅	FRONTEND_UI_STYLE_CATALOG.md, FRONTEND_LANDING_PATTERNS.md, FRONTEND_UI_PATTERNS.md, FRONTEND_NAVIGATION_PATTERNS.md, FRONTEND_AUTH_PATTERNS.md, FRONTEND_DASHBOARD_PATTERNS.md, FRONTEND_CRUD_PATTERNS.md, FRONTEND_TABLE_PATTERNS.md, FRONTEND_STATES_PATTERNS.md, FRONTEND_NOTIFICATIONS_PATTERNS.md, FRONTEND_MODALS_PATTERNS.md, FRONTEND_SIDEBAR_PATTERNS.md, FRONTEND_HTML_STRUCTURE_STANDARD.md, FRONTEND_RESPONSIVE_STANDARD.md, FRONTEND_ACCESSIBILITY_STANDARD.md, FRONTEND_COLOR_CONTRAST_STANDARD.md, FRONTEND_ELEVATION_STANDARD.md, FRONTEND_FORMATTING_STANDARD.md, FRONTEND_ERROR_PAGES_STANDARD.md, FRONTEND_ANALYTICS_CHARTS_STANDARD.md, FRONTEND_MICROCOPY_STANDARD.md, FRONTEND_ICON_SYSTEM_STANDARD.md, FRONTEND_MOTION_STANDARD.md
	↳ Nivel 2 (nuevos)	✅	FRONTEND_FORMS_PATTERNS.md, FRONTEND_FORM_CONTROLS_STANDARD.md, FRONTEND_OVERLAY_DISPLAY_STANDARD.md, FRONTEND_REACT_STANDARD.md, FRONTEND_TYPESCRIPT_STANDARD.md, FRONTEND_HTML_ELEMENTS_REFERENCE.md, FRONTEND_SEO_STANDARD.md, FRONTEND_PERFORMANCE_STANDARD.md, FRONTEND_PWA_I18N_STANDARD.md, FRONTEND_OFFLINE_STANDARD.md
	↳ Pendientes	⬜	FRONTEND_REAL_WORLD_ANALYSIS (análisis de design systems públicos — quedó sin generar por corte de presupuesto), Search & Filters, Settings, Profile, Checkout, Pricing, Wizards, Chat Interfaces, Calendar
02	Backend	✅ Nivel 1 completo	BACKEND_ENGINEERING_STANDARD.md (17 secciones, fundado en el código real de E:\workers-template)
03	API	✅ Nivel 1 completo	API_ENGINEERING_STANDARD.md (contrato hacia afuera; hereda del Backend sin repetir)
04	Database	✅ Nivel 1 + Recetas	DATABASE_ENGINEERING_STANDARD.md, DATABASE_COMMON_QUERIES.md, RLS_POLICIES_LIBRARY.md, DATABASE_MIGRATION_RECIPES.md, DATABASE_PERFORMANCE.md
05	Security	✅ Nivel 1 + 2	SECURITY_ENGINEERING_STANDARD.md, THREAT_MODEL.md (8 amenazas reales + hardening priorizado), INCIDENT_RESPONSE.md (runbook primera hora)
06	Testing (QA automatizado)	✅ Completo	Departamento QA: README, 01_QA_STRATEGY, 02_TESTING_PIPELINE, 03_CI_CD, 04_RELEASE_PROCESS, 05_BUG_LIFECYCLE, 06_TEST_CHECKLIST, 07_AUTOMATION_GUIDE, 08_QUALITY_STANDARDS, 09_METRICS, 10_PLAYBOOK + Agents/ (8 roles, mapeo 18→8)
07	DevOps	✅ Nivel 1 completo	GITHUB_STANDARD.md (Git, cuenta, PATs, Actions, secret scanning), DEPLOY_AND_FAILURES_STANDARD.md (deploy, rollback + librería de fallos B1-B7)
08	Cloud	✅ Nivel 1 completo	CLOUDFLARE_PLATFORM_STANDARD.md (matriz de almacenamiento, límites, KV/R2/Queues/DO, WAF, costos — números verificados 2026-07-20)
09	Architecture	✅ Fase 1 completada	ARCHITECTURE_DECISION_LOG.md (ADRs), DIAGRAMAS_C4.md, PATRONES_ARQUITECTONICOS.md
10	Code Quality	✅ Fase 2 completada	CODE_REVIEW_STANDARD.md, CODE_SMELLS_CATALOG.md, REFACTORING_RECIPES.md, METRICAS_CALIDAD.md, STATIC_ANALYSIS_RULES.md
11	Debugging / Troubleshooting	✅ Fase 2 completada	ERROR_INDEX.md, DEBUGGING_TOOLKIT.md, PERFORMANCE_DEBUGGING.md, Playbooks de incidentes
12	Documentation	✅ Fase 1 completada	DOCUMENTATION_STANDARD.md, TEMPLATE_ADR.md, TEMPLATE_README.md
13	AI Rules	✅ Completo	AI_WORKFLOW.md (protocolo: clasificar tarea → leer estándar → verificar → implementar; jerarquía de conflicto; anti-comportamientos), AI_PROMPTS_LIBRARY.md (11 prompts reutilizables)
14	DX (Developer Experience)	✅ Completo	DX_STANDARD.md (bootstrap, scripts npm idénticos, CLAUDE.md por proyecto), PROJECT_BOOTSTRAP_CHECKLIST.md
15	Knowledge System	✅ Completo	KNOWLEDGE_SYSTEM_STANDARD.md (frontmatter, RAG-ready, Obsidian), RESEARCH_PROCESS.md, ENGINEERING_INTELLIGENCE.md · índice: tools/build-index.mjs → INDEX.json

Nota de arquitectura pendiente de decisión: Engineering-OS/ (47 docs) y los dominios numerados 01–15 se solapan en varios temas (seguridad, frontend, git). Hay que decidir cuál es canónico — recomendación: los dominios numerados como fuente de verdad, Engineering-OS/ como capa de índice/visión. Sin resolver, hay riesgo de dos fuentes de verdad divergentes.

Frontmatter pendiente: los documentos aún no llevan el frontmatter YAML del Knowledge System (el retrofit quedó sin correr por corte de presupuesto). node tools/build-index.mjs ya genera INDEX.json y lo recogerá en cuanto se añada.

Stack de referencia (contexto para todos los documentos)

• Frontend: React 19 + Vite + Tailwind + Framer Motion, TypeScript obligatorio
• Backend: Cloudflare Workers (multi-worker), template en E:/workers-template
• DB/Auth: Supabase
• Storage: R2 (Cloudinary en migración fuera)
• Email: Resend
• Automatización: n8n (VPS Contabo) + Baileys
• IA: OpenRouter → GPT-4o-mini
• Deploy: Cloudflare Pages + Workers + VPS Contabo