Curso de Claude Code para Ingeniería de Software para empresas

Context Engineering aplicado a Claude Code para proporcionar únicamente la información necesaria en cada fase del trabajo.

Schema GraphQL como contrato estructurado para tipos, queries, mutations, inputs, enums, interfaces y relaciones del dominio.

Uso de schemas locales, generados durante el build o recuperados de fuentes autorizadas como contexto verificable.

Relación entre resolvers GraphQL, servicios Spring, persistencia, tipos generados y componentes React consumidores.

Rastreabilidad de un cambio desde schema hasta backend, generación de tipos, frontend, tests y documentación.

Detección anticipada de breaking changes, modificaciones de nullability, enums, argumentos y tipos de respuesta.

Compatibilidad hacia atrás y evolución progresiva de contratos para evitar despliegues coordinados innecesariamente.

OpenAPI y contratos REST como alternativa o complemento del mismo enfoque contract-first.

Consumer-Driven Contract Testing para comprobar que cambios aparentemente válidos no rompen consumidores.

CLAUDE.md para conservar comandos, arquitectura, convenciones y restricciones que deben conocerse en cada sesión.

`.claude/rules/` para separar instrucciones específicas de backend, frontend, testing, infraestructura o determinadas rutas.

Skills para cargar documentación contractual extensa únicamente cuando resulte relevante y reducir ruido de contexto.

MCP para acceder a schemas, catálogos API, documentación o registros externos sin copiarlos manualmente en la conversación.

Subagents orientados a estudiar diferentes capas y devolver únicamente los hallazgos necesarios al agente principal.

Regla de evidencia: ninguna modificación contractual debe basarse exclusivamente en una API o propiedad inferida por el modelo.

Threat modeling previo a modificaciones sobre autenticación, autorización, sesiones, datos sensibles o superficies expuestas.

Revisión de Spring Security, SecurityFilterChain, method security, JWT, OAuth 2.0 y OpenID Connect.

Análisis de roles, authorities, scopes y claims utilizados por backend y frontend.

Verificación de controles aplicados a endpoints REST, resolvers GraphQL y recursos subyacentes.

Revisión de CORS, CSRF, cookies, SameSite, headers y almacenamiento de tokens.

Detección de IDOR/BOLA, Broken Access Control, Mass Assignment y validaciones insuficientes.

Análisis de exposición accidental de PII, secretos y datos internos a través de logs, excepciones o respuestas.

Claude Security plugin para analizar vulnerabilidades del codebase y transformar hallazgos en propuestas de parche revisables.

Security Guidance plugin para incorporar revisión de seguridad durante la propia generación de código.

Subagent de seguridad independiente del agente encargado de implementar la funcionalidad.

Hooks `PreToolUse` para bloquear operaciones prohibidas de forma determinista en lugar de confiar únicamente en instrucciones textuales.

Permission rules allow, ask y deny para restringir lectura, edición, Bash y herramientas externas.

Sandboxed Bash para limitar filesystem y acceso de red durante ejecuciones con mayor autonomía.

Separación de secretos, credenciales, tokens y configuración sensible del contexto que recibe el modelo.

Aprobación humana obligatoria para cambios de criptografía, identidad, autorización, infraestructura crítica o datos productivos.

Skills como paquetes reutilizables de instrucciones, conocimiento y workflows invocables manualmente o cargados cuando resultan relevantes.

Diseño de una Skill orientada a testing mediante `SKILL.md`, convenciones del proyecto, criterios de aceptación y comandos de validación.

Separación entre instrucciones persistentes de CLAUDE.md y contenido especializado que debe cargarse únicamente bajo demanda.

Subagents como trabajadores aislados con ventana de contexto, prompt, tools y Skills propios.

Subagent de exploración para localizar suites existentes, patrones, fixtures y estrategias antes de generar nuevas pruebas.

Subagent de Quality Engineering para unit, integration, API, contract y end-to-end testing.

Generación de tests dirigidos a comportamiento y regresiones frente a pruebas triviales destinadas únicamente a elevar cobertura.

Prevención explícita de modificar, eliminar o deshabilitar tests para conseguir artificialmente una ejecución satisfactoria.

Agent Teams para coordinar varias sesiones Claude Code independientes con tareas compartidas y comunicación entre agentes.

