Desarrollo y seguridad Guía paso a paso

Diseñar y auditar una app con Claude Code: The Architect y Cyber Neo

Un flujo en cinco pasos para pasar de una idea a una aplicación construida y revisada: The Architect te entrevista y genera un plano detallado con la seguridad incluida, Claude Code lo construye y Cyber Neo audita el resultado en 11 áreas de seguridad sin modificar tu código.

Nivel
Intermedio
Qué necesitas
Claude Code con una suscripción de Claude, Git y un proyecto o una idea de aplicación.
Cuánto lleva
Entre 1 y 2 horas para el plano y la primera auditoría, sin contar la construcción

Herramienta creada por Enrique Rocha.

Herramientas que usa esta guía

01 Por qué diseñar y auditar por separado

Cuando le pides a un agente «hazme una app de reservas», improvisa: elige tecnologías sobre la marcha, rellena huecos con suposiciones y la seguridad llega, si llega, al final. Este flujo separa el trabajo en tres papeles: alguien que diseña sin escribir código, alguien que construye siguiendo ese diseño y alguien que audita sin tocar nada. Cada papel tiene sus propias reglas, y por eso el resultado es más predecible.

01

The Architect

Agente de diseño para Claude Code. Te entrevista, valida las versiones de cada dependencia y escribe un plano de 20 secciones con criterios de aceptación comprobables.

02

Claude Code

Construye a partir del plano, paso a paso, con un criterio de terminado y un comando de verificación en cada paso.

03

Cyber Neo

Skill de auditoría de seguridad. Lanza cinco subagentes en paralelo, revisa 11 áreas y deja un informe por gravedad. Es de solo lectura.

02 Instalar las dos herramientas

The Architect se instala como plugin desde cualquier sesión de Claude Code. Después tendrás el comando /architect disponible en cualquier carpeta, y los planos se guardan en ./blueprints/ del proyecto en el que estés.

text · Dentro de Claude Code
/plugin marketplace add Hainrixz/the-architect
/plugin install the-architect@soyenriquerocha

Cyber Neo se instala clonándolo en tu carpeta de skills personales; Claude Code lo detecta automáticamente. Si la carpeta no existe, créala antes.

bash · Terminal
mkdir -p ~/.claude/skills
cd ~/.claude/skills
git clone https://github.com/Hainrixz/cyber-neo.git

03 Paso 1: diseñar el plano

Modo Preguntas Duración aproximada Cuándo
/architect-quick 3, en un solo mensaje Unos 10 minutos Proyectos pequeños o cuando ya sabes qué tecnologías quieres
/architect 12-16, en varios mensajes 40-60 minutos Cuando el plano lo va a ejecutar un agente sin supervisión
/architect-brownfield Según el cambio Variable Diseñar una funcionalidad o migración sobre código existente

La entrevista pasa por cuatro fases: descubrimiento, preguntas específicas según el tipo de proyecto, propuesta de arquitectura (que tú confirmas) y generación. Antes de generar, aplica dos filtros: no rellenar huecos con suposiciones y un análisis previo de riesgos. La generación puede tardar 10-30 minutos sin mostrar nada en pantalla; es normal.

Prompt · Contexto para empezar la entrevista
Quiero diseñar [describe la app en dos líneas]. La usarán [quién] y guardará [qué datos: cuentas, pagos, datos personales, documentos]. Para mí la seguridad forma parte del diseño, no es un añadido: quiero que el plano detalle cómo se registran y autentican los usuarios, qué roles existen y qué puede hacer cada uno, cómo se protege cada ruta de la API, dónde hacen falta límites de uso y qué datos se cifran o no se guardan. Si te falta información para decidir algo de esto, pregúntamelo.

04 Paso 2: construir siguiendo el plano

Cada paso del orden de construcción incluye qué hacer, cuándo se considera terminado, cómo verificarlo y un punto de control. Abre Claude Code en la carpeta del proyecto y pídele que trabaje paso a paso. Si la construcción se alarga varias sesiones, /architect-next lee el estado de las tareas y te dice cuál es la siguiente.

Prompt · Construcción por bloques
Lee completo el plano que hay en ./blueprints/. Construye siguiendo su orden de construcción, un paso cada vez. Al terminar cada paso ejecuta su comando de verificación y enséñame el resultado; no avances si falla. No tomes decisiones de seguridad que no estén en el plano: si encuentras una sin definir, para y pregúntame.

05 Pasos 3 a 5: auditar, corregir y volver a auditar

text · En Claude Code, desde la raíz del proyecto
/cyber-neo .

Cyber Neo revisa código (inyecciones, XSS, SSRF…), autenticación y autorización, criptografía, secretos, dependencias, seguridad web (cabeceras, CSRF, cookies), cadena de suministro, CI/CD, contenedores, manejo de errores y logs. No instala paquetes ni modifica el proyecto: su única escritura es el informe, que guarda en ~/Desktop/cyber-neo-report-{proyecto}-{fecha}.md con los hallazgos clasificados como Critical, High, Medium y Low.

