{"id":47683604,"url":"https://github.com/luismiglezmohino/ai-dev-agents","last_synced_at":"2026-04-02T14:22:30.524Z","repository":{"id":346316842,"uuid":"1184773321","full_name":"luismiglezmohino/ai-dev-agents","owner":"luismiglezmohino","description":"11 specialized AI agents + orchestrator for software development. Tool-agnostic (9 tools). Architecture-agnostic (Clean/MVC/MVVM/None). Apache 2.0.","archived":false,"fork":false,"pushed_at":"2026-03-23T10:48:49.000Z","size":535,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-24T06:09:57.588Z","etag":null,"topics":["ai-agents","ai-assisted-development","antigravity","claude-code","clean-architecture","codex-cli","continue","copilot","cursor","developer-tools","gemini-cli","mvc","mvvm","opencode","owasp","spec-driven-development","tdd","windsurf"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/luismiglezmohino.png","metadata":{"files":{"readme":"README.es.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-17T23:20:57.000Z","updated_at":"2026-03-23T16:39:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/luismiglezmohino/ai-dev-agents","commit_stats":null,"previous_names":["luismiglezmohino/ai-dev-agents"],"tags_count":6,"template":true,"template_full_name":null,"purl":"pkg:github/luismiglezmohino/ai-dev-agents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luismiglezmohino%2Fai-dev-agents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luismiglezmohino%2Fai-dev-agents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luismiglezmohino%2Fai-dev-agents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luismiglezmohino%2Fai-dev-agents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/luismiglezmohino","download_url":"https://codeload.github.com/luismiglezmohino/ai-dev-agents/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luismiglezmohino%2Fai-dev-agents/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31307822,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-assisted-development","antigravity","claude-code","clean-architecture","codex-cli","continue","copilot","cursor","developer-tools","gemini-cli","mvc","mvvm","opencode","owasp","spec-driven-development","tdd","windsurf"],"created_at":"2026-04-02T14:22:29.593Z","updated_at":"2026-04-02T14:22:30.510Z","avatar_url":"https://github.com/luismiglezmohino.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Dev Agents\n\n[🇬🇧 Read in English](README.md)\n\nSistema de agentes especializados para desarrollo asistido por IA. Agnóstico al lenguaje, framework y herramienta de IA. Soporta Clean Architecture, MVC, MVVM y None (~90% de todos los proyectos de software).\n\n## Qué es esto\n\n12 agentes especializados + 1 orchestrator que guían a los asistentes de IA durante el desarrollo de software. Incluye patrón de verificación cruzada entre agentes para prevenir errores que un solo agente no detecta.\n\n**Principio clave:** Los agentes definen QUÉ verificar (Quality Gates agnósticos). Los skills definen CÓMO hacerlo (framework-específico).\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e¿Nuevo aquí? Empieza aquí\u003c/strong\u003e\u003c/summary\u003e\n\n### Paso 1: Prueba un agente\n\nElige una tarea que ya estés haciendo (ej. escribir un test) e invoca `@tdd-developer`. Observa si los gates detectan algo que habrías pasado por alto. No necesitas más que el Quick Start.\n\n### Paso 2: Añade el contexto de tu proyecto\n\nEjecuta el prompt de bootstrap (`.ai/prompts/es/bootstrap.md`) en tu herramienta de IA. Genera `project-context.md`, `CLAUDE.md`, `decisions.md` y skills de tu stack automáticamente. Los agentes pasan de genéricos a conscientes de tu proyecto.\n\n### Paso 3: Combina agentes\n\n- **Herramientas con agentes bajo demanda** (Claude Code, OpenCode, Antigravity, Gemini CLI, Codex CLI): invoca agentes individualmente o usa `@orchestrator` para enrutar y coordinar verificación cruzada automáticamente.\n- **Herramientas sin agentes bajo demanda** (Cursor, Windsurf, Copilot): los agentes se cargan inline — invócalos por nombre en tu prompt.\n\n### Paso 4: Feature Specs (SDD)\n\nGenera un spec con `.ai/prompts/es/feature-spec.md` antes de implementar. Cada agente extrae lo que necesita del spec. Recomendado para todas las herramientas — casi esencial para Cursor/Windsurf/Copilot donde centraliza el contexto que los agentes inline no pueden cargar bajo demanda. Ver [cuándo usar specs](.ai/docs/es/persistent-memory.md).\n\n\u003e Guía completa: [guía de inicio rápido](.ai/docs/es/getting-started.md) (5 minutos).\n\n\u003c/details\u003e\n\n## Compatibilidad por herramienta\n\n| Herramienta | Fichero siempre cargado | Agentes bajo demanda | Ahorro tokens |\n|---|---|---|---|\n| Claude Code | `CLAUDE.md` | `.claude/agents/` (sí) | Alto |\n| OpenCode | `AGENTS.md` | `.opencode/agents/` (sí) | Alto |\n| Antigravity (Google) | `GEMINI.md` | `.agents/rules/` (sí, @mention) | Alto |\n| Gemini CLI | `GEMINI.md` | `.gemini/skills/` (sí, activate_skill) | Alto |\n| Codex CLI (OpenAI) | `AGENTS.md` | `.agents/skills/` (sí, /skills) | Alto |\n| Continue (VS Code) | `.continue/rules/` | Parcial (matching implícito) | Medio |\n| Cursor | `.cursorrules` | No (todo inline) | Bajo |\n| Windsurf | `.windsurfrules` | No (todo inline) | Bajo |\n| GitHub Copilot / Copilot CLI | `.github/copilot-instructions.md`, `AGENTS.md` | CLI: sí (AGENTS.md) / IDE: no | CLI: Alto / IDE: Bajo |\n\nLas herramientas con agentes/skills bajo demanda (Claude Code, OpenCode, Antigravity, Gemini CLI, Codex CLI) cargan agentes SOLO cuando se invocan — alto ahorro de tokens. Las herramientas sin agentes bajo demanda cargan todo en un fichero compacto. Para esas, **se recomienda [SDD (Feature Specs)](.ai/templates/FEAT-TEMPLATE.md)** para centralizar contexto.\n\n\u003e Ver [herramientas soportadas y descargas](.ai/docs/es/supported-tools.md), [capacidades detalladas por herramienta](.ai/docs/es/how-claude-code-works.md) y [patrones de verificación cruzada](.ai/docs/es/cross-verification.md).\n\n## Inicio rápido\n\n### 1. Añadir `.ai/` a tu proyecto\n\n**Opción A:** Clic en \"Use this template\" en el repo de GitHub (repo completo).\n\n**Opción B:** Descargar solo `.ai/` en un proyecto existente (requiere Node.js)\n\n```bash\nnpx degit luismiglezmohino/ai-dev-agents/.ai .ai\n```\n\n**Opción C:** Sin Node.js\n\n```bash\ncurl -sL https://github.com/luismiglezmohino/ai-dev-agents/archive/main.tar.gz \\\n  | tar xz \u0026\u0026 mv ai-dev-agents-main/.ai . \u0026\u0026 rm -rf ai-dev-agents-main\n```\n\n\u003e Solo necesitas [`.ai/`](.ai/) — todo lo demás lo genera `sync.sh` en el paso 3.\n\n### 2. Configurar proyecto\n\n**Opción A: Bootstrap automático (recomendado)**\n\nAbre tu herramienta de IA y pega el contenido de `.ai/prompts/es/bootstrap.md`.\nEl LLM analiza tu proyecto (o pregunta si es nuevo) y genera automáticamente:\n- `.ai/agents/project-context.md` — contexto del proyecto\n- `CLAUDE.md` — configuración principal\n- `.ai/decisions.md` — decisiones del stack\n- `.ai/skills/` — skills básicos del stack\n\n**Opción B: Manual** — copiar templates y rellenar placeholders.\n\n### 3. Sincronizar y validar\n\n```bash\n.ai/sync.sh   # Genera configs para las 9 herramientas\n.ai/test.sh   # Valida estructura (0 errores = listo)\n```\n\n\u003e Ejecuta siempre `sync.sh` después de cualquier cambio en `.ai/`. Genera `AGENTS.md`, `.claudeignore`, estructura `docs/`, entradas `.gitignore` y configs por herramienta.\n\n### Qué commitear y qué gitignorear\n\n| Fichero/Directorio | ¿Commitear? | Por qué |\n|---|---|---|\n| `.ai/` (directorio completo) | **Sí** | Fuente de verdad |\n| `CLAUDE.md` | **Sí** | Config principal |\n| `AGENTS.md` | **Sí** | Generado por sync.sh, pero commitéalo |\n| `.claude/settings.json` | **Sí** | Config de hooks + MCP |\n| `docs/` | **Sí** | Specs, ADRs (creados por sync.sh) |\n| `.claude/agents/`, `.claude/rules/`, `.opencode/` | **No** | Generado por `sync.sh` |\n| `.cursorrules`, `.windsurfrules`, `GEMINI.md` | **No** | Generado por `sync.sh` |\n| `.agents/` | **No** | Generado por `sync.sh` (Codex, Gemini CLI, Antigravity) |\n| `.continue/rules/` | **No** | Generado por `sync.sh` (Continue) |\n| `.gemini/skills` | **No** | Generado por `sync.sh` (Gemini CLI) |\n| `.ai/.local/` | **No** | Estado de sesión |\n\n\u003e **Regla:** si `sync.sh` lo genera, gitignórealo. Si lo editas a mano, commitéalo. Edita siempre en `.ai/` y re-ejecuta `sync.sh` para propagar cambios. Sync genera para las 9 herramientas a la vez — esto permite cambiar de herramienta sin reconfigurar.\n\n## Agentes incluidos\n\n| Agente | Misión | Gates clave |\n|---|---|---|\n| product-owner | User Stories con ROI | Formato US, criterios medibles, valor claro |\n| architect | Integridad arquitectónica | Domain puro, flujo e2e, contratos completos |\n| tdd-developer | RED-GREEN-REFACTOR | Test falla primero, ambas suites, DI compila |\n| database-engineer | Schema + migraciones | Reversibles, índices, mapeo ORM verificado |\n| security-auditor | OWASP Top 10:2025 | Inputs validados, sin secrets, supply chain + gates condicionales (auth, passwords, uploads, CSRF, cookies, SSRF) |\n| qa-engineer | Coverage 100/80/0 | Pirámide testing, sin tests ignorados |\n| performance-engineer | Core Web Vitals | p95 \u003c 200ms, LCP/FID/CLS, bundle \u003c 100KB |\n| devops | CI/CD + Git workflow | Pipeline verde, infra declarativa, PR docs |\n| observability-engineer | Metrics + logs | Métricas negocio, logs JSON, health checks |\n| incident-responder | Respuesta a incidentes | Severidad clasificada, causa raíz, postmortem, monitorización actualizada |\n| technical-writer | Docs vivas | Ejemplos funcionales, ADRs completos, setup \u003c 15min |\n| ux-designer | WCAG 2.2 AA | Contraste 4.5:1, targets 44x44px, teclado |\n\nCada gate existe porque su ausencia causó problemas reales y repetidos. Ver [por qué existen estos gates](.ai/docs/es/why-these-gates.md).\n\n## Soporte de Arquitectura\n\nEl template soporta **4 modos de arquitectura** (~90% de todos los proyectos de software):\n\n| Flag | Cuándo usarlo | Agentes adaptados |\n|---|---|---|\n| `Clean` (por defecto) | Backend con capas separadas (Domain/Application/Infrastructure) | Ninguno (gates por defecto) |\n| `MVC` | Framework MVC (Laravel, Django, Rails, Spring MVC...) | architect, tdd-developer, qa-engineer, orchestrator |\n| `MVVM` | Apps mobile (Android, iOS, Flutter) | architect, ux-designer, performance-engineer, orchestrator |\n| `None` | Frontend-only SPA, herramientas CLI, o sin arquitectura formal | Architect no se invoca |\n\nEl bootstrap detecta la arquitectura por la estructura de carpetas o pregunta. Adapta los agentes relevantes — el resto no cambian.\n\n\u003e El frontend web (Vue/React) usa `None` — lo cubren ux-designer + skills, no los gates del architect.\n\n## Prompts reutilizables\n\n| Prompt | Cuándo usarlo | Obligatorio |\n|---|---|---|\n| `es/bootstrap.md` | Día 0 — genera configs + skills | Sí |\n| `es/feature-spec.md` | Antes de features complejas (SDD) | No |\n| `es/code-review.md` | Antes de abrir una PR | No |\n| `es/refine-skills.md` | Después de 2-3 features | No |\n| `es/legacy-audit.md` | Antes de modernizar código legacy | No |\n\nTodos los prompts disponibles en español (`.ai/prompts/es/`) e inglés (`.ai/prompts/`). Los gates específicos de arquitectura (`gates-mvc.md`, `gates-mvvm.md`) se cargan bajo demanda por el bootstrap — no hace falta pegarlos por separado.\n\n### Cómo usar los prompts\n\n| Herramienta | Cómo usarlos |\n|---|---|\n| Claude Code / OpenCode / Gemini CLI / Codex CLI | Dile a la IA: `Lee .ai/prompts/es/code-review.md y ejecútalo` |\n| Continue / Cursor / Windsurf / Copilot | Copia el contenido del `.md` y pégalo en el chat |\n\n## Modos de trabajo\n\nEstos son flujos de trabajo recomendados, no restricciones. Los agentes son flexibles — úsalos como encaje en tu proyecto. Los tres modos son compatibles — puedes usar A para fixes rápidos y C para features grandes en el mismo proyecto.\n\n### Modo A: Agentes directos (el más simple)\n\nInvoca cada agente manualmente cuando lo necesites:\n\n```\n@tdd implement the GET /api/users endpoint\n@architect review the layer structure\n@security audit-all\n```\n\n**Ideal para:** tareas puntuales, fixes rápidos, trabajo en una sola capa.\n\n### Modo B: Orchestrator (coordinación automática)\n\nEl orchestrator enruta al agente correcto y coordina verificación cruzada:\n\n```\n\"Necesito un nuevo endpoint para gestionar usuarios\"\n→ Enruta a @tdd-developer\n→ Luego lanza @architect y @security-auditor automáticamente\n```\n\n**Ideal para:** features completas que tocan varias capas. Disponible en herramientas con agentes bajo demanda (Claude Code, OpenCode, Antigravity, Gemini CLI, Codex CLI).\n\n### Modo C: Spec Driven Development (SDD) — el más completo\n\nDefine una especificación técnica ANTES de implementar. Los agentes trabajan contra esa especificación:\n\n1. Genera un Feature Spec con `.ai/prompts/es/feature-spec.md`\n2. Cada agente extrae lo que necesita del spec\n3. Implementación guiada por la especificación\n4. Verificación contra los criterios del spec\n\n**Ideal para:** features complejas (5+ endpoints), equipos, proyectos críticos. Recomendado para todas las herramientas — casi esencial para Cursor/Windsurf/Copilot.\n\n### Cuándo usar cada modo\n\n| Situación | Modo recomendado |\n|---|---|\n| Fix rápido, tarea puntual | A (agentes directos) |\n| Feature nueva estándar | B (orchestrator) |\n| Feature compleja o crítica | C (SDD) |\n| Proyecto nuevo (día 0) | C (SDD) para la primera feature, luego B |\n| Hotfix en producción | A (directo) + @incident-responder |\n| Código legacy / modernización | C (SDD) — especificar antes de tocar |\n\n### Cómo trabajar con cada modo\n\n**Modo A — Agentes directos:**\n\n1. Abre tu herramienta de IA (Claude Code, OpenCode, Cursor...)\n2. Escribe el comando del agente que necesitas: `@tdd implement \u003cfeature\u003e`\n3. El agente trabaja, tú revisas lo que genera\n4. Si necesitas verificación, invoca manualmente: `@security audit-all`\n5. Cuando estés satisfecho, commit y PR\n\n**Modo B — Orchestrator:**\n\n1. Describe lo que necesitas en lenguaje natural: \"Necesito un endpoint para crear usuarios\"\n2. El orchestrator decide qué agente usar y lo lanza\n3. Al terminar, el orchestrator lanza verificación cruzada automáticamente\n4. Revisas el resultado final. Si hay problemas, el orchestrator itera\n5. Cuando estés satisfecho, commit y PR\n\n**Modo C — SDD (Spec Driven Development):**\n\n1. Antes de escribir código, genera la especificación: pega `.ai/prompts/es/feature-spec.md` en tu herramienta de IA\n2. La IA genera un fichero en `docs/specs/FEAT-XXX-name.md` con requisitos, contratos, errores esperados\n3. Revisa y ajusta el spec — este es el momento de pensar, no cuando estás programando\n4. Implementa: `@tdd implement according to spec docs/specs/FEAT-XXX-name.md`\n5. Cada agente extrae lo que necesita del spec (tests, seguridad, arquitectura)\n6. Verificación cruzada contra los criterios del spec\n7. Commit y PR\n\n## Guías\n\n| Guía | Descripción |\n|---|---|\n| **[Inicio rápido](.ai/docs/es/getting-started.md)** | De cero a agentes funcionando en 5 minutos |\n| **[Verificación cruzada](.ai/docs/es/cross-verification.md)** | Flujos del orchestrator, cuándo aplicar, estrategias |\n| **[Optimización de tokens](.ai/docs/es/token-optimization.md)** | Estrategia de idiomas, jerarquía de carga, decisiones |\n| **[Cómo funciona Claude Code](.ai/docs/es/how-claude-code-works.md)** | Gestión de contexto, qué puede acceder, implicaciones |\n| **[Ciclo de vida de agentes](.ai/docs/es/agent-lifecycle.md)** | Agentes efímeros, anti-patrones, gestión de contexto |\n| **[Memoria persistente](.ai/docs/es/persistent-memory.md)** | Rules, hooks, Engram, Feature Specs, memoria por herramienta |\n| **[Por qué existen estos gates](.ai/docs/es/why-these-gates.md)** | Cadenas de error reales que motivaron cada Quality Gate |\n| **[MCPs recomendados](.ai/docs/es/recommended-mcps.md)** | MCPs básicos y opcionales por stack |\n| **[Git hooks recomendados](.ai/docs/es/recommended-hooks.md)** | Hooks con Lefthook y Husky |\n| **[GitHub Actions workflows](.ai/docs/es/recommended-workflows.md)** | CI/CD, estrategia de ramas |\n| **[Modelos recomendados](.ai/docs/es/recommended-models.md)** | Modelo por agente/tarea, estrategia de costes, modelos locales |\n\n## Siguientes pasos\n\n| Siguiente paso | Cuándo | Guía |\n|---|---|---|\n| Configurar MCPs | Si necesitas conectar BD, Sentry, GitHub... | [MCPs recomendados](.ai/docs/es/recommended-mcps.md) |\n| Configurar Git hooks | Antes de la primera PR | [Hooks recomendados](.ai/docs/es/recommended-hooks.md) |\n| Configurar CI/CD | Antes de producción | [Workflows recomendados](.ai/docs/es/recommended-workflows.md) |\n| Elegir modelos | Si quieres optimizar coste/calidad | [Modelos recomendados](.ai/docs/es/recommended-models.md) |\n| Crear Feature Spec | Antes de una feature compleja | Ver `.ai/templates/FEAT-TEMPLATE.md` |\n| Refinar skills | Después de 2-3 features implementadas | Usar `.ai/prompts/es/refine-skills.md` |\n| Auditar código legacy | Antes de modernizar | Usar `.ai/prompts/es/legacy-audit.md` |\n\n## Inspiración y referencias\n\n- **[Engram](https://github.com/Gentleman-Programming/engram)** — Memoria persistente cross-tool via MCP (MIT)\n- **[github/spec-kit](https://github.com/github/spec-kit)** — Toolkit de Spec-Driven Development por GitHub (MIT)\n- **[OWASP Top 10:2025](https://owasp.org/Top10/)** — Base del @security-auditor (CC BY-SA 4.0)\n\n## Licencia\n\nApache License 2.0 — Uso libre (incluido comercial) con atribución obligatoria. Ver [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluismiglezmohino%2Fai-dev-agents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluismiglezmohino%2Fai-dev-agents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluismiglezmohino%2Fai-dev-agents/lists"}