1.0 Cómo cursar y conocer Nexo B2B

Al terminar esta lección

• Armar la carpeta de trabajo donde vas a conservar artefactos y evidencia, con una estructura que un mentor pueda revisar.
• Distinguir el avance registrado en la academia de la revisión del portfolio.
• Clasificar un artefacto como obligatorio, cuando aplica o avanzado según la pregunta que responde.
• Redactar las reglas con las que vas a trabajar con agentes de IA, de modo que su salida nunca figure como evidencia del negocio.
• Leer el brief de Nexo B2B y nombrar, sin resolverlas, las preguntas que esconde.

Versión 7.2 · Edición de profundidad · Septiembre 2026

Equipo de Arquitectura e Ingeniería de Eje Z · Córdoba, Argentina

Cómo trabajar con el manual y el curso

Este libro no intenta convertirte en una enciclopedia de ingeniería de software. Intenta que puedas sentarte frente a una PyME real y saber qué hacer después de cada respuesta, cada contradicción y cada decisión.

Ya programás y ya trabajaste en proyectos. Lo que este curso entrena es lo que suele faltar en ese punto de la carrera: llegar a una empresa que no conocés, descubrir cómo opera de verdad, convertir eso en una especificación que otro humano o un agente de IA pueda ejecutar sin adivinar, tomar decisiones de arquitectura que se puedan defender y, al final, demostrar con evidencia que lo prometido funciona.

El proyecto conductor es Nexo B2B, una distribuidora mayorista ficticia construida a partir de problemas frecuentes en empresas reales. No vas a recibir un caso perfectamente redactado. Al principio sabrás poco, escucharás frases ambiguas y verás herramientas que se contradicen. A medida que avances aparecerán datos nuevos que obligarán a revisar decisiones anteriores. Esa incomodidad es deliberada: el trabajo profesional ocurre así.

Podés estudiar el manual de dos maneras. La primera es acompañar Nexo y producir los mismos artefactos en paralelo. La segunda, más exigente, es abrir cada playbook de campo mientras trabajás con una empresa propia. En ambos casos, la lectura no cuenta como progreso si no podés producir evidencia observable.

Anatomía de un módulo

Todos los módulos de trabajo tienen la misma forma, para que sepas qué esperar y cuánto tiempo reservar:

La práctica de cada taller es evaluable. La solución comentada vive en la biblioteca (lección 14.4) y se lee después de producir tu entrega, no antes: comparar sin haber intentado enseña mucho menos que comparar después de equivocarte.

Cómo se ve tu carpeta de trabajo

No hace falta una herramienta especial: alcanza un repositorio Git vacío (o una carpeta con control de versiones) con una estructura estable. Esta es la que usamos para el módulo 1 y que va a crecer con los demás:

1nexo-b2b/
2├── AGENTS.md                  # reglas de trabajo con agentes (ver más abajo)
3├── 00-brief/
4│   └── brief-original.md      # el mensaje del cliente, literal, con fecha
5├── 01-evidencia/
6│   ├── registro-evidencia.yaml
7│   ├── fuentes/               # capturas, PDFs, fotos, planillas tal como llegaron
8│   │   └── 2026-10-16-reunion-01/ # desde el módulo 2: grabación y material de la reunión
9│   └── consultas/             # desde el módulo 2: SQL de análisis sobre exportaciones
10├── 02-incertidumbre/
11│   ├── plan-investigacion.yaml
12│   └── reglas-candidatas.yaml # desde el módulo 2
13├── 03-notas/
14│   └── 2026-10-16-reunion-01.md
15└── 04-entregas/
16    └── e01-desarmar-el-brief.md

Dos hábitos valen más que cualquier plantilla. Primero, lo que recibís del cliente se guarda tal como llegó en fuentes/ y nunca se edita; tu interpretación vive en otro archivo que referencia la fuente. Segundo, cada cambio relevante es un commit con un mensaje que dice qué evidencia lo motivó. Cuando alguien pregunte "¿por qué dice esto?", el historial tiene que poder responder.

Tres categorías de artefactos

No todos los proyectos necesitan el mismo peso documental. Para evitar que la ingeniería se convierta en burocracia, usamos tres categorías simples:

