Tus compañeros de
desarrollo en un plugin

para Claude Code y OpenCode (en desarrollo)

19 agentes especializados con personalidad propia. 10 de núcleo, 9 opcionales. Hasta 7 fases, 26 comandos, memoria persistente y quality gates automáticas en cada transición.

Ahora en main
Lucius — segunda opinión técnica Nuevo Cuando Alfred termina, invoca a Codex CLI para una perspectiva externa. Diagnóstico y prescripción por ítem: seguridad, arquitectura, tests o rendimiento. Sin tocar nada. Tú decides qué implementar y con quién.
Selina — dirección de estilo visual Nuevo Antes de escribir una línea de CSS, Selina presenta tres propuestas de estilo en el navegador. El usuario elige; el equipo ejecuta con coherencia desde el primer componente.
Continuidad operativa real Alfred ya sabe decir qué toca ahora, pausar una sesión, retomarla y mostrar el estado del proyecto sin reabrir medio repo.
Brownfield sin empezar a ciegas Repos existentes arrancan por map-codebase y discuss: Alfred deja un mapa persistente del codebase antes de abrir flujos de implementación.
Quick mode con garantías Los cambios pequeños ya tienen su propio flujo ligero: menos ceremonia, pero con tests, regresión local y revisión de seguridad.
UAT explícita y trazable verify separa los tests automáticos de la validación humana y progress expone kanban, bloqueos, trazabilidad y estado de UAT.
SonIA usable desde CLI standup, blocked, in-progress, validate y search convierten el kanban local en una interfaz diaria útil, no solo en documentación oculta.
GitHub como espejo opcional SonIA Sync publica backlog, bloqueos y progreso en GitHub Issues con gh, sin perder la fuente de verdad local en docs/project y SQLite.
Memory UI en navegador La memoria SQLite del proyecto ya se puede abrir como UI local viva: overview, timeline, decisiones, commits, búsqueda, salud y señales operativas.
19
Agentes
60
Skills
6
Flujos
26
Comandos
7
Templates
13
Hooks
23
Gates
El equipo

10 agentes de núcleo

Cada agente tiene un rol definido, una personalidad propia y frases características. Trabajan coordinados por Alfred, el mayordomo jefe. Siempre activos en cada flujo.

Alfred opus
Mayordomo jefe
Orquestador del equipo. Decide qué agentes activar, en qué orden, y evalúa las quality gates entre fases.
"Muy bien, señor. Permítame organizar eso."
SonIA sonnet
Project Manager
Si no está en el kanban, no existe. Descompone el PRD en tareas, traza cada criterio de aceptación hasta su test y documentación, y detecta desvíos de alcance.
"El criterio CA-05 no tiene test asociado. Quién se encarga?"
El buscador de problemas opus
Product Owner
Obsesionado con el problema del usuario. PRDs, historias de usuario, criterios de aceptación, análisis competitivo.
"Muy bonito, pero qué problema resuelve esto?"
El dibujante de cajas opus
Arquitecto
Piensa en sistemas, no en líneas de código. Diagramas Mermaid, ADRs, matrices de decisión, evaluación de dependencias.
"Si no cabe en un diagrama, es demasiado complejo."
El artesano opus
Senior Dev
Pragmático, test-first. TDD estricto, refactoring, commits atómicos. Alergia crónica al código clever.
"Primero el test. Siempre primero el test."
El paranoico opus
Security Officer
Desconfiado por defecto. OWASP Top 10, compliance RGPD/NIS2/CRA, auditoría de dependencias, threat modeling, SBOM.
"Habéis validado esa entrada? No, en serio."
El rompe-cosas sonnet
QA Engineer
Su misión es demostrar que el código no funciona. Test plans, code review, testing exploratorio, regresión.
"Ese edge case que no contemplaste? Lo encontré."
El fontanero sonnet
DevOps Engineer
Infraestructura invisible es infraestructura bien hecha. Docker, CI/CD, deploy, monitoring. Todo automatizado.
"Si lo despliegas a mano, lo despliegas mal."
El escriba sonnet
Tech Writer
Document first. Comenta el código inline (cabeceras, docstrings) y genera la documentación de proyecto: API docs, arquitectura con diagramas Mermaid, guías y changelogs.
"Ese fichero no tiene cabecera. Nadie sabe para qué sirve."
Selina opus
La Estilista
Directora de estilo visual. Garantiza que tipografía, paleta y densidad queden decididas antes de que el architect diseñe el primer componente. Solo activa en proyectos con interfaz de usuario.
"El estilo no es decoración: es comunicación."
Ampliables

9 agentes opcionales

Roles especializados que activas según lo que necesite tu proyecto. Alfred analiza tu stack y te sugiere cuáles activar. Se gestionan con /alfred-dev:config.

