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.
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.
Claude Code
Construye a partir del plano, paso a paso, con un criterio de terminado y un comando de verificación en cada paso.
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.
/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.
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.
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.
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
/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.
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.
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.