Diferencias entre Subagent y Agent Team según aislamiento, comunicación, coste y necesidad de coordinación autónoma.

Revisores paralelos especializados en testing, seguridad, rendimiento y arquitectura.

Dynamic Workflows para orquestar mediante scripts conjuntos amplios de subagents sobre auditorías, migraciones o investigación.

Worktrees separados para agentes que necesitan modificar código simultáneamente.

Integración de resultados del testing como condición explícita para continuar o detener una automatización.

Evaluación de coste y calidad antes de utilizar Agent Teams en trabajos que un único Subagent puede resolver de forma más eficiente.

Debugging basado en evidencia antes de permitir modificaciones del código.

Reconstrucción de incidencias desde interfaz React hasta GraphQL o REST, Spring, persistencia y servicios downstream.

Correlación de browser console, network requests, stack traces, excepciones, logs y resultados de tests.

Construcción de varias hipótesis de causa raíz y priorización según evidencia observable.

Uso de Plan Mode para investigar sin modificar mientras se acota el problema.

Navegación web y browser tooling para reproducir flujos, inspeccionar estados y comprobar aplicaciones.

Claude Code con Chrome para automatizar navegación, formularios, extracción de datos y debugging basado en console logs.

Computer Use para interactuar con aplicaciones gráficas cuando la investigación no puede resolverse desde terminal o navegador.

Grafana, Prometheus, Elastic, Sentry y otras plataformas como fuentes de telemetría accesibles directamente o mediante MCP.

Distributed tracing y Correlation IDs para reconstruir operaciones que atraviesan múltiples servicios.

Reducción de grandes volúmenes de observabilidad antes de incorporarlos al contexto principal.

Análisis temporal de errores frente a commits, releases, cambios de configuración y dependencias.

Regression tests creados después de disponer de una reproducción fiable del defecto.

Separación entre diagnóstico, corrección y verificación para evitar que una hipótesis inicial condicione toda la investigación.

Incorporación de conclusiones confirmadas a documentación, Rules o memoria sin convertir inferencias no demostradas en conocimiento permanente.

Documentación como parte de la Definition of Done de una modificación y no como trabajo opcional posterior.

Actualización de README, instalación, configuración, despliegue, testing y troubleshooting a partir del codebase real.

Documentación de arquitectura, módulos, responsabilidades y contratos REST o GraphQL.

Architecture Decision Records para registrar decisión, alternativas, restricciones y trade-offs.

Detección mediante diffs de cambios que afectan realmente a documentación funcional o técnica.

Actualización localizada de secciones afectadas sin regenerar innecesariamente documentos completos.

Traducción de modificaciones técnicas a explicaciones funcionales comprensibles para perfiles no especializados.

Trazabilidad entre issue, código, tests, ADR, documentación y release.

Detección de cambios de interfaz que convierten capturas anteriores en evidencias obsoletas.

Automatización de navegación y preparación de estados antes de capturar evidencias visuales reproducibles.

Chrome o Computer Use para recopilar capturas cuando la interfaz forma parte de la documentación.

Artifacts de Claude Code para transformar resultados de una sesión en páginas interactivas compartibles cuando resulte apropiado.

Quality Gate que impida documentar comportamientos que no pueden justificarse con código, contratos, tests o ejecución.

Revisión separada de contenido técnico y contenido funcional según el público destinatario.

Automatización de documentación sin permitir que el agente convierta inferencias sobre el producto en hechos publicados.

Arquitectura RAG aplicada a repositorios, documentación, ADR, configuración, contratos y conocimiento operativo.

Diferenciación de fuentes por repositorio, módulo, versión, branch, lenguaje, tipo de artefacto y nivel de sensibilidad.

Preparación de código y documentación para ingestión, normalización, metadata y actualización incremental.

Chunking estructural de funciones, clases, módulos, schemas, documentación y decisiones arquitectónicas.

Preservación de relaciones necesarias para interpretar correctamente código, tipos, imports y contratos.

Hybrid Retrieval mediante embeddings, búsqueda textual y filtros estructurados.

Separación estricta entre retrieval y generación para conocer la evidencia realmente proporcionada al modelo.

MCP como capa de acceso a motores de búsqueda, vector stores, documentación, bases de datos o servicios de conocimiento.

