Crear el proyecto Laravel del equipo: Sail con puertos propios, composer qa y la configuración del Setup

Hola, bienvenido. En esta lección vamos a crear el proyecto helpdesk, el primero del equipo de Marta y el que nos va a acompañar durante todo el curso. Lo vamos a crear desde cero con laravel.build y con Sail en puertos propios, para que conviva con cualquier otro proyecto que tengas levantado. Después vamos a añadir las herramientas de QA y los 18 arch tests tal como los dejó el Setup Profesional, y a copiar la configuración de Claude Code de tu proyecto de ese curso. Al terminar tendrás composer qa en verde y 2 commits.

¿Por qué crear el proyecto aquí en vez de partir del proyecto final del curso Setup Profesional Laravel + IA para 2026↗ (se abre en una pestaña nueva)? Porque en un equipo todo el mundo tiene que arrancar del mismo estado, y un proyecto que cada uno construyó a su ritmo nunca es exactamente igual al de al lado: una restricción de versión distinta, un archivo que se quedó sin commit, un composer.lock de otro día. Con un script y unos archivos que copias tal cual, el proyecto es el mismo en tu máquina y en la de cualquiera que siga el curso. Del Setup solo vamos a traer lo que es de la IA: .claude/, CLAUDE.md, .ai/, boost.json y .mcp.json. Lo demás lo vamos a crear paso a paso en esta lección. Cada herramienta y cada regla se explican en ese curso, así que aquí nos centramos en instalarlas y configurarlas.

Todo el curso vive en ~/code/team, la carpeta que dejamos creada en la lección anterior: ahí van a ir los 4 repos del equipo. En toda esta primera sección los comandos los ejecuta Marta, y los de esta lección, en la pestaña helpdesk, que de momento está abierta en ~/code/team y, en cuanto exista el proyecto, va a quedarse en ~/code/team/helpdesk.

laravel.build es el script oficial de Laravel para crear un proyecto nuevo con Sail sin tener PHP ni Composer en tu máquina: lo hace todo en un contenedor. Vamos a pedirle MySQL y Redis, y nada más. Mailpit, Meilisearch y Selenium no los necesita el curso, y Mailpit además publicaría los puertos 1025 y 8025, que es fácil que ya tengas ocupados. En la pestaña helpdesk:

El script crea el proyecto, instala Sail, descarga las imágenes de MySQL y Redis y construye la imagen de PHP, así que la primera vez tarda unos minutos. Esta es la parte de su salida que interesa, resumida:

Al final pide tu contraseña: el proyecto lo ha creado un contenedor como root y, con sudo chown, el script deja los archivos a tu nombre. En tu máquina, las versiones pueden ser otras. En la misma pestaña, entra en el proyecto. Es el único cd que hace falta: desde aquí la pestaña helpdesk ya está en su carpeta, y en ella vamos a ejecutar todo lo que queda de lección:

La pestaña ya está en su carpeta, pero el layout todavía no lo sabe: si otro día lanzas zellij --layout team en vez de zellij attach, la pestaña helpdesk se abrirá otra vez en ~/code/team. Para que no pase, vamos a reescribir ~/.config/zellij/layouts/team.kdl con la pestaña helpdesk ya en ~/code/team/helpdesk. En la misma pestaña:

Vamos a hacer lo mismo con cada repo que aparezca en el curso: cuando abramos su pestaña, reescribiremos el layout con todas las que tengas hasta ese punto, y así zellij --layout team las abrirá siempre, cada una en su carpeta.