{"id":50948728,"url":"https://github.com/azulls1/iagentek-framework","last_synced_at":"2026-06-17T23:03:44.812Z","repository":{"id":360282718,"uuid":"1249455603","full_name":"azulls1/iagentek-framework","owner":"azulls1","description":"Autonomous AI-assisted development framework. Merges Spec-Driven Development with BMAD Method in a single npx CLI. Orchestrates specialized agents (Analyst, PM, Architect, Dev, QA, DevOps) with human checkpoints. Works with Claude, OpenAI, Gemini, DeepSeek, Ollama. Greenfield \u0026 brownfield. One command, full cyc","archived":false,"fork":false,"pushed_at":"2026-05-26T15:12:22.000Z","size":297,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-26T15:33:39.555Z","etag":null,"topics":["agents","ai","anthropic","autonomous","bmad","claude","claude-code","cli","deepseek","framework","gemini","npx","ollama","openai","spec-driven-development","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/azulls1.png","metadata":{"files":{"readme":"README.es.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-25T18:08:15.000Z","updated_at":"2026-05-26T15:21:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/azulls1/iagentek-framework","commit_stats":null,"previous_names":["azulls1/gentek-framework","azulls1/iagentek-framework"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/azulls1/iagentek-framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azulls1%2Fiagentek-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azulls1%2Fiagentek-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azulls1%2Fiagentek-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azulls1%2Fiagentek-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azulls1","download_url":"https://codeload.github.com/azulls1/iagentek-framework/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azulls1%2Fiagentek-framework/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34468767,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agents","ai","anthropic","autonomous","bmad","claude","claude-code","cli","deepseek","framework","gemini","npx","ollama","openai","spec-driven-development","typescript"],"created_at":"2026-06-17T23:03:42.509Z","updated_at":"2026-06-17T23:03:44.804Z","avatar_url":"https://github.com/azulls1.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IAgentek\n\n[![npm version](https://img.shields.io/npm/v/@iagentek/cli.svg?label=npm\u0026color=cb3837)](https://www.npmjs.com/package/@iagentek/cli)\n[![CI](https://img.shields.io/github/actions/workflow/status/azulls1/iagentek-framework/ci.yml?branch=main\u0026label=CI)](https://github.com/azulls1/iagentek-framework/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)\n[![Node](https://img.shields.io/node/v/@iagentek/cli.svg)](https://nodejs.org)\n[![npm downloads](https://img.shields.io/npm/dm/@iagentek/cli.svg)](https://www.npmjs.com/package/@iagentek/cli)\n\n\u003e 🇬🇧 Also available in [English](./README.md)\n\n\u003e Framework de desarrollo autónomo asistido por IA para equipos de programadores.\n\u003e Fusiona **Spec-Driven Development** (specs como source-of-truth) con **BMAD Method** (agentes especializados con roles claros).\n\nUn comando, un ciclo entero. Greenfield, brownfield, bugfix o refactor. Claude por default, cualquier IA por API key. Disponible como **CLI `npx`** o como **plugin de Claude Code**.\n\n```bash\nnpx @iagentek/cli init mi-producto\ncd mi-producto\nnpx @iagentek/cli cycle --idea \"Quiero un sistema de tickets para soporte que...\"\n```\n\nO desde Claude Code:\n```\n/iagentek-init mi-producto\n/iagentek-cycle --idea \"...\"\n```\n\n---\n\n## ¿Qué hace?\n\nIAgentek orquesta un equipo virtual de agentes (Analyst → PM → Architect → Scrum Master → Dev → QA → DevOps + Debugger + Refactor Architect) que pasan por un ciclo de desarrollo completo. Cada agente produce artefactos **spec-driven** (constitución, PRD, specs, plans, tasks, stories) que son la fuente de verdad del proyecto. Tú apruebas en checkpoints clave y el ciclo sigue.\n\n**Modos de ejecución:**\n- `autonomous-with-checkpoints` (default) — corre solo, se detiene en momentos clave\n- `fully-autonomous` — end-to-end sin parar\n- `interactive` — pregunta en cada paso\n\n**4 ciclos completos:**\n- `greenfield` — producto desde cero (7 fases)\n- `brownfield` — sobre código existente (8 fases, análisis previo automático)\n- `bugfix` — incident response corto (triage → repro → fix → postmortem)\n- `refactor` — reducción de tech-debt por etapas (audit → migration plan → ejecución segura)\n\n**6 providers de IA (auto-detectados):**\n| Provider | Cómo se detecta | Default model |\n|---|---|---|\n| `claude-cli` | comando `claude` en PATH | claude-opus-4-7 |\n| `anthropic` | `ANTHROPIC_API_KEY` | claude-opus-4-7 |\n| `openai` | `OPENAI_API_KEY` | gpt-4o |\n| `gemini` | `GEMINI_API_KEY` | gemini-2.0-flash |\n| `deepseek` | `DEEPSEEK_API_KEY` | deepseek-chat |\n| `ollama` | comando `ollama` en PATH | llama3.1 |\n\n**9 agentes BMAD:**\nAnalyst · PM · Architect · Scrum Master · Dev · QA · DevOps · Debugger · Refactor Architect.\n\n---\n\n## Quick start (CLI)\n\n### 1) Bootstrap\n```bash\nnpx @iagentek/cli init mi-producto\n```\nDetecta automáticamente el provider disponible. Si necesitas API key y no está en env, te la pide y la guarda en `.env` (con `.gitignore` automático).\n\nAdemás eliges el **idioma de output** (English o Español) de forma interactiva, o vía flag:\n```bash\nnpx @iagentek/cli init mi-producto --lang es      # Output en español\nnpx @iagentek/cli init mi-producto --lang en      # Output en inglés (default)\n```\nEl framework detecta el locale del sistema (`LANG`/`LC_ALL`) y propone español si tu SO está configurado como `es_*`.\n\n### 2) Ejecutar el ciclo\n```bash\ncd mi-producto\nnpx @iagentek/cli cycle --idea \"App móvil para reservar canchas de pádel\"\n```\n\n### 3) Comandos disponibles\n| Comando | Qué hace |\n|---|---|\n| `init [name]` | Bootstrap `.iagentek/` con config + state |\n| `cycle [--flow X] [--idea \"...\"]` | Ejecuta el ciclo con checkpoints |\n| `status` | Muestra fases, checkpoints aprobados, próximos pasos |\n| `resume` | Retoma desde la última fase pausada |\n| `agent \u003crole\u003e [--prompt \"...\"]` | Invoca un agente BMAD aislado |\n\n---\n\n## Quick start (Claude Code plugin)\n\nInstala el plugin apuntando a este repo:\n```\n/plugin add github.com/azulls1/iagentek-framework path:iagentek-plugin\n```\n\nComandos disponibles después de instalar:\n- `/iagentek-init` — bootstrap interactivo\n- `/iagentek-cycle` — ciclo completo\n- `/iagentek-status` — estado actual\n- `/iagentek-resume` — retoma desde checkpoint\n- `/iagentek-agent` — invoca un agente\n\nAgentes invocables como `@iagentek-analyst`, `@iagentek-pm`, `@iagentek-architect`, etc.\n\nVer detalles en [`iagentek-plugin/README.md`](./iagentek-plugin/README.md).\n\n---\n\n## Estructura que se genera en tu proyecto\n\n```\nmi-producto/\n├── .env                       # API key (gitignored)\n├── .gitignore\n└── .iagentek/\n    ├── config.yaml            # provider, flow, modo, checkpoints\n    ├── state.json             # tracking de fases (gitignored)\n    ├── constitution.md        # principios no-negociables (SDD)\n    ├── project-brief.md       # output del Analyst\n    ├── current-state.md       # solo en brownfield/bugfix/refactor (auto)\n    ├── PRD.md                 # output del PM\n    ├── architecture.md        # output del Architect\n    ├── sprint-plan.md         # output del Scrum Master\n    ├── DoD.md                 # Definition of Done\n    ├── specs/                 # specs SDD por feature\n    ├── plans/                 # plans técnicos por feature\n    ├── stories/               # user stories (sprint)\n    ├── tasks/                 # tasks atómicas (1-4h)\n    ├── qa/                    # reportes de QA por story\n    ├── deployment.md          # runbook de DevOps\n    ├── incidents/             # postmortems (solo bugfix)\n    ├── debt-audit.md          # auditoría (solo refactor)\n    ├── refactor-plans/        # planes por etapas (solo refactor)\n    └── .transcripts/          # outputs crudos de cada agente (gitignored)\n```\n\n---\n\n## Fusión SDD + BMAD\n\n| Aspecto | Lo que aporta SDD | Lo que aporta BMAD |\n|---|---|---|\n| Artefactos | Constitution, spec, plan, tasks | — |\n| Agentes | — | Analyst, PM, Architect, SM, Dev, QA, DevOps |\n| Filosofía | Specs son el contrato | Roles especializados ejecutan |\n| Validación | Acceptance criteria verificables | Checkpoints humanos por fase |\n\n**En IAgentek:** los agentes BMAD son los ejecutores; los artefactos SDD son el contrato. Cada agente lee artefactos previos como input y produce los suyos como output. El humano aprueba en checkpoints.\n\n---\n\n## Arquitectura del framework\n\nVer [ARCHITECTURE.md](./ARCHITECTURE.md). Monorepo con 3 paquetes npm + 1 plugin de Claude Code:\n\n- `@iagentek/cli` — CLI ejecutable por `npx`\n- `@iagentek/core` — providers de IA, orchestrator, checkpoints, state, codebase analyzer\n- `@iagentek/method` — agentes BMAD + plantillas SDD + flows (markdown + YAML)\n- `iagentek-plugin/` — plugin de Claude Code complementario (no se publica a npm)\n\n---\n\n## Desarrollo local\n\n```bash\ngit clone https://github.com/azulls1/iagentek-framework\ncd iagentek-framework\nnpm install\nnpm run build\nnode packages/cli/dist/bin/iagentek.js --help\n```\n\n## Publicación a npm\nVer [PUBLISHING.md](./PUBLISHING.md).\n\n---\n\n## Estado y roadmap\n\n**v0.4.4 (actual) — Hardening de seguridad:**\n- ✅ **Path traversal bloqueado.** Los bloques `file:path` emitidos por los agentes se validan contra la raíz del proyecto — paths absolutos, escapes con `..`, paths de Windows con letra de unidad y UNC son rechazados.\n- ✅ **Prompt injection neutralizado.** La idea del usuario, los inputs de archivos y los excerpts de README analizados se envuelven en marcadores `\u003c\u003c\u003cUNTRUSTED_INPUT_*\u003e\u003e\u003e` y el prompt del agente los trata como datos, no como instrucciones.\n- ✅ **`.gitignore` seguro en brownfield.** `init` ahora garantiza idempotentemente que `.env`, `.iagentek/state.json`, `.iagentek/.transcripts/` y `.iagentek/.cache/` queden ignorados aunque el repo ya tuviera su `.gitignore`.\n- ✅ **Allowlist del `.env`.** Solo se importan claves de provider (`*_API_KEY`, `*_TOKEN`, `*_SECRET`, `OLLAMA_HOST`) — un `.env` malicioso no puede secuestrar `PATH`, `LD_PRELOAD`, `NODE_OPTIONS`, etc.\n- ✅ **Scrub de secretos en transcripts.** Tokens de Anthropic/OpenAI/Google/AWS/GitHub/Slack se redactan antes de escribirse a `.iagentek/.transcripts/`.\n- ✅ **Validación del `model` en `claude-cli`.** `provider.model` debe matchear `/^[A-Za-z0-9._:/-]+$/` para prevenir inyección de shell en Windows (`shell:true` necesario para `claude.cmd`).\n- ✅ **98/98 tests** (28 tests de regresión nuevos para los 6 hallazgos) — `npm audit` reporta 0 vulnerabilidades.\n\n**v0.4.3:**\n- ✅ READMEs del monorepo actualizados con la feature bilingüe y versión actual\n- ✅ 70 tests pasando\n\n**v0.4.2:**\n- ✅ Limpieza: strings residuales en español del core traducidos a inglés\n- ✅ `.claude-plugin/marketplace.json` añadido para que el plugin sea instalable vía Claude Code v2+\n- ✅ Los 4 flows validados end-to-end con LLM real (greenfield, brownfield, bugfix, refactor)\n\n**v0.4.0 / v0.4.1:**\n- ✅ **Output bilingüe: English / Español** — el usuario elige en `init` (`--lang en|es`), persiste en `config.yaml`, auto-detección del locale del SO (`LANG`, `LC_ALL`)\n- ✅ Assets reorganizados: `packages/method/assets/{en,es}/{agents,templates,flows}/`\n- ✅ Nombres de fases traducidos en `/es/flows/*.yaml`\n\n**v0.3.x:**\n- ✅ 4 ciclos completos (greenfield, brownfield, bugfix, refactor)\n- ✅ 9 agentes BMAD con prompts completos\n- ✅ 6 providers de IA con auto-detección\n- ✅ Plugin de Claude Code (5 slash commands + 9 agents)\n- ✅ Fix crítico: `ClaudeCliProvider` ya no trunca prompts en Windows\n- ✅ Fix crítico: orchestrator ya no sobreescribe código real con placeholders del Dev agent\n\n**Próximas mejoras (no comprometidas):**\n- Streaming de tokens en tiempo real\n- Web UI para visualizar el ciclo\n- Soporte para más providers (Mistral, Groq, Cohere, xAI, Bedrock)\n- Más idiomas (Portugués, Francés, Alemán)\n- Loop real por story en la fase de implementación\n- Cache de respuestas para reducir costos de IA\n\n---\n\n## Contribuir\nPull requests bienvenidos. Issues en [github.com/azulls1/iagentek-framework/issues](https://github.com/azulls1/iagentek-framework/issues).\n\n## Licencia\nMIT — ver [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazulls1%2Fiagentek-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazulls1%2Fiagentek-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazulls1%2Fiagentek-framework/lists"}