El fontanero de datos sonnet
Data Engineer
Diseño de esquemas, migraciones con rollback obligatorio, optimización de queries. Si hay base de datos, hay trabajo.
"Una migración sin rollback es un billete de ida."
El abogado del usuario sonnet
UX Reviewer
Auditoría WCAG 2.1 AA, heurísticas de Nielsen, revisión de flujos. Lo que es obvio para ti no lo es para el usuario.
"Si el usuario necesita un manual, has fallado."
El cronómetro sonnet
Performance Engineer
Profiling, benchmarks con estadísticas reales (p50, p95, p99), análisis de bundles. Medir antes y después, siempre.
"Sin números no hay optimización, hay superstición."
El portero sonnet
GitHub Manager
Configuración de repositorios, branch protection, PRs, releases, issue templates. Todo vía gh CLI, sin menciones a IA.
"Un repo sin protección de ramas es una ruleta rusa."
El rastreador sonnet
SEO Specialist
Meta tags, datos estructurados JSON-LD, Core Web Vitals, Lighthouse. Si Google no lo encuentra, no existe.
"Un canonical mal puesto y tienes contenido duplicado."
La pluma sonnet
Copywriter
Revisión de textos, CTAs efectivos, guía de tono. Ortografía impecable como prioridad absoluta. Sin teletienda.
"Si escribes 'aplicacion' sin tilde, no publiques."
El Bibliotecario sonnet
Memoria del proyecto
Responde consultas históricas sobre decisiones, commits e iteraciones del proyecto. Siempre cita las fuentes con IDs verificables: [D#id], [C#sha], [I#id].
"Según la decisión D#42 del 15 de febrero, se descartó Redis por latencia."
La Intérprete sonnet
i18n Specialist
Auditoría de claves i18n, detección de cadenas hardcodeadas, validación de formatos por locale. Si el idioma base tiene N claves, todos los demás deben tener N.
"El idioma base tiene 847 claves. El francés tiene 831. Faltan 16."
Lucius opus
Director técnico externo
Segunda opinión técnica vía Codex CLI con GPT-5.4. Audita el proyecto completo y devuelve diagnóstico y prescripción por ítem. Requiere suscripción activa de OpenAI. Sin modificaciones: solo analiza.
"Desde fuera, esto tiene un punto débil que probablemente no veis porque estáis dentro."
Composicion dinamica

El equipo que necesitas, cuando lo necesitas

Cuando Alfred detecta que toca abrir un flujo multiagente, analiza tu tarea en tiempo real y sugiere los agentes opcionales mas relevantes. Si antes toca mapear, retomar, verificar o mostrar progreso, resuelve eso primero.

Cuando /alfred-dev:alfred o un comando explicito deciden que la ruta correcta es un flujo multiagente, Alfred razona sobre que especialistas encajan con el trabajo, te presenta la seleccion de agentes y arranca la fase adecuada. Asi se ve cuando la ruta elegida es /alfred-dev:feature:

terminal
$ /alfred-dev:feature
|
Flujos de trabajo

6 flujos de ejecución, 18 fases

Cada flujo se ejecuta por fases. Entre fase y fase hay una quality gate (la sección de abajo las detalla todas). Fuera de los flujos, comandos como next, pause, resume y progress permiten pausar, retomar o consultar el estado sin perder el hilo.

/alfred-dev:feature
Ciclo completo o parcial
Hasta 7 fases: producto, estilo visual (Selina, condicional), arquitectura, desarrollo TDD, calidad + seguridad, documentación, entrega. Puedes arrancar desde cualquier fase.
1Producto 2Estilo visual 3Arquitectura 4Desarrollo 5Calidad + Seguridad 6Documentación 7Entrega
/alfred-dev:quick
Cambio pequeño
2 fases: ejecución acotada y validación rápida. Menos ceremonia que feature, pero con tests y revisión de seguridad.
1Ejecución acotada 2Validación rápida
/alfred-dev:fix
Corrección rápida
Diagnóstico de causa raíz, corrección con TDD (test que reproduce el bug primero), validación con QA + seguridad.
1Diagnóstico 2Corrección TDD 3Validación
/alfred-dev:spike
Investigación
Exploración técnica sin compromiso: prototipos, benchmarks, evaluación de alternativas. Documento de hallazgos.
1Investigación 2Hallazgos
/alfred-dev:ship
Despliegue
Auditoría final paralela, documentación de release, empaquetado con versionado semántico, despliegue a producción.
1Auditoría 2Documentación 3Empaquetado 4Despliegue
/alfred-dev:audit
Auditoría
4 agentes en paralelo: calidad, seguridad, arquitectura y documentación. Informe consolidado con prioridades.
1Auditoría paralela
Quality gates

Cobertura de calidad en todo el ciclo

Cada fase del desarrollo tiene sus propias quality gates. Los 10 agentes de núcleo cubren desde la validación del producto hasta la entrega, y los opcionales amplían el control a dominios especializados. Si una gate no se supera, el flujo se detiene.

Núcleo -- de la idea a producción

Valida el PRD con el usuario antes de pasar a diseño
Revisa coherencia arquitectónica y acoplamiento entre módulos antes de codificar
Analiza el diseño en busca de vectores de ataque con modelo de amenazas
Aplica TDD estricto: test que falla, implementación mínima, refactor
Ejecuta tests unitarios, de integración y E2E antes de avanzar a calidad
Audita OWASP Top 10, CVEs en dependencias y compliance RGPD, NIS2 y CRA
Documenta código en línea durante el desarrollo y genera documentación de proyecto al cierre
Exige pipeline CI/CD en verde como requisito de entrega
Rastrea progreso entre fases y mantiene la trazabilidad de cada decisión
Consulta la memoria persistente del proyecto para contextualizar con el histórico
Vigila cada escritura de fichero buscando secretos, API keys o tokens
Detecta tildes omitidas en castellano al escribir o editar ficheros
Verifica que los tests se ejecutaron realmente antes de aceptar que pasan (evidencia verificable)
Itera dentro de cada fase hasta 5 veces si la gate no se supera, habilitando ciclos TDD naturales

Opcionales -- amplían el control

Analiza el código con SonarQube (instala Docker si falta, con tu permiso)
Exige rollback en cada migración de base de datos antes de ejecutarla
Verifica accesibilidad WCAG 2.1 AA antes de dar por buena la interfaz
Mide rendimiento con métricas reales (p50, p95, p99) antes y después
Configura branch protection en main y exige PR con aprobación
Monitoriza Core Web Vitals (LCP, INP, CLS) y alerta si están fuera de umbral
Revisa meta tags, structured data y rastreabilidad SEO antes de publicar
Valida ortografía, tono y consistencia de los textos de la interfaz
Comprueba que todas las claves i18n del idioma base existan en todos los idiomas destino
Capacidades

60 skills en 13 dominios

Cada skill es una habilidad concreta que los agentes ejecutan. Los 7 dominios originales se amplían con 6 nuevos para los agentes opcionales.

Producto 4 skills
  • write-prd PRD completo con historias y criterios
  • user-stories Descomposición en historias de usuario
  • acceptance-criteria Criterios Given/When/Then
  • competitive-analysis Análisis de alternativas
Arquitectura 4 skills
  • write-adr Architecture Decision Records
  • choose-stack Matriz de decisión de stack
  • design-system Diseño con diagramas Mermaid
  • evaluate-dependencies Auditoría de dependencias
Desarrollo 4 skills
  • tdd-cycle Ciclo rojo-verde-refactor
  • explore-codebase Exploración de código
  • refactor Refactoring guiado
  • code-review-response Respuesta a code reviews
Seguridad 6 skills
  • threat-model Modelado STRIDE
  • dependency-audit CVEs, licencias, versiones
  • security-review OWASP Top 10
  • compliance-check RGPD, NIS2, CRA
  • sbom-generate Software Bill of Materials
  • dependency-update Actualización segura de dependencias
Calidad 6 skills
  • test-plan Test plans por riesgo
  • code-review Review de calidad
  • exploratory-test Testing exploratorio
  • regression-check Análisis de regresión
  • sonarqube Análisis con SonarQube + Docker
  • spelling-check Verificación ortográfica (tildes)
DevOps 4 skills
  • dockerize Dockerfile multi-stage
  • ci-cd-pipeline GitHub Actions, GitLab CI
  • deploy-config Vercel, Railway, Fly, AWS, K8s
  • monitoring-setup Logging, alertas, tracking
Documentación 9 skills
  • api-docs Endpoints, params, ejemplos
  • architecture-docs Visión global del sistema
  • user-guide Instalación, uso, troubleshooting
  • changelog Keep a Changelog
  • project-docs Documentación completa en docs/
  • glossary Corpus lingüístico del proyecto
  • readme-review Auditoría del README
  • onboarding-guide Guía para nuevos developers
  • migration-guide Migración entre versiones
Datos 3 skills
  • schema-design Diseño de esquemas normalizados
  • migration-plan Migraciones con rollback
  • query-optimization Optimización con EXPLAIN
UX 3 skills
  • accessibility-audit WCAG 2.1 AA completo
  • usability-heuristics 10 heurísticas de Nielsen
  • flow-review Análisis de flujos de usuario
Rendimiento 3 skills
  • profiling CPU y memoria por runtime
  • benchmark Benchmarks con p50, p95, p99
  • bundle-size Análisis y reducción de bundles
GitHub 4 skills
  • repo-setup Configuración completa de repo
  • pr-workflow PRs bien documentadas
  • release Releases con versionado semántico
  • issue-templates Plantillas de issues YAML
SEO 3 skills
  • meta-tags Title, description, Open Graph
  • structured-data JSON-LD para schema.org
  • lighthouse-audit Core Web Vitals y métricas
Marketing 3 skills
  • copy-review Revisión de textos públicos
  • cta-writing CTAs efectivos sin teletienda
  • tone-guide Guía de tono de marca
Bajo el capó

Hooks, templates y core

La infraestructura que hace funcionar al equipo: hooks que arrancan la sesión, templates que estandarizan artefactos y un core que orquesta tanto los flujos de ejecución como la continuidad operativa.

13 hooks

session-bootstrap.sh SessionStart
session-start.sh SessionStart
stop-hook.py Stop
secret-guard.sh PreToolUse
dangerous-command-guard.py PreToolUse
sensitive-read-guard.py PreToolUse
prefetch-finish-guard.py PreToolUse
quality-gate.py PostToolUse
evidence-guard.py PostToolUse
dependency-watch.py PostToolUse
spelling-guard.py PostToolUse
activity-capture.py PostToolUse
memory-compact.py PreCompact

7 templates

prd.md Product Requirements
adr.md Architecture Decision
test-plan.md Plan de testing
threat-model.md Modelado STRIDE
sbom.md Bill of Materials
changelog-entry.md Entrada de changelog
release-notes.md Notas de release

6 módulos core

orchestrator.py Flujos, sesiones, gates, loop iterativo y autopilot
continuity.py Continuidad, PM operativo, búsqueda y sync GitHub
personality.py Motor de personalidad
config_loader.py Config y detección de stack
memory.py Memoria persistente SQLite
session_report.py Informes de sesión en markdown
Interfaz

26 comandos

Todo se controla desde la línea de comandos de Claude Code.

Flujos
/alfred-dev:feature Ciclo completo: hasta 7 fases o desde la que indiques. Selina se activa automáticamente en proyectos con UI.
/alfred-dev:quick Cambio pequeño con dos fases ligeras: ejecución acotada y validación rápida con QA + seguridad.
/alfred-dev:fix Bug con 3 fases: diagnóstico, corrección TDD, validación.
/alfred-dev:spike Investigación exploratoria sin compromiso: prototipos, benchmarks, conclusiones.
/alfred-dev:ship Preparar release: auditoría final, documentación, empaquetado, despliegue.
/alfred-dev:audit Auditoría con 4 agentes en paralelo: calidad, seguridad, arquitectura, documentación.
Contexto
/alfred-dev:alfred Asistente contextual: detecta el estado del proyecto y decide si toca mapear, retomar, refinar o abrir un flujo.
/alfred-dev:map-codebase Analiza un repo existente y crea codebase-map.md y current.md antes de tocar código.
/alfred-dev:discuss Refina una idea antes de abrir implementación. Deja discovery.md y el siguiente comando recomendado.
/alfred-dev:lucius Segunda opinión externa vía Codex CLI (GPT-5.4). Diagnóstico y prescripción por ítem. Requiere suscripción OpenAI.
Continuidad
/alfred-dev:next Responde “qué toca ahora” y ejecuta si la ruta es inequívoca: retomar, verificar, mapear o abrir flujo.
/alfred-dev:pause Pausa el trabajo y deja un handoff explícito en .claude/alfred-handoff.json.
/alfred-dev:resume Retoma una sesión activa o handoff pendiente sin abrir una iteración nueva a ciegas.
/alfred-dev:verify Registra la validación manual/UAT del entregable, separando la aceptación humana de los tests automáticos.
PM operativo
/alfred-dev:progress Progreso, kanban, bloqueos, trazabilidad y estado de UAT en una vista compacta.
/alfred-dev:standup Standup diario accionable: foco actual, trabajo en curso, bloqueos y siguiente paso.
/alfred-dev:blocked Tareas bloqueadas con dependencia, nota operativa y responsable.
/alfred-dev:in-progress Trabajo en curso sin releer todo el tablero.
/alfred-dev:validate Salud del tablero: IDs duplicados, trazabilidad incompleta, UAT pendiente, drift de sync.
/alfred-dev:search Busca en artefactos y memoria SQLite a la vez para responder dudas históricas u operativas.
/alfred-dev:sync-github SonIA Sync: refleja el tablero local en GitHub Issues con gh.
Herramientas
/alfred-dev:memory-ui UI local en navegador sobre la SQLite del proyecto: overview, timeline, decisiones, commits, búsqueda.
/alfred-dev:config Autonomía, stack, compliance, personalidad, agentes opcionales y memoria. Bootstrappeable en la primera sesión.
/alfred-dev:status Sesión activa: fase actual, fases completadas, gate pendiente y foco inmediato.
/alfred-dev:update Ver si hay versión nueva, leer las notas de release y actualizar con un clic.
/alfred-dev:help Ayuda completa de todos los comandos disponibles.
Los 9 agentes opcionales se activan con /alfred-dev:config y Alfred los integra automáticamente en feature, quick, fix, spike, audit y ship.
Detección automática

Se adapta a tu proyecto

Alfred Dev detecta automáticamente el stack tecnológico de tu proyecto y adapta sus artefactos al ecosistema real.

Node.js -- npm, pnpm, bun, yarn. Express, Next.js, Fastify, Hono.
Python -- pip, poetry, uv. Django, Flask, FastAPI.
Rust -- cargo. Actix, Axum, Rocket.
Go -- go mod. Gin, Echo, Fiber.
Ruby -- bundler. Rails, Sinatra.
Elixir -- mix. Phoenix.
Java / Kotlin -- Maven, Gradle. Spring Boot, Quarkus, Micronaut.
PHP -- Composer. Laravel, Symfony.
C# / .NET -- dotnet, NuGet. ASP.NET, Blazor.
Swift -- SPM. Vapor.
En la práctica

Cómo se usa

Escenarios reales de uso paso a paso. Cada caso muestra el flujo completo desde la invocación hasta el resultado.

Desarrollo
Desarrollar una feature completa
/alfred-dev:feature sistema de notificaciones push
  • El product-owner genera el PRD con historias de usuario y criterios de aceptación
  • El architect diseña la solución y el security-officer valida el diseño
  • El senior-dev implementa siguiendo TDD estricto (rojo-verde-refactor)
  • QA y seguridad auditan en paralelo antes de dar el visto bueno
  • El escriba documenta el código inline y genera los docs de API; el devops-engineer prepara el despliegue
Corrección
Corregir un bug
/alfred-dev:fix el login falla con emails que tienen tildes
  • El senior-dev reproduce el error e identifica la causa raíz
  • Escribe un test que falla reproduciendo el bug exacto
  • Implementa la corrección mínima que hace pasar el test
  • QA y seguridad validan que no se hayan introducido regresiones
Investigación
Investigación técnica (spike)
/alfred-dev:spike evaluar si migrar de REST a gRPC
  • El architect y el senior-dev exploran las alternativas sin compromiso de código
  • Se generan pruebas de concepto ligeras para comparar rendimiento
  • Se documenta un ADR con los hallazgos, pros, contras y recomendación
  • El usuario decide si proceder a implementación o descartarlo
Auditoría
Auditar el proyecto
/alfred-dev:audit
  • 4 agentes trabajan en paralelo: QA, seguridad, arquitectura y documentación
  • QA busca errores lógicos, code smells y cobertura de tests
  • Seguridad analiza OWASP Top 10, dependencias con CVEs y compliance RGPD/NIS2
  • Se consolida un informe único con hallazgos priorizados por severidad
Entrega
Preparar una entrega
/alfred-dev:ship
  • Auditoría final obligatoria: QA y seguridad deben aprobar
  • El escriba actualiza el changelog y genera las notas de release
  • El devops-engineer empaqueta, configura el pipeline y verifica el build
  • Despliegue supervisado: el usuario confirma antes de subir a producción
Conversacional
Asistente contextual
/alfred-dev:alfred
  • Alfred detecta el stack del proyecto, la sesión activa, el handoff pendiente y si falta mapa brownfield
  • Decide si toca next, map-codebase, discuss, quick, feature, fix, spike, audit, verify o progress
  • Si la ruta correcta es operativa, la resuelve antes de abrir un equipo multiagente
  • Solo compone agentes cuando de verdad toca un flujo de ejecución
Brownfield
Entrar en un repo existente
/alfred-dev:map-codebase checkout
  • Alfred analiza README, manifiestos, estructura principal y zonas sensibles sin tocar código de producto
  • Genera docs/project/codebase-map.md con dominios, entrypoints, hotspots, pruebas, despliegue y riesgos
  • Deja docs/project/current.md con lectura operativa y siguiente comando recomendado
  • A partir de ahí feature, fix, spike y audit ya no arrancan a ciegas
Refinado
Aterrizar una idea antes de construir
/alfred-dev:discuss nuevo onboarding para equipos
  • Alfred clarifica problema real, actor principal, alcance y supuestos antes de hablar de implementación
  • Persiste el refinado en docs/project/discovery.md y actualiza docs/project/current.md
  • Si la idea ya está madura, recomienda feature o quick; si faltan datos técnicos, spike
  • Evita abrir PRD, arquitectura o desarrollo antes de tiempo
Cambio pequeño
Resolver algo pequeño sin abrir toda la maquinaria
/alfred-dev:quick corregir copy del checkout y su test
  • Quick abre una sesión ligera con dos fases: ejecución acotada y validación rápida
  • El senior-dev cambia solo la superficie tocada y actualiza los tests necesarios
  • QA y seguridad revisan regresión local y riesgos obvios sin convertirlo en una auditoría global
  • El siguiente paso esperado queda explícito: /alfred-dev:verify
Continuidad
Saber qué toca ahora
/alfred-dev:next
  • Prioriza sesión activa, handoff pendiente, UAT pendiente o brownfield sin mapear
  • Si la salida es inequívoca, ejecuta la ruta correcta sin ofrecer un menú genérico
  • Si hay trabajo a retomar, muestra flujo, fase actual, gate pendiente y siguiente acción concreta
  • Si no hay nada vivo, sugiere el siguiente flujo razonable para el estado real del proyecto
Continuidad
Pausar y retomar sin perder el hilo
/alfred-dev:pause
  • Pause guarda handoff en .claude/alfred-handoff.json y docs/project/handoff.md
  • Resume reutiliza estado e handoff para volver exactamente al punto en que se dejó el trabajo
  • No abre una iteración nueva ni empuja gates por su cuenta: primero deja claro qué toca
  • Sirve igual para sesiones largas de feature que para quick o trabajo interrumpido
Verificación
Cerrar la aceptación manual
/alfred-dev:verify aprobado smoke manual correcto
  • Verify prepara o actualiza la UAT del entregable actual en .claude/alfred-uat.json y docs/project/uat.md
  • Separa claramente los tests automáticos de la validación humana final
  • Registra si la UAT queda pendiente, aprobada o rechazada, junto con la nota principal
  • Si la validación falla, el siguiente paso operativo vuelve a quedar visible en current/uat
Project management
Ver el estado real del proyecto
/alfred-dev:progress
  • Progress expone la capa operativa de SonIA: progreso general, kanban, bloqueos y trazabilidad
  • Resume el flujo activo o el handoff pendiente sin reabrir el trabajo en curso
  • Muestra huecos de trazabilidad y el estado de la UAT si existe
  • Cierra con el siguiente comando recomendado para seguir avanzando
Project management
Tener un standup diario sin abrir GitHub ni releer docs
/alfred-dev:standup
  • Standup resume foco actual, tareas en curso, bloqueos, evidencia reciente y recomendación operativa
  • Lee el kanban de SonIA, el estado de continuidad y la UAT pendiente o aprobada
  • Sirve como briefing rápido antes de seguir trabajando o delegar una tarea
  • No modifica el tablero: solo hace visible lo importante
Project management
Validar la salud operativa antes de seguir
/alfred-dev:validate
  • Validate revisa backlog, in-progress, blocked y done buscando IDs duplicados o tareas sin metadatos básicos
  • Contrasta trazabilidad, evidencia, UAT y artefactos clave como progress.md o traceability.md
  • Si existe sync local con GitHub, también detecta desalineaciones entre tareas e issues
  • Devuelve un checklist accionable para corregir el tablero antes de seguir avanzando
Project management
Ejecutar SonIA Sync con GitHub
/alfred-dev:sync-github owner/repo
  • Lee el tablero local y crea o actualiza issues para backlog, trabajo en curso, bloqueos y tareas terminadas
  • Asegura labels de Alfred y un issue paraguas de SonIA Sync con el resumen global
  • Guarda el mapping local en .claude/alfred-github-sync.json y un resumen humano en docs/project/github-sync.md
  • GitHub actúa como espejo colaborativo: la verdad sigue estando en docs/project y SQLite
Contexto
Buscar contexto sin explorar medio repo
/alfred-dev:search login social
  • Search cruza discovery, current, handoff, UAT, kanban y memoria persistente en una sola consulta
  • Devuelve coincidencias de artefactos operativos y decisiones históricas con su origen visible
  • Es especialmente útil para saber por qué se tomó una decisión o dónde quedó apuntado un bloqueo
  • Evita abrir manualmente varios Markdown o consultar SQLite por separado
Memoria
Abrir la memoria viva del proyecto
/alfred-dev:memory-ui
  • Levanta una UI local en el navegador sobre la SQLite real del proyecto, sin duplicar la fuente de verdad
  • Muestra overview, timeline, decisiones, commits, búsqueda y salud del almacén en una sola pantalla
  • Mezcla memoria persistente con señales operativas de current, progress, traceability y kanban cuando existen
  • Se refresca sola mientras Alfred sigue trabajando, así que sirve como panel vivo del proyecto
Estilo visual
Decidir la dirección de estilo antes de construir
/alfred-dev:feature nueva app de finanzas personales
  • Selina lee el PRD aprobado, detecta el stack (framework, componentes, contexto del producto) y confirma el público objetivo
  • Levanta el servidor visual local y genera tres propuestas HTML en pantalla completa: cada una con tipografía, paleta, densidad y personalidad diferente
  • El usuario elige en el navegador; Selina registra la elección y genera docs/style-direction.md con la dirección completa
  • Architect, senior-dev, ux-reviewer, copywriter y seo-specialist leen ese artefacto como referencia de estilo para el resto del flujo
  • La fase se salta automáticamente en proyectos sin interfaz de usuario
Calidad
Análisis con SonarQube
/alfred-dev:audit
  • El security-officer comprueba si Docker está instalado; si no, pide permiso al usuario para instalarlo
  • Levanta SonarQube con Docker automáticamente y espera a que esté listo
  • Configura el proyecto, ejecuta el scanner y espera los resultados
  • Traduce los hallazgos (bugs, vulnerabilidades, code smells) en un informe con correcciones propuestas
  • Limpia el contenedor al terminar: no deja nada corriendo
Datos
Diseñar y migrar una base de datos
/alfred-dev:feature añadir sistema de suscripciones con pagos
  • El data-engineer diseña el esquema normalizado con constraints e índices
  • Genera el script de migración con rollback obligatorio (ida y vuelta)
  • El architect valida la integración con el ORM y el resto del stack
  • Se ejecuta la migración, se verifican las tablas y se pasan los tests de integración
GitHub
Configurar y publicar un repositorio
/alfred-dev:ship
  • El github-manager verifica que gh CLI está instalado y autenticado; si no, guía el proceso
  • Configura branch protection, labels, issue templates y .gitignore optimizado
  • Crea la PR con descripción estructurada, labels y asignación de reviewers
  • Genera la release con versionado semántico, changelog categorizado y artefactos adjuntos
SEO + Copy
Optimizar una landing page
/alfred-dev:audit
  • El seo-specialist audita meta tags, Open Graph, canonical y datos estructurados JSON-LD
  • Ejecuta Lighthouse y prioriza las mejoras por impacto en Core Web Vitals
  • El copywriter revisa los textos: ortografía (tildes primero), claridad, tono y CTAs
  • Se genera un informe conjunto con correcciones listas para aplicar
UX
Auditoría de accesibilidad y usabilidad
/alfred-dev:audit
  • El ux-reviewer ejecuta una auditoría WCAG 2.1 AA por los 4 principios (perceptible, operable, comprensible, robusto)
  • Aplica las 10 heurísticas de Nielsen al flujo principal del usuario
  • Identifica puntos de fricción, edge cases y pasos innecesarios en cada flujo
  • Genera un informe con severidad (0-4) y propuesta de mejora para cada hallazgo
Rendimiento
Optimizar el rendimiento
/alfred-dev:spike la API tarda 3 segundos en responder
  • El performance-engineer ejecuta profiling de CPU y memoria para localizar cuellos de botella
  • Analiza queries lentas con EXPLAIN y propone índices o reestructuración
  • Ejecuta benchmarks antes y después con métricas reales (p50, p95, p99)
  • Si hay frontend, analiza el bundle size y propone tree-shaking o code splitting
Automático
Protección en segundo plano

Sin necesidad de ejecutar ningún comando, Alfred vigila automáticamente tu sesión de trabajo mediante hooks que se activan en cada operación relevante.

  • Guardia de secretos -- bloquea la escritura de API keys, tokens o contraseñas en el código
  • Quality gate -- verifica que los tests pasen después de cada cambio significativo
  • Verificación de evidencia -- registra cada ejecución de tests como evidencia verificable, impidiendo afirmaciones sin pruebas
  • Vigilancia de dependencias -- detecta nuevas librerías y notifica al auditor de seguridad
  • Guardia ortográfico -- detecta palabras castellanas sin tilde al escribir o editar ficheros
  • Captura de memoria -- registra automáticamente eventos del flujo de trabajo en la memoria persistente
  • Captura de commits -- detecta cada git commit y registra SHA, autor y ficheros en la memoria
  • Contexto protegido -- las decisiones críticas sobreviven a la compactación de contexto
  • Informe de sesión -- al cerrar una sesión completada se genera un resumen en docs/alfred-reports/ con fases, evidencia y artefactos
Autonomía
Modo autopilot
/alfred-dev:feature --autopilot
  • El flujo completo se ejecuta sin intervención: las gates de usuario se aprueban automáticamente
  • Las gates automáticas (tests) y de seguridad se siguen evaluando normalmente
  • Si una gate automática falla, el loop iterativo reintenta hasta 5 veces antes de escalar
Memoria persistente por proyecto

Memoria persistente

Alfred Dev recuerda decisiones, commits e iteraciones entre sesiones. La memoria se almacena en una base de datos SQLite local dentro de cada proyecto, sin dependencias externas ni servicios remotos. Desde v0.2.3: etiquetas, estado y relaciones entre decisiones, auto-captura de commits, filtros avanzados y export/import.

Base de datos local

SQLite con modo WAL para escrituras concurrentes. Almacena decisiones, commits, iteraciones y eventos en .claude/alfred-memory.db dentro de cada proyecto. Permisos 0600 por defecto.

Búsqueda inteligente

Texto completo con FTS5 cuando está disponible, con fallback automático a LIKE para entornos sin extensión FTS. Busca en títulos de decisiones, razones, alternativas descartadas, mensajes de commit y eventos con contenido.

Captura automática

Un único hook unificado (activity-capture.py) captura todo automáticamente: eventos del flujo (iteraciones, fases), commits de Git (SHA, mensaje, autor, ficheros) y actividad de herramientas. Dispatch interno según el tipo de evento.

Servidor MCP integrado

15 herramientas accesibles desde cualquier agente vía MCP stdio: buscar, registrar, consultar iteraciones, estadísticas, gestión de iteraciones, ciclo de vida de decisiones, validación de integridad, export/import. Sin dependencias externas.

Contexto de sesión

Al iniciar cada sesión, se inyectan las decisiones relevantes: si hay iteración activa, las de esa iteración; si no, las 5 últimas globales. Un hook PreCompact protege estas decisiones durante la compactación de contexto.

Seguridad integrada

Sanitización de secretos con los mismos patrones que secret-guard.sh: API keys, tokens, JWT, cadenas de conexión y claves privadas se redactan antes de almacenarse. Permisos 0600 en el fichero de base de datos.

El Bibliotecario

Agente opcional -- memoria del proyecto

El Bibliotecario es el agente que responde consultas históricas sobre el proyecto. A diferencia de otros agentes que trabajan sobre el código actual, este se centra en el por qué de las decisiones pasadas: qué se decidió, cuándo, qué alternativas se descartaron y qué commits implementaron cada decisión. Desde v0.2.3 también gestiona el ciclo de vida de las decisiones (estado, etiquetas, relaciones), valida la integridad de la memoria y permite exportar decisiones a Markdown o importar desde Git y ADRs.

Tiene una regla infranqueable: siempre cita las fuentes. Cada afirmación incluye referencias verificables con formato [D#42] para decisiones, [C#a1b2c3d] para commits y [I#7] para iteraciones. Si no encuentra evidencia, lo dice en lugar de inventar.

Ejemplo de consulta:
> Por qué usamos SQLite en lugar de PostgreSQL para la memoria?
Se eligió SQLite porque el requisito era cero dependencias externas [D#12]. La alternativa de PostgreSQL se descartó por requerir un servicio externo corriendo [D#12, alternativas]. La implementación se hizo en el commit [C#1833e83] dentro de la iteración [I#3].

Activación: se habilita desde /alfred-dev:config en la sección de memoria persistente. Una vez activo, Alfred le delega automáticamente las consultas históricas que surjan durante cualquier flujo.

Preguntas sobre la memoria

En el fichero .claude/alfred-memory.db dentro de la raíz de cada proyecto. Es un fichero SQLite local, no se envía nada a servicios externos. Añádelo a .gitignore si no quieres versionarlo.
No. La activación es explícitamente opcional. Se habilita desde /alfred-dev:config en la sección de memoria. Si no la activas, no se crea la base de datos ni se captura nada.
Todo el contenido pasa por la misma sanitización que usa el hook secret-guard.sh antes de almacenarse. Claves de API, tokens, JWT, cadenas de conexión y cabeceras de clave privada se redactan automáticamente. El fichero de base de datos tiene permisos 0600 (solo lectura/escritura para el propietario).
Sí. Basta con eliminar el fichero .claude/alfred-memory.db. También puedes desactivar la memoria desde /alfred-dev:config: los datos existentes se conservan pero dejan de consultarse y no se capturan nuevos eventos.
Primeros pasos

Instalación

Un comando en la terminal y listo. Compatible con macOS, Linux y Windows. El instalador es idempotente: ejecutarlo de nuevo actualiza sin conflictos. En la primera sesión Alfred puede bootstrappear tu configuración local y sugerirte el siguiente paso.

curl -fsSL https://raw.githubusercontent.com/686f6c61/alfred-dev/main/install.sh | bash
Requisitos: git, Python 3.10+, Claude Code instalado.
Tras la instalación, reinicia Claude Code y ejecuta /alfred-dev:alfred o /alfred-dev:help.
curl -fsSL https://raw.githubusercontent.com/686f6c61/alfred-dev/main/install.sh | bash
Requisitos: git, Python 3.10+, Claude Code instalado.
Tras la instalación, reinicia Claude Code y ejecuta /alfred-dev:alfred o /alfred-dev:help.
irm https://raw.githubusercontent.com/686f6c61/alfred-dev/main/install.ps1 | iex
Requisitos: git, PowerShell 5.1+ (preinstalado en Windows 10/11), Claude Code instalado.
No necesita Python. Tras la instalación, reinicia Claude Code y ejecuta /alfred-dev:alfred o /alfred-dev:help.
Alternativa: también puedes usar el instalador bash con WSL o Git Bash.

Desinstalación

Para eliminar Alfred Dev completamente, ejecuta el desinstalador de tu plataforma. Limpia todos los registros y directorios del plugin.

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/686f6c61/alfred-dev/main/uninstall.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/686f6c61/alfred-dev/main/uninstall.ps1 | iex

Actualización

Desde Claude Code, ejecuta /alfred-dev:update para comprobar si hay una versión nueva. Si la hay, Alfred te muestra las notas de la release y te pregunta si quieres actualizar. También puedes volver a ejecutar el instalador: es idempotente.

Personalización

Configuración por proyecto

Cada proyecto tiene su propio fichero de configuración en .claude/alfred-dev.local.md. La primera sesión puede generarlo automáticamente con una configuración usable para CLI; después /alfred-dev:config te deja revisarlo y ampliarlo con autonomía, agentes opcionales y memoria persistente.

alfred-dev.local.md
---
autonomia:
  producto: autonomo
  arquitectura: autonomo
  desarrollo: autonomo
  calidad: autonomo
  documentacion: autonomo
  entrega: autonomo

agentes_opcionales:
  data-engineer: false
  ux-reviewer: false
  performance-engineer: false
  github-manager: false
  seo-specialist: false
  copywriter: false
  librarian: false
  i18n-specialist: false

memoria:
  enabled: true
  sync_to_native: true
  sync_commits_limit: 10
  capture_decisions: true
  capture_commits: true
  retention_days: 365

personalidad:
  nivel_sarcasmo: 3
  celebrar_victorias: true
  insultar_malas_practicas: true
---

Bootstrap automático

Si un proyecto no tiene configuración local, Alfred puede generar .claude/alfred-dev.local.md automáticamente en la primera sesión para que el plugin sea usable desde CLI sin preparación manual.

Autonomía operativa

Controla cuánta intervención necesitas en cada fase o tramo del flujo. En modo autónomo Alfred reduce entrevistas innecesarias y prioriza continuidad, brownfield y siguiente paso antes de abrir un equipo completo.

Agentes opcionales

Activa solo los que necesites. Alfred analiza tu proyecto y te sugiere cuáles habilitar según el stack detectado. Se pueden cambiar en cualquier momento sin reinstalar.

Memoria y contexto

La memoria persistente y los artefactos de continuidad conviven: decisiones en SQLite por proyecto, handoff, UAT y documentos operativos en docs/project/ para retomar trabajo sin perder el hilo.

Personalidad

El nivel de sarcasmo va de 0 (profesional formal) a 5 (ácido con cariño). Las celebraciones y los avisos por malas prácticas se activan por separado.

Preguntas frecuentes

FAQ

Sí. Alfred Dev tiene un instalador nativo en PowerShell para Windows 10/11. También puedes usar el instalador bash a través de WSL (Windows Subsystem for Linux) o Git Bash. La única dependencia en Windows es git; no necesita python3.
En macOS y Linux: git y python3. Ambas suelen estar preinstaladas o son fáciles de instalar con el gestor de paquetes del sistema.

En Windows: solo git. PowerShell maneja el JSON de forma nativa, así que python3 no es necesario. PowerShell 5.1+ viene preinstalado en Windows 10/11.
Ejecuta /alfred-dev:update dentro de Claude Code. El comando consulta GitHub, compara versiones y te muestra las notas de la release si hay versión nueva. También puedes volver a ejecutar el instalador: sobreescribe la versión anterior sin conflictos.
Si el proyecto ya tiene código pero todavía no tiene mapa persistente, Alfred prioriza /alfred-dev:map-codebase. Analiza la estructura, detecta stack, entrypoints, riesgos y convenciones, y deja el contexto en docs/project/codebase-map.md y docs/project/current.md antes de abrir feature, fix, spike o audit.
/alfred-dev:quick es para cambios pequeños, locales y acotados: dos fases ligeras, tests de la zona tocada y revisión rápida de seguridad. /alfred-dev:feature es para funcionalidad nueva o cambios que cruzan varios dominios, necesitan PRD, decisiones de arquitectura o un ciclo completo de producto a entrega.
Sí. /alfred-dev:pause guarda el estado actual en .claude/alfred-handoff.json y docs/project/handoff.md. Después puedes volver con /alfred-dev:resume o pedir simplemente /alfred-dev:next. Alfred recupera el flujo, la fase actual, la gate pendiente y el siguiente paso concreto.
/alfred-dev:verify cierra la validación humana del entregable. Los tests automáticos dicen si el sistema funciona técnicamente; verify registra si cumple la expectativa del usuario en UAT. El estado queda trazado como pendiente, aprobado o rechazado en .claude/alfred-uat.json y docs/project/uat.md.
/alfred-dev:progress hace visible el estado operativo del proyecto: flujo activo o handoff, progreso general, kanban, bloqueos, trazabilidad y estado de UAT. No abre trabajo nuevo ni fuerza una gate; sirve para decidir qué toca ahora con contexto real.
Ahora SonIA no solo mantiene el tablero por debajo. /alfred-dev:standup, /alfred-dev:blocked, /alfred-dev:in-progress, /alfred-dev:validate y /alfred-dev:search convierten ese estado en una interfaz operativa diaria desde CLI.
No. /alfred-dev:sync-github ejecuta SonIA Sync como espejo colaborativo para issues. La fuente de verdad sigue siendo local: docs/project/, .claude/ y la memoria SQLite del proyecto.
/alfred-dev:memory-ui abre una vista local en navegador sobre la SQLite real del proyecto. Úsala cuando quieras entender rápido qué ha pasado, qué decisiones hay registradas, qué commits se han capturado, cómo va la continuidad o si la memoria está sana, sin leer la base de datos a mano.
No necesariamente. En la primera sesión Alfred puede bootstrappear .claude/alfred-dev.local.md con una configuración base usable para CLI. Después puedes afinar autonomía, agentes opcionales, memoria o personalidad con /alfred-dev:config.
Sí. Alfred Dev convive sin conflictos con otros plugins instalados. Usa su propio namespace (alfred-dev) y no interfiere con la configuración de otros plugins.
Son 8 agentes especializados que puedes activar según las necesidades de tu proyecto: data-engineer (bases de datos), ux-reviewer (accesibilidad y usabilidad), performance-engineer (rendimiento), github-manager (gestión de repositorios), seo-specialist (posicionamiento web), copywriter (textos y ortografía), El Bibliotecario (memoria persistente: consultas históricas sobre decisiones, commits e iteraciones del proyecto) y La Intérprete (internacionalización: auditoría de claves i18n, detección de cadenas hardcodeadas, validación de formatos por locale).

Alfred analiza tu proyecto y te sugiere cuáles activar. También puedes gestionarlos manualmente con /alfred-dev:config. Se activan o desactivan sin reinstalar nada.
60 skills distribuidos en 13 dominios. Los 7 dominios originales (producto, arquitectura, desarrollo, seguridad, calidad, DevOps, documentación) cubren el ciclo de vida estándar. Los 6 nuevos (datos, UX, rendimiento, GitHub, SEO, marketing) corresponden a los agentes opcionales. Los dominios existentes también se han ampliado: documentación pasó de 4 a 9 skills, seguridad de 5 a 6, y calidad de 4 a 6.
Es una base de datos SQLite local que almacena las decisiones, commits e iteraciones de cada proyecto. Se activa opcionalmente desde /alfred-dev:config. Una vez activa, Alfred registra automáticamente los eventos del flujo de trabajo y el agente El Bibliotecario puede responder consultas históricas como "por qué se eligió esta arquitectura" o "qué se hizo en la última iteración", citando siempre las fuentes. Los datos no salen del proyecto: todo queda en .claude/alfred-memory.db.
Nada. Alfred Dev es software libre bajo licencia MIT. Puedes usarlo, modificarlo y distribuirlo sin restricciones. El código fuente está en GitHub (github.com/686f6c61/alfred-dev).
Castellano de España por defecto: tanto las respuestas como los comentarios de código, commits y documentación generada. Puedes ajustar este comportamiento con /alfred-dev:config.
Cualquier versión de Claude Code que soporte el sistema de plugins. Si puedes instalar plugins desde la línea de comandos, Alfred Dev funcionará. No hay requisito de versión mínima específica.
Sí. Alfred Dev es software libre bajo licencia MIT. Puedes reportar bugs, proponer mejoras o enviar pull requests en el repositorio de GitHub (github.com/686f6c61/alfred-dev/issues). Las contribuciones de código, documentación, traducciones o simplemente reportar problemas son bienvenidas.
Sí, como cualquier interacción con Claude. Los agentes son instrucciones de sistema que guían las respuestas, así que consumen contexto proporcional a su complejidad. En la práctica, el coste adicional es moderado: los system prompts de los agentes están optimizados para ocupar el mínimo posible sin perder precisión. Los agentes opcionales solo se cargan si los activas, así que el contexto base es el de los 10 de núcleo.
Alfred detecta el stack del directorio de trabajo actual, no del repositorio raíz. Si ejecutas Claude Code desde la raíz de un monorepo, detectará todos los lenguajes presentes. Si lo ejecutas desde un paquete concreto, se centrará en ese paquete. La memoria persistente es por directorio de trabajo, así que cada paquete puede tener su propia base de datos de decisiones si lo configuras así.
El flujo se detiene en la fase actual y Alfred te explica qué no se cumple: tests que fallan, vulnerabilidades detectadas, documentación incompleta o lo que corresponda. Tienes tres opciones: corregir el problema y reintentar la gate, pedir a Alfred que te ayude a resolverlo (por ejemplo, con /alfred-dev:fix si es un bug), o continuar manualmente asumiendo el riesgo. Alfred nunca avanza en silencio si una gate no se supera.
Está en desarrollo. OpenCode es un editor de código basado en terminal, de código abierto, que comparte la arquitectura de plugins con Claude Code. Alfred Dev está adaptándose para ser compatible con ambos entornos. La versión para OpenCode se anunciará en el repositorio cuando esté lista para uso general.