senior-architect
por alirezarezvanisenior-architect es una skill de Software Architecture para diseño de sistemas, ADRs, decisiones de stack, revisiones de escalabilidad, análisis de dependencias y diagramas de arquitectura mediante scripts de Python y referencias incluidos.
Esta skill obtiene 84/100, lo que la convierte en una candidata sólida para usuarios del directorio que buscan un agente capaz de diseñar, revisar y analizar arquitectura con flujos reutilizables y scripts de apoyo. Ofrece suficiente orientación de activación, material de referencia y herramientas ejecutables para resultar más útil que un prompt genérico, aunque conviene tener en cuenta que no incluye instrucciones de instalación y que sus herramientas de análisis son de naturaleza heurística.
- Alta capacidad de activación: el frontmatter enumera explícitamente intenciones habituales del usuario, como diseño de arquitectura de sistemas, evaluación de microservicios frente a monolito, elección de base de datos, análisis de dependencias, ADRs y generación de diagramas.
- Buen contenido operativo: SKILL.md incluye comandos de inicio rápido, resúmenes de herramientas, flujos de decisión, comandos frecuentes y enlaces a documentación de referencia.
- Aporte relevante para agentes: tres scripts ayudan con la generación de diagramas de arquitectura, el análisis de dependencias y la evaluación de la arquitectura de proyectos, mientras que las referencias ofrecen comparativas de patrones, flujos de diseño de sistemas y matrices de decisión tecnológica.
- No hay un comando de instalación ni un README en la ruta de la skill, por lo que es posible que los usuarios deban deducir cómo copiarla o ejecutarla dentro de su configuración de Agent/Claude skills.
- Los scripts de análisis parecen heurísticos y basados en patrones, así que sus resultados deben usarse como apoyo para la revisión arquitectónica, no como evaluaciones definitivas del sistema.
Descripción general de senior-architect skill
Para qué sirve senior-architect
senior-architect es una skill de Software Architecture para convertir preguntas vagas de diseño de sistemas en decisiones de arquitectura estructuradas, diagramas, revisiones de dependencias y análisis de trade-offs de implementación. Encaja mejor con usuarios que necesitan un plan de arquitectura, razonamiento tipo ADR, comparación de stacks, revisión de escalabilidad o evaluación de arquitectura a nivel de codebase, en lugar de una respuesta genérica de lluvia de ideas.
Usuarios y trabajos para los que encaja mejor
Usa la skill senior-architect cuando tengas que decidir entre patrones como monolith, modular monolith, microservices, event-driven, CQRS, hexagonal o clean architecture. También resulta útil para equipos que revisan un repositorio existente, porque los scripts de Python incluidos pueden escanear la estructura del proyecto, inferir capas arquitectónicas, detectar acoplamiento y generar diagramas Mermaid, PlantUML o ASCII.
Qué la hace diferente
La skill combina guía de prompts con tooling concreto para repositorios. Sus referencias cubren patrones de arquitectura, flujos de trabajo de diseño de sistemas y matrices de decisión tecnológica; sus scripts aportan generación de diagramas de proyecto, análisis de dependencias y evaluación de arquitectura. Eso la vuelve más práctica que un simple prompt de “act as a senior architect” cuando necesitas evidencia extraída de una codebase.
Restricciones importantes antes de adoptarla
Los scripts son escáneres heurísticos, no validadores formales de arquitectura. Funcionan mejor con estructuras de proyecto convencionales y ecosistemas comunes como Node, Python, Go, Rust, Java, Docker y Kubernetes. En monorepos muy personalizados, el resultado generado debe tratarse como punto de partida para la revisión, no como una decisión final.
Cómo usar senior-architect skill
Instalación de senior-architect y primeros archivos que conviene leer
Instálala desde el directorio de skills de GitHub con:
npx skills add alirezarezvani/claude-skills --skill senior-architect
Después de instalar, lee primero SKILL.md para entender el alcance de activación y ver ejemplos de comandos. Luego revisa:
references/architecture_patterns.mdpara trade-offs de patrones y orientación sobre “when not to use”references/system_design_workflows.mdpara flujos de capacidad, diseño de API, migración y escalabilidadreferences/tech_decision_guide.mdpara decisiones sobre base de datos, caché, colas, auth, frontend, cloud y estilos de APIscripts/architecture_diagram_generator.pyscripts/dependency_analyzer.pyscripts/project_architect.py
Este orden de lectura te ayuda a entender tanto el marco de razonamiento como las herramientas de análisis ejecutables antes de depender de sus resultados.
Entradas que producen mejores resultados de arquitectura
La skill senior-architect funciona mejor cuando aportas tanto contexto de negocio como restricciones técnicas. Un prompt débil sería: “Design a scalable backend.” Un prompt más sólido sería:
Use senior-architect for Software Architecture. Design an architecture for a B2B analytics app with 50k tenants, 5M daily events, PostgreSQL today, Python/FastAPI backend, React frontend, AWS deployment, 99.9% availability target, small team of 6, and a requirement to support tenant-level data isolation. Compare modular monolith vs microservices, include risks, ADR summary, and a Mermaid component diagram.
Entre las entradas útiles se incluyen usuarios esperados, volumen de requests, proporción de lecturas/escrituras, objetivo de latencia, objetivo de disponibilidad, retención de datos, requisitos de compliance, tamaño del equipo, entorno de despliegue, stack actual, restricciones de migración y decisiones que ya se descartaron.
Flujo práctico para usar senior-architect
Para un sistema nuevo, empieza con los flujos de referencia: aclara requisitos funcionales, estima la escala, identifica requisitos no funcionales y luego pide arquitecturas candidatas con sus trade-offs. Para una codebase existente, ejecuta los scripts antes de pedir recomendaciones:
python scripts/architecture_diagram_generator.py ./my-project --format mermaid
python scripts/dependency_analyzer.py ./my-project --output json
python scripts/project_architect.py ./my-project --verbose
Pega en tu prompt los hallazgos más relevantes: patrón detectado, puntuación de acoplamiento, dependencias circulares, capas ausentes, package manager y cualquier recomendación. Así el modelo trabaja con evidencia concreta, en vez de obligarlo a inferir la arquitectura a partir de una descripción vaga.
Patrón de prompt para decisiones y revisiones
Para decisiones de diseño, pide un formato explícito: contexto, opciones, criterios de decisión, opción recomendada, alternativas rechazadas, riesgos, plan de migración y preguntas abiertas. Para revisiones, pide a la skill que separe “observed facts” de “interpretation” y “recommended changes.” Esto reduce consejos de arquitectura demasiado seguros y hace que el resultado sea más fácil de convertir en un ADR, un elemento de roadmap o una propuesta de ingeniería.
FAQ de senior-architect skill
¿senior-architect es solo para sistemas grandes?
No. Puede ayudar a equipos pequeños a elegir una arquitectura simple y evitar microservices prematuros. La referencia de patrones de arquitectura incluida cubre explícitamente los trade-offs de monolith y modular monolith, así que la skill también es útil cuando la mejor respuesta es “mantenerlo más simple.”
¿En qué mejora a un prompt de arquitectura común?
Un prompt normal depende sobre todo de lo que recuerdes incluir. La skill senior-architect añade flujos de decisión reutilizables, referencias de patrones, matrices de comparación tecnológica y scripts de escaneo de codebase. Esa combinación es especialmente valiosa cuando necesitas una revisión de arquitectura repetible, no un consejo aislado.
¿Pueden usar esta skill senior-architect las personas principiantes?
Sí, pero las personas principiantes deberían usarla como ayuda guiada para decidir, no como autoridad absoluta. Pídele que explique trade-offs, defina términos y etiquete supuestos. Si no conoces tu escala, objetivo de disponibilidad o restricciones operativas, pide a la skill que liste las preguntas faltantes antes de recomendar un diseño.
¿Cuándo no debería usarla?
No la uses como única fuente para decisiones críticas de seguridad, con alta carga de compliance o de migración a producción. Tampoco sustituye el profiling, las pruebas de carga, el modelado de costos cloud ni la revisión experta de un dominio singular. Para bugs de implementación de bajo nivel, puede encajar mejor una skill de debugging específica del lenguaje.
Cómo mejorar senior-architect skill
Mejora las entradas de senior-architect con restricciones medibles
El fallo más común es recibir consejos de arquitectura que suenan plausibles, pero no son accionables. Mejora los resultados agregando números: usuarios, requests por segundo, crecimiento de almacenamiento, multiplicador de picos, presupuesto de latencia, objetivo de uptime, tamaño del equipo, frecuencia de releases y techo de costos. Incluso estimaciones aproximadas son mejores que adjetivos como “high scale” o “enterprise grade.”
Usa evidencia del repositorio antes de pedir cambios
Para proyectos existentes, incluye la salida de los scripts y un resumen breve del árbol de archivos. Menciona si el código usa controllers/services/repositories, carpetas domain/application/infrastructure, Docker, Kubernetes, message queues o varios servicios desplegables. Esto ayuda a senior-architect a distinguir una arquitectura intencional de una nomenclatura de carpetas accidental.
Itera desde el diseño general hasta artefactos concretos
No te quedes con la primera propuesta de arquitectura. Pide seguimientos para un ADR, un diagrama Mermaid, una secuencia de migración, un registro de riesgos, la elección de base de datos, el límite de una API o un modelo de propiedad de servicios. Una buena ruta de iteración es: diseño de alto nivel → comparación de trade-offs → arquitectura elegida → diagrama → ADR → plan de implementación por fases.
Vigila la sobreingeniería y los supuestos faltantes
Si el resultado recomienda microservices, event sourcing, CQRS o mensajería distribuida, pregunta por qué se justifica la complejidad operativa adicional. Si faltan supuestos, solicita una respuesta revisada que declare las incógnitas y proponga un valor por defecto más simple. El mejor uso de senior-architect mantiene el diseño alineado con la capacidad del equipo, no solo con la escalabilidad teórica.