Claude Agent SDK para construir agentes de producción reutilizando el agent loop y capacidades de Claude Code.

Incorporación de CLAUDE.md, Skills, Hooks y otras extensiones de Claude Code dentro de agentes construidos con Agent SDK.

Asistente interno capaz de citar archivo, repositorio, versión, documento y fragmento recuperado.

Respuesta explícita de información insuficiente cuando el corpus recuperado no respalda una conclusión.

ACL y autorización previa a retrieval para impedir que el asistente amplíe los permisos originales sobre la información.

Evaluation set para medir retrieval relevance, answer correctness, groundedness y cobertura.

Sincronización entre cambios de código, cambios documentales y reindexación para evitar respuestas basadas en versiones obsoletas.

Representación de dependencias directas y transitivas entre aplicaciones, módulos, librerías, APIs y componentes.

Inspección de manifests, lockfiles, Maven, Gradle, npm, pnpm, Docker y otros artefactos de dependencias.

Identificación de consumidores antes de actualizar una librería, runtime o contrato.

Análisis de release notes, changelogs, migration guides y diferencias de API.

Clasificación de modificaciones compatibles, deprecated, behavioral y breaking.

Localización mediante Code Intelligence de símbolos, tipos, clases, métodos y referencias potencialmente afectadas.

Subagents paralelos para analizar diferentes módulos sin saturar el contexto principal.

Construcción de un Impact Map antes de iniciar cambios.

Relación del cambio con código, configuración, tests, documentación, observabilidad e infraestructura.

Detección de impactos indirectos producidos por dependencias transitivas.

Priorización según criticidad, frecuencia de uso, exposición y riesgo de regresión.

Diferenciación entre componentes que requieren adaptación y componentes que únicamente requieren validación.

Migration Plan incremental con gates y puntos de rollback.

Evidencias técnicas que justifiquen cada cambio propuesto por Claude.

Prevención de actualizaciones masivas que combinan demasiados cambios difíciles de validar o revertir.

Modelado de relaciones entre librerías base, servicios, frontend, contratos, infraestructura y consumidores.

Detección de modificaciones que deben propagarse entre capas o repositorios.

Consistencia entre backend, frontend, tipos generados, clientes y componentes compartidos.

Automatización de actualizaciones mecánicas sobre manifests, configuración, referencias y versiones.

Separación entre transformaciones mecánicas automatizables y cambios semánticos que requieren decisión humana.

Ordenación de la migración según dependencias entre productores y consumidores.

Compatibilidad temporal y estrategias que permitan despliegues progresivos.

Worktrees para mantener líneas de migración independientes dentro de un mismo repositorio.

Claude Code in the cloud para delegar tareas prolongadas sobre repositorios conectados y recuperar después sus cambios.

Projects para coordinar trabajo relacionado entre varias sesiones cloud que comparten repositorios, instrucciones y memoria.

Dynamic Workflows para generar y reutilizar orquestaciones de Subagents en migraciones a gran escala.

Agent Teams cuando diferentes agentes necesitan intercambiar hallazgos durante una migración compleja.

Validaciones por capa antes de propagar el cambio al siguiente consumidor.

Resumen consolidado de componentes actualizados, pendientes, riesgos y decisiones manuales.

Patrón repetible para futuras actualizaciones de framework, runtime, SDK, API o librería corporativa.

Conversión del Impact Map y Migration Plan en tareas concretas y verificables.

Restricción previa de archivos, comandos, herramientas, redes y sistemas que Claude puede utilizar.

Permission Mode adecuado a cada fase: Plan, aprobación de cambios o ejecución más autónoma en entornos aislados.

División del trabajo en incrementos pequeños que puedan revisarse y revertirse.

Worktrees para aislar implementaciones realizadas en paralelo.

Subagent implementador separado del agente encargado de revisión o testing.

Build, type checking y static analysis después de modificaciones estructurales.

Ejecución progresiva desde tests directamente afectados hasta regresiones más amplias.

Prohibición explícita de modificar controles de calidad para ocultar fallos introducidos por la implementación.

Stop Conditions ante requisitos contradictorios, falta de evidencia, riesgos de seguridad o fallos externos al alcance.

`/goal` para mantener a Claude trabajando hacia una condición de finalización verificable en tareas adecuadas.