Prompt · Corregir a partir del informe
Lee el informe de Cyber Neo más reciente de mi Escritorio. Trabaja primero los hallazgos Critical y después los High, uno por uno: antes de cambiar nada, explícame el problema y el arreglo; después de aplicarlo, dime cómo comprobarlo. Si un arreglo exige una decisión mía (cambiar una librería, mover un secreto, tocar la configuración del servidor), para y pregúntame. Los Medium y Low agrúpalos al final en una lista con su impacto para decidir en otra ronda.
Prompt · Comparar con la auditoría anterior
He vuelto a ejecutar /cyber-neo . tras los arreglos. Compara el informe nuevo con el anterior y dime qué hallazgos Critical y High se han cerrado, cuáles siguen abiertos y si ha aparecido alguno nuevo. Termina con un recuento por gravedad antes y después.

Preguntas frecuentes

No. Solo diseña y escribe el plano. La construcción la hace otra sesión de Claude Code leyendo ese plano.

Sí: clona el repositorio, entra en la carpeta y ejecuta claude. Sigue el mismo flujo de forma conversacional, aunque sin los comandos ni los subagentes del plugin.

Está diseñado como solo lectura: no instala dependencias ni modifica archivos del proyecto. Lo único que escribe es el informe en tu Escritorio.

Sí. Cyber Neo audita cualquier carpeta y The Architect tiene /architect-brownfield para diseñar cambios sobre código existente.

Después de cada ronda de arreglos y antes de cada lanzamiento importante, sobre todo si añades dependencias, pagos o nuevos roles de usuario.

Sobre el autor

Equipo editorial de appyweb

Marketing, SEO y desarrollo con IA

Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.

Sigue con estas guías

Guía paso a paso · Intermedio

The Architect: planos de software que Claude Code construye sin preguntarte

The Architect es un plugin de Claude Code que no programa: te entrevista, elige el stack, detecta lo que falta por decidir y escribe un plano autocontenido con criterios de aceptación y comandos de verificación en cada paso. Útil para fundadores, agencias y equipos que quieren delegar la construcción a un agente sin perder el control.

Unos 10 minutos en modo rápido o entre 40 y 60 en modo completo, más la generación del plano. Leer la guía →
Guía paso a paso · Intermedio

Cyber Neo: auditoría de seguridad de tu proyecto con Claude Code

Cyber Neo es una skill de código abierto para Claude Code que audita la seguridad de un proyecto: secretos expuestos, dependencias vulnerables, autenticación, cabeceras web, CI/CD y más. Trabaja en modo solo lectura con varios subagentes en paralelo y entrega un informe en Markdown con cada hallazgo priorizado y su solución propuesta.

Unos 10 minutos para instalarla y lanzar la primera auditoría Leer la guía →
Guía paso a paso · Intermedio

The Architect, Cyber Neo y All Deploy: diseñar, auditar y publicar con Claude Code

Tres herramientas de código abierto que cubren el principio y el final de un proyecto en Claude Code: The Architect te entrevista y escribe un plano técnico verificable, Cyber Neo audita la seguridad con subagentes en paralelo y All Deploy publica con vista previa, comprobación de salud y vuelta atrás. Aprenderás a instalarlas y a encadenarlas.

Unos 20 minutos de instalación; el plano completo lleva de 10 a 60 minutos según el modo Leer la guía →
Guía paso a paso · Principiante

Planifica, audita y construye con el modo plan de Claude Code

El modo plan obliga a Claude Code a investigar y proponer antes de editar nada. Aprenderás a activarlo, a auditar el plan con preguntas concretas (alternativas, dependencias, permisos), a elegir cómo aprobarlo según el riesgo y a cerrar el ciclo con un commit que explique el porqué. Útil para no acumular dependencias que nadie eligió.

10 minutos para aprenderlo; después, unos minutos extra por tarea Leer la guía →
Guía paso a paso · Intermedio

Revisar tu código con Claude Code: /verify, /code-review y /security-review

Claude Code trae de serie tres comandos de revisión: uno arranca tu app para comprobar que el cambio funciona, otro busca bugs en tu diff y el tercero busca vulnerabilidades. Aquí verás qué hace cada uno, sus opciones, sus límites y una rutina fija para pasarlos antes de subir código.

Unos 15 minutos la primera vez; después, 3-5 minutos por cambio Leer la guía →

¿Quieres llevar la IA a tu empresa sin pelearte con todo esto?

Diseñamos e implantamos agentes, automatizaciones y asistentes con IA a medida de tu negocio.

Ver nuestros servicios de IA

Cuéntanos tu proyecto. Te respondemos en 48 h.

Auditoría gratuita de IA, campañas, web y SEO, con prioridades y cifras reales de tu negocio.

✓ Sin compromiso ✓ Respuesta en 48 h laborables ✓ Un consultor senior, no un bot
WA WhatsApp