Umbrella

Aroma (Recipe site) aroma

Standards that bind this project:

• Shared GitHub Actions budget — docs/STANDARD-ACTIONS-BUDGET.md · applies via GitHub · configuration integrated on 2026-09-25 · first unblocked GitHub execution and measured savings pending · no conforms_to declared

  source_control:
    provider: GitHub
    capability: repository / CI-CD
    conforms_to: [STANDARD-ACTIONS-BUDGET, STANDARD-DOC-ENTRYPOINT, STANDARD-PUBLISHED-OUTPUT]

• Standard — one canonical entrypoint, never two copies — docs/STANDARD-DOC-ENTRYPOINT.md · applies via GitHub · active since 2026-08-21 · no conforms_to declared
• Standard — every published output needs a verified consumer — docs/STANDARD-PUBLISHED-OUTPUT.md · applies via GitHub · active since 2026-08-21 · no conforms_to declared
• Standard — Twilio OTP / SMS anti-abuse — docs/STANDARD-TWILIO-OTP.md · applies via Twilio · active since 2026-08-10 · no conforms_to declared

  auth:
    provider: Twilio
    capability: phone verification (OTP)
    implemented_in: api/_lib/twilio.js
    conforms_to: STANDARD-TWILIO-OTP

Already solved elsewhere in the portfolio:

• repository / CI-CD — already built in glossa → .github/workflows/glossa-publish.yml. Read it before writing your own.
• credential management — already built in thesis → phd-agents/docs/RECOVERY-SECRETS.md. Read it before writing your own.
• design system — you have your own in docs/ARCHITECTURE.md, and there are 6 more in the portfolio: radius → docs/DECISIONS.md · thesis → pwa/WEBAPP-MEMORY.md · ademas-ai → inbox/index.html · glossa → src/styles/global.css · merit → web/src/app/globals.css · numora → 04-UI-Visual-Specification.md. Worth comparing before the next change to yours.
• mobile web UI — you have your own in src/index.css, and there are 3 more in the portfolio: ademas-ai → inbox/index.html · merit → web/src/components/ChildTabBar.tsx · numora → app/app/layout.tsx. Worth comparing before the next change to yours.

Lessons from other projects that touch what you use (245, grouped by what matched):

• Anthropic — 25 · shared across projects
  • 2026-07-07 — Mockup layer removed — radius docs/DECISIONS.md
  • El tracking de costos miente si no refleja precios promocionales y de lanzamiento — thesis LESSONS.md
  • Los topes de gasto declarados deben saltar ANTES que el tope del proveedor — thesis LESSONS.md
  • claude-opus-5 rechaza temperature con 400 — y los clientes viejos no lo saben — thesis LESSONS.md
  • La contabilidad idempotente no impide pagar dos peticiones idénticas — thesis LESSONS.md
  • Consultar los recibos antes de ampliar una revisión truncada — thesis LESSONS.md
  • Una respuesta mal formada puede costar aunque el resumen diga cero — thesis LESSONS.md
  • Un límite de revisiones puede dejar la última corrección sin comprobar — thesis LESSONS.md
  • Una ruta económica de curación no cambia los revisores de investigación — thesis LESSONS.md
  • Consultar hoy no significa tener el gasto de hoy — thesis LESSONS.md
  • Un comité necesita recuperar opiniones, no repetir la consulta completa — thesis LESSONS.md
  • Una revisión bilingüe aprobada puede esconder una ampliación normativa y un componente vacío — thesis LESSONS.md
  • Un límite de salida económico puede pagar razonamiento y no recibir ningún veredicto — thesis LESSONS.md
  • La síntesis del buscador puede contaminar una ficha aunque el extracto correcto esté guardado — thesis LESSONS.md
  • Un esquema válido para OpenAI puede impedir que arranque el revisor Anthropic — thesis LESSONS.md
  • 23-sep-2026 · Actualizar un modelo sin recomprar trabajos ni inventar equivalencias — thesis LESSONS.md
  • Los prompts no pueden citar los marcadores que otro componente emite — ademas-ai docs/LESSONS.md
  • Las reglas suaves de mitad de conversación son frágiles por demostración — ademas-ai docs/LESSONS.md
  • Dos resolvedores del mismo valor = el bug original con otra cara — ademas-ai docs/LESSONS.md
  • La auditoría adversarial con otro modelo paga — ademas-ai docs/LESSONS.md
  • El Usage/Cost Report de Anthropic devuelve BUCKETS con las filas adentro — iterar data.data directo suma $0 sin error — ademas-ai docs/LESSONS.md
  • El grep de un invariante debe cubrir TODAS las formas de invocar al proveedor — ademas-ai docs/LESSONS.md
  • Multi-proveedor de LLM: una sola puerta, usage normalizado, y precio techo desde el día uno — ademas-ai docs/LESSONS.md
  • 2026-08-21 — Un modelo prefiere el metadato al contenido, y eso rompe la atribución — glossa docs/09-Decisiones-Abiertas.md
  • 2026-08-15 — Sonnet 5 emits thinking blocks before text — numora LESSONS.md
• OpenAI — 18 · shared across projects
  • Un evaluador puede confundir preparación bibliográfica con resultados todavía por producir — thesis LESSONS.md
  • Esperar un lote no es un fallo semántico ni permiso para volver a pagarlo — thesis LESSONS.md
  • El título publicado también necesita una revisión de evidencia — thesis LESSONS.md
  • Un resultado de búsqueda pobre no vuelve ajeno un tema pertinente — thesis LESSONS.md
  • Una espera debe identificar la solicitud que sigue pendiente — thesis LESSONS.md
  • Conservar el cotejo documental después de resolver el faltante — thesis LESSONS.md
  • Un ensayo de modelos debe validar primero su propio contrato — thesis LESSONS.md
  • Las citas literales requieren distinguir tipografía de contenido inventado — thesis LESSONS.md
  • Dos revisores de acuerdo pueden aprobar una cita que perdió su negación — thesis LESSONS.md
  • El precio de un modelo no es el costo de obtener su resultado útil — thesis LESSONS.md
  • Un defecto del banco de pruebas se puede confundir con un fallo del modelo — thesis LESSONS.md
  • Una recomendación rechazada necesita una corrección distinta antes de otra revisión — thesis LESSONS.md
  • Un árbitro de frontera puede aceptar el error que detecta un modelo intermedio — thesis LESSONS.md
  • 2026-09-14 — Grok consistente también puede omitir un error; costos de capítulo y operación separados — thesis LESSONS.md
  • El artefacto revisado y el que se muestra deben tener la misma huella — thesis LESSONS.md
  • Si las preguntas están en un idioma y el corpus en otro, la ordenación no lo arregla — thesis LESSONS.md
  • El orden accidental de los pasajes puede volver a comprar la misma investigación — thesis LESSONS.md
  • Un rechazo que solo enumera aciertos no justifica comprar otra redacción — thesis LESSONS.md
• 1Password — 15 · shared across projects
  • 2026-06-27 — GitHub Actions as the job runner — radius docs/DECISIONS.md
  • Los campos nuevos de 1Password caen dentro de una sección — y op read por ruta corta no los ve — thesis LESSONS.md
  • Las credenciales innecesarias pueden agotar la cuota compartida de 1Password — thesis LESSONS.md
  • Un fallo del almacén de credenciales no debe agotar los intentos de investigación — thesis LESSONS.md
  • Una etiqueta de 1Password no identifica un campo de forma única — thesis LESSONS.md
  • El espejo documental necesita recuperación aunque no haya otra edición — thesis LESSONS.md
  • Una comprobación omitida no debe despertar toda la cadena — thesis LESSONS.md
  • Una cola vacía puede agotar consultas del gestor de secretos — thesis LESSONS.md
  • 1.1 load-secrets-action@v2 con export-env: true no propaga — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.2 Nombres de items con espacios — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.3 Campos duplicados → error "more than one X field" — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.4 Arquitectura de items del proyecto — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Una clave nueva no separa la cuota; hay que separar la cuenta — glossa LESSONS.md
  • El campo de 1Password no siempre se llama igual — glossa LESSONS.md
  • 2026-08-15 — op read rejects em-dashes in item titles — numora LESSONS.md
• Twilio — 12 · shared across projects
  • 2026-06-27 — Phone = account — radius docs/DECISIONS.md
  • tenanta2pregistrations es solo para ISV tenants — nunca para el operador — ademas-ai docs/LESSONS.md
  • HMAC validation — usar ambas URLs — ademas-ai docs/LESSONS.md
  • A2P 10DLC — URLs reales en el campaign — ademas-ai docs/LESSONS.md
  • Twilio Verify API bypasa A2P — ademas-ai docs/LESSONS.md
  • Precondiciones se calculan ANTES del insert propio (y excluyendo filas internas) — ademas-ai docs/LESSONS.md
  • Una guarda de identidad colapsa cuando dos roles se vuelven la misma persona — ademas-ai docs/LESSONS.md
  • Los avisos al operador se escriben para su destinatario, no para el log — ademas-ai docs/LESSONS.md
  • La compra-en-el-momento ya estaba escrita; el pool la tenía muerta — ademas-ai docs/LESSONS.md
  • sips: no es SRTP en Twilio <Dial><Sip>: es ;secure=true — ademas-ai docs/LESSONS.md
  • «Completed» no significa «atendido por el agente» — ademas-ai docs/LESSONS.md
  • Llamar de un asistente a otro es la prueba de punta a punta que no necesita humanos — ademas-ai docs/LESSONS.md
• GitHub — 10 · shared across projects
  • 2026-07-13 — Repo layout = engine at root — radius docs/DECISIONS.md
  • 19-sep-2026 · Memoria vigente breve y archivo íntegro — thesis LESSONS.md
  • Antes de tocar un archivo, revisar el otro clone por trabajo sin commitear — ademas-ai docs/LESSONS.md
  • Umbrella enruta por capacidad DECLARADA: lo que no declaras, no te llega — glossa LESSONS.md
  • Una regla que solo mira failure no ve un trabajo muerto por tiempo — glossa LESSONS.md
  • Un vigilante con falsas alarmas es un vigilante que se ignora — glossa LESSONS.md
  • Todo lo que se genera necesita un lector nombrado, y comprobado — glossa LESSONS.md
  • Las migraciones aplicadas y no commiteadas dejan un esquema irreconstruible — glossa LESSONS.md
  • 2026-08-21 — Una salida sin lector es peor que ninguna salida — glossa docs/09-Decisiones-Abiertas.md
  • 2026-08-15 — sharp/libvips CVEs via Next image optimizer — numora LESSONS.md
• Vercel — 6 · shared across projects
  • redirects en la configuración pierde contra la normalización de barra final — glossa LESSONS.md
  • 2026-08-15 — Fail-closed gate from commit one — numora LESSONS.md
  • 2026-08-15 — Repo root must never be publicly served — numora LESSONS.md
  • 2026-08-15 — Git-triggered deploys land BLOCKED; API deploys build fine — numora LESSONS.md
  • 2026-08-16 — JSON values in .env.local must be single-quoted — numora LESSONS.md
  • 2026-08-16 — La caché HMR de dev inyecta cuerpos de fetch en el HTML — numora LESSONS.md
• Stripe — 4 · shared across projects
  • 2026-07-01 — Stripe with dynamic pricedata — radius docs/DECISIONS.md
  • Trial expirado bloquea silenciosamente todos los canales — ademas-ai docs/LESSONS.md
  • Comparar API keys carácter por carácter — ademas-ai docs/LESSONS.md
  • Stripe CardElement en iframe cross-origin — ademas-ai docs/LESSONS.md
• React — 3 · shared across projects
  • window.confirm() bloquea browser automation — ademas-ai docs/LESSONS.md
  • setState updater + synthetic events — ademas-ai docs/LESSONS.md
  • JSX inline en Cloudflare Pages — no pre-compilar — ademas-ai docs/LESSONS.md
• Neon — 1 · shared across projects
  • 2026-06-26 — Neon Postgres over Supabase — radius docs/DECISIONS.md
• LLM — 74
  • 22-sep-2026 · Un recuerdo largo no debe bloquear toda la memoria — thesis LESSONS.md
  • 21-sep-2026 · Ahorrar por horario sin alterar calidad ni reintentos — thesis LESSONS.md
  • 21-sep-2026 · Reproducir pruebas antes de comprar otra comparación — thesis LESSONS.md
  • 21-sep-2026 · Reparaciones invisibles al contador de costes — thesis LESSONS.md
  • 21-sep-2026 · Piloto 1.1 y comprobación de modelos por sección — thesis LESSONS.md
  • 2026-09-21 — Un fallo de API no puntúa calidad ni demuestra gratuidad — thesis LESSONS.md
  • 2026-09-21 — Los recibos necesitan una cola que vuelva a encontrarlos — thesis LESSONS.md
  • 2026-09-21 — Recuperar un panel sin fabricar votos ni gasto nuevo — thesis LESSONS.md
  • 2026-09-21 — Una corrección automática incluye su prueba — thesis LESSONS.md
  • Gemini 3.x «razona» gastando maxOutputTokens — con tope corto el texto llega vacío — thesis LESSONS.md
  • Un tope de gasto que no está en la ruta caliente no frena nada — thesis LESSONS.md
  • Con razonamiento adaptativo, maxtokens es también el presupuesto del pensamiento — thesis LESSONS.md
  • Ordenar una cola no concentra el trabajo en terminar su primera unidad — thesis LESSONS.md
  • Un comité puede convertir una ambigüedad en una restricción inexistente — thesis LESSONS.md
  • Revisar una respuesta no confirma las correcciones del revisor — thesis LESSONS.md
  • Una respuesta cortada puede costar más que un presupuesto de salida suficiente — thesis LESSONS.md
  • Añadir el rechazo al mensaje inicial puede volver a cobrar un borrador idéntico — thesis LESSONS.md
  • El revisor puede aprobar sus propias correcciones y agotar todos los intentos — thesis LESSONS.md
  • Cambiar el diagnóstico puede volver a cobrar una selección ya generada — thesis LESSONS.md
  • El evaluador necesita la misma fecha de corte y las mismas decisiones — thesis LESSONS.md
  • Menos objeciones no demuestra que una corrección esté terminada — thesis LESSONS.md
  • Un límite corto puede duplicar el coste de una revisión experta — thesis LESSONS.md
  • Cambiar de día no debe recomprar una investigación idéntica — thesis LESSONS.md
  • Una revisión positiva debe justificar cada requisito de preparación — thesis LESSONS.md
  • Los análisis dependientes deben esperar a la selección revisada — thesis LESSONS.md
  • Un agregador no garantiza ni el mismo precio ni la misma disponibilidad — thesis LESSONS.md
  • Un bloqueo terminal puede ocultar una etapa del evaluador que nunca se ejecutó — thesis LESSONS.md
  • Un modo de render sin modelos puede pagar al refrescar evidencia antes de su bifurcación — thesis LESSONS.md
  • Mover una comprobación gratuita puede invalidar llamadas ya pagadas si cambia la secuencia congelada — thesis LESSONS.md
  • 2026-09-21 · Repetir respuestas no añade independencia al comité — thesis LESSONS.md
  • 2026-09-21 · Separar vigencia de precios, pruebas y autorización — thesis LESSONS.md
  • 2026-09-21 · Evaluar una cadena, no contar llamadas como éxitos — thesis LESSONS.md
  • 2026-09-21 · Evaluar al revisor con la entrada exacta, no solo su diagnóstico — thesis LESSONS.md
  • 2026-09-21 · Una objeción corregida puede citar el texto que ya se eliminó — thesis LESSONS.md
  • 2026-09-21 · Medir la reparación y distinguir verdad de edición — thesis LESSONS.md
  • 2026-09-21 · Una evaluación terminada puede retener la reutilización — thesis LESSONS.md
  • 2026-09-21 · Parámetros reales y presupuesto entre variantes — thesis LESSONS.md
  • 2026-09-21 · El presupuesto de salida también contiene razonamiento — thesis LESSONS.md
  • 2026-09-21 · Controles breves correctos no acreditan coherencia del análisis — thesis LESSONS.md
  • 2026-09-21 · Verificar el alcance efectivo de las instrucciones de evaluación — thesis LESSONS.md
  • 2026-09-21 · Una pregunta futura no exige un caso ya demostrado — thesis LESSONS.md
  • 2026-09-21 · Localizar la cita antes de recomprar la revisión — thesis LESSONS.md
  • 2026-09-21 · El replay debe demostrar que no puede volver a pagar — thesis LESSONS.md
  • 2026-09-21 · Probar el recorrido instalado y conservar la incertidumbre por separado — thesis LESSONS.md
  • 2026-09-21 · Conciliar el resumen vigente al conservar una cronología — thesis LESSONS.md
  • 2026-09-21 · Conservar la entrada antes de esperar un lote — thesis LESSONS.md
  • 2026-09-22 · Separar fecha del extracto y actualización de una página viva — thesis LESSONS.md
  • 2026-09-22 · Una búsqueda fallida no invalida el original ya ingerido — thesis LESSONS.md
  • 2026-09-22 · Contexto de agentes: reducir detalle sin perder vigencia — thesis LESSONS.md
  • 2026-09-22 · Un cambio de interfaz no renueva una aprobación académica — thesis LESSONS.md
  • 2026-09-22 · Un rechazo terminal protege la misma evidencia, no congela la nueva — thesis LESSONS.md
  • 2026-09-23 · Hipótesis sustantiva y validación del instrumento no son la misma prueba — thesis LESSONS.md
  • 2026-09-26 · Lo que se apaga en silencio mientras nada corre — thesis LESSONS.md
  • Jueces con fallback: el panel externo nunca puede tirar el pipeline — ademas-ai docs/LESSONS.md
  • Council Loop — el lazo autónomo de calidad es un patrón portable, y ya tiene blueprint — ademas-ai docs/LESSONS.md
  • El feedback humano manual es la señal de los huecos del detector automático — ademas-ai docs/LESSONS.md
  • Rigor que produce un texto ilegible es rigor mal puesto — glossa LESSONS.md
  • Cuando una marca promete algo que no puedes cumplir, cambia la marca — glossa LESSONS.md
  • Un modelo que razona traduciendo es dinero quemado en pensar — glossa LESSONS.md
  • Ningún modelo acierta siempre: verifica y pasa al siguiente — glossa LESSONS.md
  • Marcarlo todo es no marcar nada — glossa LESSONS.md
  • Un ranking por volumen entierra justo lo que añadiste para no perderte — glossa LESSONS.md
  • Una compuerta barata puesta después de la cara — glossa LESSONS.md
  • Una regla que nunca se ha disparado es una regla sin probar — glossa LESSONS.md
  • El content vacío de un modelo de razonamiento no es un fallo de parseo — glossa LESSONS.md
  • fetch de Node aborta a los 300 s esperando cabeceras — glossa LESSONS.md
  • Elegir modelo por precio es elegir mal; el eje real es si aplana las distinciones — glossa LESSONS.md
  • Una regeneración parcial no debe sobrescribir a una completa — glossa LESSONS.md
  • Un filtro que trabaja en silencio es indistinguible de un descubrimiento roto — glossa LESSONS.md
  • Una etiqueta de tema no es una consulta de búsqueda — glossa LESSONS.md
  • Digerir un reporte con el prompt de un episodio le fabrica una voz — glossa LESSONS.md
  • El directorio de fuentes crece por expediente, no por fama (D-024) — glossa LESSONS.md
  • Dos señales independientes, o no se funde nada — glossa LESSONS.md
  • El 429 que no se arregla esperando — glossa LESSONS.md
• relational database — 59
  • Una escritura cuyo código de retorno se descarta convierte una deriva de esquema en corrupción silenciosa — thesis LESSONS.md
  • Si una decisión puede mutar el dato, la marcha atrás tiene que cubrirla — thesis LESSONS.md
  • Deshabilitar una credencial no surte efecto al instante — y una espera fija vuelve permanente el rollback — thesis LESSONS.md
  • Un ANALYZE sobre una tabla de vectores puede tumbar TODO el REST del proyecto — thesis LESSONS.md
  • Una migración vieja que recrea un constraint estrecha lo que una nueva amplió — y «recrear si no existe» tampoco salva — thesis LESSONS.md
  • Un consumidor que lee «las N más nuevas» pierde en silencio lo que cae por debajo de N — thesis LESSONS.md
  • Un índice que cubre búsquedas puede atascar un recuento de control — thesis LESSONS.md
  • Una búsqueda general y «la última petición» pueden ocultar faltantes de otros conceptos — thesis LESSONS.md
  • La cuota de un buscador no debe detener toda la investigación — thesis LESSONS.md
  • Un enlace alternativo bloqueado no exige volver a descargar el mismo texto oficial — thesis LESSONS.md
  • Una URL corregida debe conservar la identidad de la solicitud — thesis LESSONS.md
  • Una cola de avisos no es la cola de trabajo — thesis LESSONS.md
  • Un espejo necesita comprobar el contenido y el contrato de estados — thesis LESSONS.md
  • La bibliografía puede bloquearse aunque el corpus y la exportación funcionen — thesis LESSONS.md
  • Un cron activo de GitHub no garantiza que haya ocurrido una pasada — thesis LESSONS.md
  • El último listado de ejecuciones puede ocultar un aviso atascado desde el día anterior — thesis LESSONS.md
  • Buscar fuera puede perpetuar un faltante cuyo original ya está en el corpus — thesis LESSONS.md
  • Una cola sin documentos nuevos puede tardar en volver a verificar lo ya completo — thesis LESSONS.md
  • Un pasaje existente puede quedar fuera de la muestra que recibe el revisor — thesis LESSONS.md
  • Una vista previa fallida puede parecer un libro completo por sus referencias — thesis LESSONS.md
  • Un PDF oficial puede carecer de los metadatos que sí tiene su registro editorial — thesis LESSONS.md
  • El último dictamen no sustituye el historial consultivo — thesis LESSONS.md
  • Conciliar los borradores preparados antes de volver a generarlos — thesis LESSONS.md
  • El último correo guardado no demuestra que el buzón esté procesado — thesis LESSONS.md
  • Una respuesta pagada necesita un recibo antes de repetir el correo — thesis LESSONS.md
  • Una cita revisada puede seguir fuera de la biblioteca — thesis LESSONS.md
  • El recibo de ingesta debe volver al borrador que usa la fuente — thesis LESSONS.md
  • Un diagnóstico guardado necesita una transición de recuperación — thesis LESSONS.md
  • Un latido que dice «partial» ante cualquier error deja de avisar de nada — thesis LESSONS.md
  • En CI de pago, el coste lo multiplican las cadenas de disparos, no el trabajo — thesis LESSONS.md
  • «Hay trabajo pendiente» calculado con intentos vencidos casi siempre da sí — thesis LESSONS.md
  • Una prueba que el equipo conoce deja de medir en cuanto se optimiza contra ella — thesis LESSONS.md
  • Arreglar el buscador no arregla a quien no lo usa — thesis LESSONS.md
  • Comparar fechas serializadas como texto inventa fallos después de una escritura correcta — thesis LESSONS.md
  • Una sonda puede parecer una regresión de búsqueda si recorta sus respuestas esperadas — thesis LESSONS.md
  • Una caché escrita después del modelo no impide compras concurrentes ni permite conciliar gasto — thesis LESSONS.md
  • La selección revisada no corrige automáticamente el resumen antiguo del catálogo — thesis LESSONS.md
  • Una fecha reciente del espejo puede ser solo una reescritura sin cambios — thesis LESSONS.md
  • Un coordinador compartido necesita latidos que identifiquen el trabajo realmente realizado — thesis LESSONS.md
  • CI puede verificar una versión histórica del monitor de crédito y omitir la desplegada — thesis LESSONS.md
  • 2026-09-21 · Un espejo necesita catálogo y disparador del consumidor — thesis LESSONS.md
  • 2026-09-26 · El vigilante no puede vivir donde vive lo que vigila — thesis LESSONS.md
  • 2.1 Management PAT (sbp) vs servicerole JWT (eyJhbG) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.2 RLS status actual (abr-2026) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.3 CHECK constraint en evaluateditems.actiontag — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.4 Trigger BEFORE INSERT en evaluateditems — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • JWT auth en edge functions — ademas-ai docs/LESSONS.md
  • RPC updateagent — merge JSONB con || — ademas-ai docs/LESSONS.md
  • Nunca actualizar agents con anon key — ademas-ai docs/LESSONS.md
  • Verificar la hipótesis contra filas reales ANTES de codificarla — ademas-ai docs/LESSONS.md
  • Migraciones por replace() llevan guard ruidoso obligatorio — ademas-ai docs/LESSONS.md
  • Una policy RLS sin TO aplica a PUBLIC; "para el service role" sin TO servicerole abre la tabla a la anon key — ademas-ai docs/LESSONS.md
  • Una traducción vieja junto a un texto nuevo son dos revistas distintas — glossa LESSONS.md
  • La semana del lector, no la del servidor — glossa LESSONS.md
  • Un índice parcial no puede arbitrar un ON CONFLICT — glossa LESSONS.md
  • Una fila que se marca «en curso» necesita quién la rescate — glossa LESSONS.md
  • Una ventana relativa a «hoy» multiplica filas en vez de actualizarlas — glossa LESSONS.md
  • ON DELETE CASCADE detrás de un botón que dice «remove» — glossa LESSONS.md
  • 2026-08-20 — "Sin secretos en el repo" no es lo mismo que mínimo privilegio — glossa docs/09-Decisiones-Abiertas.md