Hooks PostToolUse para ejecutar linters, formatters o validaciones inmediatamente después de determinados cambios.

Checkpointing y rewind para recuperar estado de conversación o código cuando una línea de trabajo resulta incorrecta.

Validación visual cuando existen comportamientos observables por usuario.

Resultado final expresado mediante cambios, tests, evidencias, riesgos pendientes y criterios de aceptación satisfechos.

Análisis del diff completo antes de realizar operaciones Git.

Separación de cambios independientes en commits pequeños, coherentes y reversibles.

Commit messages basados en intención funcional y no únicamente en archivos modificados.

Exclusión de archivos temporales, credenciales y cambios ajenos a la tarea.

Relación trazable entre requisito, análisis, código, pruebas y commit.

Creación de branches y Pull Requests desde Claude Code respetando convenciones del repositorio.

`/review` para realizar revisión de Pull Requests dentro de la sesión activa.

Code Review automatizado con análisis multiagente del codebase para detectar errores lógicos, vulnerabilidades y regresiones.

`/ultrareview` para revisión cloud profunda y multiagente en escenarios de especial complejidad.

Claude Security como revisión específica adicional para hallazgos de seguridad.

Revisión humana como control independiente aunque varias capas de IA hayan aprobado el cambio.

Comentarios de Pull Request como nuevas entradas para una iteración controlada del agente.

GitHub Actions de Claude Code para responder a menciones, automatizar tareas y transformar issues en Pull Requests.

GitLab CI/CD como alternativa oficialmente soportada para integrar Claude en flujos de desarrollo.

Branch protection y aprobación obligatoria antes de incorporar cambios críticos.

Sesiones cloud de Claude Code para ejecutar trabajo sobre repositorios sin depender de una terminal local abierta.

Inicio desde navegador, móvil, Desktop o terminal y movimiento de sesiones mediante capacidades cloud.

Cloud environments con network access, variables de entorno, setup scripts y caché de entorno.

Configuración de repositorios y credenciales estrictamente necesarias para cada ejecución.

Projects como agrupación de trabajo relacionado capaz de coordinar sesiones cloud paralelas.

Agent View para administrar múltiples sesiones y localizar cuáles requieren intervención humana.

Cross-session messaging para permitir que sesiones Claude Code intercambien información cuando resulta necesario.

Worktrees y Git isolation para impedir colisiones entre tareas paralelas.

Self-hosted environments para ejecutar sesiones cloud sobre infraestructura controlada por la organización.

Routines como automatizaciones cloud persistentes disparadas por calendario, API o eventos GitHub.

Routines para revisión, triage, documentación, verificación post-deploy, mantenimiento y sincronización entre repositorios.

Restricciones de branch, network access y connectors como controles principales de una Routine autónoma.

Desktop Scheduled Tasks frente a Routines cloud y criterios para seleccionar ejecución local o remota.

Remote Control y aplicaciones móviles para supervisar o continuar una sesión sin permanecer delante de la máquina.

Comparación entre ejecución local, cloud administrado y self-hosted según datos, aislamiento, duración, coste y regulación.

Diseño de workflows analyse → plan → implement → validate → review → document → propose PR.

Hooks como mecanismo determinista que se ejecuta ante eventos concretos del ciclo de vida del agente.

PreToolUse para validar o bloquear operaciones antes de que ocurran.

PostToolUse para ejecutar linters, tests, logging o validaciones después de una acción.

HTTP, prompt y subagent hooks para extender la automatización más allá de shell scripts.

Channels para introducir alertas, webhooks, mensajes o resultados de CI dentro de una sesión Claude Code activa.

`/loop` para comprobaciones recurrentes mientras una sesión CLI permanece abierta.

Routines cloud para procesos desatendidos que deben sobrevivir al cierre del equipo del desarrollador.

Triggers por calendario, API y GitHub dentro de una misma Routine.

Idempotencia para impedir que reintentos o eventos duplicados repitan modificaciones.

Reintentos, timeouts, estados parciales y Stop Conditions.

Conectores MCP para acceder a issue trackers, Slack, observabilidad, documentación y otros sistemas.

GitHub Actions y GitLab CI/CD como integración nativa en pipelines existentes.

Human Approval Gates antes de despliegues, acciones destructivas, publicación o modificación de sistemas compartidos.