• Obligatorio: responde una pregunta que casi todo proyecto debe resolver, por ejemplo qué problema se acepta resolver, qué reglas son autoritativas, qué queda fuera de alcance y cómo se demostrará que el comportamiento acordado funciona.
• Cuando aplica: aparece cuando una dificultad concreta lo justifica. Un diagrama de estados puede ser excelente si el comportamiento depende del ciclo de vida; es desperdicio si el objeto tiene dos estados obvios y ninguna transición interesante.
• Avanzado: conviene conocerlo porque algunos proyectos lo necesitan, pero no se impone como ritual. Un diagrama de secuencia detallado, property-based testing o una estrategia de sagas pueden entrar aquí.

La IA está presente desde la primera página

Vas a usar agentes para ordenar notas, buscar contradicciones, proponer preguntas, comparar artefactos, generar escenarios, implementar slices y revisar diffs. Pero nunca vas a usar el output del agente como evidencia del negocio. Un modelo puede ser un excelente colaborador y una pésima autoridad. La autoridad sigue siendo la evidencia verificable, la especificación aprobada, las invariantes, el código revisado, los tests ejecutados y las observaciones que podés mostrar.

Esa regla es fácil de enunciar y difícil de sostener cuando el agente te devuelve, en diez segundos, un documento prolijo con "reglas de negocio" que suenan razonables. La prolijidad no es evidencia. Por eso conviene escribir las reglas del juego una sola vez, en un archivo que el agente lea siempre y que un mentor pueda auditar:

1# AGENTS.md · Reglas de trabajo con agentes (proyecto Nexo B2B)
2​
3## Estatus de lo que producís
4- Todo lo que generes es PROPUESTA. Nunca es evidencia del negocio ni regla confirmada.
5- Si una afirmación no tiene fuente en /01-evidencia, escribila como HIPÓTESIS o DESCONOCIDO.
6- No completes valores faltantes (plazos, porcentajes, umbrales). Escribí DESCONOCIDO.
7​
8## Qué no decidís
9- Alcance (qué entra y qué no), prioridades, autoridad de las fuentes.
10- Si hace falta un portal, una app o cualquier solución concreta.
11​
12## Cómo respondés
13- Citá la fuente (archivo y línea) de cada dato que uses.
14- Cuando algo sea ambiguo, preguntá antes de resolver.
15- Devolvé primero lo que NO pudiste verificar.

No es un conjuro: es un contrato. Si el agente lo viola, el hallazgo es tuyo, no suyo; la verificación es parte del trabajo. En cada lección vas a encontrar un recuadro "IA en esta fase" que concreta ese contrato para la tarea del momento: qué puede hacer el agente, qué no debe decidir, qué contexto necesita y cómo revisar su salida.

Qué vas a producir

• Dossier de discovery y mapa de stakeholders.
• Inventario de evidencia, glosario y registro de incertidumbre.
• Requerimientos, reglas de negocio, NFR y frontera IN / OUT / BLOCKED.
• Casos de uso y especificaciones de comportamiento cuando aportan claridad.
• Modelo conceptual y decisiones arquitectónicas necesarias para el slice.
• Sprint de Arquitectura defendible, con riesgos, pruebas y estrategia de implementación.
• Specification Bundle para humanos y agentes.
• Implementación incremental revisable, evidencia de pruebas y trazabilidad.
• Demo y defensa técnica/comercial frente al cliente.

Proporción de aprendizaje y ritmo de trabajo

Este manual alterna deliberadamente tres modos. Aproximadamente la mitad del recorrido explica el razonamiento y las herramientas con profundidad; alrededor de un cuarto vuelve a Nexo B2B para descubrir nueva evidencia y revisar decisiones; el resto obliga a producir trabajo propio. La proporción no se aplica como una plantilla rígida por página, pero ninguna unidad importante debe convertirse en teoría sin campo ni en ejercicios sin explicación.

Como referencia editorial, los bloques de unas quince páginas buscan aproximadamente ocho páginas de explicación profunda, cuatro de evolución de Nexo B2B y tres de trabajo del alumno. No es una grilla rígida: una unidad puede desviarse y otra compensar, pero el conjunto debe conservar ese equilibrio para que teoría, caso y práctica tengan peso real.

El recorrido es acumulativo, pero no es una cascada. Cada capítulo agrega una capacidad y reutiliza artefactos previos. Cuando una prueba, una conversación o un fallo contradicen algo anterior, se vuelve al punto donde nació la decisión. La secuencia sirve para aprender y para trabajar, no para fingir que un proyecto real avanza en línea recta.