• deployment / hosting — 11
  • Un deploy que publica «todo el repo menos X» termina publicando lo que no debía — thesis LESSONS.md
  • Borrar el service worker de un sitio NO desinstala el de los teléfonos — publica uno «de despedida» — thesis LESSONS.md
  • Cablear la interfaz ANTES de la primera llamada de red — thesis LESSONS.md
  • 2026-09-21 · El despliegue debe conservar el árbol de imports — thesis LESSONS.md
  • 4.1 Service worker cache busting — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Nunca reconstruir index.html desde el JSX — ademas-ai docs/LESSONS.md
  • CDN de Cloudflare Pages cachea agresivamente — ademas-ai docs/LESSONS.md
  • Al retirar un mecanismo, auditar si su reemplazo re-embarca el mismo bug — ademas-ai docs/LESSONS.md
  • .reverse() in-place ya mordió dos veces (INV-38 y F2.1) — ademas-ai docs/LESSONS.md
  • Una función desplegada a mano es código que el siguiente despliegue borra — glossa LESSONS.md
  • Los 150 s de una edge function deciden el modelo, no al revés — glossa LESSONS.md
• repository / CI-CD — 4
  • La cuenta informa más que la lista — glossa LESSONS.md
  • Un contrato no viaja en frases para humanos — glossa LESSONS.md
  • Una fuente correcta y callada se lee igual que una averiada — glossa LESSONS.md
  • Un título de feed trae el eslogan pegado — glossa LESSONS.md
• design system — 2
  • Un contador que enseña «usados» se lee como «quedan» — glossa LESSONS.md
  • Si lo decide el sistema, el panel no enseña mandos — glossa LESSONS.md
• billing / payments — 1
  • 2026-06-28 — Prepaid estimate ledger — radius docs/DECISIONS.md

