alfred-dev

█████╗ ██╗     ███████╗██████╗ ███████╗██████╗     ██████╗ ███████╗██╗   ██╗
██╔══██╗██║     ██╔════╝██╔══██╗██╔════╝██╔══██╗    ██╔══██╗██╔════╝██║   ██║
███████║██║     █████╗  ██████╔╝█████╗  ██║  ██║    ██║  ██║█████╗  ██║   ██║
██╔══██║██║     ██╔══╝  ██╔══██╗██╔══╝  ██║  ██║    ██║  ██║██╔══╝  ╚██╗ ██╔╝
██║  ██║███████╗██║     ██║  ██║███████╗██████╔╝    ██████╔╝███████╗ ╚████╔╝
╚═╝  ╚═╝╚══════╝╚═╝     ╚═╝  ╚═╝╚══════╝╚═════╝     ╚═════╝ ╚══════╝  ╚═══╝

Plugin de ingeniería de software automatizada para Claude Code.

10 agentes (8 de núcleo, Selina si hay frontend y Lucius bajo demanda), catálogo de 11 skills de proceso, memoria persistente de decisiones por proyecto, 6 flujos de trabajo con quality gates verificables con evidencia, fase de estilo visual condicional, modo autopilot y compliance europeo (RGPD, NIS2, CRA) integrado desde el diseño.

Documentación completa -- Instalar -- Equipo -- Comandos -- Arquitectura

---

Qué es Alfred Dev

Alfred Dev es un plugin que orquesta el ciclo de desarrollo de software con agentes autónomos. Cada agente tiene un rol concreto, un ámbito delimitado y quality gates que impiden avanzar a la siguiente fase sin evidencia. El sistema está pensado para que ningún artefacto llegue a producción sin haber pasado por producto, arquitectura, desarrollo con TDD, revisión de seguridad, QA y documentación.