1. Llegó un cliente: aprender a no diseñar antes de tener evidencia.
2. Primera reunión: reconstruir episodios reales, decisiones y fuentes.
3. Negocio real: observar, triangular, nombrar y descubrir excepciones.
4. Requerimientos: separar objetivos, reglas, restricciones, NFR y alcance.
5. Casos de uso: fijar la frontera y convertir objetivos en comportamiento discutible.
6. Especificación: producir contratos que humanos y agentes puedan interpretar igual.
7. Arquitectura: tomar decisiones porque existen riesgos y ASR, no por moda.
8. Sprint de Arquitectura: condensar conocimiento suficiente para comprometer una solución.
9. Construcción con IA: trabajar por slices, planes, diffs pequeños y gates ejecutados.
10. Testing: transformar promesas en evidencia justificable.
11. Integración y demo: comprobar el sistema completo antes de usar producción como laboratorio.
12. Defensa: explicar trade-offs y valor en lenguaje de negocio.
13. Graduación: repetir el proceso en una empresa nueva sin copiar Nexo.

Las flechas punteadas son tan importantes como las sólidas. Cuando un test falla porque nadie entendió una regla, la corrección no es parchar el test: es volver al artefacto donde nació el malentendido (la tabla de reglas, el caso de uso, el glosario) y arreglarlo ahí. Cada módulo te va a pedir que dejes anotado a qué etapa anterior volverías si cierta evidencia apareciera.

Nexo B2B · El mensaje con el que empieza todo

Es tentador escuchar ese mensaje y empezar a imaginar un ecommerce B2B. Todavía no sabemos si el portal es la solución correcta. Ni siquiera sabemos qué significa "tomar un pedido", qué stock es el que no coincide, qué precio usa cada cliente, qué parte del proceso requiere criterio humano o qué errores cuestan dinero. La primera habilidad del programa es resistir la urgencia de resolver antes de comprender.

Nexo vende productos de ferretería e insumos a mayoristas. Tiene alrededor de veinticinco vendedores, dos depósitos (CBA y CEN) y una combinación de ERP, planillas de Excel, WhatsApp y papel. Quien escribe el mensaje es Marta, la dueña. Esos son los datos con los que arrancás; todo lo demás (y en particular cada afirmación del mensaje) está por demostrarse.

Una primera lectura del brief

Leé el mensaje de nuevo y detectá cuántas afirmaciones distintas contiene. No es una sola idea: es un paquete de seis cosas que suenan a una.

Fijate en que ninguna fila se contesta con tecnología. Esa tabla es, en el fondo, el primer artefacto del curso: la lección 1.1 te da las etiquetas para rotular cada celda y la 1.3 te pide producir tu propia versión completa.

Material de trabajo

Errores frecuentes

• Síntoma: estudiás cada lección de corrido y a la semana no podés mostrar un solo artefacto. Causa: tratar el curso como lectura y no como práctica. Corrección: no marques una lección como completada hasta tener en tu carpeta el artefacto que pide.
• Síntoma: editás la captura o el PDF del cliente para "dejarlo más claro". Causa: mezclar fuente e interpretación. Corrección: la fuente se guarda intacta; el resumen y las marcas van en otro archivo que la referencia.
• Síntoma: abrís el curso con una idea de arquitectura y buscás confirmarla en Nexo. Causa: llegar con la solución antes que con las preguntas. Corrección: anotá tu idea como hipótesis con la evidencia que la refutaría y seguí leyendo.
• Síntoma: pasás todos los quizzes y el gate te cuesta. Causa: los quizzes miden reconocimiento; el gate mide si podés demostrar con tus artefactos. Corrección: antes de marcar un criterio del gate, abrí el archivo que lo respalda.

Para llevarte

• El curso se aprueba con artefactos revisables, no con lectura: cada taller termina en una entrega con gate.
• Guardá las fuentes tal como llegaron y escribí tu interpretación aparte, siempre apuntando a la fuente.
• Un artefacto se justifica por la decisión ambigua que reduce; si no hay ambigüedad, no hace falta.
• El output de un agente es una propuesta. Evidencia es lo que podés mostrar: un registro, un documento, una conducta observada, un test ejecutado.
• Nexo B2B arranca con un brief de cinco frases que esconde al menos seis afirmaciones distintas; tu primera tarea es separarlas, no resolverlas.
• Un error descubierto tarde se corrige en el artefacto donde nació, no en el código.