Traspaso de Sesión entre Agentes
Compacta la conversación actual en un documento de traspaso estructurado para que otro agente pueda continuar el trabajo desde donde se dejó. Incluye redacción automática de secretos, recomendación de skills para la próxima sesión y carga automática al inicio de nueva sesión.
Descarga abierta · sin registro · para Claude Code, Claude AI
generated_at: 2026-06-12T19:45:00Z goal: "Terminar la conexión n8n → ERP de NutriFlow (resolver 401, configurar variables de entorno) y abrir PR de revisión del flujo antes del deploy a producción." project: nutriflow-shopify-erp-integration agent: cs-handoff-author redaction: strict — sin secretos detectados
Handoff — 2026-06-12
Un agente fresco lee esto para continuar el trabajo. No duplicar artefactos (PRDs, planes, ADRs, commits, diffs) — referenciarlos por ruta o URL.
Goal of next session
Terminar de conectar n8n → ERP de NutriFlow: resolver el error 401 en staging configurando la variable de entorno API_KEY_ERP en n8n, validar el flujo de extremo a extremo con un pedido de prueba en Shopify staging, y abrir un PR de revisión del flujo completo antes del deploy a producción.
State of play
Git context
- Rama:
feat/nutriflow-n8n-erp-integration - Último commit:
3d8a91c feat(n8n): transformer payload passes all unit tests - Archivos sin commitear: 2 (nodo HTTP Request pendiente de ajuste, README de variables de entorno)
Completado
- Auditoría de webhooks Shopify — 3 webhooks activos documentados → ver
/proyectos/nutriflow/docs/shopify-audit-2026-06-12.md - Diseño del flujo n8n de 4 nodos: Webhook receptor → Transformador → HTTP Request ERP → Brevo email
- Implementación y tests del transformador de payload — 100% tests pasando → ver
/proyectos/nutriflow/n8n/tests/test_transformer.py - ADR-001 sobre estrategia de autenticación ERP redactado → ver
/proyectos/nutriflow/docs/ADR-001-auth-strategy.md - Flujo n8n exportado en v0.3 → ver
/proyectos/nutriflow/n8n/nutriflow-orders-flow-v0.3.json
En vuelo
- Nodo HTTP Request al ERP: implementado pero falla 401 en staging — credenciales no configuradas en variables de entorno de n8n
- README de variables de entorno de n8n: borrador iniciado, sin commitear
Bloqueado
- Deploy a producción: en espera hasta que el flujo completo pase validación en staging
- Confirmación del endpoint ERP
/api/ordersen producción: pendiente de verificar con el equipo técnico de NutriFlow (no confirmado si coincide con staging)
Open decisions
¿API key o OAuth2 para autenticar contra el ERP en producción?
- ADR-001 recomienda API key (menor fricción, ERP no soporta OAuth2 nativo)
- Pendiente: confirmación formal del equipo técnico de NutriFlow
- Impacto: si cambia a OAuth2, el nodo HTTP Request necesita refactorización
¿Dónde almacenar
API_KEY_ERPen n8n Cloud?- Opciones: variables de entorno globales n8n, credencial nativa n8n, secreto externo (Vault/1Password)
- Lean: credencial nativa n8n (más trazabilidad, sin dependencias externas)
- Decidir antes de configurar staging — la elección afecta cómo se documenta el deploy
¿Reintento automático en el nodo HTTP Request si el ERP devuelve 5xx?
- n8n soporta retry nativo o via nodo de error
- No definido en el diseño actual — aclarar con NutriFlow si es requisito para v1
Alcance de los emails Brevo: ¿solo
order/paido tambiénorder/create?- El flujo actual dispara email en cualquier evento que llegue al webhook
- NutriFlow no ha confirmado el comportamiento esperado para
order/create
Skills to use
| Skill | Por qué |
|---|---|
shopify-storefront-graphql |
Para crear un pedido de prueba en staging de Shopify y disparar el webhook order/paid extremo a extremo |
security-scan |
Para verificar que API_KEY_ERP no aparece en ningún artefacto commiteado antes de abrir el PR |
revops |
Para mapear el flujo de pedido → ERP → notificación y detectar gaps de trazabilidad antes del deploy |
code-review |
Para revisar el flujo n8n exportado y el transformador antes de abrir el PR de revisión |
analytics-tracking |
Para definir los eventos de monitoreo del pipeline (tasa de éxito webhooks, latencia ERP, errores Brevo) en producción |
Artifacts
| Artefacto | Ruta / URL |
|---|---|
| ADR-001 — Estrategia de autenticación ERP | /proyectos/nutriflow/docs/ADR-001-auth-strategy.md |
| Flujo n8n v0.3 (exportado) | /proyectos/nutriflow/n8n/nutriflow-orders-flow-v0.3.json |
| Tests del transformador de payload | /proyectos/nutriflow/n8n/tests/test_transformer.py |
| Auditoría de webhooks Shopify | /proyectos/nutriflow/docs/shopify-audit-2026-06-12.md |
| README variables de entorno n8n | /proyectos/nutriflow/docs/n8n-env-vars.md (borrador, sin commitear) |
| Rama de trabajo | feat/nutriflow-n8n-erp-integration |
Generado por cs-handoff-author · Skill: traspaso-sesion-agente v1.0.0 · Redacción: estricta (sin secretos detectados)
// qué_hace
Genera un documento de traspaso de 5 secciones (objetivo, estado, decisiones abiertas, skills sugeridas, artefactos) que permite a un agente fresco continuar el trabajo de una sesión anterior.
// cómo_lo_hace
Usa scripts Python (setup, template generator, redaction linter, self-check, skill recommender, cleanup) con hooks SessionStart/SessionEnd para automatizar la carga y recordatorio del traspaso entre sesiones.
// ejemplo_de_uso
Úsala en proyectos largos con múltiples sesiones de Claude para no repetir contexto cada vez. Ej.: al terminar la sesión se guarda el estado del sprint y al inicio del día siguiente el agente lo carga automáticamente.
// plataformas
// opiniones_de_la_comunidad
Opiniones
Cargando opiniones…
// pase_cultiva_ia
Llévate todo el arsenal con el Pase
Todas las skills, prompts y automatizaciones del catálogo en un único archivo, listas para usar: un pago, acceso de por vida y las novedades que añadamos. Sin suscripción.
Pago único · IVA incluido · pago seguro con Stripe.
Acceso inmediato · si no es lo que esperabas, te devolvemos los 10 €.