El runtime detecta el stack del proyecto con config_loader.detect_stack() (Node.js/TypeScript, Python, Rust, Go, Ruby, Elixir, Java/Kotlin, PHP, C#/.NET, Swift) y adapta artefactos al ecosistema real: frameworks, gestores de paquetes, runners de tests y estructura de directorios cuando esos manifiestos existen.

La documentación viva del proyecto auditado vive en docs/project/ (índice, arquitectura, compliance, threat-model, dependencias, mapa y estado). Los ADRs van a docs/adr/. Esos ficheros no son este repositorio: los crea el plugin en el repo donde trabajas.

El equipo

Alfred Dev no es un agente monolítico que intenta saberlo todo. Es un equipo de 10 especialistas, cada uno con un rol delimitado, personalidad propia y quality gates verificables con evidencia. Un modelo generalista rinde mejor con un rol concreto e instrucciones focalizadas que cuando se le pide que sea todo a la vez.

Cada agente se invoca como un subproceso de Claude Code mediante la herramienta Agent. Arranca con su propio system prompt, sin heredar sesgos ni ruido de conversaciones anteriores. El resultado no se promete determinista, pero sí más controlable: el mismo rol, las mismas instrucciones y los mismos artefactos reducen la variabilidad y facilitan revisar si cumplió su contrato.

Tres principios de diseño:

• Responsabilidad única. El Artesano escribe código; El Paranoico audita seguridad. Ninguno invade el territorio del otro.
• Herramientas restringidas. No todos los agentes necesitan el sistema de ficheros o la terminal. Limitar herramientas reduce la superficie de error.
• Quality gates entre fases. Ningún artefacto pasa de fase sin un punto de control. Las gates pueden ser automáticas (tests verdes), manuales (aprobación del usuario) o combinadas (automático + seguridad).

Frontera del núcleo:

• product-owner decide qué problema se resuelve y por qué.
• architect decide cómo se implementa técnicamente.
• alfred decide cuándo interviene cada uno, en qué orden y con qué gate.

Si esas tres responsabilidades se mezclan, el flujo deja de ser previsible. Alfred coordina; no redefine alcance ni diseño por su cuenta.

Flujo feature: cronología de fases

El flujo feature es el más completo: hasta siete fases secuenciales. La fase estilo_visual solo aparece si el proyecto tiene frontend. El security-officer interviene en arquitectura, calidad y entrega: la seguridad no es un paso final.

timeline
    title Flujo feature - fases y agentes
    producto
        : product-owner
        : Análisis de requisitos
        : Gate - aprobación del usuario
    estilo visual
        : selina
        : Dirección de estilo visual (solo con frontend)
        : Gate - elección del usuario
    arquitectura
        : architect + security-officer
        : Diseño técnico y threat model
        : Gate - aprobación del usuario
    desarrollo
        : senior-dev
        : Implementación TDD
        : Gate - tests verdes (automático)
    calidad
        : qa-engineer + security-officer
        : Tests y auditoría de seguridad
        : Gate - automático + seguridad
    documentación
        : tech-writer
        : Documentación técnica y de usuario
        : Gate - libre (sin bloqueo)
    entrega
        : devops-engineer + security-officer
        : Changelog y validación final
        : Gate - usuario + seguridad

El security-officer valida el threat model en arquitectura, audita el código en calidad y da el visto bueno en entrega. Detectar un problema de seguridad pronto sale más barato que detectarlo en producción.

Instalación

Una sola línea. El script verifica el entorno, registra en Claude Code una fuente GitHub global para Alfred Dev e instala el plugin con la CLI nativa de Claude Code. No pisa ~/.claude/skills ni crea ~/.claude/skills/alfred/SKILL.md ni ~/.claude/commands/alfred.md. La entrada es /alfred-dev:alfred. Parchea hooks y .mcp.json si el python3 por defecto no es compatible.

Antes de instalar, limpia el checkout local del marketplace (~/.claude/plugins/marketplaces/alfred-dev) y lo vuelve a registrar, para no materializar una caché antigua. La instalación soportada es siempre global de usuario: si existían rastros local o project del propio Alfred Dev, el instalador los normaliza y reinstala con --scope user. No usa un marketplace oficial de Anthropic: usa la CLI nativa para registrar una fuente propia no oficial.

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

Si ya tienes este repo clonado localmente, también puedes invocarlo así:

bash ./install.sh

Después de instalar, en una sesión abierta ejecuta /reload-plugins para cargar Alfred Dev sin reiniciar. Si Claude Code avisa por coste/caché de MCP o el plugin no aparece, reinicia Claude Code. Verifica con:

/alfred-dev:alfred

En Windows (PowerShell):

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

Requisitos:

• Claude Code instalado, configurado y actualizado. Alfred Dev 0.7.0 requiere una CLI con plugins, skills, hooks y MCP.
• Python 3.10+ (para hooks, core y MCP en macOS, Linux y Windows).

Para desinstalar:

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

# macOS / Linux, desde el repo clonado
bash ./uninstall.sh

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

El desinstalador retira el plugin y la fuente del marketplace en scope user. Si queda un alias global /alfred de instalaciones 0.6, también lo limpia. No borra .claude/ del proyecto (config, memoria SQLite, handoff).

/alfred-dev:update compara la versión instalada con el último GitHub Release y guía la actualización. Añadir el marketplace 686f6c61/alfred-dev instala lo que haya en la rama por defecto main.

Inicio rápido

Una vez instalado, habla en castellano. No hace falta memorizar slash commands.

sigue donde lo dejé
el login peta con eñes
cambia el texto del botón

El hook prompt-route.py sugiere la ruta si el texto no trae slash. /alfred-dev:alfred decide si toca mapear, discutir, retomar, abrir UAT o arrancar un flujo. Si quieres el flujo largo:

/alfred-dev:feature sistema de login con email y password

/alfred-dev:ajustes cambia autonomía y Lucius. /alfred-dev:feature recorre hasta 7 fases (producto, estilo visual, arquitectura, desarrollo, calidad, documentación, entrega). Autopilot solo resuelve gates de usuario configuradas; no salta tests, seguridad, evidencia ni confirmación humana de despliegue. La fase de estilo visual se activa solo si hay interfaz.

Novedades en v0.7.0

Recorte alineado con el SDK de Claude Code: 10 agentes (inherit), 11 skills planas, 18 comandos publicados. La entrada es /alfred-dev:alfred. Continuidad pública: alfred, progress y retomar. Sin alias global /alfred, sin stop-hook Ralph y sin reescribir settings.json. El servidor de memoria usa MCP stdio moderno y arranca mcp/memory_server.py con FastMCP si el paquete mcp está instalado. Secret-guard cubre Write, Edit, Bash y tools MCP de escritura. Agent Teams solo si el usuario ya lo tiene activo. La auditoría viva está en docs/release.md. El histórico de 0.6.x está en el changelog.

Comandos

Toda la interfaz se controla desde la línea de comandos de Claude Code. La entrada principal es /alfred-dev:alfred. El resto usa el mismo prefijo /alfred-dev:. No hay alias global /alfred. plugin.json publica 18 comandos. En commands/ quedan helpers internos que no se listan como slash: next, search, _composicion.md y _docs_vivas.md.

Core

Comando	Descripción
/alfred-dev:alfred	Entrada contextual: decide si toca mapear, discutir, retomar, abrir UAT o arrancar un flujo multiagente.
/alfred-dev:feature <desc>	Ciclo completo de hasta 7 fases. Alfred pregunta desde qué fase arrancar.
/alfred-dev:quick <desc>	Flujo ligero para cambios pequeños con menos ceremonia que feature.
/alfred-dev:fix <desc>	Corrección de bugs en 3 fases: diagnóstico, corrección TDD, validación.
/alfred-dev:spike <tema>	Investigación técnica sin compromiso: prototipos, benchmarks, hallazgos.
/alfred-dev:discuss <desc>	Refina una idea o fase y deja docs/project/discovery.md antes de abrir feature.
/alfred-dev:map-codebase	Analiza un repo existente y deja docs/project/codebase-map.md y docs/project/current.md.
/alfred-dev:progress	Resume kanban, bloqueos, trazabilidad, UAT y estado operativo.
/alfred-dev:uat	Crea o cierra la validación humana, separada de los tests automáticos.
/alfred-dev:audit	Auditoría con 4 agentes en paralelo: calidad, seguridad, arquitectura, documentación.
/alfred-dev:ship	Release: auditoría final, changelog, versionado semántico, despliegue.
/alfred-dev:memory-ui	Abre o cierra la UI local de la memoria SQLite.
/alfred-dev:ajustes	Configurar autonomía, stack, Lucius, memoria y personalidad.

Operativos

Comando	Descripción
/alfred-dev:retomar	Retoma una sesión pausada usando el handoff y el estado guardado.
/alfred-dev:pause	Pausa el trabajo en curso y genera handoff persistente.
/alfred-dev:sync-github [owner/repo]	Refleja el tablero local en GitHub Issues usando gh.
/alfred-dev:lucius [dir] [--scope X]	Segunda opinión técnica vía Codex CLI.
/alfred-dev:update	Comprueba si hay versión nueva (GitHub Releases) y actualiza el plugin.

Ejemplo de uso