Métricas de tasa de éxito, duración, retrabajo, escalado humano y coste de cada automatización.

Claude Agent SDK como librería para construir agentes de producción sobre las capacidades utilizadas por Claude Code.

SDK de Python y TypeScript para ejecución programática de sesiones y agent loops.

Diferencias entre CLI headless, Agent SDK y sesión interactiva.

Configuración de modelo, entorno, límites, herramientas, permisos y persistencia desde código.

Reutilización de CLAUDE.md, Skills, Hooks y otras capacidades de Claude Code dentro de agentes construidos con SDK.

Callbacks de permisos para implementar aprobación dinámica de herramientas en aplicaciones propias.

MCP como estándar para conectar datos, APIs, bases de datos, browser automation y herramientas empresariales.

`.mcp.json` como configuración versionable de servidores MCP compartidos por el proyecto.

Servidores MCP locales y remotos, OAuth y control de herramientas disponibles.

MCP frente a Skills: conexión externa frente a conocimiento o procedimiento reutilizable.

Plugins como paquetes que agrupan Skills, Subagents, Hooks y MCP Servers para su distribución.

Plugin marketplaces internos para estandarizar extensiones corporativas.

Plugin evals para medir el comportamiento añadido antes de distribuir una extensión a toda la organización.

Gateways LLM para centralizar credenciales, modelos, tracking de uso y límites económicos.

Diseño de una plataforma interna de ingeniería agéntica sin ocultar permisos, trazabilidad ni responsabilidad sobre las acciones.

Modelo de gobierno para herramientas capaces de leer, editar y ejecutar software empresarial.

Managed Settings y Server-Managed Settings para imponer configuración organizativa en los equipos de desarrollo.

Managed MCP para permitir, bloquear o proporcionar servidores MCP de forma centralizada.

Permission rules, Hooks y sandbox como capas diferenciadas de control preventivo.

Selección del sandbox según el threat model: Bash sandboxed, container, dev container, Docker o VM.

Network configuration empresarial mediante proxies, Certificate Authorities y mTLS.

Gateways corporativos para centralizar credenciales, uso, modelos y controles de coste.

OpenTelemetry para exportar métricas operativas y analizar el uso de Claude Code.

Analytics para medir adopción y patrones de utilización dentro del equipo.

Seguimiento de tokens, gasto y selección de modelos según criticidad y complejidad.

Coste por feature, Pull Request, Routine, Agent Team o workflow automatizado.

Indicadores de calidad: regresiones, rollback rate, review findings, tasa de éxito y retrabajo.

Human Intervention Rate para identificar procesos que todavía no son adecuados para autonomía.

Zero Data Retention y políticas de tratamiento cuando la organización y el plan cumplen los requisitos aplicables.

Modelo operativo donde productividad, calidad, seguridad, privacidad y coste evolucionen conjuntamente.

Arquitectura de referencia de un workflow FullStack empresarial basado en Claude Code y varios agentes especializados.

Codebase con backend, frontend y contrato API compartido, incluyendo una dependencia o componente que requiera evolución coordinada.

Modelo de instrucciones mediante CLAUDE.md, Rules y Skills adaptado a arquitectura, testing, seguridad y convenciones.

Topología de Subagents para exploración, impacto, implementación, QA, seguridad y documentación.

Agent Team o Dynamic Workflow reservado a las fases en las que la coordinación paralela aporte una ventaja verificable.

Arquitectura de contexto que limite a cada agente al código, contratos, documentación y herramientas necesarios.

Dependency Graph, Impact Map y Migration Plan como artefactos previos a cualquier modificación.

Worktrees independientes para separar líneas de implementación y revisión.

Estrategia de propagación entre backend, frontend, contratos, documentación y consumidores.

Gates de build, tipos, contract tests, unit, integration y end-to-end testing.

Revisión independiente mediante Code Review, ultrareview o Claude Security según criticidad.

Documentación técnica, funcional y evidencias visuales sincronizadas con el comportamiento resultante.

Base RAG de código y documentación accesible mediante MCP o Agent SDK y protegida por permisos.

Routine o pipeline desatendido para detectar futuras actualizaciones y proponer cambios sin integrarlos automáticamente.

Modelo final de seguridad, observabilidad, costes, aprobación humana, rollback y reutilización del workflow en futuras evoluciones.