Primeros 30 minutos · Fieldnotes

Lee antes de ejecutar

Lee README, CONTRIBUTING, AGENTS.md y los runbooks internos.
Mira rama y cambios locales: git status --short --branch.
Busca pom.xml, mvnw, build.gradle, gradlew, package.json, Dockerfile y compose.yaml.
Identifica perfiles, variables, bases locales y servicios externos. Pregunta por los accesos necesarios.
Usa el comando documentado y conserva el primer error completo.

El wrapper (mvnw o gradlew) fija la versión de la herramienta de build. Si el repositorio lo incluye, normalmente conviene usarlo.

Qué	Dónde mirar
Java activo	`java -version`
Versión que compila	`java.version`, `maven.compiler.release`, `sourceCompatibility` o `toolchain`
Spring Boot	Parent, BOM o plugin en Maven/Gradle
Gradle	`gradle/wrapper/gradle-wrapper.properties`
Frontend	`package.json` y su lockfile
Configuración	`application.yml`, `application-{profile}.yml`, variables de entorno

La JVM de tu terminal, el compilador del proyecto y el runtime de producción pueden ser distintos. Contrástalos con el build y CI.

Primero confirma el perfil y los servicios que requiere el proyecto.

# Maven en Windows PowerShell
.\mvnw.cmd spring-boot:run

# Gradle en Windows
.\gradlew.bat bootRun

# Linux / macOS
./mvnw spring-boot:run
./gradlew bootRun

Para el frontend, lista los scripts disponibles antes de elegir uno:

npm run

Usa el gestor y la versión del runtime indicados por el proyecto.

Versión incompatible: compara JDK activo, versión declarada y CI.
Dependencias: podría faltar red, acceso a un repositorio privado, proxy o credenciales.
Configuración: pregunta cuál perfil local se usa y qué variables hacen falta.
Puerto ocupado: identifica el proceso antes de detenerlo.
Base o servicio externo: confirma estado, host, puerto y permisos de red.

No compartas tokens, contraseñas, datos de clientes ni contenido de .env en chats o capturas.