• Bound by STANDARD-ACTIONS-BUDGET (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-DOC-ENTRYPOINT (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-PUBLISHED-OUTPUT (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-TWILIO-OTP (matched on Twilio) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.

Radius (Marketing / ZIP / EDDM) radius

Standards that bind this project:

• Shared GitHub Actions budget — docs/STANDARD-ACTIONS-BUDGET.md · applies via GitHub Actions · configuration integrated on 2026-09-25 · first unblocked GitHub execution and measured savings pending · no conforms_to declared

  ci_cd:
    provider: GitHub Actions
    capability: CI/CD
    implemented_in: docs/PIPELINE.md
    conforms_to: STANDARD-ACTIONS-BUDGET

• Standard — one canonical entrypoint, never two copies — docs/STANDARD-DOC-ENTRYPOINT.md · applies via GitHub · active since 2026-08-21 · no conforms_to declared

  source_control:
    provider: GitHub
    capability: repository / CI-CD
    conforms_to: [STANDARD-DOC-ENTRYPOINT, STANDARD-PUBLISHED-OUTPUT]

• Standard — every published output needs a verified consumer — docs/STANDARD-PUBLISHED-OUTPUT.md · applies via GitHub · active since 2026-08-21 · no conforms_to declared
• Standard — Twilio OTP / SMS anti-abuse — docs/STANDARD-TWILIO-OTP.md · applies via Twilio · active since 2026-08-10 · conformance declared

Already solved elsewhere in the portfolio:

• design system — you have your own in docs/DECISIONS.md, and there are 6 more in the portfolio: aroma → docs/ARCHITECTURE.md · thesis → pwa/WEBAPP-MEMORY.md · ademas-ai → inbox/index.html · glossa → src/styles/global.css · merit → web/src/app/globals.css · numora → 04-UI-Visual-Specification.md. Worth comparing before the next change to yours.
• admin UI — you have your own in site/, and there is 1 more in the portfolio: ademas-ai → console/index.html. Worth comparing before the next change to yours.
• repository / CI-CD — already built in glossa → .github/workflows/glossa-publish.yml. Read it before writing your own.
• LLM — already built in aroma → api/_lib/textModels.js · aroma → api/_lib/recipeImages.js · thesis → phd-agents/docs/MODEL-ROUTING.md · thesis → phd-agents/shared/curation_models.py · ademas-ai → supabase/functions/_shared/llm.ts · glossa → skills/SKILL.md · glossa → supabase/functions/_shared/gemini.ts · glossa → scripts/weekly_from_supabase.mjs · merit → web/src/lib/anthropic.ts. Read it before writing your own.
• search / benchmarking — already built in thesis → phd-agents/shared/research_search.py · glossa → src/lib/gdelt.mjs · glossa → src/lib/gnews.mjs · glossa → scripts/research_from_supabase.mjs · glossa → scripts/reportaje_from_supabase.mjs · glossa → supabase/functions/_shared/feeds.ts. Read it before writing your own.
• credential management — already built in thesis → phd-agents/docs/RECOVERY-SECRETS.md. Read it before writing your own.

Lessons from other projects that touch what you use (304, grouped by what matched):

• GitHub Actions — 33 · shared across projects
  • 2026-09-25 — Measure account spend before cutting a quiet project's tests — aroma docs/LESSONS.md
  • Un workflow en verde puede no haber hecho su trabajo — thesis LESSONS.md
  • El auditor automático también deriva — átalo a su fuente con un test — thesis LESSONS.md
  • Las guardas de un camino que nunca se ha ejecutado son hipótesis, no guardas — thesis LESSONS.md
  • Un grep de cordura sobre un artefacto binario puede pasar por accidente — thesis LESSONS.md
  • Dos componentes que miden lo mismo con umbrales propios acaban contradiciéndose — thesis LESSONS.md
  • Un pedido explícito no puede quedar a merced de la clasificación automática que le sigue — thesis LESSONS.md
  • Un consumidor que lee «las N más nuevas» pierde en silencio lo que cae por debajo de N — thesis LESSONS.md
  • Ordenar una cola no concentra el trabajo en terminar su primera unidad — thesis LESSONS.md
  • Un evento omitido no debe renovar el aplazamiento del siguiente — thesis LESSONS.md
  • Una búsqueda general y «la última petición» pueden ocultar faltantes de otros conceptos — thesis LESSONS.md
  • Una comprobación que termina sin trabajar también puede cancelar trabajo pendiente — thesis LESSONS.md
  • Una cola de avisos no es la cola de trabajo — thesis LESSONS.md
  • Un cron activo de GitHub no garantiza que haya ocurrido una pasada — thesis LESSONS.md
  • El último listado de ejecuciones puede ocultar un aviso atascado desde el día anterior — thesis LESSONS.md
  • Una comprobación omitida no debe despertar toda la cadena — thesis LESSONS.md
  • Una sonda de calidad en el mismo paso de shell apagó un agente que no tenía nada que ver — thesis LESSONS.md
  • En CI de pago, el coste lo multiplican las cadenas de disparos, no el trabajo — thesis LESSONS.md
  • Una prueba que el equipo conoce deja de medir en cuanto se optimiza contra ella — thesis LESSONS.md
  • Reanudar un objetivo antiguo puede repetir trabajo ya terminado en otra superficie — thesis LESSONS.md
  • Una cola vacía puede agotar consultas del gestor de secretos — thesis LESSONS.md
  • Un coordinador compartido necesita latidos que identifiquen el trabajo realmente realizado — thesis LESSONS.md
  • 2026-09-21 · Filtrar trabajo editorial por los archivos que realmente cuentan — thesis LESSONS.md
  • 2026-09-25 · El minuto más barato es el proceso que no se despierta — thesis LESSONS.md
  • 2026-09-26 · El vigilante no puede vivir donde vive lo que vigila — thesis LESSONS.md
  • 2026-09-26 · Lo que se apaga en silencio mientras nada corre — thesis LESSONS.md
  • 3.1 Delay entre push y trigger — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 3.2 YAML en heredocs con Python inline — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 3.3 Log fetch con DNS cache overflow — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • workflowdispatch requiere branch ref, no refs/pull/N/merge — ademas-ai docs/LESSONS.md
  • GitHub Actions + Wrangler deploy — ademas-ai docs/LESSONS.md
  • 2026-09-25 — Un monitor trasladado y un reloj vacío son gastos distintos — ademas-ai docs/LESSONS.md
  • 2026-09-25 — Superseded CI is not new quality evidence — numora LESSONS.md
• Anthropic — 30 · shared across projects
  • Verify model IDs before hard-coding them — aroma docs/LESSONS.md
  • Source URL hallucination — aroma docs/LESSONS.md
  • Extended thinking adds latency without quality gain for structured JSON — aroma docs/LESSONS.md
  • Upstream AI calls must abort before the function's maxDuration — aroma docs/LESSONS.md
  • AI Provider API Syntax & Limits — a fix that expired — aroma docs/LESSONS.md
  • A timeout that fits the common case hides the failing one — aroma docs/LESSONS.md
  • The newer tool version is not the cheaper one — aroma docs/LESSONS.md
  • El tracking de costos miente si no refleja precios promocionales y de lanzamiento — thesis LESSONS.md
  • Los topes de gasto declarados deben saltar ANTES que el tope del proveedor — thesis LESSONS.md
  • claude-opus-5 rechaza temperature con 400 — y los clientes viejos no lo saben — thesis LESSONS.md
  • La contabilidad idempotente no impide pagar dos peticiones idénticas — thesis LESSONS.md
  • Consultar los recibos antes de ampliar una revisión truncada — thesis LESSONS.md
  • Una respuesta mal formada puede costar aunque el resumen diga cero — thesis LESSONS.md
  • Un límite de revisiones puede dejar la última corrección sin comprobar — thesis LESSONS.md
  • Una ruta económica de curación no cambia los revisores de investigación — thesis LESSONS.md
  • Consultar hoy no significa tener el gasto de hoy — thesis LESSONS.md
  • Un comité necesita recuperar opiniones, no repetir la consulta completa — thesis LESSONS.md
  • Una revisión bilingüe aprobada puede esconder una ampliación normativa y un componente vacío — thesis LESSONS.md
  • Un límite de salida económico puede pagar razonamiento y no recibir ningún veredicto — thesis LESSONS.md
  • Un esquema válido para OpenAI puede impedir que arranque el revisor Anthropic — thesis LESSONS.md
  • 23-sep-2026 · Actualizar un modelo sin recomprar trabajos ni inventar equivalencias — thesis LESSONS.md
  • Los prompts no pueden citar los marcadores que otro componente emite — ademas-ai docs/LESSONS.md
  • Las reglas suaves de mitad de conversación son frágiles por demostración — ademas-ai docs/LESSONS.md
  • Dos resolvedores del mismo valor = el bug original con otra cara — ademas-ai docs/LESSONS.md
  • La auditoría adversarial con otro modelo paga — ademas-ai docs/LESSONS.md
  • El Usage/Cost Report de Anthropic devuelve BUCKETS con las filas adentro — iterar data.data directo suma $0 sin error — ademas-ai docs/LESSONS.md
  • El grep de un invariante debe cubrir TODAS las formas de invocar al proveedor — ademas-ai docs/LESSONS.md
  • Multi-proveedor de LLM: una sola puerta, usage normalizado, y precio techo desde el día uno — ademas-ai docs/LESSONS.md
  • 2026-08-21 — Un modelo prefiere el metadato al contenido, y eso rompe la atribución — glossa docs/09-Decisiones-Abiertas.md
  • 2026-08-15 — Sonnet 5 emits thinking blocks before text — numora LESSONS.md
• 1Password — 17 · shared across projects
  • 1Password Environments are separate from ordinary vault items — aroma docs/LESSONS.md
  • Vercel Development does not support Sensitive variables — aroma docs/LESSONS.md
  • 1Password local env mounts are FIFO streams — aroma docs/LESSONS.md
  • Capture one-time provider secrets before closing the confirmation page — aroma docs/LESSONS.md
  • Reusing one secret across trust domains multiplies the blast radius — aroma docs/LESSONS.md
  • Los campos nuevos de 1Password caen dentro de una sección — y op read por ruta corta no los ve — thesis LESSONS.md
  • Las credenciales innecesarias pueden agotar la cuota compartida de 1Password — thesis LESSONS.md
  • Un fallo del almacén de credenciales no debe agotar los intentos de investigación — thesis LESSONS.md
  • Una etiqueta de 1Password no identifica un campo de forma única — thesis LESSONS.md
  • El espejo documental necesita recuperación aunque no haya otra edición — thesis LESSONS.md
  • 1.1 load-secrets-action@v2 con export-env: true no propaga — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.2 Nombres de items con espacios — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.3 Campos duplicados → error "more than one X field" — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.4 Arquitectura de items del proyecto — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Una clave nueva no separa la cuota; hay que separar la cuenta — glossa LESSONS.md
  • El campo de 1Password no siempre se llama igual — glossa LESSONS.md
  • 2026-08-15 — op read rejects em-dashes in item titles — numora LESSONS.md
• Twilio — 15 · shared across projects
  • Keep partial provider configuration out of Vercel — aroma docs/LESSONS.md
  • Twilio Verify code length is service-scoped — aroma docs/LESSONS.md
  • Phone auth needs both Verify and an SMS sender — aroma docs/LESSONS.md
  • The OTP guard only protects the endpoint it is wired into — aroma docs/LESSONS.md
  • tenanta2pregistrations es solo para ISV tenants — nunca para el operador — ademas-ai docs/LESSONS.md
  • HMAC validation — usar ambas URLs — ademas-ai docs/LESSONS.md
  • A2P 10DLC — URLs reales en el campaign — ademas-ai docs/LESSONS.md
  • Twilio Verify API bypasa A2P — ademas-ai docs/LESSONS.md
  • Precondiciones se calculan ANTES del insert propio (y excluyendo filas internas) — ademas-ai docs/LESSONS.md
  • Una guarda de identidad colapsa cuando dos roles se vuelven la misma persona — ademas-ai docs/LESSONS.md
  • Los avisos al operador se escriben para su destinatario, no para el log — ademas-ai docs/LESSONS.md
  • La compra-en-el-momento ya estaba escrita; el pool la tenía muerta — ademas-ai docs/LESSONS.md
  • sips: no es SRTP en Twilio <Dial><Sip>: es ;secure=true — ademas-ai docs/LESSONS.md
  • «Completed» no significa «atendido por el agente» — ademas-ai docs/LESSONS.md
  • Llamar de un asistente a otro es la prueba de punta a punta que no necesita humanos — ademas-ai docs/LESSONS.md
• GitHub — 12 · shared across projects
  • Never commit Claude worktree snapshots or DB dumps — aroma docs/LESSONS.md
  • External Mesa renames need owner-level write credentials — aroma docs/LESSONS.md
  • Vercel production deploys require a recognized git author — aroma docs/LESSONS.md
  • 19-sep-2026 · Memoria vigente breve y archivo íntegro — thesis LESSONS.md
  • Antes de tocar un archivo, revisar el otro clone por trabajo sin commitear — ademas-ai docs/LESSONS.md
  • Umbrella enruta por capacidad DECLARADA: lo que no declaras, no te llega — glossa LESSONS.md
  • Una regla que solo mira failure no ve un trabajo muerto por tiempo — glossa LESSONS.md
  • Un vigilante con falsas alarmas es un vigilante que se ignora — glossa LESSONS.md
  • Todo lo que se genera necesita un lector nombrado, y comprobado — glossa LESSONS.md
  • Las migraciones aplicadas y no commiteadas dejan un esquema irreconstruible — glossa LESSONS.md
  • 2026-08-21 — Una salida sin lector es peor que ninguna salida — glossa docs/09-Decisiones-Abiertas.md
  • 2026-08-15 — sharp/libvips CVEs via Next image optimizer — numora LESSONS.md
• DeepSeek — 5 · shared across projects
  • 21-sep-2026 · Ahorrar por horario sin alterar calidad ni reintentos — thesis LESSONS.md
  • Un evaluador puede confundir preparación bibliográfica con resultados todavía por producir — thesis LESSONS.md
  • El título publicado también necesita una revisión de evidencia — thesis LESSONS.md
  • Un ensayo de modelos debe validar primero su propio contrato — thesis LESSONS.md
  • Un agregador no garantiza ni el mismo precio ni la misma disponibilidad — thesis LESSONS.md
• Stripe — 5 · shared across projects
  • Keep Stripe live and sandbox credentials explicit — aroma docs/LESSONS.md
  • Webhook signatures cover bytes, not objects — aroma docs/LESSONS.md
  • Trial expirado bloquea silenciosamente todos los canales — ademas-ai docs/LESSONS.md
  • Comparar API keys carácter por carácter — ademas-ai docs/LESSONS.md
  • Stripe CardElement en iframe cross-origin — ademas-ai docs/LESSONS.md
• Neon — 4 · shared across projects
  • Verify Neon schema before auth migration assumptions — aroma docs/LESSONS.md
  • Neon DB column names mismatch with API routes — aroma docs/LESSONS.md
  • A background poll is the most expensive line of code in a free-tier app — aroma docs/LESSONS.md
  • Batch the round trips, not just the statements — aroma docs/LESSONS.md
• Tavily — 2 · shared across projects
  • La cuota de un buscador no debe detener toda la investigación — thesis LESSONS.md
  • El contador de una clave de Tavily puede estar sano mientras su cuenta está bloqueada — thesis LESSONS.md
• cloudflare workers — 1 · shared across projects
  • Una sonda de salud pesada no sirve para vigilar cada 5 minutos; la de hoy tardó 26 min en no avisar — ademas-ai docs/LESSONS.md
• LLM — 84
  • Compact AI payloads at the server boundary — aroma docs/LESSONS.md
  • Every long AI endpoint needs Vercel duration and client escape hatch — aroma docs/LESSONS.md
  • 22-sep-2026 · Un recuerdo largo no debe bloquear toda la memoria — thesis LESSONS.md
  • 21-sep-2026 · Reproducir pruebas antes de comprar otra comparación — thesis LESSONS.md
  • 21-sep-2026 · Reparaciones invisibles al contador de costes — thesis LESSONS.md
  • 21-sep-2026 · Piloto 1.1 y comprobación de modelos por sección — thesis LESSONS.md
  • 2026-09-21 — Un fallo de API no puntúa calidad ni demuestra gratuidad — thesis LESSONS.md
  • 2026-09-21 — Los recibos necesitan una cola que vuelva a encontrarlos — thesis LESSONS.md
  • 2026-09-21 — Recuperar un panel sin fabricar votos ni gasto nuevo — thesis LESSONS.md
  • 2026-09-21 — Una corrección automática incluye su prueba — thesis LESSONS.md
  • Gemini 3.x «razona» gastando maxOutputTokens — con tope corto el texto llega vacío — thesis LESSONS.md
  • Un tope de gasto que no está en la ruta caliente no frena nada — thesis LESSONS.md
  • Con razonamiento adaptativo, maxtokens es también el presupuesto del pensamiento — thesis LESSONS.md
  • Esperar un lote no es un fallo semántico ni permiso para volver a pagarlo — thesis LESSONS.md
  • Un comité puede convertir una ambigüedad en una restricción inexistente — thesis LESSONS.md
  • Revisar una respuesta no confirma las correcciones del revisor — thesis LESSONS.md
  • Una respuesta cortada puede costar más que un presupuesto de salida suficiente — thesis LESSONS.md
  • Añadir el rechazo al mensaje inicial puede volver a cobrar un borrador idéntico — thesis LESSONS.md
  • El revisor puede aprobar sus propias correcciones y agotar todos los intentos — thesis LESSONS.md
  • Cambiar el diagnóstico puede volver a cobrar una selección ya generada — thesis LESSONS.md
  • El evaluador necesita la misma fecha de corte y las mismas decisiones — thesis LESSONS.md
  • Menos objeciones no demuestra que una corrección esté terminada — thesis LESSONS.md
  • Un límite corto puede duplicar el coste de una revisión experta — thesis LESSONS.md
  • Cambiar de día no debe recomprar una investigación idéntica — thesis LESSONS.md
  • Una revisión positiva debe justificar cada requisito de preparación — thesis LESSONS.md
  • Los análisis dependientes deben esperar a la selección revisada — thesis LESSONS.md
  • Una espera debe identificar la solicitud que sigue pendiente — thesis LESSONS.md
  • Conservar el cotejo documental después de resolver el faltante — thesis LESSONS.md
  • Las citas literales requieren distinguir tipografía de contenido inventado — thesis LESSONS.md
  • Dos revisores de acuerdo pueden aprobar una cita que perdió su negación — thesis LESSONS.md
  • El precio de un modelo no es el costo de obtener su resultado útil — thesis LESSONS.md
  • Un defecto del banco de pruebas se puede confundir con un fallo del modelo — thesis LESSONS.md
  • Una recomendación rechazada necesita una corrección distinta antes de otra revisión — thesis LESSONS.md
  • Un árbitro de frontera puede aceptar el error que detecta un modelo intermedio — thesis LESSONS.md
  • 2026-09-14 — Grok consistente también puede omitir un error; costos de capítulo y operación separados — thesis LESSONS.md
  • El artefacto revisado y el que se muestra deben tener la misma huella — thesis LESSONS.md
  • Si las preguntas están en un idioma y el corpus en otro, la ordenación no lo arregla — thesis LESSONS.md
  • Un bloqueo terminal puede ocultar una etapa del evaluador que nunca se ejecutó — thesis LESSONS.md
  • Un modo de render sin modelos puede pagar al refrescar evidencia antes de su bifurcación — thesis LESSONS.md
  • El orden accidental de los pasajes puede volver a comprar la misma investigación — thesis LESSONS.md
  • Un rechazo que solo enumera aciertos no justifica comprar otra redacción — thesis LESSONS.md
  • Mover una comprobación gratuita puede invalidar llamadas ya pagadas si cambia la secuencia congelada — thesis LESSONS.md
  • 2026-09-21 · Repetir respuestas no añade independencia al comité — thesis LESSONS.md
  • 2026-09-21 · Separar vigencia de precios, pruebas y autorización — thesis LESSONS.md
  • 2026-09-21 · Evaluar una cadena, no contar llamadas como éxitos — thesis LESSONS.md
  • 2026-09-21 · Evaluar al revisor con la entrada exacta, no solo su diagnóstico — thesis LESSONS.md
  • 2026-09-21 · Una objeción corregida puede citar el texto que ya se eliminó — thesis LESSONS.md
  • 2026-09-21 · Medir la reparación y distinguir verdad de edición — thesis LESSONS.md
  • 2026-09-21 · Una evaluación terminada puede retener la reutilización — thesis LESSONS.md
  • 2026-09-21 · Parámetros reales y presupuesto entre variantes — thesis LESSONS.md
  • 2026-09-21 · El presupuesto de salida también contiene razonamiento — thesis LESSONS.md
  • 2026-09-21 · Controles breves correctos no acreditan coherencia del análisis — thesis LESSONS.md
  • 2026-09-21 · Verificar el alcance efectivo de las instrucciones de evaluación — thesis LESSONS.md
  • 2026-09-21 · Una pregunta futura no exige un caso ya demostrado — thesis LESSONS.md
  • 2026-09-21 · Localizar la cita antes de recomprar la revisión — thesis LESSONS.md
  • 2026-09-21 · El replay debe demostrar que no puede volver a pagar — thesis LESSONS.md
  • 2026-09-21 · Probar el recorrido instalado y conservar la incertidumbre por separado — thesis LESSONS.md
  • 2026-09-21 · Conciliar el resumen vigente al conservar una cronología — thesis LESSONS.md
  • 2026-09-21 · Conservar la entrada antes de esperar un lote — thesis LESSONS.md
  • 2026-09-22 · Separar fecha del extracto y actualización de una página viva — thesis LESSONS.md
  • 2026-09-22 · Una búsqueda fallida no invalida el original ya ingerido — thesis LESSONS.md
  • 2026-09-22 · Contexto de agentes: reducir detalle sin perder vigencia — thesis LESSONS.md
  • 2026-09-22 · Un cambio de interfaz no renueva una aprobación académica — thesis LESSONS.md
  • 2026-09-22 · Un rechazo terminal protege la misma evidencia, no congela la nueva — thesis LESSONS.md
  • 2026-09-23 · Hipótesis sustantiva y validación del instrumento no son la misma prueba — thesis LESSONS.md
  • Jueces con fallback: el panel externo nunca puede tirar el pipeline — ademas-ai docs/LESSONS.md
  • Council Loop — el lazo autónomo de calidad es un patrón portable, y ya tiene blueprint — ademas-ai docs/LESSONS.md
  • El feedback humano manual es la señal de los huecos del detector automático — ademas-ai docs/LESSONS.md
  • Rigor que produce un texto ilegible es rigor mal puesto — glossa LESSONS.md
  • Cuando una marca promete algo que no puedes cumplir, cambia la marca — glossa LESSONS.md
  • Un modelo que razona traduciendo es dinero quemado en pensar — glossa LESSONS.md
  • Ningún modelo acierta siempre: verifica y pasa al siguiente — glossa LESSONS.md
  • Marcarlo todo es no marcar nada — glossa LESSONS.md
  • Un ranking por volumen entierra justo lo que añadiste para no perderte — glossa LESSONS.md
  • Una compuerta barata puesta después de la cara — glossa LESSONS.md
  • Una regla que nunca se ha disparado es una regla sin probar — glossa LESSONS.md
  • El content vacío de un modelo de razonamiento no es un fallo de parseo — glossa LESSONS.md
  • fetch de Node aborta a los 300 s esperando cabeceras — glossa LESSONS.md
  • Elegir modelo por precio es elegir mal; el eje real es si aplana las distinciones — glossa LESSONS.md
  • Una regeneración parcial no debe sobrescribir a una completa — glossa LESSONS.md
  • Digerir un reporte con el prompt de un episodio le fabrica una voz — glossa LESSONS.md
  • El directorio de fuentes crece por expediente, no por fama (D-024) — glossa LESSONS.md
  • Dos señales independientes, o no se funde nada — glossa LESSONS.md
  • El 429 que no se arregla esperando — glossa LESSONS.md
• relational database — 52
  • Shared data must belong to the household, not to the member who created it — aroma docs/LESSONS.md
  • One household per person needs an index, not a LIMIT 1 — aroma docs/LESSONS.md
  • ON CONFLICT is essential for all household INSERTs — aroma docs/LESSONS.md
  • Una escritura cuyo código de retorno se descarta convierte una deriva de esquema en corrupción silenciosa — thesis LESSONS.md
  • Si una decisión puede mutar el dato, la marcha atrás tiene que cubrirla — thesis LESSONS.md
  • Deshabilitar una credencial no surte efecto al instante — y una espera fija vuelve permanente el rollback — thesis LESSONS.md
  • Un ANALYZE sobre una tabla de vectores puede tumbar TODO el REST del proyecto — thesis LESSONS.md
  • Una migración vieja que recrea un constraint estrecha lo que una nueva amplió — y «recrear si no existe» tampoco salva — thesis LESSONS.md
  • Un índice que cubre búsquedas puede atascar un recuento de control — thesis LESSONS.md
  • Un enlace alternativo bloqueado no exige volver a descargar el mismo texto oficial — thesis LESSONS.md
  • Una URL corregida debe conservar la identidad de la solicitud — thesis LESSONS.md
  • Un espejo necesita comprobar el contenido y el contrato de estados — thesis LESSONS.md
  • La bibliografía puede bloquearse aunque el corpus y la exportación funcionen — thesis LESSONS.md
  • Buscar fuera puede perpetuar un faltante cuyo original ya está en el corpus — thesis LESSONS.md
  • Una cola sin documentos nuevos puede tardar en volver a verificar lo ya completo — thesis LESSONS.md
  • Un pasaje existente puede quedar fuera de la muestra que recibe el revisor — thesis LESSONS.md
  • Una vista previa fallida puede parecer un libro completo por sus referencias — thesis LESSONS.md
  • Un PDF oficial puede carecer de los metadatos que sí tiene su registro editorial — thesis LESSONS.md
  • El último dictamen no sustituye el historial consultivo — thesis LESSONS.md
  • Conciliar los borradores preparados antes de volver a generarlos — thesis LESSONS.md
  • El último correo guardado no demuestra que el buzón esté procesado — thesis LESSONS.md
  • Una respuesta pagada necesita un recibo antes de repetir el correo — thesis LESSONS.md
  • Una cita revisada puede seguir fuera de la biblioteca — thesis LESSONS.md
  • El recibo de ingesta debe volver al borrador que usa la fuente — thesis LESSONS.md
  • Un diagnóstico guardado necesita una transición de recuperación — thesis LESSONS.md
  • Un latido que dice «partial» ante cualquier error deja de avisar de nada — thesis LESSONS.md
  • «Hay trabajo pendiente» calculado con intentos vencidos casi siempre da sí — thesis LESSONS.md
  • Arreglar el buscador no arregla a quien no lo usa — thesis LESSONS.md
  • Comparar fechas serializadas como texto inventa fallos después de una escritura correcta — thesis LESSONS.md
  • Una sonda puede parecer una regresión de búsqueda si recorta sus respuestas esperadas — thesis LESSONS.md
  • Una caché escrita después del modelo no impide compras concurrentes ni permite conciliar gasto — thesis LESSONS.md
  • La selección revisada no corrige automáticamente el resumen antiguo del catálogo — thesis LESSONS.md
  • Una fecha reciente del espejo puede ser solo una reescritura sin cambios — thesis LESSONS.md
  • CI puede verificar una versión histórica del monitor de crédito y omitir la desplegada — thesis LESSONS.md
  • 2026-09-21 · Un espejo necesita catálogo y disparador del consumidor — thesis LESSONS.md
  • 2.1 Management PAT (sbp) vs servicerole JWT (eyJhbG) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.2 RLS status actual (abr-2026) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.3 CHECK constraint en evaluateditems.actiontag — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.4 Trigger BEFORE INSERT en evaluateditems — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • JWT auth en edge functions — ademas-ai docs/LESSONS.md
  • RPC updateagent — merge JSONB con || — ademas-ai docs/LESSONS.md
  • Nunca actualizar agents con anon key — ademas-ai docs/LESSONS.md
  • Verificar la hipótesis contra filas reales ANTES de codificarla — ademas-ai docs/LESSONS.md
  • Migraciones por replace() llevan guard ruidoso obligatorio — ademas-ai docs/LESSONS.md
  • Una policy RLS sin TO aplica a PUBLIC; "para el service role" sin TO servicerole abre la tabla a la anon key — ademas-ai docs/LESSONS.md
  • Una traducción vieja junto a un texto nuevo son dos revistas distintas — glossa LESSONS.md
  • La semana del lector, no la del servidor — glossa LESSONS.md
  • Un índice parcial no puede arbitrar un ON CONFLICT — glossa LESSONS.md
  • Una fila que se marca «en curso» necesita quién la rescate — glossa LESSONS.md
  • Una ventana relativa a «hoy» multiplica filas en vez de actualizarlas — glossa LESSONS.md
  • ON DELETE CASCADE detrás de un botón que dice «remove» — glossa LESSONS.md
  • 2026-08-20 — "Sin secretos en el repo" no es lo mismo que mínimo privilegio — glossa docs/09-Decisiones-Abiertas.md
• deployment / hosting — 20
  • Vercel preview deployments miss Production-only env vars — aroma docs/LESSONS.md
  • iPhone photos must be compressed before serverless upload — aroma docs/LESSONS.md
  • Un deploy que publica «todo el repo menos X» termina publicando lo que no debía — thesis LESSONS.md
  • Borrar el service worker de un sitio NO desinstala el de los teléfonos — publica uno «de despedida» — thesis LESSONS.md
  • Cablear la interfaz ANTES de la primera llamada de red — thesis LESSONS.md
  • 2026-09-21 · El despliegue debe conservar el árbol de imports — thesis LESSONS.md
  • 4.1 Service worker cache busting — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Nunca reconstruir index.html desde el JSX — ademas-ai docs/LESSONS.md
  • CDN de Cloudflare Pages cachea agresivamente — ademas-ai docs/LESSONS.md
  • JSX inline en Cloudflare Pages — no pre-compilar — ademas-ai docs/LESSONS.md
  • Al retirar un mecanismo, auditar si su reemplazo re-embarca el mismo bug — ademas-ai docs/LESSONS.md
  • .reverse() in-place ya mordió dos veces (INV-38 y F2.1) — ademas-ai docs/LESSONS.md
  • Una función desplegada a mano es código que el siguiente despliegue borra — glossa LESSONS.md
  • Los 150 s de una edge function deciden el modelo, no al revés — glossa LESSONS.md
  • redirects en la configuración pierde contra la normalización de barra final — glossa LESSONS.md
  • 2026-08-15 — Fail-closed gate from commit one — numora LESSONS.md
  • 2026-08-15 — Repo root must never be publicly served — numora LESSONS.md
  • 2026-08-15 — Git-triggered deploys land BLOCKED; API deploys build fine — numora LESSONS.md
  • 2026-08-16 — JSON values in .env.local must be single-quoted — numora LESSONS.md
  • 2026-08-16 — La caché HMR de dev inyecta cuerpos de fetch en el HTML — numora LESSONS.md
• search / benchmarking — 12
  • Un resultado de búsqueda pobre no vuelve ajeno un tema pertinente — thesis LESSONS.md
  • La síntesis del buscador puede contaminar una ficha aunque el extracto correcto esté guardado — thesis LESSONS.md
  • El parte mide lo que ENTRÓ, no lo que se vio — glossa LESSONS.md
  • La lista de subidas de un canal no es su lista de episodios — glossa LESSONS.md
  • Un filtro que trabaja en silencio es indistinguible de un descubrimiento roto — glossa LESSONS.md
  • Excluir por «fue un directo» descarta casi todo lo bueno — glossa LESSONS.md
  • YouTube sirve los subtítulos a tu ordenador y no a un servidor — glossa LESSONS.md
  • Una etiqueta de tema no es una consulta de búsqueda — glossa LESSONS.md
  • El presupuesto de búsqueda se ajusta solo mirando si los medios divergen — glossa LESSONS.md
  • Pagar una búsqueda y luego descubrir que no cabe — glossa LESSONS.md
  • Un tope que cuenta mal no es un tope — glossa LESSONS.md
  • Buscar fuera y encontrarse a uno mismo — glossa LESSONS.md
• design system — 5
  • Override --font-serif to restyle every title at once — aroma docs/LESSONS.md
  • Optimistic UI removes perceived AI/network latency — aroma docs/LESSONS.md
  • Safe area insets for iPhone — aroma docs/LESSONS.md
  • Un contador que enseña «usados» se lee como «quedan» — glossa LESSONS.md
  • Si lo decide el sistema, el panel no enseña mandos — glossa LESSONS.md
• repository / CI-CD — 4
  • La cuenta informa más que la lista — glossa LESSONS.md
  • Un contrato no viaja en frases para humanos — glossa LESSONS.md
  • Una fuente correcta y callada se lee igual que una averiada — glossa LESSONS.md
  • Un título de feed trae el eslogan pegado — glossa LESSONS.md
• CI/CD — 2
  • El canal de alerta de un sistema autónomo no puede ser uno que el humano ignora (D-15) — ademas-ai docs/LESSONS.md
  • «No arrancó» no es «falló»: lee las annotations antes de depurar código — ademas-ai docs/LESSONS.md
• credential management — 1
  • Connected provider accounts may not own the named resource — aroma docs/LESSONS.md

• Bound by STANDARD-ACTIONS-BUDGET (matched on GitHub Actions) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-DOC-ENTRYPOINT (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-PUBLISHED-OUTPUT (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.

thesis-repo (Research RAG / USAL thesis) thesis

Standards that bind this project:

• Shared GitHub Actions budget — docs/STANDARD-ACTIONS-BUDGET.md · applies via GitHub Actions · configuration integrated on 2026-09-25 · first unblocked GitHub execution and measured savings pending · no conforms_to declared

  ci_cd:
    provider: GitHub Actions
    capability: CI/CD
    implemented_in: phd-agents/README.md
    conforms_to: STANDARD-ACTIONS-BUDGET

• Standard — one canonical entrypoint, never two copies — docs/STANDARD-DOC-ENTRYPOINT.md · applies via GitHub · active since 2026-08-21 · no conforms_to declared

  source_control:
    provider: GitHub
    capability: repository / CI-CD
    conforms_to: [STANDARD-DOC-ENTRYPOINT, STANDARD-PUBLISHED-OUTPUT]

• Standard — every published output needs a verified consumer — docs/STANDARD-PUBLISHED-OUTPUT.md · applies via GitHub · active since 2026-08-21 · no conforms_to declared

Already solved elsewhere in the portfolio:

• design system — you have your own in pwa/WEBAPP-MEMORY.md, and there are 6 more in the portfolio: aroma → docs/ARCHITECTURE.md · radius → docs/DECISIONS.md · ademas-ai → inbox/index.html · glossa → src/styles/global.css · merit → web/src/app/globals.css · numora → 04-UI-Visual-Specification.md. Worth comparing before the next change to yours.
• progressive web app — you have your own in pwa/, and there is 1 more in the portfolio: ademas-ai → inbox/manifest.json. Worth comparing before the next change to yours.
• repository / CI-CD — already built in glossa → .github/workflows/glossa-publish.yml. Read it before writing your own.

External material found for your open items — proposals, not instructions: nothing here was verified against a repository

• English Proficiency - Graduate Admission undated — Result [4] directly addresses whether completing a master's degree can waive English proficiency requirements.
• What Is Data Deduplication? Enterprise Use Cases, Best Practices undated — Result [4] specifically mentions batch deduplication scheduling, directly addressing the project's batch deduplication requirement.

Lessons from other projects that touch what you use (143, grouped by what matched):

• Anthropic — 16 · shared across projects
  • Source URL hallucination — aroma docs/LESSONS.md
  • Extended thinking adds latency without quality gain for structured JSON — aroma docs/LESSONS.md
  • Upstream AI calls must abort before the function's maxDuration — aroma docs/LESSONS.md
  • AI Provider API Syntax & Limits — a fix that expired — aroma docs/LESSONS.md
  • A timeout that fits the common case hides the failing one — aroma docs/LESSONS.md
  • The newer tool version is not the cheaper one — aroma docs/LESSONS.md
  • 2026-07-07 — Mockup layer removed — radius docs/DECISIONS.md
  • Los prompts no pueden citar los marcadores que otro componente emite — ademas-ai docs/LESSONS.md
  • Las reglas suaves de mitad de conversación son frágiles por demostración — ademas-ai docs/LESSONS.md
  • Dos resolvedores del mismo valor = el bug original con otra cara — ademas-ai docs/LESSONS.md
  • La auditoría adversarial con otro modelo paga — ademas-ai docs/LESSONS.md
  • El Usage/Cost Report de Anthropic devuelve BUCKETS con las filas adentro — iterar data.data directo suma $0 sin error — ademas-ai docs/LESSONS.md
  • El grep de un invariante debe cubrir TODAS las formas de invocar al proveedor — ademas-ai docs/LESSONS.md
  • Multi-proveedor de LLM: una sola puerta, usage normalizado, y precio techo desde el día uno — ademas-ai docs/LESSONS.md
  • 2026-08-21 — Un modelo prefiere el metadato al contenido, y eso rompe la atribución — glossa docs/09-Decisiones-Abiertas.md
  • 2026-08-15 — Sonnet 5 emits thinking blocks before text — numora LESSONS.md
• Supabase — 12 · shared across projects
  • Neon DB column names mismatch with API routes — aroma docs/LESSONS.md
  • Supabase .delete() silently failed when RLS blocked — aroma docs/LESSONS.md
  • RLS self-referencing subqueries cause infinite recursion — aroma docs/LESSONS.md
  • Missing RLS policies = silent access denial — aroma docs/LESSONS.md
  • SECURITY DEFINER functions — aroma docs/LESSONS.md
  • RLS policy changes take effect immediately — aroma docs/LESSONS.md
  • 2026-06-26 — Neon Postgres over Supabase — radius docs/DECISIONS.md
  • Los grants por defecto de Postgres/Supabase hacen pública toda función nueva — ademas-ai docs/LESSONS.md
  • Añadir metadata a una fila rompe a quien la barría por metadata IS NULL — ademas-ai docs/LESSONS.md
  • Un JSONB de ajustes que se reescribe entero con una copia leída antes pierde datos en silencio — ademas-ai docs/LESSONS.md
  • Una sonda de salud pesada no sirve para vigilar cada 5 minutos; la de hoy tardó 26 min en no avisar — ademas-ai docs/LESSONS.md
  • 2026-08-20 — "Sin secretos en el repo" no es lo mismo que mínimo privilegio — glossa docs/09-Decisiones-Abiertas.md
• GitHub — 11 · shared across projects
  • Never commit Claude worktree snapshots or DB dumps — aroma docs/LESSONS.md
  • External Mesa renames need owner-level write credentials — aroma docs/LESSONS.md
  • Vercel production deploys require a recognized git author — aroma docs/LESSONS.md
  • 2026-07-13 — Repo layout = engine at root — radius docs/DECISIONS.md
  • Antes de tocar un archivo, revisar el otro clone por trabajo sin commitear — ademas-ai docs/LESSONS.md
  • Umbrella enruta por capacidad DECLARADA: lo que no declaras, no te llega — glossa LESSONS.md
  • Una regla que solo mira failure no ve un trabajo muerto por tiempo — glossa LESSONS.md
  • Un vigilante con falsas alarmas es un vigilante que se ignora — glossa LESSONS.md
  • Todo lo que se genera necesita un lector nombrado, y comprobado — glossa LESSONS.md
  • 2026-08-21 — Una salida sin lector es peor que ninguna salida — glossa docs/09-Decisiones-Abiertas.md
  • 2026-08-15 — sharp/libvips CVEs via Next image optimizer — numora LESSONS.md
• 1Password — 10 · shared across projects
  • Keep Stripe live and sandbox credentials explicit — aroma docs/LESSONS.md
  • 1Password Environments are separate from ordinary vault items — aroma docs/LESSONS.md
  • Vercel Development does not support Sensitive variables — aroma docs/LESSONS.md
  • 1Password local env mounts are FIFO streams — aroma docs/LESSONS.md
  • Capture one-time provider secrets before closing the confirmation page — aroma docs/LESSONS.md
  • Reusing one secret across trust domains multiplies the blast radius — aroma docs/LESSONS.md
  • Comparar API keys carácter por carácter — ademas-ai docs/LESSONS.md
  • Una clave nueva no separa la cuota; hay que separar la cuenta — glossa LESSONS.md
  • El campo de 1Password no siempre se llama igual — glossa LESSONS.md
  • 2026-08-15 — op read rejects em-dashes in item titles — numora LESSONS.md
• GitHub Actions — 7 · shared across projects
  • 2026-09-25 — Measure account spend before cutting a quiet project's tests — aroma docs/LESSONS.md
  • 2026-06-27 — GitHub Actions as the job runner — radius docs/DECISIONS.md
  • 2026-09-25 — Preserve on-demand pipelines and bound CI/deployment — radius docs/DECISIONS.md
  • workflowdispatch requiere branch ref, no refs/pull/N/merge — ademas-ai docs/LESSONS.md
  • GitHub Actions + Wrangler deploy — ademas-ai docs/LESSONS.md
  • 2026-09-25 — Un monitor trasladado y un reloj vacío son gastos distintos — ademas-ai docs/LESSONS.md
  • 2026-09-25 — Superseded CI is not new quality evidence — numora LESSONS.md
• OpenAI — 7 · shared across projects
  • Verify model IDs before hard-coding them — aroma docs/LESSONS.md
  • AI image URLs need provider-aware handling — aroma docs/LESSONS.md
  • Verify image provider env before backfills — aroma docs/LESSONS.md
  • Do not force image responseformat — aroma docs/LESSONS.md
  • Image generation must fit Vercel timeout — aroma docs/LESSONS.md
  • Low-quality recipe images lose the editorial Mesa look — aroma docs/LESSONS.md
  • Match data URL MIME to generated image format — aroma docs/LESSONS.md
• Supabase (phd-kb) — 4 · shared across projects
  • Un índice parcial no puede arbitrar un ON CONFLICT — glossa LESSONS.md
  • Los 150 s de una edge function deciden el modelo, no al revés — glossa LESSONS.md
  • Una fila que se marca «en curso» necesita quién la rescate — glossa LESSONS.md
  • Las migraciones aplicadas y no commiteadas dejan un esquema irreconstruible — glossa LESSONS.md
• Cloudflare Pages — 3 · shared across projects
  • Nunca reconstruir index.html desde el JSX — ademas-ai docs/LESSONS.md
  • CDN de Cloudflare Pages cachea agresivamente — ademas-ai docs/LESSONS.md
  • JSX inline en Cloudflare Pages — no pre-compilar — ademas-ai docs/LESSONS.md
• Cloudflare — 1 · shared across projects
  • Connected provider accounts may not own the named resource — aroma docs/LESSONS.md
• Resend — 1 · shared across projects
  • Una key restringida falla distinto por camino — y el proveedor te lo dice si guardas su error — ademas-ai docs/LESSONS.md
• LLM — 21
  • Compact AI payloads at the server boundary — aroma docs/LESSONS.md
  • Every long AI endpoint needs Vercel duration and client escape hatch — aroma docs/LESSONS.md
  • Jueces con fallback: el panel externo nunca puede tirar el pipeline — ademas-ai docs/LESSONS.md
  • Council Loop — el lazo autónomo de calidad es un patrón portable, y ya tiene blueprint — ademas-ai docs/LESSONS.md
  • El feedback humano manual es la señal de los huecos del detector automático — ademas-ai docs/LESSONS.md
  • Rigor que produce un texto ilegible es rigor mal puesto — glossa LESSONS.md
  • Cuando una marca promete algo que no puedes cumplir, cambia la marca — glossa LESSONS.md
  • Un modelo que razona traduciendo es dinero quemado en pensar — glossa LESSONS.md
  • Ningún modelo acierta siempre: verifica y pasa al siguiente — glossa LESSONS.md
  • Marcarlo todo es no marcar nada — glossa LESSONS.md
  • Un ranking por volumen entierra justo lo que añadiste para no perderte — glossa LESSONS.md
  • Una compuerta barata puesta después de la cara — glossa LESSONS.md
  • Una regla que nunca se ha disparado es una regla sin probar — glossa LESSONS.md
  • El content vacío de un modelo de razonamiento no es un fallo de parseo — glossa LESSONS.md
  • fetch de Node aborta a los 300 s esperando cabeceras — glossa LESSONS.md
  • Elegir modelo por precio es elegir mal; el eje real es si aplana las distinciones — glossa LESSONS.md
  • Una regeneración parcial no debe sobrescribir a una completa — glossa LESSONS.md
  • Digerir un reporte con el prompt de un episodio le fabrica una voz — glossa LESSONS.md
  • El directorio de fuentes crece por expediente, no por fama (D-024) — glossa LESSONS.md
  • Dos señales independientes, o no se funde nada — glossa LESSONS.md
  • El 429 que no se arregla esperando — glossa LESSONS.md
• relational database — 14
  • Shared data must belong to the household, not to the member who created it — aroma docs/LESSONS.md
  • One household per person needs an index, not a LIMIT 1 — aroma docs/LESSONS.md
  • ON CONFLICT is essential for all household INSERTs — aroma docs/LESSONS.md
  • Batch the round trips, not just the statements — aroma docs/LESSONS.md
  • JWT auth en edge functions — ademas-ai docs/LESSONS.md
  • RPC updateagent — merge JSONB con || — ademas-ai docs/LESSONS.md
  • Nunca actualizar agents con anon key — ademas-ai docs/LESSONS.md
  • Verificar la hipótesis contra filas reales ANTES de codificarla — ademas-ai docs/LESSONS.md
  • Migraciones por replace() llevan guard ruidoso obligatorio — ademas-ai docs/LESSONS.md
  • Una policy RLS sin TO aplica a PUBLIC; "para el service role" sin TO servicerole abre la tabla a la anon key — ademas-ai docs/LESSONS.md
  • Una traducción vieja junto a un texto nuevo son dos revistas distintas — glossa LESSONS.md
  • La semana del lector, no la del servidor — glossa LESSONS.md
  • Una ventana relativa a «hoy» multiplica filas en vez de actualizarlas — glossa LESSONS.md
  • ON DELETE CASCADE detrás de un botón que dice «remove» — glossa LESSONS.md
• deployment / hosting — 12
  • Vercel preview deployments miss Production-only env vars — aroma docs/LESSONS.md
  • iPhone photos must be compressed before serverless upload — aroma docs/LESSONS.md
  • A background poll is the most expensive line of code in a free-tier app — aroma docs/LESSONS.md
  • Al retirar un mecanismo, auditar si su reemplazo re-embarca el mismo bug — ademas-ai docs/LESSONS.md
  • .reverse() in-place ya mordió dos veces (INV-38 y F2.1) — ademas-ai docs/LESSONS.md
  • Una función desplegada a mano es código que el siguiente despliegue borra — glossa LESSONS.md
  • redirects en la configuración pierde contra la normalización de barra final — glossa LESSONS.md
  • 2026-08-15 — Fail-closed gate from commit one — numora LESSONS.md
  • 2026-08-15 — Repo root must never be publicly served — numora LESSONS.md
  • 2026-08-15 — Git-triggered deploys land BLOCKED; API deploys build fine — numora LESSONS.md
  • 2026-08-16 — JSON values in .env.local must be single-quoted — numora LESSONS.md
  • 2026-08-16 — La caché HMR de dev inyecta cuerpos de fetch en el HTML — numora LESSONS.md
• search / benchmarking — 10
  • El parte mide lo que ENTRÓ, no lo que se vio — glossa LESSONS.md
  • La lista de subidas de un canal no es su lista de episodios — glossa LESSONS.md
  • Un filtro que trabaja en silencio es indistinguible de un descubrimiento roto — glossa LESSONS.md
  • Excluir por «fue un directo» descarta casi todo lo bueno — glossa LESSONS.md
  • YouTube sirve los subtítulos a tu ordenador y no a un servidor — glossa LESSONS.md
  • Una etiqueta de tema no es una consulta de búsqueda — glossa LESSONS.md
  • El presupuesto de búsqueda se ajusta solo mirando si los medios divergen — glossa LESSONS.md
  • Pagar una búsqueda y luego descubrir que no cabe — glossa LESSONS.md
  • Un tope que cuenta mal no es un tope — glossa LESSONS.md
  • Buscar fuera y encontrarse a uno mismo — glossa LESSONS.md
• design system — 5
  • Override --font-serif to restyle every title at once — aroma docs/LESSONS.md
  • Optimistic UI removes perceived AI/network latency — aroma docs/LESSONS.md
  • Safe area insets for iPhone — aroma docs/LESSONS.md
  • Un contador que enseña «usados» se lee como «quedan» — glossa LESSONS.md
  • Si lo decide el sistema, el panel no enseña mandos — glossa LESSONS.md
• repository / CI-CD — 4
  • La cuenta informa más que la lista — glossa LESSONS.md
  • Un contrato no viaja en frases para humanos — glossa LESSONS.md
  • Una fuente correcta y callada se lee igual que una averiada — glossa LESSONS.md
  • Un título de feed trae el eslogan pegado — glossa LESSONS.md
• CI/CD — 2
  • El canal de alerta de un sistema autónomo no puede ser uno que el humano ignora (D-15) — ademas-ai docs/LESSONS.md
  • «No arrancó» no es «falló»: lee las annotations antes de depurar código — ademas-ai docs/LESSONS.md
• credential management — 1
  • Keep partial provider configuration out of Vercel — aroma docs/LESSONS.md
• Google Apps Script — 1
  • Google Apps Script POST requests redirect — aroma docs/LESSONS.md
• user authentication — 1
  • Un claim de JWT decodificado a mano es texto del atacante — ademas-ai docs/LESSONS.md

• Provider strings flagged for vocabulary drift: Supabase (phd-kb), Moonshot. Confirm each one marks a genuinely separate account rather than a differently-worded same service.
• Bound by STANDARD-ACTIONS-BUDGET (matched on GitHub Actions) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-DOC-ENTRYPOINT (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-PUBLISHED-OUTPUT (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.

ademas.ai (AI voice assistant) ademas-ai

Standards that bind this project:

• Shared GitHub Actions budget — docs/STANDARD-ACTIONS-BUDGET.md · applies via GitHub Actions · configuration integrated on 2026-09-25 · first unblocked GitHub execution and measured savings pending · no conforms_to declared

  ci_cd:
    provider: GitHub Actions
    capability: CI/CD
    implemented_in: .github/workflows/deploy.yml
    conforms_to: STANDARD-ACTIONS-BUDGET

• Standard — Twilio OTP / SMS anti-abuse — docs/STANDARD-TWILIO-OTP.md · applies via Twilio · active since 2026-08-10 · no conforms_to declared

  messaging:
    provider: Twilio
    capability: SMS
    implemented_in: supabase/functions/send-message/index.ts
    conforms_to: STANDARD-TWILIO-OTP

Already solved elsewhere in the portfolio:

• relational database — already built in aroma → api/_lib/db.js · radius → docs/ARCHITECTURE.md · thesis → phd-agents/sql/ · glossa → docs/11-Integracion-phd-kb.md · merit → web/src/lib/supabase-admin.ts · numora → lib/db.ts. Read it before writing your own.
• transactional email — already built in thesis → phd-agents/weekly_digest/main.py · glossa → scripts/boletin_from_supabase.mjs · numora → lib/email.ts. Read it before writing your own.
• design system — you have your own in inbox/index.html, and there are 6 more in the portfolio: aroma → docs/ARCHITECTURE.md · radius → docs/DECISIONS.md · thesis → pwa/WEBAPP-MEMORY.md · glossa → src/styles/global.css · merit → web/src/app/globals.css · numora → 04-UI-Visual-Specification.md. Worth comparing before the next change to yours.
• chat interface — you have your own in inbox/app.jsx, and there are 2 more in the portfolio: merit → web/src/app/inbox/f/[friendshipId]/page.tsx · numora → app/app/three-panel.tsx. Worth comparing before the next change to yours.
• progressive web app — you have your own in inbox/manifest.json, and there is 1 more in the portfolio: thesis → pwa/. Worth comparing before the next change to yours.
• mobile web UI — you have your own in inbox/index.html, and there are 3 more in the portfolio: aroma → src/index.css · merit → web/src/components/ChildTabBar.tsx · numora → app/app/layout.tsx. Worth comparing before the next change to yours.
• admin UI — you have your own in console/index.html, and there is 1 more in the portfolio: radius → site/. Worth comparing before the next change to yours.
• credential management — already built in thesis → phd-agents/docs/RECOVERY-SECRETS.md. Read it before writing your own.

External material found for your open items — proposals, not instructions: nothing here was verified against a repository

• How We Achieved 99.99% Reliability At Vapi - Vapi AI Blog undated — Directly addresses Vapi automatic failover implementation with concrete reliability metrics and architecture details.
• Claude Sonnet 5 Pricing Locked at $2/$10 undated — Clearly states Anthropic canceled the price increase, making intro pricing permanent instead of ending 08-31.
• Best practice for handling auth token refresh in a frontend app? · community · Discussion #184563 · GitHub undated — Addresses token refresh handling and 401 error interception directly relevant to frontend migration.
• BYOK (Store Keys) · Cloudflare AI Gateway docs undated — Confirms BYOK feature exists and is free, directly supporting the decision's cost rationale.
• Top 5 AI Gateways to Monitor and Control the Costs of LLMs undated — Bifrost directly addresses multi-provider key consolidation, cost tracking, and unified API gateway needs.
• A2P 10DLC - Standard and Low-Volume Standard Brand Onboarding Guide for ISVs | Twilio undated — Result [1] directly addresses campaign compliance requirements and January 30, 2025 deadline for older campaigns.
• Create Message Templates for Your WhatsApp Business ... undated — Provides step-by-step instructions to create message templates in Meta Business Suite directly.
• Configure the customer portal undated — Provides step-by-step Dashboard configuration instructions without requiring browser automation.

Lessons from other projects that touch what you use (264, grouped by what matched):

• Supabase — 39 · shared across projects
  • Neon DB column names mismatch with API routes — aroma docs/LESSONS.md
  • Supabase .delete() silently failed when RLS blocked — aroma docs/LESSONS.md
  • RLS self-referencing subqueries cause infinite recursion — aroma docs/LESSONS.md
  • Missing RLS policies = silent access denial — aroma docs/LESSONS.md
  • SECURITY DEFINER functions — aroma docs/LESSONS.md
  • RLS policy changes take effect immediately — aroma docs/LESSONS.md
  • 2026-06-26 — Neon Postgres over Supabase — radius docs/DECISIONS.md
  • 22-sep-2026 · Un recuerdo largo no debe bloquear toda la memoria — thesis LESSONS.md
  • La RLS de una tabla no protege las funciones que la leen con privilegios — thesis LESSONS.md
  • La bibliografía puede bloquearse aunque el corpus y la exportación funcionen — thesis LESSONS.md
  • Buscar fuera puede perpetuar un faltante cuyo original ya está en el corpus — thesis LESSONS.md
  • Una cola sin documentos nuevos puede tardar en volver a verificar lo ya completo — thesis LESSONS.md
  • Un pasaje existente puede quedar fuera de la muestra que recibe el revisor — thesis LESSONS.md
  • Una vista previa fallida puede parecer un libro completo por sus referencias — thesis LESSONS.md
  • Un PDF oficial puede carecer de los metadatos que sí tiene su registro editorial — thesis LESSONS.md
  • El último dictamen no sustituye el historial consultivo — thesis LESSONS.md
  • Conservar el cotejo documental después de resolver el faltante — thesis LESSONS.md
  • El último correo guardado no demuestra que el buzón esté procesado — thesis LESSONS.md
  • Una respuesta pagada necesita un recibo antes de repetir el correo — thesis LESSONS.md
  • Una cita revisada puede seguir fuera de la biblioteca — thesis LESSONS.md
  • El recibo de ingesta debe volver al borrador que usa la fuente — thesis LESSONS.md
  • Un diagnóstico guardado necesita una transición de recuperación — thesis LESSONS.md
  • Un latido que dice «partial» ante cualquier error deja de avisar de nada — thesis LESSONS.md
  • «Hay trabajo pendiente» calculado con intentos vencidos casi siempre da sí — thesis LESSONS.md
  • Si las preguntas están en un idioma y el corpus en otro, la ordenación no lo arregla — thesis LESSONS.md
  • Arreglar el buscador no arregla a quien no lo usa — thesis LESSONS.md
  • Una sonda puede parecer una regresión de búsqueda si recorta sus respuestas esperadas — thesis LESSONS.md
  • Una caché escrita después del modelo no impide compras concurrentes ni permite conciliar gasto — thesis LESSONS.md
  • La selección revisada no corrige automáticamente el resumen antiguo del catálogo — thesis LESSONS.md
  • Una fecha reciente del espejo puede ser solo una reescritura sin cambios — thesis LESSONS.md
  • 2026-09-21 · Una etiqueta de cita no es una lista completa de autores — thesis LESSONS.md
  • 2026-09-21 · La referencia debe citar la versión consultada — thesis LESSONS.md
  • 2026-09-21 · Actualizar preparación tras publicar bibliografía — thesis LESSONS.md
  • 2026-09-22 · Una búsqueda fallida no invalida el original ya ingerido — thesis LESSONS.md
  • 2.1 Management PAT (sbp) vs servicerole JWT (eyJhbG) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.2 RLS status actual (abr-2026) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.3 CHECK constraint en evaluateditems.actiontag — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.4 Trigger BEFORE INSERT en evaluateditems — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2026-08-20 — "Sin secretos en el repo" no es lo mismo que mínimo privilegio — glossa docs/09-Decisiones-Abiertas.md
• GitHub Actions — 32 · shared across projects
  • 2026-09-25 — Measure account spend before cutting a quiet project's tests — aroma docs/LESSONS.md
  • 2026-06-27 — GitHub Actions as the job runner — radius docs/DECISIONS.md
  • 2026-09-25 — Preserve on-demand pipelines and bound CI/deployment — radius docs/DECISIONS.md
  • Un workflow en verde puede no haber hecho su trabajo — thesis LESSONS.md
  • El auditor automático también deriva — átalo a su fuente con un test — thesis LESSONS.md
  • Las guardas de un camino que nunca se ha ejecutado son hipótesis, no guardas — thesis LESSONS.md
  • Un grep de cordura sobre un artefacto binario puede pasar por accidente — thesis LESSONS.md
  • Dos componentes que miden lo mismo con umbrales propios acaban contradiciéndose — thesis LESSONS.md
  • Un pedido explícito no puede quedar a merced de la clasificación automática que le sigue — thesis LESSONS.md
  • Un consumidor que lee «las N más nuevas» pierde en silencio lo que cae por debajo de N — thesis LESSONS.md
  • Ordenar una cola no concentra el trabajo en terminar su primera unidad — thesis LESSONS.md
  • Un evento omitido no debe renovar el aplazamiento del siguiente — thesis LESSONS.md
  • Una búsqueda general y «la última petición» pueden ocultar faltantes de otros conceptos — thesis LESSONS.md
  • Una comprobación que termina sin trabajar también puede cancelar trabajo pendiente — thesis LESSONS.md
  • Una cola de avisos no es la cola de trabajo — thesis LESSONS.md
  • Un cron activo de GitHub no garantiza que haya ocurrido una pasada — thesis LESSONS.md
  • El último listado de ejecuciones puede ocultar un aviso atascado desde el día anterior — thesis LESSONS.md
  • Una comprobación omitida no debe despertar toda la cadena — thesis LESSONS.md
  • Una sonda de calidad en el mismo paso de shell apagó un agente que no tenía nada que ver — thesis LESSONS.md
  • En CI de pago, el coste lo multiplican las cadenas de disparos, no el trabajo — thesis LESSONS.md
  • Una prueba que el equipo conoce deja de medir en cuanto se optimiza contra ella — thesis LESSONS.md
  • Reanudar un objetivo antiguo puede repetir trabajo ya terminado en otra superficie — thesis LESSONS.md
  • Una cola vacía puede agotar consultas del gestor de secretos — thesis LESSONS.md
  • Un coordinador compartido necesita latidos que identifiquen el trabajo realmente realizado — thesis LESSONS.md
  • 2026-09-21 · Filtrar trabajo editorial por los archivos que realmente cuentan — thesis LESSONS.md
  • 2026-09-25 · El minuto más barato es el proceso que no se despierta — thesis LESSONS.md
  • 2026-09-26 · El vigilante no puede vivir donde vive lo que vigila — thesis LESSONS.md
  • 2026-09-26 · Lo que se apaga en silencio mientras nada corre — thesis LESSONS.md
  • 3.1 Delay entre push y trigger — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 3.2 YAML en heredocs con Python inline — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 3.3 Log fetch con DNS cache overflow — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2026-09-25 — Superseded CI is not new quality evidence — numora LESSONS.md
• Anthropic — 25 · shared across projects
  • Verify model IDs before hard-coding them — aroma docs/LESSONS.md
  • Source URL hallucination — aroma docs/LESSONS.md
  • Extended thinking adds latency without quality gain for structured JSON — aroma docs/LESSONS.md
  • Upstream AI calls must abort before the function's maxDuration — aroma docs/LESSONS.md
  • AI Provider API Syntax & Limits — a fix that expired — aroma docs/LESSONS.md
  • A timeout that fits the common case hides the failing one — aroma docs/LESSONS.md
  • The newer tool version is not the cheaper one — aroma docs/LESSONS.md
  • 2026-07-07 — Mockup layer removed — radius docs/DECISIONS.md
  • El tracking de costos miente si no refleja precios promocionales y de lanzamiento — thesis LESSONS.md
  • Los topes de gasto declarados deben saltar ANTES que el tope del proveedor — thesis LESSONS.md
  • claude-opus-5 rechaza temperature con 400 — y los clientes viejos no lo saben — thesis LESSONS.md
  • La contabilidad idempotente no impide pagar dos peticiones idénticas — thesis LESSONS.md
  • Consultar los recibos antes de ampliar una revisión truncada — thesis LESSONS.md
  • Una respuesta mal formada puede costar aunque el resumen diga cero — thesis LESSONS.md
  • Un límite de revisiones puede dejar la última corrección sin comprobar — thesis LESSONS.md
  • Una ruta económica de curación no cambia los revisores de investigación — thesis LESSONS.md
  • Consultar hoy no significa tener el gasto de hoy — thesis LESSONS.md
  • Un comité necesita recuperar opiniones, no repetir la consulta completa — thesis LESSONS.md
  • Una revisión bilingüe aprobada puede esconder una ampliación normativa y un componente vacío — thesis LESSONS.md
  • Un límite de salida económico puede pagar razonamiento y no recibir ningún veredicto — thesis LESSONS.md
  • La síntesis del buscador puede contaminar una ficha aunque el extracto correcto esté guardado — thesis LESSONS.md
  • Un esquema válido para OpenAI puede impedir que arranque el revisor Anthropic — thesis LESSONS.md
  • 23-sep-2026 · Actualizar un modelo sin recomprar trabajos ni inventar equivalencias — thesis LESSONS.md
  • 2026-08-21 — Un modelo prefiere el metadato al contenido, y eso rompe la atribución — glossa docs/09-Decisiones-Abiertas.md
  • 2026-08-15 — Sonnet 5 emits thinking blocks before text — numora LESSONS.md
• 1Password — 17 · shared across projects
  • 1Password Environments are separate from ordinary vault items — aroma docs/LESSONS.md
  • Vercel Development does not support Sensitive variables — aroma docs/LESSONS.md
  • 1Password local env mounts are FIFO streams — aroma docs/LESSONS.md
  • Capture one-time provider secrets before closing the confirmation page — aroma docs/LESSONS.md
  • Reusing one secret across trust domains multiplies the blast radius — aroma docs/LESSONS.md
  • Los campos nuevos de 1Password caen dentro de una sección — y op read por ruta corta no los ve — thesis LESSONS.md
  • Las credenciales innecesarias pueden agotar la cuota compartida de 1Password — thesis LESSONS.md
  • Un fallo del almacén de credenciales no debe agotar los intentos de investigación — thesis LESSONS.md
  • Una etiqueta de 1Password no identifica un campo de forma única — thesis LESSONS.md
  • El espejo documental necesita recuperación aunque no haya otra edición — thesis LESSONS.md
  • 1.1 load-secrets-action@v2 con export-env: true no propaga — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.2 Nombres de items con espacios — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.3 Campos duplicados → error "more than one X field" — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.4 Arquitectura de items del proyecto — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Una clave nueva no separa la cuota; hay que separar la cuenta — glossa LESSONS.md
  • El campo de 1Password no siempre se llama igual — glossa LESSONS.md
  • 2026-08-15 — op read rejects em-dashes in item titles — numora LESSONS.md
• Twilio — 5 · shared across projects
  • Keep partial provider configuration out of Vercel — aroma docs/LESSONS.md
  • Twilio Verify code length is service-scoped — aroma docs/LESSONS.md
  • Phone auth needs both Verify and an SMS sender — aroma docs/LESSONS.md
  • The OTP guard only protects the endpoint it is wired into — aroma docs/LESSONS.md
  • 2026-06-27 — Phone = account — radius docs/DECISIONS.md
• Cloudflare Pages — 3 · shared across projects
  • Un deploy que publica «todo el repo menos X» termina publicando lo que no debía — thesis LESSONS.md
  • Borrar el service worker de un sitio NO desinstala el de los teléfonos — publica uno «de despedida» — thesis LESSONS.md
  • Cablear la interfaz ANTES de la primera llamada de red — thesis LESSONS.md
• Stripe — 3 · shared across projects
  • Keep Stripe live and sandbox credentials explicit — aroma docs/LESSONS.md
  • Webhook signatures cover bytes, not objects — aroma docs/LESSONS.md
  • 2026-07-01 — Stripe with dynamic pricedata — radius docs/DECISIONS.md
• Cloudflare — 1 · shared across projects
  • Connected provider accounts may not own the named resource — aroma docs/LESSONS.md
• Resend — 1 · shared across projects
  • Un informe diario sellado en UTC llega con la fecha de mañana — thesis LESSONS.md
• LLM — 84
  • Compact AI payloads at the server boundary — aroma docs/LESSONS.md
  • Every long AI endpoint needs Vercel duration and client escape hatch — aroma docs/LESSONS.md
  • 21-sep-2026 · Ahorrar por horario sin alterar calidad ni reintentos — thesis LESSONS.md
  • 21-sep-2026 · Reproducir pruebas antes de comprar otra comparación — thesis LESSONS.md
  • 21-sep-2026 · Reparaciones invisibles al contador de costes — thesis LESSONS.md
  • 21-sep-2026 · Piloto 1.1 y comprobación de modelos por sección — thesis LESSONS.md
  • 2026-09-21 — Un fallo de API no puntúa calidad ni demuestra gratuidad — thesis LESSONS.md
  • 2026-09-21 — Los recibos necesitan una cola que vuelva a encontrarlos — thesis LESSONS.md
  • 2026-09-21 — Recuperar un panel sin fabricar votos ni gasto nuevo — thesis LESSONS.md
  • 2026-09-21 — Una corrección automática incluye su prueba — thesis LESSONS.md
  • Gemini 3.x «razona» gastando maxOutputTokens — con tope corto el texto llega vacío — thesis LESSONS.md
  • Un tope de gasto que no está en la ruta caliente no frena nada — thesis LESSONS.md
  • Con razonamiento adaptativo, maxtokens es también el presupuesto del pensamiento — thesis LESSONS.md
  • Un evaluador puede confundir preparación bibliográfica con resultados todavía por producir — thesis LESSONS.md
  • Esperar un lote no es un fallo semántico ni permiso para volver a pagarlo — thesis LESSONS.md
  • El título publicado también necesita una revisión de evidencia — thesis LESSONS.md
  • Un comité puede convertir una ambigüedad en una restricción inexistente — thesis LESSONS.md
  • Revisar una respuesta no confirma las correcciones del revisor — thesis LESSONS.md
  • Una respuesta cortada puede costar más que un presupuesto de salida suficiente — thesis LESSONS.md
  • Añadir el rechazo al mensaje inicial puede volver a cobrar un borrador idéntico — thesis LESSONS.md
  • El revisor puede aprobar sus propias correcciones y agotar todos los intentos — thesis LESSONS.md
  • Cambiar el diagnóstico puede volver a cobrar una selección ya generada — thesis LESSONS.md
  • El evaluador necesita la misma fecha de corte y las mismas decisiones — thesis LESSONS.md
  • Menos objeciones no demuestra que una corrección esté terminada — thesis LESSONS.md
  • Un límite corto puede duplicar el coste de una revisión experta — thesis LESSONS.md
  • Cambiar de día no debe recomprar una investigación idéntica — thesis LESSONS.md
  • Una revisión positiva debe justificar cada requisito de preparación — thesis LESSONS.md
  • Los análisis dependientes deben esperar a la selección revisada — thesis LESSONS.md
  • Una espera debe identificar la solicitud que sigue pendiente — thesis LESSONS.md
  • Un ensayo de modelos debe validar primero su propio contrato — thesis LESSONS.md
  • Un agregador no garantiza ni el mismo precio ni la misma disponibilidad — thesis LESSONS.md
  • Las citas literales requieren distinguir tipografía de contenido inventado — thesis LESSONS.md
  • Dos revisores de acuerdo pueden aprobar una cita que perdió su negación — thesis LESSONS.md
  • El precio de un modelo no es el costo de obtener su resultado útil — thesis LESSONS.md
  • Un defecto del banco de pruebas se puede confundir con un fallo del modelo — thesis LESSONS.md
  • Una recomendación rechazada necesita una corrección distinta antes de otra revisión — thesis LESSONS.md
  • Un árbitro de frontera puede aceptar el error que detecta un modelo intermedio — thesis LESSONS.md
  • 2026-09-14 — Grok consistente también puede omitir un error; costos de capítulo y operación separados — thesis LESSONS.md
  • El artefacto revisado y el que se muestra deben tener la misma huella — thesis LESSONS.md
  • Un bloqueo terminal puede ocultar una etapa del evaluador que nunca se ejecutó — thesis LESSONS.md
  • Un modo de render sin modelos puede pagar al refrescar evidencia antes de su bifurcación — thesis LESSONS.md
  • El orden accidental de los pasajes puede volver a comprar la misma investigación — thesis LESSONS.md
  • Un rechazo que solo enumera aciertos no justifica comprar otra redacción — thesis LESSONS.md
  • Mover una comprobación gratuita puede invalidar llamadas ya pagadas si cambia la secuencia congelada — thesis LESSONS.md
  • 2026-09-21 · Repetir respuestas no añade independencia al comité — thesis LESSONS.md
  • 2026-09-21 · Separar vigencia de precios, pruebas y autorización — thesis LESSONS.md
  • 2026-09-21 · Evaluar una cadena, no contar llamadas como éxitos — thesis LESSONS.md
  • 2026-09-21 · Evaluar al revisor con la entrada exacta, no solo su diagnóstico — thesis LESSONS.md
  • 2026-09-21 · Una objeción corregida puede citar el texto que ya se eliminó — thesis LESSONS.md
  • 2026-09-21 · Medir la reparación y distinguir verdad de edición — thesis LESSONS.md
  • 2026-09-21 · Una evaluación terminada puede retener la reutilización — thesis LESSONS.md
  • 2026-09-21 · Parámetros reales y presupuesto entre variantes — thesis LESSONS.md
  • 2026-09-21 · El presupuesto de salida también contiene razonamiento — thesis LESSONS.md
  • 2026-09-21 · Controles breves correctos no acreditan coherencia del análisis — thesis LESSONS.md
  • 2026-09-21 · Verificar el alcance efectivo de las instrucciones de evaluación — thesis LESSONS.md
  • 2026-09-21 · Una pregunta futura no exige un caso ya demostrado — thesis LESSONS.md
  • 2026-09-21 · Localizar la cita antes de recomprar la revisión — thesis LESSONS.md
  • 2026-09-21 · El replay debe demostrar que no puede volver a pagar — thesis LESSONS.md
  • 2026-09-21 · Probar el recorrido instalado y conservar la incertidumbre por separado — thesis LESSONS.md
  • 2026-09-21 · Conciliar el resumen vigente al conservar una cronología — thesis LESSONS.md
  • 2026-09-21 · Conservar la entrada antes de esperar un lote — thesis LESSONS.md
  • 2026-09-22 · Separar fecha del extracto y actualización de una página viva — thesis LESSONS.md
  • 2026-09-22 · Contexto de agentes: reducir detalle sin perder vigencia — thesis LESSONS.md
  • 2026-09-22 · Un cambio de interfaz no renueva una aprobación académica — thesis LESSONS.md
  • 2026-09-22 · Un rechazo terminal protege la misma evidencia, no congela la nueva — thesis LESSONS.md
  • 2026-09-23 · Hipótesis sustantiva y validación del instrumento no son la misma prueba — thesis LESSONS.md
  • Rigor que produce un texto ilegible es rigor mal puesto — glossa LESSONS.md
  • Cuando una marca promete algo que no puedes cumplir, cambia la marca — glossa LESSONS.md
  • Un modelo que razona traduciendo es dinero quemado en pensar — glossa LESSONS.md
  • Ningún modelo acierta siempre: verifica y pasa al siguiente — glossa LESSONS.md
  • Marcarlo todo es no marcar nada — glossa LESSONS.md
  • Un ranking por volumen entierra justo lo que añadiste para no perderte — glossa LESSONS.md
  • Una compuerta barata puesta después de la cara — glossa LESSONS.md
  • Una regla que nunca se ha disparado es una regla sin probar — glossa LESSONS.md
  • El content vacío de un modelo de razonamiento no es un fallo de parseo — glossa LESSONS.md
  • fetch de Node aborta a los 300 s esperando cabeceras — glossa LESSONS.md
  • Elegir modelo por precio es elegir mal; el eje real es si aplana las distinciones — glossa LESSONS.md
  • Una regeneración parcial no debe sobrescribir a una completa — glossa LESSONS.md
  • Un filtro que trabaja en silencio es indistinguible de un descubrimiento roto — glossa LESSONS.md
  • Una etiqueta de tema no es una consulta de búsqueda — glossa LESSONS.md
  • Digerir un reporte con el prompt de un episodio le fabrica una voz — glossa LESSONS.md
  • El directorio de fuentes crece por expediente, no por fama (D-024) — glossa LESSONS.md
  • Dos señales independientes, o no se funde nada — glossa LESSONS.md
  • El 429 que no se arregla esperando — glossa LESSONS.md
• relational database — 26
  • Shared data must belong to the household, not to the member who created it — aroma docs/LESSONS.md
  • One household per person needs an index, not a LIMIT 1 — aroma docs/LESSONS.md
  • ON CONFLICT is essential for all household INSERTs — aroma docs/LESSONS.md
  • Batch the round trips, not just the statements — aroma docs/LESSONS.md
  • Una escritura cuyo código de retorno se descarta convierte una deriva de esquema en corrupción silenciosa — thesis LESSONS.md
  • Si una decisión puede mutar el dato, la marcha atrás tiene que cubrirla — thesis LESSONS.md
  • Deshabilitar una credencial no surte efecto al instante — y una espera fija vuelve permanente el rollback — thesis LESSONS.md
  • Un ANALYZE sobre una tabla de vectores puede tumbar TODO el REST del proyecto — thesis LESSONS.md
  • Una migración vieja que recrea un constraint estrecha lo que una nueva amplió — y «recrear si no existe» tampoco salva — thesis LESSONS.md
  • Un índice que cubre búsquedas puede atascar un recuento de control — thesis LESSONS.md
  • La cuota de un buscador no debe detener toda la investigación — thesis LESSONS.md
  • Un resultado de búsqueda pobre no vuelve ajeno un tema pertinente — thesis LESSONS.md
  • Un enlace alternativo bloqueado no exige volver a descargar el mismo texto oficial — thesis LESSONS.md
  • Una URL corregida debe conservar la identidad de la solicitud — thesis LESSONS.md
  • Un espejo necesita comprobar el contenido y el contrato de estados — thesis LESSONS.md
  • Conciliar los borradores preparados antes de volver a generarlos — thesis LESSONS.md
  • Comparar fechas serializadas como texto inventa fallos después de una escritura correcta — thesis LESSONS.md
  • CI puede verificar una versión histórica del monitor de crédito y omitir la desplegada — thesis LESSONS.md
  • 2026-09-21 · Un espejo necesita catálogo y disparador del consumidor — thesis LESSONS.md
  • Una traducción vieja junto a un texto nuevo son dos revistas distintas — glossa LESSONS.md
  • La semana del lector, no la del servidor — glossa LESSONS.md
  • Un índice parcial no puede arbitrar un ON CONFLICT — glossa LESSONS.md
  • Una fila que se marca «en curso» necesita quién la rescate — glossa LESSONS.md
  • Una ventana relativa a «hoy» multiplica filas en vez de actualizarlas — glossa LESSONS.md
  • ON DELETE CASCADE detrás de un botón que dice «remove» — glossa LESSONS.md
  • Las migraciones aplicadas y no commiteadas dejan un esquema irreconstruible — glossa LESSONS.md
• deployment / hosting — 13
  • Vercel preview deployments miss Production-only env vars — aroma docs/LESSONS.md
  • iPhone photos must be compressed before serverless upload — aroma docs/LESSONS.md
  • A background poll is the most expensive line of code in a free-tier app — aroma docs/LESSONS.md
  • 2026-09-21 · El despliegue debe conservar el árbol de imports — thesis LESSONS.md
  • 4.1 Service worker cache busting — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Una función desplegada a mano es código que el siguiente despliegue borra — glossa LESSONS.md
  • Los 150 s de una edge function deciden el modelo, no al revés — glossa LESSONS.md
  • redirects en la configuración pierde contra la normalización de barra final — glossa LESSONS.md
  • 2026-08-15 — Fail-closed gate from commit one — numora LESSONS.md
  • 2026-08-15 — Repo root must never be publicly served — numora LESSONS.md
  • 2026-08-15 — Git-triggered deploys land BLOCKED; API deploys build fine — numora LESSONS.md
  • 2026-08-16 — JSON values in .env.local must be single-quoted — numora LESSONS.md
  • 2026-08-16 — La caché HMR de dev inyecta cuerpos de fetch en el HTML — numora LESSONS.md
• mobile web UI — 7
  • A list that never refetches looks exactly like a sync bug — aroma docs/LESSONS.md
  • iOS Safari ignores an SVG apple-touch-icon — aroma docs/LESSONS.md
  • Optimistic UI removes perceived AI/network latency — aroma docs/LESSONS.md
  • Stock inline edit needs blur save on iPhone — aroma docs/LESSONS.md
  • Safe area insets for iPhone — aroma docs/LESSONS.md
  • Clipboard paste on iPhone requires onPaste handler — aroma docs/LESSONS.md
  • A 200 in the logs does not mean the phone got the answer — aroma docs/LESSONS.md
• design system — 3
  • Override --font-serif to restyle every title at once — aroma docs/LESSONS.md
  • Un contador que enseña «usados» se lee como «quedan» — glossa LESSONS.md
  • Si lo decide el sistema, el panel no enseña mandos — glossa LESSONS.md
• backup / mirror — 2
  • Una cuenta de servicio no puede CREAR archivos en un Drive personal, pero sí mover y renombrar los ajenos — thesis LESSONS.md
  • 19-sep-2026 · Memoria vigente breve y archivo íntegro — thesis LESSONS.md
• billing / payments — 1
  • 2026-06-28 — Prepaid estimate ledger — radius docs/DECISIONS.md
• credential management — 1
  • External Mesa renames need owner-level write credentials — aroma docs/LESSONS.md
• progressive web app — 1
  • Reproducir audio después de esperar la red cae fuera del gesto — iOS lo veta en silencio — thesis LESSONS.md

• Provider strings flagged for vocabulary drift: Supabase (ademas-ai). Confirm each one marks a genuinely separate account rather than a differently-worded same service.
• Bound by STANDARD-ACTIONS-BUDGET (matched on GitHub Actions) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-TWILIO-OTP (matched on Twilio) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.

Glossa (bilingual publication layer over phd-kb) glossa

Standards that bind this project:

• Shared GitHub Actions budget — docs/STANDARD-ACTIONS-BUDGET.md · applies via GitHub Actions · configuration integrated on 2026-09-25 · first unblocked GitHub execution and measured savings pending · no conforms_to declared

  monitoring:
    provider: GitHub Actions
    capability: monitoring / health checks
    implemented_in: scripts/vigilante_from_supabase.mjs
    conforms_to: STANDARD-ACTIONS-BUDGET

• Standard — one canonical entrypoint, never two copies — docs/STANDARD-DOC-ENTRYPOINT.md · applies via GitHub · active since 2026-08-21 · conformance declared
• Standard — every published output needs a verified consumer — docs/STANDARD-PUBLISHED-OUTPUT.md · applies via GitHub · active since 2026-08-21 · conformance declared

Already solved elsewhere in the portfolio:

• credential management — already built in thesis → phd-agents/docs/RECOVERY-SECRETS.md. Read it before writing your own.
• design system — you have your own in src/styles/global.css, and there are 6 more in the portfolio: aroma → docs/ARCHITECTURE.md · radius → docs/DECISIONS.md · thesis → pwa/WEBAPP-MEMORY.md · ademas-ai → inbox/index.html · merit → web/src/app/globals.css · numora → 04-UI-Visual-Specification.md. Worth comparing before the next change to yours.

Lessons from other projects that touch what you use (264, grouped by what matched):

• Supabase — 42 · shared across projects
  • Neon DB column names mismatch with API routes — aroma docs/LESSONS.md
  • Supabase .delete() silently failed when RLS blocked — aroma docs/LESSONS.md
  • RLS self-referencing subqueries cause infinite recursion — aroma docs/LESSONS.md
  • Missing RLS policies = silent access denial — aroma docs/LESSONS.md
  • SECURITY DEFINER functions — aroma docs/LESSONS.md
  • RLS policy changes take effect immediately — aroma docs/LESSONS.md
  • 2026-06-26 — Neon Postgres over Supabase — radius docs/DECISIONS.md
  • 22-sep-2026 · Un recuerdo largo no debe bloquear toda la memoria — thesis LESSONS.md
  • La RLS de una tabla no protege las funciones que la leen con privilegios — thesis LESSONS.md
  • La bibliografía puede bloquearse aunque el corpus y la exportación funcionen — thesis LESSONS.md
  • Buscar fuera puede perpetuar un faltante cuyo original ya está en el corpus — thesis LESSONS.md
  • Una cola sin documentos nuevos puede tardar en volver a verificar lo ya completo — thesis LESSONS.md
  • Un pasaje existente puede quedar fuera de la muestra que recibe el revisor — thesis LESSONS.md
  • Una vista previa fallida puede parecer un libro completo por sus referencias — thesis LESSONS.md
  • Un PDF oficial puede carecer de los metadatos que sí tiene su registro editorial — thesis LESSONS.md
  • El último dictamen no sustituye el historial consultivo — thesis LESSONS.md
  • Conservar el cotejo documental después de resolver el faltante — thesis LESSONS.md
  • El último correo guardado no demuestra que el buzón esté procesado — thesis LESSONS.md
  • Una respuesta pagada necesita un recibo antes de repetir el correo — thesis LESSONS.md
  • Una cita revisada puede seguir fuera de la biblioteca — thesis LESSONS.md
  • El recibo de ingesta debe volver al borrador que usa la fuente — thesis LESSONS.md
  • Un diagnóstico guardado necesita una transición de recuperación — thesis LESSONS.md
  • Un latido que dice «partial» ante cualquier error deja de avisar de nada — thesis LESSONS.md
  • «Hay trabajo pendiente» calculado con intentos vencidos casi siempre da sí — thesis LESSONS.md
  • Si las preguntas están en un idioma y el corpus en otro, la ordenación no lo arregla — thesis LESSONS.md
  • Arreglar el buscador no arregla a quien no lo usa — thesis LESSONS.md
  • Una sonda puede parecer una regresión de búsqueda si recorta sus respuestas esperadas — thesis LESSONS.md
  • Una caché escrita después del modelo no impide compras concurrentes ni permite conciliar gasto — thesis LESSONS.md
  • La selección revisada no corrige automáticamente el resumen antiguo del catálogo — thesis LESSONS.md
  • Una fecha reciente del espejo puede ser solo una reescritura sin cambios — thesis LESSONS.md
  • 2026-09-21 · Una etiqueta de cita no es una lista completa de autores — thesis LESSONS.md
  • 2026-09-21 · La referencia debe citar la versión consultada — thesis LESSONS.md
  • 2026-09-21 · Actualizar preparación tras publicar bibliografía — thesis LESSONS.md
  • 2026-09-22 · Una búsqueda fallida no invalida el original ya ingerido — thesis LESSONS.md
  • 2.1 Management PAT (sbp) vs servicerole JWT (eyJhbG) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.2 RLS status actual (abr-2026) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.3 CHECK constraint en evaluateditems.actiontag — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.4 Trigger BEFORE INSERT en evaluateditems — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Los grants por defecto de Postgres/Supabase hacen pública toda función nueva — ademas-ai docs/LESSONS.md
  • Añadir metadata a una fila rompe a quien la barría por metadata IS NULL — ademas-ai docs/LESSONS.md
  • Un JSONB de ajustes que se reescribe entero con una copia leída antes pierde datos en silencio — ademas-ai docs/LESSONS.md
  • Una sonda de salud pesada no sirve para vigilar cada 5 minutos; la de hoy tardó 26 min en no avisar — ademas-ai docs/LESSONS.md
• GitHub Actions — 36 · shared across projects
  • 2026-09-25 — Measure account spend before cutting a quiet project's tests — aroma docs/LESSONS.md
  • 2026-06-27 — GitHub Actions as the job runner — radius docs/DECISIONS.md
  • 2026-09-25 — Preserve on-demand pipelines and bound CI/deployment — radius docs/DECISIONS.md
  • Un workflow en verde puede no haber hecho su trabajo — thesis LESSONS.md
  • El auditor automático también deriva — átalo a su fuente con un test — thesis LESSONS.md
  • Las guardas de un camino que nunca se ha ejecutado son hipótesis, no guardas — thesis LESSONS.md
  • Un grep de cordura sobre un artefacto binario puede pasar por accidente — thesis LESSONS.md
  • Dos componentes que miden lo mismo con umbrales propios acaban contradiciéndose — thesis LESSONS.md
  • Un pedido explícito no puede quedar a merced de la clasificación automática que le sigue — thesis LESSONS.md
  • Un consumidor que lee «las N más nuevas» pierde en silencio lo que cae por debajo de N — thesis LESSONS.md
  • Ordenar una cola no concentra el trabajo en terminar su primera unidad — thesis LESSONS.md
  • Un evento omitido no debe renovar el aplazamiento del siguiente — thesis LESSONS.md
  • Una búsqueda general y «la última petición» pueden ocultar faltantes de otros conceptos — thesis LESSONS.md
  • Una comprobación que termina sin trabajar también puede cancelar trabajo pendiente — thesis LESSONS.md
  • Una cola de avisos no es la cola de trabajo — thesis LESSONS.md
  • Un cron activo de GitHub no garantiza que haya ocurrido una pasada — thesis LESSONS.md
  • El último listado de ejecuciones puede ocultar un aviso atascado desde el día anterior — thesis LESSONS.md
  • Una comprobación omitida no debe despertar toda la cadena — thesis LESSONS.md
  • Una sonda de calidad en el mismo paso de shell apagó un agente que no tenía nada que ver — thesis LESSONS.md
  • En CI de pago, el coste lo multiplican las cadenas de disparos, no el trabajo — thesis LESSONS.md
  • Una prueba que el equipo conoce deja de medir en cuanto se optimiza contra ella — thesis LESSONS.md
  • Reanudar un objetivo antiguo puede repetir trabajo ya terminado en otra superficie — thesis LESSONS.md
  • Una cola vacía puede agotar consultas del gestor de secretos — thesis LESSONS.md
  • Un coordinador compartido necesita latidos que identifiquen el trabajo realmente realizado — thesis LESSONS.md
  • 2026-09-21 · Filtrar trabajo editorial por los archivos que realmente cuentan — thesis LESSONS.md
  • 2026-09-25 · El minuto más barato es el proceso que no se despierta — thesis LESSONS.md
  • 2026-09-26 · El vigilante no puede vivir donde vive lo que vigila — thesis LESSONS.md
  • 2026-09-26 · Lo que se apaga en silencio mientras nada corre — thesis LESSONS.md
  • 3.1 Delay entre push y trigger — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 3.2 YAML en heredocs con Python inline — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 3.3 Log fetch con DNS cache overflow — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • workflowdispatch requiere branch ref, no refs/pull/N/merge — ademas-ai docs/LESSONS.md
  • GitHub Actions + Wrangler deploy — ademas-ai docs/LESSONS.md
  • «No arrancó» no es «falló»: lee las annotations antes de depurar código — ademas-ai docs/LESSONS.md
  • 2026-09-25 — Un monitor trasladado y un reloj vacío son gastos distintos — ademas-ai docs/LESSONS.md
  • 2026-09-25 — Superseded CI is not new quality evidence — numora LESSONS.md
• Anthropic — 29 · shared across projects
  • Verify model IDs before hard-coding them — aroma docs/LESSONS.md
  • Source URL hallucination — aroma docs/LESSONS.md
  • Extended thinking adds latency without quality gain for structured JSON — aroma docs/LESSONS.md
  • Upstream AI calls must abort before the function's maxDuration — aroma docs/LESSONS.md
  • AI Provider API Syntax & Limits — a fix that expired — aroma docs/LESSONS.md
  • The newer tool version is not the cheaper one — aroma docs/LESSONS.md
  • 2026-07-07 — Mockup layer removed — radius docs/DECISIONS.md
  • El tracking de costos miente si no refleja precios promocionales y de lanzamiento — thesis LESSONS.md
  • Los topes de gasto declarados deben saltar ANTES que el tope del proveedor — thesis LESSONS.md
  • claude-opus-5 rechaza temperature con 400 — y los clientes viejos no lo saben — thesis LESSONS.md
  • La contabilidad idempotente no impide pagar dos peticiones idénticas — thesis LESSONS.md
  • Consultar los recibos antes de ampliar una revisión truncada — thesis LESSONS.md
  • Una respuesta mal formada puede costar aunque el resumen diga cero — thesis LESSONS.md
  • Un límite de revisiones puede dejar la última corrección sin comprobar — thesis LESSONS.md
  • Una ruta económica de curación no cambia los revisores de investigación — thesis LESSONS.md
  • Consultar hoy no significa tener el gasto de hoy — thesis LESSONS.md
  • Un comité necesita recuperar opiniones, no repetir la consulta completa — thesis LESSONS.md
  • Una revisión bilingüe aprobada puede esconder una ampliación normativa y un componente vacío — thesis LESSONS.md
  • Un límite de salida económico puede pagar razonamiento y no recibir ningún veredicto — thesis LESSONS.md
  • Un esquema válido para OpenAI puede impedir que arranque el revisor Anthropic — thesis LESSONS.md
  • 23-sep-2026 · Actualizar un modelo sin recomprar trabajos ni inventar equivalencias — thesis LESSONS.md
  • Los prompts no pueden citar los marcadores que otro componente emite — ademas-ai docs/LESSONS.md
  • Las reglas suaves de mitad de conversación son frágiles por demostración — ademas-ai docs/LESSONS.md
  • Dos resolvedores del mismo valor = el bug original con otra cara — ademas-ai docs/LESSONS.md
  • La auditoría adversarial con otro modelo paga — ademas-ai docs/LESSONS.md
  • El Usage/Cost Report de Anthropic devuelve BUCKETS con las filas adentro — iterar data.data directo suma $0 sin error — ademas-ai docs/LESSONS.md
  • El grep de un invariante debe cubrir TODAS las formas de invocar al proveedor — ademas-ai docs/LESSONS.md
  • Multi-proveedor de LLM: una sola puerta, usage normalizado, y precio techo desde el día uno — ademas-ai docs/LESSONS.md
  • 2026-08-15 — Sonnet 5 emits thinking blocks before text — numora LESSONS.md
• Vercel — 22 · shared across projects
  • Vercel preview deployments miss Production-only env vars — aroma docs/LESSONS.md
  • iPhone photos must be compressed before serverless upload — aroma docs/LESSONS.md
  • Vercel Development does not support Sensitive variables — aroma docs/LESSONS.md
  • Keep partial provider configuration out of Vercel — aroma docs/LESSONS.md
  • New Vercel functions can exceed the free-plan cap — aroma docs/LESSONS.md
  • Keep one canonical short URL — aroma docs/LESSONS.md
  • Vercel production deploys require a recognized git author — aroma docs/LESSONS.md
  • Forced image regeneration needs stable batching — aroma docs/LESSONS.md
  • Verify image provider env before backfills — aroma docs/LESSONS.md
  • Image generation must fit Vercel timeout — aroma docs/LESSONS.md
  • Reuse image maintenance functions to stay under Vercel limits — aroma docs/LESSONS.md
  • Every long AI endpoint needs Vercel duration and client escape hatch — aroma docs/LESSONS.md
  • A background poll is the most expensive line of code in a free-tier app — aroma docs/LESSONS.md
  • Webhook signatures cover bytes, not objects — aroma docs/LESSONS.md
  • A timeout that fits the common case hides the failing one — aroma docs/LESSONS.md
  • A 200 in the logs does not mean the phone got the answer — aroma docs/LESSONS.md
  • Unit tests and the Vite build never load the API routes — aroma docs/LESSONS.md
  • 2026-08-15 — Fail-closed gate from commit one — numora LESSONS.md
  • 2026-08-15 — Repo root must never be publicly served — numora LESSONS.md
  • 2026-08-15 — Git-triggered deploys land BLOCKED; API deploys build fine — numora LESSONS.md
  • 2026-08-16 — JSON values in .env.local must be single-quoted — numora LESSONS.md
  • 2026-08-16 — La caché HMR de dev inyecta cuerpos de fetch en el HTML — numora LESSONS.md
• 1Password — 16 · shared across projects
  • Keep Stripe live and sandbox credentials explicit — aroma docs/LESSONS.md
  • 1Password Environments are separate from ordinary vault items — aroma docs/LESSONS.md
  • 1Password local env mounts are FIFO streams — aroma docs/LESSONS.md
  • Capture one-time provider secrets before closing the confirmation page — aroma docs/LESSONS.md
  • Reusing one secret across trust domains multiplies the blast radius — aroma docs/LESSONS.md
  • Los campos nuevos de 1Password caen dentro de una sección — y op read por ruta corta no los ve — thesis LESSONS.md
  • Las credenciales innecesarias pueden agotar la cuota compartida de 1Password — thesis LESSONS.md
  • Un fallo del almacén de credenciales no debe agotar los intentos de investigación — thesis LESSONS.md
  • Una etiqueta de 1Password no identifica un campo de forma única — thesis LESSONS.md
  • El espejo documental necesita recuperación aunque no haya otra edición — thesis LESSONS.md
  • 1.1 load-secrets-action@v2 con export-env: true no propaga — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.2 Nombres de items con espacios — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.3 Campos duplicados → error "more than one X field" — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.4 Arquitectura de items del proyecto — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Comparar API keys carácter por carácter — ademas-ai docs/LESSONS.md
  • 2026-08-15 — op read rejects em-dashes in item titles — numora LESSONS.md
• Supabase (phd-kb) — 14 · shared across projects
  • Una búsqueda vectorial por escaneo exacto escala lineal con el corpus — y un día cruza el statementtimeout — thesis LESSONS.md
  • Validar el índice no es validar el instrumento — thesis LESSONS.md
  • Una escritura cuyo código de retorno se descarta convierte una deriva de esquema en corrupción silenciosa — thesis LESSONS.md
  • Si una decisión puede mutar el dato, la marcha atrás tiene que cubrirla — thesis LESSONS.md
  • Deshabilitar una credencial no surte efecto al instante — y una espera fija vuelve permanente el rollback — thesis LESSONS.md
  • Un ANALYZE sobre una tabla de vectores puede tumbar TODO el REST del proyecto — thesis LESSONS.md
  • Una migración vieja que recrea un constraint estrecha lo que una nueva amplió — y «recrear si no existe» tampoco salva — thesis LESSONS.md
  • Un índice que cubre búsquedas puede atascar un recuento de control — thesis LESSONS.md
  • Un enlace alternativo bloqueado no exige volver a descargar el mismo texto oficial — thesis LESSONS.md
  • Una URL corregida debe conservar la identidad de la solicitud — thesis LESSONS.md
  • Un espejo necesita comprobar el contenido y el contrato de estados — thesis LESSONS.md
  • Conciliar los borradores preparados antes de volver a generarlos — thesis LESSONS.md
  • Comparar fechas serializadas como texto inventa fallos después de una escritura correcta — thesis LESSONS.md
  • CI puede verificar una versión histórica del monitor de crédito y omitir la desplegada — thesis LESSONS.md
• GitHub — 6 · shared across projects
  • Never commit Claude worktree snapshots or DB dumps — aroma docs/LESSONS.md
  • External Mesa renames need owner-level write credentials — aroma docs/LESSONS.md
  • 2026-07-13 — Repo layout = engine at root — radius docs/DECISIONS.md
  • 19-sep-2026 · Memoria vigente breve y archivo íntegro — thesis LESSONS.md
  • Antes de tocar un archivo, revisar el otro clone por trabajo sin commitear — ademas-ai docs/LESSONS.md
  • 2026-08-15 — sharp/libvips CVEs via Next image optimizer — numora LESSONS.md
• Resend — 2 · shared across projects
  • Un informe diario sellado en UTC llega con la fecha de mañana — thesis LESSONS.md
  • Una key restringida falla distinto por camino — y el proveedor te lo dice si guardas su error — ademas-ai docs/LESSONS.md
• Tavily — 2 · shared across projects
  • La cuota de un buscador no debe detener toda la investigación — thesis LESSONS.md
  • El contador de una clave de Tavily puede estar sano mientras su cuenta está bloqueada — thesis LESSONS.md
• Cloudflare — 1 · shared across projects
  • Connected provider accounts may not own the named resource — aroma docs/LESSONS.md
• Google Gemini — 1 · shared across projects
  • Gemini 3.x «razona» gastando maxOutputTokens — con tope corto el texto llega vacío — thesis LESSONS.md
• LLM — 67
  • Compact AI payloads at the server boundary — aroma docs/LESSONS.md
  • 21-sep-2026 · Ahorrar por horario sin alterar calidad ni reintentos — thesis LESSONS.md
  • 21-sep-2026 · Reproducir pruebas antes de comprar otra comparación — thesis LESSONS.md
  • 21-sep-2026 · Reparaciones invisibles al contador de costes — thesis LESSONS.md
  • 21-sep-2026 · Piloto 1.1 y comprobación de modelos por sección — thesis LESSONS.md
  • 2026-09-21 — Un fallo de API no puntúa calidad ni demuestra gratuidad — thesis LESSONS.md
  • 2026-09-21 — Los recibos necesitan una cola que vuelva a encontrarlos — thesis LESSONS.md
  • 2026-09-21 — Recuperar un panel sin fabricar votos ni gasto nuevo — thesis LESSONS.md
  • 2026-09-21 — Una corrección automática incluye su prueba — thesis LESSONS.md
  • Un tope de gasto que no está en la ruta caliente no frena nada — thesis LESSONS.md
  • Con razonamiento adaptativo, maxtokens es también el presupuesto del pensamiento — thesis LESSONS.md
  • Un evaluador puede confundir preparación bibliográfica con resultados todavía por producir — thesis LESSONS.md
  • Esperar un lote no es un fallo semántico ni permiso para volver a pagarlo — thesis LESSONS.md
  • El título publicado también necesita una revisión de evidencia — thesis LESSONS.md
  • Un comité puede convertir una ambigüedad en una restricción inexistente — thesis LESSONS.md
  • Revisar una respuesta no confirma las correcciones del revisor — thesis LESSONS.md
  • Una respuesta cortada puede costar más que un presupuesto de salida suficiente — thesis LESSONS.md
  • Añadir el rechazo al mensaje inicial puede volver a cobrar un borrador idéntico — thesis LESSONS.md
  • El revisor puede aprobar sus propias correcciones y agotar todos los intentos — thesis LESSONS.md
  • Cambiar el diagnóstico puede volver a cobrar una selección ya generada — thesis LESSONS.md
  • El evaluador necesita la misma fecha de corte y las mismas decisiones — thesis LESSONS.md
  • Menos objeciones no demuestra que una corrección esté terminada — thesis LESSONS.md
  • Un límite corto puede duplicar el coste de una revisión experta — thesis LESSONS.md
  • Cambiar de día no debe recomprar una investigación idéntica — thesis LESSONS.md
  • Una revisión positiva debe justificar cada requisito de preparación — thesis LESSONS.md
  • Los análisis dependientes deben esperar a la selección revisada — thesis LESSONS.md
  • Una espera debe identificar la solicitud que sigue pendiente — thesis LESSONS.md
  • Un ensayo de modelos debe validar primero su propio contrato — thesis LESSONS.md
  • Un agregador no garantiza ni el mismo precio ni la misma disponibilidad — thesis LESSONS.md
  • Las citas literales requieren distinguir tipografía de contenido inventado — thesis LESSONS.md
  • Dos revisores de acuerdo pueden aprobar una cita que perdió su negación — thesis LESSONS.md
  • El precio de un modelo no es el costo de obtener su resultado útil — thesis LESSONS.md
  • Un defecto del banco de pruebas se puede confundir con un fallo del modelo — thesis LESSONS.md
  • Una recomendación rechazada necesita una corrección distinta antes de otra revisión — thesis LESSONS.md
  • Un árbitro de frontera puede aceptar el error que detecta un modelo intermedio — thesis LESSONS.md
  • 2026-09-14 — Grok consistente también puede omitir un error; costos de capítulo y operación separados — thesis LESSONS.md
  • El artefacto revisado y el que se muestra deben tener la misma huella — thesis LESSONS.md
  • Un bloqueo terminal puede ocultar una etapa del evaluador que nunca se ejecutó — thesis LESSONS.md
  • Un modo de render sin modelos puede pagar al refrescar evidencia antes de su bifurcación — thesis LESSONS.md
  • El orden accidental de los pasajes puede volver a comprar la misma investigación — thesis LESSONS.md
  • Un rechazo que solo enumera aciertos no justifica comprar otra redacción — thesis LESSONS.md
  • Mover una comprobación gratuita puede invalidar llamadas ya pagadas si cambia la secuencia congelada — thesis LESSONS.md
  • 2026-09-21 · Repetir respuestas no añade independencia al comité — thesis LESSONS.md
  • 2026-09-21 · Separar vigencia de precios, pruebas y autorización — thesis LESSONS.md
  • 2026-09-21 · Evaluar una cadena, no contar llamadas como éxitos — thesis LESSONS.md
  • 2026-09-21 · Evaluar al revisor con la entrada exacta, no solo su diagnóstico — thesis LESSONS.md
  • 2026-09-21 · Una objeción corregida puede citar el texto que ya se eliminó — thesis LESSONS.md
  • 2026-09-21 · Medir la reparación y distinguir verdad de edición — thesis LESSONS.md
  • 2026-09-21 · Una evaluación terminada puede retener la reutilización — thesis LESSONS.md
  • 2026-09-21 · Parámetros reales y presupuesto entre variantes — thesis LESSONS.md
  • 2026-09-21 · El presupuesto de salida también contiene razonamiento — thesis LESSONS.md
  • 2026-09-21 · Controles breves correctos no acreditan coherencia del análisis — thesis LESSONS.md
  • 2026-09-21 · Verificar el alcance efectivo de las instrucciones de evaluación — thesis LESSONS.md
  • 2026-09-21 · Una pregunta futura no exige un caso ya demostrado — thesis LESSONS.md
  • 2026-09-21 · Localizar la cita antes de recomprar la revisión — thesis LESSONS.md
  • 2026-09-21 · El replay debe demostrar que no puede volver a pagar — thesis LESSONS.md
  • 2026-09-21 · Probar el recorrido instalado y conservar la incertidumbre por separado — thesis LESSONS.md
  • 2026-09-21 · Conciliar el resumen vigente al conservar una cronología — thesis LESSONS.md
  • 2026-09-21 · Conservar la entrada antes de esperar un lote — thesis LESSONS.md
  • 2026-09-22 · Separar fecha del extracto y actualización de una página viva — thesis LESSONS.md
  • 2026-09-22 · Contexto de agentes: reducir detalle sin perder vigencia — thesis LESSONS.md
  • 2026-09-22 · Un cambio de interfaz no renueva una aprobación académica — thesis LESSONS.md
  • 2026-09-22 · Un rechazo terminal protege la misma evidencia, no congela la nueva — thesis LESSONS.md
  • 2026-09-23 · Hipótesis sustantiva y validación del instrumento no son la misma prueba — thesis LESSONS.md
  • Jueces con fallback: el panel externo nunca puede tirar el pipeline — ademas-ai docs/LESSONS.md
  • Council Loop — el lazo autónomo de calidad es un patrón portable, y ya tiene blueprint — ademas-ai docs/LESSONS.md
  • El feedback humano manual es la señal de los huecos del detector automático — ademas-ai docs/LESSONS.md
• relational database — 11
  • Shared data must belong to the household, not to the member who created it — aroma docs/LESSONS.md
  • One household per person needs an index, not a LIMIT 1 — aroma docs/LESSONS.md
  • ON CONFLICT is essential for all household INSERTs — aroma docs/LESSONS.md
  • Batch the round trips, not just the statements — aroma docs/LESSONS.md
  • 2026-09-21 · Un espejo necesita catálogo y disparador del consumidor — thesis LESSONS.md
  • JWT auth en edge functions — ademas-ai docs/LESSONS.md
  • RPC updateagent — merge JSONB con || — ademas-ai docs/LESSONS.md
  • Nunca actualizar agents con anon key — ademas-ai docs/LESSONS.md
  • Verificar la hipótesis contra filas reales ANTES de codificarla — ademas-ai docs/LESSONS.md
  • Migraciones por replace() llevan guard ruidoso obligatorio — ademas-ai docs/LESSONS.md
  • Una policy RLS sin TO aplica a PUBLIC; "para el service role" sin TO servicerole abre la tabla a la anon key — ademas-ai docs/LESSONS.md
• deployment / hosting — 10
  • Un deploy que publica «todo el repo menos X» termina publicando lo que no debía — thesis LESSONS.md
  • Borrar el service worker de un sitio NO desinstala el de los teléfonos — publica uno «de despedida» — thesis LESSONS.md
  • Cablear la interfaz ANTES de la primera llamada de red — thesis LESSONS.md
  • 2026-09-21 · El despliegue debe conservar el árbol de imports — thesis LESSONS.md
  • 4.1 Service worker cache busting — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Nunca reconstruir index.html desde el JSX — ademas-ai docs/LESSONS.md
  • CDN de Cloudflare Pages cachea agresivamente — ademas-ai docs/LESSONS.md
  • JSX inline en Cloudflare Pages — no pre-compilar — ademas-ai docs/LESSONS.md
  • Al retirar un mecanismo, auditar si su reemplazo re-embarca el mismo bug — ademas-ai docs/LESSONS.md
  • .reverse() in-place ya mordió dos veces (INV-38 y F2.1) — ademas-ai docs/LESSONS.md
• design system — 3
  • Override --font-serif to restyle every title at once — aroma docs/LESSONS.md
  • Optimistic UI removes perceived AI/network latency — aroma docs/LESSONS.md
  • Safe area insets for iPhone — aroma docs/LESSONS.md
• search / benchmarking — 2
  • Un resultado de búsqueda pobre no vuelve ajeno un tema pertinente — thesis LESSONS.md
  • La síntesis del buscador puede contaminar una ficha aunque el extracto correcto esté guardado — thesis LESSONS.md

• Provider strings flagged for vocabulary drift: Supabase (phd-kb), Moonshot (Kimi). Confirm each one marks a genuinely separate account rather than a differently-worded same service.
• Bound by STANDARD-ACTIONS-BUDGET (matched on GitHub Actions) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.

Merit (academic-merit messaging) merit

Standards that bind this project:

• Shared GitHub Actions budget — docs/STANDARD-ACTIONS-BUDGET.md · applies via GitHub · configuration integrated on 2026-09-25 · first unblocked GitHub execution and measured savings pending · no conforms_to declared

  source_control:
    provider: GitHub
    capability: repository / CI-CD
    conforms_to: [STANDARD-ACTIONS-BUDGET, STANDARD-DOC-ENTRYPOINT, STANDARD-PUBLISHED-OUTPUT]

• Standard — one canonical entrypoint, never two copies — docs/STANDARD-DOC-ENTRYPOINT.md · applies via GitHub · active since 2026-08-21 · no conforms_to declared
• Standard — every published output needs a verified consumer — docs/STANDARD-PUBLISHED-OUTPUT.md · applies via GitHub · active since 2026-08-21 · no conforms_to declared
• Standard — Twilio OTP / SMS anti-abuse — docs/STANDARD-TWILIO-OTP.md · applies via Twilio · active since 2026-08-10 · conformance declared

Already solved elsewhere in the portfolio:

• repository / CI-CD — already built in glossa → .github/workflows/glossa-publish.yml. Read it before writing your own.
• design system — you have your own in web/src/app/globals.css, and there are 6 more in the portfolio: aroma → docs/ARCHITECTURE.md · radius → docs/DECISIONS.md · thesis → pwa/WEBAPP-MEMORY.md · ademas-ai → inbox/index.html · glossa → src/styles/global.css · numora → 04-UI-Visual-Specification.md. Worth comparing before the next change to yours.
• chat interface — you have your own in web/src/app/inbox/f/[friendshipId]/page.tsx, and there are 2 more in the portfolio: ademas-ai → inbox/app.jsx · numora → app/app/three-panel.tsx. Worth comparing before the next change to yours.
• mobile web UI — you have your own in web/src/components/ChildTabBar.tsx, and there are 3 more in the portfolio: aroma → src/index.css · ademas-ai → inbox/index.html · numora → app/app/layout.tsx. Worth comparing before the next change to yours.

External material found for your open items — proposals, not instructions: nothing here was verified against a repository

• The Ultimate Guide to Palo Alto Networks Software NGFW (Flex) Credits. How NGFW credits work, Renewal considerations, Online Credit Estimator, Deployment Profiles undated — Directly answers that credits expire on a fixed schedule (12 or 36 months), not daily.
• “I Cannot Write This Because It Violates Our Content Policy”:Understanding Content Moderation Policies and User Experiences in Generative AI Products undated — Result [3] directly addresses block vs. alert approaches, recommending soft moderation (alert/warning) over hard blocking.
• 10 LLM Cost-to-Quality Trade-Offs You Can Measure undated — Directly addresses generation vs evaluation trade-offs with measurable metrics and practical decision rule.
• Tokens, credits and the new economics of AI consumption undated — Explains token-based metering scales with activity/usage, directly addressing scaling with message length.

Lessons from other projects that touch what you use (292, grouped by what matched):

• Supabase — 50 · shared across projects
  • Neon DB column names mismatch with API routes — aroma docs/LESSONS.md
  • Supabase .delete() silently failed when RLS blocked — aroma docs/LESSONS.md
  • RLS self-referencing subqueries cause infinite recursion — aroma docs/LESSONS.md
  • Missing RLS policies = silent access denial — aroma docs/LESSONS.md
  • SECURITY DEFINER functions — aroma docs/LESSONS.md
  • RLS policy changes take effect immediately — aroma docs/LESSONS.md
  • 2026-06-26 — Neon Postgres over Supabase — radius docs/DECISIONS.md
  • 22-sep-2026 · Un recuerdo largo no debe bloquear toda la memoria — thesis LESSONS.md
  • La RLS de una tabla no protege las funciones que la leen con privilegios — thesis LESSONS.md
  • La bibliografía puede bloquearse aunque el corpus y la exportación funcionen — thesis LESSONS.md
  • Un cron activo de GitHub no garantiza que haya ocurrido una pasada — thesis LESSONS.md
  • El último listado de ejecuciones puede ocultar un aviso atascado desde el día anterior — thesis LESSONS.md
  • Buscar fuera puede perpetuar un faltante cuyo original ya está en el corpus — thesis LESSONS.md
  • Una cola sin documentos nuevos puede tardar en volver a verificar lo ya completo — thesis LESSONS.md
  • Un pasaje existente puede quedar fuera de la muestra que recibe el revisor — thesis LESSONS.md
  • Una vista previa fallida puede parecer un libro completo por sus referencias — thesis LESSONS.md
  • Un PDF oficial puede carecer de los metadatos que sí tiene su registro editorial — thesis LESSONS.md
  • El último dictamen no sustituye el historial consultivo — thesis LESSONS.md
  • Conservar el cotejo documental después de resolver el faltante — thesis LESSONS.md
  • El último correo guardado no demuestra que el buzón esté procesado — thesis LESSONS.md
  • Una respuesta pagada necesita un recibo antes de repetir el correo — thesis LESSONS.md
  • El espejo documental necesita recuperación aunque no haya otra edición — thesis LESSONS.md
  • Una cita revisada puede seguir fuera de la biblioteca — thesis LESSONS.md
  • El recibo de ingesta debe volver al borrador que usa la fuente — thesis LESSONS.md
  • Un diagnóstico guardado necesita una transición de recuperación — thesis LESSONS.md
  • Una sonda de calidad en el mismo paso de shell apagó un agente que no tenía nada que ver — thesis LESSONS.md
  • Un latido que dice «partial» ante cualquier error deja de avisar de nada — thesis LESSONS.md
  • En CI de pago, el coste lo multiplican las cadenas de disparos, no el trabajo — thesis LESSONS.md
  • «Hay trabajo pendiente» calculado con intentos vencidos casi siempre da sí — thesis LESSONS.md
  • Si las preguntas están en un idioma y el corpus en otro, la ordenación no lo arregla — thesis LESSONS.md
  • Una prueba que el equipo conoce deja de medir en cuanto se optimiza contra ella — thesis LESSONS.md
  • Arreglar el buscador no arregla a quien no lo usa — thesis LESSONS.md
  • Una sonda puede parecer una regresión de búsqueda si recorta sus respuestas esperadas — thesis LESSONS.md
  • Una caché escrita después del modelo no impide compras concurrentes ni permite conciliar gasto — thesis LESSONS.md
  • La selección revisada no corrige automáticamente el resumen antiguo del catálogo — thesis LESSONS.md
  • Una fecha reciente del espejo puede ser solo una reescritura sin cambios — thesis LESSONS.md
  • Un coordinador compartido necesita latidos que identifiquen el trabajo realmente realizado — thesis LESSONS.md
  • 2026-09-21 · Una etiqueta de cita no es una lista completa de autores — thesis LESSONS.md
  • 2026-09-21 · La referencia debe citar la versión consultada — thesis LESSONS.md
  • 2026-09-21 · Actualizar preparación tras publicar bibliografía — thesis LESSONS.md
  • 2026-09-22 · Una búsqueda fallida no invalida el original ya ingerido — thesis LESSONS.md
  • 2.1 Management PAT (sbp) vs servicerole JWT (eyJhbG) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.2 RLS status actual (abr-2026) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.3 CHECK constraint en evaluateditems.actiontag — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.4 Trigger BEFORE INSERT en evaluateditems — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Los grants por defecto de Postgres/Supabase hacen pública toda función nueva — ademas-ai docs/LESSONS.md
  • Añadir metadata a una fila rompe a quien la barría por metadata IS NULL — ademas-ai docs/LESSONS.md
  • Un JSONB de ajustes que se reescribe entero con una copia leída antes pierde datos en silencio — ademas-ai docs/LESSONS.md
  • Una sonda de salud pesada no sirve para vigilar cada 5 minutos; la de hoy tardó 26 min en no avisar — ademas-ai docs/LESSONS.md
  • 2026-08-20 — "Sin secretos en el repo" no es lo mismo que mínimo privilegio — glossa docs/09-Decisiones-Abiertas.md
• Anthropic — 31 · shared across projects
  • Verify model IDs before hard-coding them — aroma docs/LESSONS.md
  • Source URL hallucination — aroma docs/LESSONS.md
  • Extended thinking adds latency without quality gain for structured JSON — aroma docs/LESSONS.md
  • Upstream AI calls must abort before the function's maxDuration — aroma docs/LESSONS.md
  • AI Provider API Syntax & Limits — a fix that expired — aroma docs/LESSONS.md
  • The newer tool version is not the cheaper one — aroma docs/LESSONS.md
  • 2026-07-07 — Mockup layer removed — radius docs/DECISIONS.md
  • El tracking de costos miente si no refleja precios promocionales y de lanzamiento — thesis LESSONS.md
  • Los topes de gasto declarados deben saltar ANTES que el tope del proveedor — thesis LESSONS.md
  • claude-opus-5 rechaza temperature con 400 — y los clientes viejos no lo saben — thesis LESSONS.md
  • La contabilidad idempotente no impide pagar dos peticiones idénticas — thesis LESSONS.md
  • Consultar los recibos antes de ampliar una revisión truncada — thesis LESSONS.md
  • Una respuesta mal formada puede costar aunque el resumen diga cero — thesis LESSONS.md
  • Un límite de revisiones puede dejar la última corrección sin comprobar — thesis LESSONS.md
  • Una ruta económica de curación no cambia los revisores de investigación — thesis LESSONS.md
  • Consultar hoy no significa tener el gasto de hoy — thesis LESSONS.md
  • Un comité necesita recuperar opiniones, no repetir la consulta completa — thesis LESSONS.md
  • Una revisión bilingüe aprobada puede esconder una ampliación normativa y un componente vacío — thesis LESSONS.md
  • Un límite de salida económico puede pagar razonamiento y no recibir ningún veredicto — thesis LESSONS.md
  • La síntesis del buscador puede contaminar una ficha aunque el extracto correcto esté guardado — thesis LESSONS.md
  • Un esquema válido para OpenAI puede impedir que arranque el revisor Anthropic — thesis LESSONS.md
  • 23-sep-2026 · Actualizar un modelo sin recomprar trabajos ni inventar equivalencias — thesis LESSONS.md
  • Los prompts no pueden citar los marcadores que otro componente emite — ademas-ai docs/LESSONS.md
  • Las reglas suaves de mitad de conversación son frágiles por demostración — ademas-ai docs/LESSONS.md
  • Dos resolvedores del mismo valor = el bug original con otra cara — ademas-ai docs/LESSONS.md
  • La auditoría adversarial con otro modelo paga — ademas-ai docs/LESSONS.md
  • El Usage/Cost Report de Anthropic devuelve BUCKETS con las filas adentro — iterar data.data directo suma $0 sin error — ademas-ai docs/LESSONS.md
  • El grep de un invariante debe cubrir TODAS las formas de invocar al proveedor — ademas-ai docs/LESSONS.md
  • Multi-proveedor de LLM: una sola puerta, usage normalizado, y precio techo desde el día uno — ademas-ai docs/LESSONS.md
  • 2026-08-21 — Un modelo prefiere el metadato al contenido, y eso rompe la atribución — glossa docs/09-Decisiones-Abiertas.md
  • 2026-08-15 — Sonnet 5 emits thinking blocks before text — numora LESSONS.md
• Vercel — 23 · shared across projects
  • Vercel preview deployments miss Production-only env vars — aroma docs/LESSONS.md
  • iPhone photos must be compressed before serverless upload — aroma docs/LESSONS.md
  • Vercel Development does not support Sensitive variables — aroma docs/LESSONS.md
  • Keep partial provider configuration out of Vercel — aroma docs/LESSONS.md
  • New Vercel functions can exceed the free-plan cap — aroma docs/LESSONS.md
  • Keep one canonical short URL — aroma docs/LESSONS.md
  • Vercel production deploys require a recognized git author — aroma docs/LESSONS.md
  • Forced image regeneration needs stable batching — aroma docs/LESSONS.md
  • Verify image provider env before backfills — aroma docs/LESSONS.md
  • Image generation must fit Vercel timeout — aroma docs/LESSONS.md
  • Reuse image maintenance functions to stay under Vercel limits — aroma docs/LESSONS.md
  • Every long AI endpoint needs Vercel duration and client escape hatch — aroma docs/LESSONS.md
  • A background poll is the most expensive line of code in a free-tier app — aroma docs/LESSONS.md
  • Webhook signatures cover bytes, not objects — aroma docs/LESSONS.md
  • A timeout that fits the common case hides the failing one — aroma docs/LESSONS.md
  • A 200 in the logs does not mean the phone got the answer — aroma docs/LESSONS.md
  • Unit tests and the Vite build never load the API routes — aroma docs/LESSONS.md
  • redirects en la configuración pierde contra la normalización de barra final — glossa LESSONS.md
  • 2026-08-15 — Fail-closed gate from commit one — numora LESSONS.md
  • 2026-08-15 — Repo root must never be publicly served — numora LESSONS.md
  • 2026-08-15 — Git-triggered deploys land BLOCKED; API deploys build fine — numora LESSONS.md
  • 2026-08-16 — JSON values in .env.local must be single-quoted — numora LESSONS.md
  • 2026-08-16 — La caché HMR de dev inyecta cuerpos de fetch en el HTML — numora LESSONS.md
• Twilio — 16 · shared across projects
  • Capture one-time provider secrets before closing the confirmation page — aroma docs/LESSONS.md
  • Twilio Verify code length is service-scoped — aroma docs/LESSONS.md
  • Phone auth needs both Verify and an SMS sender — aroma docs/LESSONS.md
  • The OTP guard only protects the endpoint it is wired into — aroma docs/LESSONS.md
  • 2026-06-27 — Phone = account — radius docs/DECISIONS.md
  • tenanta2pregistrations es solo para ISV tenants — nunca para el operador — ademas-ai docs/LESSONS.md
  • HMAC validation — usar ambas URLs — ademas-ai docs/LESSONS.md
  • A2P 10DLC — URLs reales en el campaign — ademas-ai docs/LESSONS.md
  • Twilio Verify API bypasa A2P — ademas-ai docs/LESSONS.md
  • Precondiciones se calculan ANTES del insert propio (y excluyendo filas internas) — ademas-ai docs/LESSONS.md
  • Una guarda de identidad colapsa cuando dos roles se vuelven la misma persona — ademas-ai docs/LESSONS.md
  • Los avisos al operador se escriben para su destinatario, no para el log — ademas-ai docs/LESSONS.md
  • La compra-en-el-momento ya estaba escrita; el pool la tenía muerta — ademas-ai docs/LESSONS.md
  • sips: no es SRTP en Twilio <Dial><Sip>: es ;secure=true — ademas-ai docs/LESSONS.md
  • «Completed» no significa «atendido por el agente» — ademas-ai docs/LESSONS.md
  • Llamar de un asistente a otro es la prueba de punta a punta que no necesita humanos — ademas-ai docs/LESSONS.md
• GitHub — 12 · shared across projects
  • Never commit Claude worktree snapshots or DB dumps — aroma docs/LESSONS.md
  • External Mesa renames need owner-level write credentials — aroma docs/LESSONS.md
  • 2026-07-13 — Repo layout = engine at root — radius docs/DECISIONS.md
  • 19-sep-2026 · Memoria vigente breve y archivo íntegro — thesis LESSONS.md
  • Antes de tocar un archivo, revisar el otro clone por trabajo sin commitear — ademas-ai docs/LESSONS.md
  • Umbrella enruta por capacidad DECLARADA: lo que no declaras, no te llega — glossa LESSONS.md
  • Una regla que solo mira failure no ve un trabajo muerto por tiempo — glossa LESSONS.md
  • Un vigilante con falsas alarmas es un vigilante que se ignora — glossa LESSONS.md
  • Todo lo que se genera necesita un lector nombrado, y comprobado — glossa LESSONS.md
  • Las migraciones aplicadas y no commiteadas dejan un esquema irreconstruible — glossa LESSONS.md
  • 2026-08-21 — Una salida sin lector es peor que ninguna salida — glossa docs/09-Decisiones-Abiertas.md
  • 2026-08-15 — sharp/libvips CVEs via Next image optimizer — numora LESSONS.md
• Stripe — 5 · shared across projects
  • Keep Stripe live and sandbox credentials explicit — aroma docs/LESSONS.md
  • 2026-07-01 — Stripe with dynamic pricedata — radius docs/DECISIONS.md
  • Trial expirado bloquea silenciosamente todos los canales — ademas-ai docs/LESSONS.md
  • Comparar API keys carácter por carácter — ademas-ai docs/LESSONS.md
  • Stripe CardElement en iframe cross-origin — ademas-ai docs/LESSONS.md
• React — 3 · shared across projects
  • window.confirm() bloquea browser automation — ademas-ai docs/LESSONS.md
  • setState updater + synthetic events — ademas-ai docs/LESSONS.md
  • JSX inline en Cloudflare Pages — no pre-compilar — ademas-ai docs/LESSONS.md
• Cloudflare — 1 · shared across projects
  • Connected provider accounts may not own the named resource — aroma docs/LESSONS.md
• LLM — 90
  • Compact AI payloads at the server boundary — aroma docs/LESSONS.md
  • 21-sep-2026 · Ahorrar por horario sin alterar calidad ni reintentos — thesis LESSONS.md
  • 21-sep-2026 · Reproducir pruebas antes de comprar otra comparación — thesis LESSONS.md
  • 21-sep-2026 · Reparaciones invisibles al contador de costes — thesis LESSONS.md
  • 21-sep-2026 · Piloto 1.1 y comprobación de modelos por sección — thesis LESSONS.md
  • 2026-09-21 — Un fallo de API no puntúa calidad ni demuestra gratuidad — thesis LESSONS.md
  • 2026-09-21 — Los recibos necesitan una cola que vuelva a encontrarlos — thesis LESSONS.md
  • 2026-09-21 — Recuperar un panel sin fabricar votos ni gasto nuevo — thesis LESSONS.md
  • 2026-09-21 — Una corrección automática incluye su prueba — thesis LESSONS.md
  • Gemini 3.x «razona» gastando maxOutputTokens — con tope corto el texto llega vacío — thesis LESSONS.md
  • Un tope de gasto que no está en la ruta caliente no frena nada — thesis LESSONS.md
  • Con razonamiento adaptativo, maxtokens es también el presupuesto del pensamiento — thesis LESSONS.md
  • Ordenar una cola no concentra el trabajo en terminar su primera unidad — thesis LESSONS.md
  • Un evaluador puede confundir preparación bibliográfica con resultados todavía por producir — thesis LESSONS.md
  • Esperar un lote no es un fallo semántico ni permiso para volver a pagarlo — thesis LESSONS.md
  • Un fallo del almacén de credenciales no debe agotar los intentos de investigación — thesis LESSONS.md
  • El título publicado también necesita una revisión de evidencia — thesis LESSONS.md
  • Un comité puede convertir una ambigüedad en una restricción inexistente — thesis LESSONS.md
  • Revisar una respuesta no confirma las correcciones del revisor — thesis LESSONS.md
  • Una respuesta cortada puede costar más que un presupuesto de salida suficiente — thesis LESSONS.md
  • Añadir el rechazo al mensaje inicial puede volver a cobrar un borrador idéntico — thesis LESSONS.md
  • El revisor puede aprobar sus propias correcciones y agotar todos los intentos — thesis LESSONS.md
  • Cambiar el diagnóstico puede volver a cobrar una selección ya generada — thesis LESSONS.md
  • El evaluador necesita la misma fecha de corte y las mismas decisiones — thesis LESSONS.md
  • Menos objeciones no demuestra que una corrección esté terminada — thesis LESSONS.md
  • Un límite corto puede duplicar el coste de una revisión experta — thesis LESSONS.md
  • Cambiar de día no debe recomprar una investigación idéntica — thesis LESSONS.md
  • Una revisión positiva debe justificar cada requisito de preparación — thesis LESSONS.md
  • Los análisis dependientes deben esperar a la selección revisada — thesis LESSONS.md
  • Una espera debe identificar la solicitud que sigue pendiente — thesis LESSONS.md
  • Un ensayo de modelos debe validar primero su propio contrato — thesis LESSONS.md
  • Un agregador no garantiza ni el mismo precio ni la misma disponibilidad — thesis LESSONS.md
  • Las citas literales requieren distinguir tipografía de contenido inventado — thesis LESSONS.md
  • Dos revisores de acuerdo pueden aprobar una cita que perdió su negación — thesis LESSONS.md
  • El precio de un modelo no es el costo de obtener su resultado útil — thesis LESSONS.md
  • Un defecto del banco de pruebas se puede confundir con un fallo del modelo — thesis LESSONS.md
  • Una recomendación rechazada necesita una corrección distinta antes de otra revisión — thesis LESSONS.md
  • Un árbitro de frontera puede aceptar el error que detecta un modelo intermedio — thesis LESSONS.md
  • 2026-09-14 — Grok consistente también puede omitir un error; costos de capítulo y operación separados — thesis LESSONS.md
  • El artefacto revisado y el que se muestra deben tener la misma huella — thesis LESSONS.md
  • Un bloqueo terminal puede ocultar una etapa del evaluador que nunca se ejecutó — thesis LESSONS.md
  • Un modo de render sin modelos puede pagar al refrescar evidencia antes de su bifurcación — thesis LESSONS.md
  • El orden accidental de los pasajes puede volver a comprar la misma investigación — thesis LESSONS.md
  • Un rechazo que solo enumera aciertos no justifica comprar otra redacción — thesis LESSONS.md
  • Mover una comprobación gratuita puede invalidar llamadas ya pagadas si cambia la secuencia congelada — thesis LESSONS.md
  • 2026-09-21 · Repetir respuestas no añade independencia al comité — thesis LESSONS.md
  • 2026-09-21 · Separar vigencia de precios, pruebas y autorización — thesis LESSONS.md
  • 2026-09-21 · Evaluar una cadena, no contar llamadas como éxitos — thesis LESSONS.md
  • 2026-09-21 · Evaluar al revisor con la entrada exacta, no solo su diagnóstico — thesis LESSONS.md
  • 2026-09-21 · Una objeción corregida puede citar el texto que ya se eliminó — thesis LESSONS.md
  • 2026-09-21 · Medir la reparación y distinguir verdad de edición — thesis LESSONS.md
  • 2026-09-21 · Una evaluación terminada puede retener la reutilización — thesis LESSONS.md
  • 2026-09-21 · Parámetros reales y presupuesto entre variantes — thesis LESSONS.md
  • 2026-09-21 · El presupuesto de salida también contiene razonamiento — thesis LESSONS.md
  • 2026-09-21 · Controles breves correctos no acreditan coherencia del análisis — thesis LESSONS.md
  • 2026-09-21 · Verificar el alcance efectivo de las instrucciones de evaluación — thesis LESSONS.md
  • 2026-09-21 · Una pregunta futura no exige un caso ya demostrado — thesis LESSONS.md
  • 2026-09-21 · Localizar la cita antes de recomprar la revisión — thesis LESSONS.md
  • 2026-09-21 · El replay debe demostrar que no puede volver a pagar — thesis LESSONS.md
  • 2026-09-21 · Probar el recorrido instalado y conservar la incertidumbre por separado — thesis LESSONS.md
  • 2026-09-21 · Conciliar el resumen vigente al conservar una cronología — thesis LESSONS.md
  • 2026-09-21 · Conservar la entrada antes de esperar un lote — thesis LESSONS.md
  • 2026-09-22 · Separar fecha del extracto y actualización de una página viva — thesis LESSONS.md
  • 2026-09-22 · Contexto de agentes: reducir detalle sin perder vigencia — thesis LESSONS.md
  • 2026-09-22 · Un cambio de interfaz no renueva una aprobación académica — thesis LESSONS.md
  • 2026-09-22 · Un rechazo terminal protege la misma evidencia, no congela la nueva — thesis LESSONS.md
  • 2026-09-23 · Hipótesis sustantiva y validación del instrumento no son la misma prueba — thesis LESSONS.md
  • 2026-09-26 · Lo que se apaga en silencio mientras nada corre — thesis LESSONS.md
  • Jueces con fallback: el panel externo nunca puede tirar el pipeline — ademas-ai docs/LESSONS.md
  • Council Loop — el lazo autónomo de calidad es un patrón portable, y ya tiene blueprint — ademas-ai docs/LESSONS.md
  • El feedback humano manual es la señal de los huecos del detector automático — ademas-ai docs/LESSONS.md
  • Rigor que produce un texto ilegible es rigor mal puesto — glossa LESSONS.md
  • Cuando una marca promete algo que no puedes cumplir, cambia la marca — glossa LESSONS.md
  • Un modelo que razona traduciendo es dinero quemado en pensar — glossa LESSONS.md
  • Ningún modelo acierta siempre: verifica y pasa al siguiente — glossa LESSONS.md
  • Marcarlo todo es no marcar nada — glossa LESSONS.md
  • Un ranking por volumen entierra justo lo que añadiste para no perderte — glossa LESSONS.md
  • Una compuerta barata puesta después de la cara — glossa LESSONS.md
  • Una regla que nunca se ha disparado es una regla sin probar — glossa LESSONS.md
  • El content vacío de un modelo de razonamiento no es un fallo de parseo — glossa LESSONS.md
  • fetch de Node aborta a los 300 s esperando cabeceras — glossa LESSONS.md
  • Elegir modelo por precio es elegir mal; el eje real es si aplana las distinciones — glossa LESSONS.md
  • Una regeneración parcial no debe sobrescribir a una completa — glossa LESSONS.md
  • Un filtro que trabaja en silencio es indistinguible de un descubrimiento roto — glossa LESSONS.md
  • Una clave nueva no separa la cuota; hay que separar la cuenta — glossa LESSONS.md
  • Una etiqueta de tema no es una consulta de búsqueda — glossa LESSONS.md
  • Digerir un reporte con el prompt de un episodio le fabrica una voz — glossa LESSONS.md
  • El directorio de fuentes crece por expediente, no por fama (D-024) — glossa LESSONS.md
  • Dos señales independientes, o no se funde nada — glossa LESSONS.md
  • El 429 que no se arregla esperando — glossa LESSONS.md
• relational database — 35
  • Shared data must belong to the household, not to the member who created it — aroma docs/LESSONS.md
  • One household per person needs an index, not a LIMIT 1 — aroma docs/LESSONS.md
  • ON CONFLICT is essential for all household INSERTs — aroma docs/LESSONS.md
  • Batch the round trips, not just the statements — aroma docs/LESSONS.md
  • Una escritura cuyo código de retorno se descarta convierte una deriva de esquema en corrupción silenciosa — thesis LESSONS.md
  • Si una decisión puede mutar el dato, la marcha atrás tiene que cubrirla — thesis LESSONS.md
  • Deshabilitar una credencial no surte efecto al instante — y una espera fija vuelve permanente el rollback — thesis LESSONS.md
  • Un ANALYZE sobre una tabla de vectores puede tumbar TODO el REST del proyecto — thesis LESSONS.md
  • Una migración vieja que recrea un constraint estrecha lo que una nueva amplió — y «recrear si no existe» tampoco salva — thesis LESSONS.md
  • Un consumidor que lee «las N más nuevas» pierde en silencio lo que cae por debajo de N — thesis LESSONS.md
  • Un índice que cubre búsquedas puede atascar un recuento de control — thesis LESSONS.md
  • Una búsqueda general y «la última petición» pueden ocultar faltantes de otros conceptos — thesis LESSONS.md
  • La cuota de un buscador no debe detener toda la investigación — thesis LESSONS.md
  • Un resultado de búsqueda pobre no vuelve ajeno un tema pertinente — thesis LESSONS.md
  • Un enlace alternativo bloqueado no exige volver a descargar el mismo texto oficial — thesis LESSONS.md
  • Una URL corregida debe conservar la identidad de la solicitud — thesis LESSONS.md
  • Una cola de avisos no es la cola de trabajo — thesis LESSONS.md
  • Un espejo necesita comprobar el contenido y el contrato de estados — thesis LESSONS.md
  • Conciliar los borradores preparados antes de volver a generarlos — thesis LESSONS.md
  • Comparar fechas serializadas como texto inventa fallos después de una escritura correcta — thesis LESSONS.md
  • CI puede verificar una versión histórica del monitor de crédito y omitir la desplegada — thesis LESSONS.md
  • 2026-09-21 · Un espejo necesita catálogo y disparador del consumidor — thesis LESSONS.md
  • 2026-09-26 · El vigilante no puede vivir donde vive lo que vigila — thesis LESSONS.md
  • JWT auth en edge functions — ademas-ai docs/LESSONS.md
  • RPC updateagent — merge JSONB con || — ademas-ai docs/LESSONS.md
  • Nunca actualizar agents con anon key — ademas-ai docs/LESSONS.md
  • Verificar la hipótesis contra filas reales ANTES de codificarla — ademas-ai docs/LESSONS.md
  • Migraciones por replace() llevan guard ruidoso obligatorio — ademas-ai docs/LESSONS.md
  • Una policy RLS sin TO aplica a PUBLIC; "para el service role" sin TO servicerole abre la tabla a la anon key — ademas-ai docs/LESSONS.md
  • Una traducción vieja junto a un texto nuevo son dos revistas distintas — glossa LESSONS.md
  • La semana del lector, no la del servidor — glossa LESSONS.md
  • Un índice parcial no puede arbitrar un ON CONFLICT — glossa LESSONS.md
  • Una fila que se marca «en curso» necesita quién la rescate — glossa LESSONS.md
  • Una ventana relativa a «hoy» multiplica filas en vez de actualizarlas — glossa LESSONS.md
  • ON DELETE CASCADE detrás de un botón que dice «remove» — glossa LESSONS.md
• deployment / hosting — 12
  • Un deploy que publica «todo el repo menos X» termina publicando lo que no debía — thesis LESSONS.md
  • Borrar el service worker de un sitio NO desinstala el de los teléfonos — publica uno «de despedida» — thesis LESSONS.md
  • Cablear la interfaz ANTES de la primera llamada de red — thesis LESSONS.md
  • Una comprobación omitida no debe despertar toda la cadena — thesis LESSONS.md
  • 2026-09-21 · El despliegue debe conservar el árbol de imports — thesis LESSONS.md
  • 4.1 Service worker cache busting — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Nunca reconstruir index.html desde el JSX — ademas-ai docs/LESSONS.md
  • CDN de Cloudflare Pages cachea agresivamente — ademas-ai docs/LESSONS.md
  • Al retirar un mecanismo, auditar si su reemplazo re-embarca el mismo bug — ademas-ai docs/LESSONS.md
  • .reverse() in-place ya mordió dos veces (INV-38 y F2.1) — ademas-ai docs/LESSONS.md
  • Una función desplegada a mano es código que el siguiente despliegue borra — glossa LESSONS.md
  • Los 150 s de una edge function deciden el modelo, no al revés — glossa LESSONS.md
• mobile web UI — 6
  • A list that never refetches looks exactly like a sync bug — aroma docs/LESSONS.md
  • iOS Safari ignores an SVG apple-touch-icon — aroma docs/LESSONS.md
  • Optimistic UI removes perceived AI/network latency — aroma docs/LESSONS.md
  • Stock inline edit needs blur save on iPhone — aroma docs/LESSONS.md
  • Safe area insets for iPhone — aroma docs/LESSONS.md
  • Clipboard paste on iPhone requires onPaste handler — aroma docs/LESSONS.md
• repository / CI-CD — 4
  • La cuenta informa más que la lista — glossa LESSONS.md
  • Un contrato no viaja en frases para humanos — glossa LESSONS.md
  • Una fuente correcta y callada se lee igual que una averiada — glossa LESSONS.md
  • Un título de feed trae el eslogan pegado — glossa LESSONS.md
• design system — 3
  • Override --font-serif to restyle every title at once — aroma docs/LESSONS.md
  • Un contador que enseña «usados» se lee como «quedan» — glossa LESSONS.md
  • Si lo decide el sistema, el panel no enseña mandos — glossa LESSONS.md
• billing / payments — 1
  • 2026-06-28 — Prepaid estimate ledger — radius docs/DECISIONS.md

• No LESSONS.md or DECISIONS.md recorded. Whatever this project has learned the hard way is currently unavailable to every other project, and will be re-learned at full price.
• Provider strings flagged for vocabulary drift: Supabase (account artcx@protonmail.com). Confirm each one marks a genuinely separate account rather than a differently-worded same service.
• Bound by STANDARD-ACTIONS-BUDGET (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-DOC-ENTRYPOINT (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-PUBLISHED-OUTPUT (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.

Numora (Fiscal & financial intelligence) numora

Standards that bind this project:

• Shared GitHub Actions budget — docs/STANDARD-ACTIONS-BUDGET.md · applies via GitHub Actions · configuration integrated on 2026-09-25 · first unblocked GitHub execution and measured savings pending · no conforms_to declared

  ci_cd:
    provider: GitHub Actions
    capability: CI/CD
    conforms_to: STANDARD-ACTIONS-BUDGET

• Standard — one canonical entrypoint, never two copies — docs/STANDARD-DOC-ENTRYPOINT.md · applies via GitHub · active since 2026-08-21 · no conforms_to declared

  source_control:
    provider: GitHub
    capability: repository / CI-CD
    conforms_to: [STANDARD-DOC-ENTRYPOINT, STANDARD-PUBLISHED-OUTPUT]

• Standard — every published output needs a verified consumer — docs/STANDARD-PUBLISHED-OUTPUT.md · applies via GitHub · active since 2026-08-21 · no conforms_to declared
• Standard — Twilio OTP / SMS anti-abuse — docs/STANDARD-TWILIO-OTP.md · applies via Twilio · active since 2026-08-10 · no conforms_to declared

  communications:
    provider: Twilio
    capability: phone verification (OTP)
    implemented_in: app/api/auth/start/route.ts
    conforms_to: STANDARD-TWILIO-OTP

Already solved elsewhere in the portfolio:

• deployment / hosting — already built in aroma → docs/ARCHITECTURE.md · radius → docs/DEPLOY.md · thesis → .github/workflows/pages-deploy.yml · ademas-ai → .github/workflows/deploy.yml · ademas-ai → supabase/functions/ · ademas-ai → voice-gateway/src/call-session.ts · ademas-ai → functions/_middleware.js · glossa → skills/references/deployment.md · merit → web/vercel.json. Read it before writing your own.
• LLM — already built in aroma → api/_lib/textModels.js · aroma → api/_lib/recipeImages.js · thesis → phd-agents/docs/MODEL-ROUTING.md · thesis → phd-agents/shared/curation_models.py · ademas-ai → supabase/functions/_shared/llm.ts · glossa → skills/SKILL.md · glossa → supabase/functions/_shared/gemini.ts · glossa → scripts/weekly_from_supabase.mjs · merit → web/src/lib/anthropic.ts. Read it before writing your own.
• CI/CD — already built in radius → docs/PIPELINE.md · thesis → phd-agents/README.md · ademas-ai → .github/workflows/deploy.yml · ademas-ai → scripts/start-guard-session.ts. Read it before writing your own.
• repository / CI-CD — already built in glossa → .github/workflows/glossa-publish.yml. Read it before writing your own.
• credential management — already built in thesis → phd-agents/docs/RECOVERY-SECRETS.md. Read it before writing your own.
• design system — you have your own in 04-UI-Visual-Specification.md, and there are 6 more in the portfolio: aroma → docs/ARCHITECTURE.md · radius → docs/DECISIONS.md · thesis → pwa/WEBAPP-MEMORY.md · ademas-ai → inbox/index.html · glossa → src/styles/global.css · merit → web/src/app/globals.css. Worth comparing before the next change to yours.
• chat interface — you have your own in app/app/three-panel.tsx, and there are 2 more in the portfolio: ademas-ai → inbox/app.jsx · merit → web/src/app/inbox/f/[friendshipId]/page.tsx. Worth comparing before the next change to yours.
• mobile web UI — you have your own in app/app/layout.tsx, and there are 3 more in the portfolio: aroma → src/index.css · ademas-ai → inbox/index.html · merit → web/src/components/ChildTabBar.tsx. Worth comparing before the next change to yours.

External material found for your open items — proposals, not instructions: nothing here was verified against a repository

• A Systematic Investigation of Document Chunking ... undated — Large-scale evaluation of 36 chunking methods directly addresses hierarchical vs fixed-size comparison.
• Implementing Hybrid Semantic + Lexical Search undated — Concrete design with parallel retrieval, Reciprocal Rank Fusion merging, and R2/FTS5 implementation details.
• Heads Up — FASB Amends Guidance on the Accounting for and Disclosure of Software Costs (September 18, 2025) | DART – Deloitte Accounting Research Tool undated — Directly addresses software cost accounting guidance changes and capitalization decisions with specific examples.
• Breakpoints in Responsive Design - NN/G undated — Result [1] directly addresses panel collapse behavior at medium screen sizes via IBM example.
• Best practices for managing service account keys undated — Directly addresses service account key management best practices and separation of concerns for different credential types.
• Evaluation of Retrieval-Augmented Generation: A Survey undated — Directly addresses retrieval evaluation metrics and datasets needed for RAG systems comprehensively.
• Developer Manual undated — Directly addresses per-key rate limiting and contacting agency owners for higher limits.
• Chunking Strategies to Improve LLM RAG Pipeline Performance | Weaviate undated — Provides concrete baseline (512 tokens, 50-100 overlap) for empirical testing approach.

Lessons from other projects that touch what you use (328, grouped by what matched):

• Supabase — 43 · shared across projects
  • Neon DB column names mismatch with API routes — aroma docs/LESSONS.md
  • Supabase .delete() silently failed when RLS blocked — aroma docs/LESSONS.md
  • RLS self-referencing subqueries cause infinite recursion — aroma docs/LESSONS.md
  • Missing RLS policies = silent access denial — aroma docs/LESSONS.md
  • SECURITY DEFINER functions — aroma docs/LESSONS.md
  • RLS policy changes take effect immediately — aroma docs/LESSONS.md
  • 2026-06-26 — Neon Postgres over Supabase — radius docs/DECISIONS.md
  • 22-sep-2026 · Un recuerdo largo no debe bloquear toda la memoria — thesis LESSONS.md
  • La RLS de una tabla no protege las funciones que la leen con privilegios — thesis LESSONS.md
  • La bibliografía puede bloquearse aunque el corpus y la exportación funcionen — thesis LESSONS.md
  • Buscar fuera puede perpetuar un faltante cuyo original ya está en el corpus — thesis LESSONS.md
  • Una cola sin documentos nuevos puede tardar en volver a verificar lo ya completo — thesis LESSONS.md
  • Un pasaje existente puede quedar fuera de la muestra que recibe el revisor — thesis LESSONS.md
  • Una vista previa fallida puede parecer un libro completo por sus referencias — thesis LESSONS.md
  • Un PDF oficial puede carecer de los metadatos que sí tiene su registro editorial — thesis LESSONS.md
  • El último dictamen no sustituye el historial consultivo — thesis LESSONS.md
  • Conservar el cotejo documental después de resolver el faltante — thesis LESSONS.md
  • El último correo guardado no demuestra que el buzón esté procesado — thesis LESSONS.md
  • Una respuesta pagada necesita un recibo antes de repetir el correo — thesis LESSONS.md
  • Una cita revisada puede seguir fuera de la biblioteca — thesis LESSONS.md
  • El recibo de ingesta debe volver al borrador que usa la fuente — thesis LESSONS.md
  • Un diagnóstico guardado necesita una transición de recuperación — thesis LESSONS.md
  • Un latido que dice «partial» ante cualquier error deja de avisar de nada — thesis LESSONS.md
  • «Hay trabajo pendiente» calculado con intentos vencidos casi siempre da sí — thesis LESSONS.md
  • Si las preguntas están en un idioma y el corpus en otro, la ordenación no lo arregla — thesis LESSONS.md
  • Arreglar el buscador no arregla a quien no lo usa — thesis LESSONS.md
  • Una sonda puede parecer una regresión de búsqueda si recorta sus respuestas esperadas — thesis LESSONS.md
  • Una caché escrita después del modelo no impide compras concurrentes ni permite conciliar gasto — thesis LESSONS.md
  • La selección revisada no corrige automáticamente el resumen antiguo del catálogo — thesis LESSONS.md
  • Una fecha reciente del espejo puede ser solo una reescritura sin cambios — thesis LESSONS.md
  • 2026-09-21 · Una etiqueta de cita no es una lista completa de autores — thesis LESSONS.md
  • 2026-09-21 · La referencia debe citar la versión consultada — thesis LESSONS.md
  • 2026-09-21 · Actualizar preparación tras publicar bibliografía — thesis LESSONS.md
  • 2026-09-22 · Una búsqueda fallida no invalida el original ya ingerido — thesis LESSONS.md
  • 2.1 Management PAT (sbp) vs servicerole JWT (eyJhbG) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.2 RLS status actual (abr-2026) — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.3 CHECK constraint en evaluateditems.actiontag — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 2.4 Trigger BEFORE INSERT en evaluateditems — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Los grants por defecto de Postgres/Supabase hacen pública toda función nueva — ademas-ai docs/LESSONS.md
  • Añadir metadata a una fila rompe a quien la barría por metadata IS NULL — ademas-ai docs/LESSONS.md
  • Un JSONB de ajustes que se reescribe entero con una copia leída antes pierde datos en silencio — ademas-ai docs/LESSONS.md
  • Una sonda de salud pesada no sirve para vigilar cada 5 minutos; la de hoy tardó 26 min en no avisar — ademas-ai docs/LESSONS.md
  • 2026-08-20 — "Sin secretos en el repo" no es lo mismo que mínimo privilegio — glossa docs/09-Decisiones-Abiertas.md
• GitHub Actions — 34 · shared across projects
  • 2026-09-25 — Measure account spend before cutting a quiet project's tests — aroma docs/LESSONS.md
  • 2026-06-27 — GitHub Actions as the job runner — radius docs/DECISIONS.md
  • 2026-09-25 — Preserve on-demand pipelines and bound CI/deployment — radius docs/DECISIONS.md
  • Un workflow en verde puede no haber hecho su trabajo — thesis LESSONS.md
  • El auditor automático también deriva — átalo a su fuente con un test — thesis LESSONS.md
  • Las guardas de un camino que nunca se ha ejecutado son hipótesis, no guardas — thesis LESSONS.md
  • Un grep de cordura sobre un artefacto binario puede pasar por accidente — thesis LESSONS.md
  • Dos componentes que miden lo mismo con umbrales propios acaban contradiciéndose — thesis LESSONS.md
  • Un pedido explícito no puede quedar a merced de la clasificación automática que le sigue — thesis LESSONS.md
  • Un consumidor que lee «las N más nuevas» pierde en silencio lo que cae por debajo de N — thesis LESSONS.md
  • Ordenar una cola no concentra el trabajo en terminar su primera unidad — thesis LESSONS.md
  • Un evento omitido no debe renovar el aplazamiento del siguiente — thesis LESSONS.md
  • Una búsqueda general y «la última petición» pueden ocultar faltantes de otros conceptos — thesis LESSONS.md
  • Una comprobación que termina sin trabajar también puede cancelar trabajo pendiente — thesis LESSONS.md
  • Una cola de avisos no es la cola de trabajo — thesis LESSONS.md
  • Un cron activo de GitHub no garantiza que haya ocurrido una pasada — thesis LESSONS.md
  • El último listado de ejecuciones puede ocultar un aviso atascado desde el día anterior — thesis LESSONS.md
  • Una comprobación omitida no debe despertar toda la cadena — thesis LESSONS.md
  • Una sonda de calidad en el mismo paso de shell apagó un agente que no tenía nada que ver — thesis LESSONS.md
  • En CI de pago, el coste lo multiplican las cadenas de disparos, no el trabajo — thesis LESSONS.md
  • Una prueba que el equipo conoce deja de medir en cuanto se optimiza contra ella — thesis LESSONS.md
  • Reanudar un objetivo antiguo puede repetir trabajo ya terminado en otra superficie — thesis LESSONS.md
  • Una cola vacía puede agotar consultas del gestor de secretos — thesis LESSONS.md
  • Un coordinador compartido necesita latidos que identifiquen el trabajo realmente realizado — thesis LESSONS.md
  • 2026-09-21 · Filtrar trabajo editorial por los archivos que realmente cuentan — thesis LESSONS.md
  • 2026-09-25 · El minuto más barato es el proceso que no se despierta — thesis LESSONS.md
  • 2026-09-26 · El vigilante no puede vivir donde vive lo que vigila — thesis LESSONS.md
  • 2026-09-26 · Lo que se apaga en silencio mientras nada corre — thesis LESSONS.md
  • 3.1 Delay entre push y trigger — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 3.2 YAML en heredocs con Python inline — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 3.3 Log fetch con DNS cache overflow — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • workflowdispatch requiere branch ref, no refs/pull/N/merge — ademas-ai docs/LESSONS.md
  • GitHub Actions + Wrangler deploy — ademas-ai docs/LESSONS.md
  • 2026-09-25 — Un monitor trasladado y un reloj vacío son gastos distintos — ademas-ai docs/LESSONS.md
• Anthropic — 29 · shared across projects
  • Source URL hallucination — aroma docs/LESSONS.md
  • Extended thinking adds latency without quality gain for structured JSON — aroma docs/LESSONS.md
  • Upstream AI calls must abort before the function's maxDuration — aroma docs/LESSONS.md
  • AI Provider API Syntax & Limits — a fix that expired — aroma docs/LESSONS.md
  • The newer tool version is not the cheaper one — aroma docs/LESSONS.md
  • 2026-07-07 — Mockup layer removed — radius docs/DECISIONS.md
  • El tracking de costos miente si no refleja precios promocionales y de lanzamiento — thesis LESSONS.md
  • Los topes de gasto declarados deben saltar ANTES que el tope del proveedor — thesis LESSONS.md
  • claude-opus-5 rechaza temperature con 400 — y los clientes viejos no lo saben — thesis LESSONS.md
  • La contabilidad idempotente no impide pagar dos peticiones idénticas — thesis LESSONS.md
  • Consultar los recibos antes de ampliar una revisión truncada — thesis LESSONS.md
  • Una respuesta mal formada puede costar aunque el resumen diga cero — thesis LESSONS.md
  • Un límite de revisiones puede dejar la última corrección sin comprobar — thesis LESSONS.md
  • Una ruta económica de curación no cambia los revisores de investigación — thesis LESSONS.md
  • Consultar hoy no significa tener el gasto de hoy — thesis LESSONS.md
  • Un comité necesita recuperar opiniones, no repetir la consulta completa — thesis LESSONS.md
  • Una revisión bilingüe aprobada puede esconder una ampliación normativa y un componente vacío — thesis LESSONS.md
  • Un límite de salida económico puede pagar razonamiento y no recibir ningún veredicto — thesis LESSONS.md
  • La síntesis del buscador puede contaminar una ficha aunque el extracto correcto esté guardado — thesis LESSONS.md
  • Un esquema válido para OpenAI puede impedir que arranque el revisor Anthropic — thesis LESSONS.md
  • 23-sep-2026 · Actualizar un modelo sin recomprar trabajos ni inventar equivalencias — thesis LESSONS.md
  • Los prompts no pueden citar los marcadores que otro componente emite — ademas-ai docs/LESSONS.md
  • Las reglas suaves de mitad de conversación son frágiles por demostración — ademas-ai docs/LESSONS.md
  • Dos resolvedores del mismo valor = el bug original con otra cara — ademas-ai docs/LESSONS.md
  • La auditoría adversarial con otro modelo paga — ademas-ai docs/LESSONS.md
  • El Usage/Cost Report de Anthropic devuelve BUCKETS con las filas adentro — iterar data.data directo suma $0 sin error — ademas-ai docs/LESSONS.md
  • El grep de un invariante debe cubrir TODAS las formas de invocar al proveedor — ademas-ai docs/LESSONS.md
  • Multi-proveedor de LLM: una sola puerta, usage normalizado, y precio techo desde el día uno — ademas-ai docs/LESSONS.md
  • 2026-08-21 — Un modelo prefiere el metadato al contenido, y eso rompe la atribución — glossa docs/09-Decisiones-Abiertas.md
• OpenAI — 23 · shared across projects
  • Verify model IDs before hard-coding them — aroma docs/LESSONS.md
  • AI image URLs need provider-aware handling — aroma docs/LESSONS.md
  • Verify image provider env before backfills — aroma docs/LESSONS.md
  • Do not force image responseformat — aroma docs/LESSONS.md
  • Image generation must fit Vercel timeout — aroma docs/LESSONS.md
  • Low-quality recipe images lose the editorial Mesa look — aroma docs/LESSONS.md
  • Match data URL MIME to generated image format — aroma docs/LESSONS.md
  • Un evaluador puede confundir preparación bibliográfica con resultados todavía por producir — thesis LESSONS.md
  • Esperar un lote no es un fallo semántico ni permiso para volver a pagarlo — thesis LESSONS.md
  • El título publicado también necesita una revisión de evidencia — thesis LESSONS.md
  • Un resultado de búsqueda pobre no vuelve ajeno un tema pertinente — thesis LESSONS.md
  • Una espera debe identificar la solicitud que sigue pendiente — thesis LESSONS.md
  • Un ensayo de modelos debe validar primero su propio contrato — thesis LESSONS.md
  • Las citas literales requieren distinguir tipografía de contenido inventado — thesis LESSONS.md
  • Dos revisores de acuerdo pueden aprobar una cita que perdió su negación — thesis LESSONS.md
  • El precio de un modelo no es el costo de obtener su resultado útil — thesis LESSONS.md
  • Un defecto del banco de pruebas se puede confundir con un fallo del modelo — thesis LESSONS.md
  • Una recomendación rechazada necesita una corrección distinta antes de otra revisión — thesis LESSONS.md
  • Un árbitro de frontera puede aceptar el error que detecta un modelo intermedio — thesis LESSONS.md
  • 2026-09-14 — Grok consistente también puede omitir un error; costos de capítulo y operación separados — thesis LESSONS.md
  • El artefacto revisado y el que se muestra deben tener la misma huella — thesis LESSONS.md
  • El orden accidental de los pasajes puede volver a comprar la misma investigación — thesis LESSONS.md
  • Un rechazo que solo enumera aciertos no justifica comprar otra redacción — thesis LESSONS.md
• Vercel — 16 · shared across projects
  • Vercel preview deployments miss Production-only env vars — aroma docs/LESSONS.md
  • iPhone photos must be compressed before serverless upload — aroma docs/LESSONS.md
  • Vercel Development does not support Sensitive variables — aroma docs/LESSONS.md
  • Keep partial provider configuration out of Vercel — aroma docs/LESSONS.md
  • New Vercel functions can exceed the free-plan cap — aroma docs/LESSONS.md
  • Keep one canonical short URL — aroma docs/LESSONS.md
  • Vercel production deploys require a recognized git author — aroma docs/LESSONS.md
  • Forced image regeneration needs stable batching — aroma docs/LESSONS.md
  • Reuse image maintenance functions to stay under Vercel limits — aroma docs/LESSONS.md
  • Every long AI endpoint needs Vercel duration and client escape hatch — aroma docs/LESSONS.md
  • A background poll is the most expensive line of code in a free-tier app — aroma docs/LESSONS.md
  • Webhook signatures cover bytes, not objects — aroma docs/LESSONS.md
  • A timeout that fits the common case hides the failing one — aroma docs/LESSONS.md
  • A 200 in the logs does not mean the phone got the answer — aroma docs/LESSONS.md
  • Unit tests and the Vite build never load the API routes — aroma docs/LESSONS.md
  • redirects en la configuración pierde contra la normalización de barra final — glossa LESSONS.md
• 1Password — 15 · shared across projects
  • 1Password Environments are separate from ordinary vault items — aroma docs/LESSONS.md
  • 1Password local env mounts are FIFO streams — aroma docs/LESSONS.md
  • Capture one-time provider secrets before closing the confirmation page — aroma docs/LESSONS.md
  • Reusing one secret across trust domains multiplies the blast radius — aroma docs/LESSONS.md
  • Los campos nuevos de 1Password caen dentro de una sección — y op read por ruta corta no los ve — thesis LESSONS.md
  • Las credenciales innecesarias pueden agotar la cuota compartida de 1Password — thesis LESSONS.md
  • Un fallo del almacén de credenciales no debe agotar los intentos de investigación — thesis LESSONS.md
  • Una etiqueta de 1Password no identifica un campo de forma única — thesis LESSONS.md
  • El espejo documental necesita recuperación aunque no haya otra edición — thesis LESSONS.md
  • 1.1 load-secrets-action@v2 con export-env: true no propaga — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.2 Nombres de items con espacios — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.3 Campos duplicados → error "more than one X field" — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • 1.4 Arquitectura de items del proyecto — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Una clave nueva no separa la cuota; hay que separar la cuenta — glossa LESSONS.md
  • El campo de 1Password no siempre se llama igual — glossa LESSONS.md
• Twilio — 15 · shared across projects
  • Twilio Verify code length is service-scoped — aroma docs/LESSONS.md
  • Phone auth needs both Verify and an SMS sender — aroma docs/LESSONS.md
  • The OTP guard only protects the endpoint it is wired into — aroma docs/LESSONS.md
  • 2026-06-27 — Phone = account — radius docs/DECISIONS.md
  • tenanta2pregistrations es solo para ISV tenants — nunca para el operador — ademas-ai docs/LESSONS.md
  • HMAC validation — usar ambas URLs — ademas-ai docs/LESSONS.md
  • A2P 10DLC — URLs reales en el campaign — ademas-ai docs/LESSONS.md
  • Twilio Verify API bypasa A2P — ademas-ai docs/LESSONS.md
  • Precondiciones se calculan ANTES del insert propio (y excluyendo filas internas) — ademas-ai docs/LESSONS.md
  • Una guarda de identidad colapsa cuando dos roles se vuelven la misma persona — ademas-ai docs/LESSONS.md
  • Los avisos al operador se escriben para su destinatario, no para el log — ademas-ai docs/LESSONS.md
  • La compra-en-el-momento ya estaba escrita; el pool la tenía muerta — ademas-ai docs/LESSONS.md
  • sips: no es SRTP en Twilio <Dial><Sip>: es ;secure=true — ademas-ai docs/LESSONS.md
  • «Completed» no significa «atendido por el agente» — ademas-ai docs/LESSONS.md
  • Llamar de un asistente a otro es la prueba de punta a punta que no necesita humanos — ademas-ai docs/LESSONS.md
• GitHub — 11 · shared across projects
  • Never commit Claude worktree snapshots or DB dumps — aroma docs/LESSONS.md
  • External Mesa renames need owner-level write credentials — aroma docs/LESSONS.md
  • 2026-07-13 — Repo layout = engine at root — radius docs/DECISIONS.md
  • 19-sep-2026 · Memoria vigente breve y archivo íntegro — thesis LESSONS.md
  • Antes de tocar un archivo, revisar el otro clone por trabajo sin commitear — ademas-ai docs/LESSONS.md
  • Umbrella enruta por capacidad DECLARADA: lo que no declaras, no te llega — glossa LESSONS.md
  • Una regla que solo mira failure no ve un trabajo muerto por tiempo — glossa LESSONS.md
  • Un vigilante con falsas alarmas es un vigilante que se ignora — glossa LESSONS.md
  • Todo lo que se genera necesita un lector nombrado, y comprobado — glossa LESSONS.md
  • Las migraciones aplicadas y no commiteadas dejan un esquema irreconstruible — glossa LESSONS.md
  • 2026-08-21 — Una salida sin lector es peor que ninguna salida — glossa docs/09-Decisiones-Abiertas.md
• Stripe — 5 · shared across projects
  • Keep Stripe live and sandbox credentials explicit — aroma docs/LESSONS.md
  • 2026-07-01 — Stripe with dynamic pricedata — radius docs/DECISIONS.md
  • Trial expirado bloquea silenciosamente todos los canales — ademas-ai docs/LESSONS.md
  • Comparar API keys carácter por carácter — ademas-ai docs/LESSONS.md
  • Stripe CardElement en iframe cross-origin — ademas-ai docs/LESSONS.md
• React — 3 · shared across projects
  • window.confirm() bloquea browser automation — ademas-ai docs/LESSONS.md
  • setState updater + synthetic events — ademas-ai docs/LESSONS.md
  • JSX inline en Cloudflare Pages — no pre-compilar — ademas-ai docs/LESSONS.md
• Resend — 2 · shared across projects
  • Un informe diario sellado en UTC llega con la fecha de mañana — thesis LESSONS.md
  • Una key restringida falla distinto por camino — y el proveedor te lo dice si guardas su error — ademas-ai docs/LESSONS.md
• Cloudflare — 1 · shared across projects
  • Connected provider accounts may not own the named resource — aroma docs/LESSONS.md
• Google Drive — 1 · shared across projects
  • Una cuenta de servicio no puede CREAR archivos en un Drive personal, pero sí mover y renombrar los ajenos — thesis LESSONS.md
• LLM — 71
  • Compact AI payloads at the server boundary — aroma docs/LESSONS.md
  • 21-sep-2026 · Ahorrar por horario sin alterar calidad ni reintentos — thesis LESSONS.md
  • 21-sep-2026 · Reproducir pruebas antes de comprar otra comparación — thesis LESSONS.md
  • 21-sep-2026 · Reparaciones invisibles al contador de costes — thesis LESSONS.md
  • 21-sep-2026 · Piloto 1.1 y comprobación de modelos por sección — thesis LESSONS.md
  • 2026-09-21 — Un fallo de API no puntúa calidad ni demuestra gratuidad — thesis LESSONS.md
  • 2026-09-21 — Los recibos necesitan una cola que vuelva a encontrarlos — thesis LESSONS.md
  • 2026-09-21 — Recuperar un panel sin fabricar votos ni gasto nuevo — thesis LESSONS.md
  • 2026-09-21 — Una corrección automática incluye su prueba — thesis LESSONS.md
  • Gemini 3.x «razona» gastando maxOutputTokens — con tope corto el texto llega vacío — thesis LESSONS.md
  • Un tope de gasto que no está en la ruta caliente no frena nada — thesis LESSONS.md
  • Con razonamiento adaptativo, maxtokens es también el presupuesto del pensamiento — thesis LESSONS.md
  • Un comité puede convertir una ambigüedad en una restricción inexistente — thesis LESSONS.md
  • Revisar una respuesta no confirma las correcciones del revisor — thesis LESSONS.md
  • Una respuesta cortada puede costar más que un presupuesto de salida suficiente — thesis LESSONS.md
  • Añadir el rechazo al mensaje inicial puede volver a cobrar un borrador idéntico — thesis LESSONS.md
  • El revisor puede aprobar sus propias correcciones y agotar todos los intentos — thesis LESSONS.md
  • Cambiar el diagnóstico puede volver a cobrar una selección ya generada — thesis LESSONS.md
  • El evaluador necesita la misma fecha de corte y las mismas decisiones — thesis LESSONS.md
  • Menos objeciones no demuestra que una corrección esté terminada — thesis LESSONS.md
  • Un límite corto puede duplicar el coste de una revisión experta — thesis LESSONS.md
  • Cambiar de día no debe recomprar una investigación idéntica — thesis LESSONS.md
  • Una revisión positiva debe justificar cada requisito de preparación — thesis LESSONS.md
  • Los análisis dependientes deben esperar a la selección revisada — thesis LESSONS.md
  • Un agregador no garantiza ni el mismo precio ni la misma disponibilidad — thesis LESSONS.md
  • Un bloqueo terminal puede ocultar una etapa del evaluador que nunca se ejecutó — thesis LESSONS.md
  • Un modo de render sin modelos puede pagar al refrescar evidencia antes de su bifurcación — thesis LESSONS.md
  • Mover una comprobación gratuita puede invalidar llamadas ya pagadas si cambia la secuencia congelada — thesis LESSONS.md
  • 2026-09-21 · Repetir respuestas no añade independencia al comité — thesis LESSONS.md
  • 2026-09-21 · Separar vigencia de precios, pruebas y autorización — thesis LESSONS.md
  • 2026-09-21 · Evaluar una cadena, no contar llamadas como éxitos — thesis LESSONS.md
  • 2026-09-21 · Evaluar al revisor con la entrada exacta, no solo su diagnóstico — thesis LESSONS.md
  • 2026-09-21 · Una objeción corregida puede citar el texto que ya se eliminó — thesis LESSONS.md
  • 2026-09-21 · Medir la reparación y distinguir verdad de edición — thesis LESSONS.md
  • 2026-09-21 · Una evaluación terminada puede retener la reutilización — thesis LESSONS.md
  • 2026-09-21 · Parámetros reales y presupuesto entre variantes — thesis LESSONS.md
  • 2026-09-21 · El presupuesto de salida también contiene razonamiento — thesis LESSONS.md
  • 2026-09-21 · Controles breves correctos no acreditan coherencia del análisis — thesis LESSONS.md
  • 2026-09-21 · Verificar el alcance efectivo de las instrucciones de evaluación — thesis LESSONS.md
  • 2026-09-21 · Una pregunta futura no exige un caso ya demostrado — thesis LESSONS.md
  • 2026-09-21 · Localizar la cita antes de recomprar la revisión — thesis LESSONS.md
  • 2026-09-21 · El replay debe demostrar que no puede volver a pagar — thesis LESSONS.md
  • 2026-09-21 · Probar el recorrido instalado y conservar la incertidumbre por separado — thesis LESSONS.md
  • 2026-09-21 · Conciliar el resumen vigente al conservar una cronología — thesis LESSONS.md
  • 2026-09-21 · Conservar la entrada antes de esperar un lote — thesis LESSONS.md
  • 2026-09-22 · Separar fecha del extracto y actualización de una página viva — thesis LESSONS.md
  • 2026-09-22 · Contexto de agentes: reducir detalle sin perder vigencia — thesis LESSONS.md
  • 2026-09-22 · Un cambio de interfaz no renueva una aprobación académica — thesis LESSONS.md
  • 2026-09-22 · Un rechazo terminal protege la misma evidencia, no congela la nueva — thesis LESSONS.md
  • 2026-09-23 · Hipótesis sustantiva y validación del instrumento no son la misma prueba — thesis LESSONS.md
  • Jueces con fallback: el panel externo nunca puede tirar el pipeline — ademas-ai docs/LESSONS.md
  • Council Loop — el lazo autónomo de calidad es un patrón portable, y ya tiene blueprint — ademas-ai docs/LESSONS.md
  • El feedback humano manual es la señal de los huecos del detector automático — ademas-ai docs/LESSONS.md
  • Rigor que produce un texto ilegible es rigor mal puesto — glossa LESSONS.md
  • Cuando una marca promete algo que no puedes cumplir, cambia la marca — glossa LESSONS.md
  • Un modelo que razona traduciendo es dinero quemado en pensar — glossa LESSONS.md
  • Ningún modelo acierta siempre: verifica y pasa al siguiente — glossa LESSONS.md
  • Marcarlo todo es no marcar nada — glossa LESSONS.md
  • Un ranking por volumen entierra justo lo que añadiste para no perderte — glossa LESSONS.md
  • Una compuerta barata puesta después de la cara — glossa LESSONS.md
  • Una regla que nunca se ha disparado es una regla sin probar — glossa LESSONS.md
  • El content vacío de un modelo de razonamiento no es un fallo de parseo — glossa LESSONS.md
  • fetch de Node aborta a los 300 s esperando cabeceras — glossa LESSONS.md
  • Elegir modelo por precio es elegir mal; el eje real es si aplana las distinciones — glossa LESSONS.md
  • Una regeneración parcial no debe sobrescribir a una completa — glossa LESSONS.md
  • Un filtro que trabaja en silencio es indistinguible de un descubrimiento roto — glossa LESSONS.md
  • Una etiqueta de tema no es una consulta de búsqueda — glossa LESSONS.md
  • Digerir un reporte con el prompt de un episodio le fabrica una voz — glossa LESSONS.md
  • El directorio de fuentes crece por expediente, no por fama (D-024) — glossa LESSONS.md
  • Dos señales independientes, o no se funde nada — glossa LESSONS.md
  • El 429 que no se arregla esperando — glossa LESSONS.md
• relational database — 30
  • Shared data must belong to the household, not to the member who created it — aroma docs/LESSONS.md
  • One household per person needs an index, not a LIMIT 1 — aroma docs/LESSONS.md
  • ON CONFLICT is essential for all household INSERTs — aroma docs/LESSONS.md
  • Batch the round trips, not just the statements — aroma docs/LESSONS.md
  • Una escritura cuyo código de retorno se descarta convierte una deriva de esquema en corrupción silenciosa — thesis LESSONS.md
  • Si una decisión puede mutar el dato, la marcha atrás tiene que cubrirla — thesis LESSONS.md
  • Deshabilitar una credencial no surte efecto al instante — y una espera fija vuelve permanente el rollback — thesis LESSONS.md
  • Un ANALYZE sobre una tabla de vectores puede tumbar TODO el REST del proyecto — thesis LESSONS.md
  • Una migración vieja que recrea un constraint estrecha lo que una nueva amplió — y «recrear si no existe» tampoco salva — thesis LESSONS.md
  • Un índice que cubre búsquedas puede atascar un recuento de control — thesis LESSONS.md
  • La cuota de un buscador no debe detener toda la investigación — thesis LESSONS.md
  • Un enlace alternativo bloqueado no exige volver a descargar el mismo texto oficial — thesis LESSONS.md
  • Una URL corregida debe conservar la identidad de la solicitud — thesis LESSONS.md
  • Un espejo necesita comprobar el contenido y el contrato de estados — thesis LESSONS.md
  • Conciliar los borradores preparados antes de volver a generarlos — thesis LESSONS.md
  • Comparar fechas serializadas como texto inventa fallos después de una escritura correcta — thesis LESSONS.md
  • CI puede verificar una versión histórica del monitor de crédito y omitir la desplegada — thesis LESSONS.md
  • 2026-09-21 · Un espejo necesita catálogo y disparador del consumidor — thesis LESSONS.md
  • JWT auth en edge functions — ademas-ai docs/LESSONS.md
  • RPC updateagent — merge JSONB con || — ademas-ai docs/LESSONS.md
  • Nunca actualizar agents con anon key — ademas-ai docs/LESSONS.md
  • Verificar la hipótesis contra filas reales ANTES de codificarla — ademas-ai docs/LESSONS.md
  • Migraciones por replace() llevan guard ruidoso obligatorio — ademas-ai docs/LESSONS.md
  • Una policy RLS sin TO aplica a PUBLIC; "para el service role" sin TO servicerole abre la tabla a la anon key — ademas-ai docs/LESSONS.md
  • Una traducción vieja junto a un texto nuevo son dos revistas distintas — glossa LESSONS.md
  • La semana del lector, no la del servidor — glossa LESSONS.md
  • Un índice parcial no puede arbitrar un ON CONFLICT — glossa LESSONS.md
  • Una fila que se marca «en curso» necesita quién la rescate — glossa LESSONS.md
  • Una ventana relativa a «hoy» multiplica filas en vez de actualizarlas — glossa LESSONS.md
  • ON DELETE CASCADE detrás de un botón que dice «remove» — glossa LESSONS.md
• deployment / hosting — 11
  • Un deploy que publica «todo el repo menos X» termina publicando lo que no debía — thesis LESSONS.md
  • Borrar el service worker de un sitio NO desinstala el de los teléfonos — publica uno «de despedida» — thesis LESSONS.md
  • Cablear la interfaz ANTES de la primera llamada de red — thesis LESSONS.md
  • 2026-09-21 · El despliegue debe conservar el árbol de imports — thesis LESSONS.md
  • 4.1 Service worker cache busting — thesis phd-pm/docs/LESSONS-LEARNED-2026-04.md
  • Nunca reconstruir index.html desde el JSX — ademas-ai docs/LESSONS.md
  • CDN de Cloudflare Pages cachea agresivamente — ademas-ai docs/LESSONS.md
  • Al retirar un mecanismo, auditar si su reemplazo re-embarca el mismo bug — ademas-ai docs/LESSONS.md
  • .reverse() in-place ya mordió dos veces (INV-38 y F2.1) — ademas-ai docs/LESSONS.md
  • Una función desplegada a mano es código que el siguiente despliegue borra — glossa LESSONS.md
  • Los 150 s de una edge function deciden el modelo, no al revés — glossa LESSONS.md
• mobile web UI — 6
  • A list that never refetches looks exactly like a sync bug — aroma docs/LESSONS.md
  • iOS Safari ignores an SVG apple-touch-icon — aroma docs/LESSONS.md
  • Optimistic UI removes perceived AI/network latency — aroma docs/LESSONS.md
  • Stock inline edit needs blur save on iPhone — aroma docs/LESSONS.md
  • Safe area insets for iPhone — aroma docs/LESSONS.md
  • Clipboard paste on iPhone requires onPaste handler — aroma docs/LESSONS.md
• repository / CI-CD — 4
  • La cuenta informa más que la lista — glossa LESSONS.md
  • Un contrato no viaja en frases para humanos — glossa LESSONS.md
  • Una fuente correcta y callada se lee igual que una averiada — glossa LESSONS.md
  • Un título de feed trae el eslogan pegado — glossa LESSONS.md
• design system — 3
  • Override --font-serif to restyle every title at once — aroma docs/LESSONS.md
  • Un contador que enseña «usados» se lee como «quedan» — glossa LESSONS.md
  • Si lo decide el sistema, el panel no enseña mandos — glossa LESSONS.md
• CI/CD — 2
  • El canal de alerta de un sistema autónomo no puede ser uno que el humano ignora (D-15) — ademas-ai docs/LESSONS.md
  • «No arrancó» no es «falló»: lee las annotations antes de depurar código — ademas-ai docs/LESSONS.md
• vector database / embeddings — 2
  • Una búsqueda vectorial por escaneo exacto escala lineal con el corpus — y un día cruza el statementtimeout — thesis LESSONS.md
  • Validar el índice no es validar el instrumento — thesis LESSONS.md
• billing / payments — 1
  • 2026-06-28 — Prepaid estimate ledger — radius docs/DECISIONS.md

• Provider strings flagged for vocabulary drift: Supabase (project numora). Confirm each one marks a genuinely separate account rather than a differently-worded same service.
• Bound by STANDARD-ACTIONS-BUDGET (matched on GitHub Actions) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-DOC-ENTRYPOINT (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-PUBLISHED-OUTPUT (matched on GitHub) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.
• Bound by STANDARD-TWILIO-OTP (matched on Twilio) and no conforms_to is declared for it. Umbrella reads documentation, not code, so this is a missing declaration rather than proof of non-compliance — but the resource is shared, so the cost of getting it wrong is not.