{
  "markdown": "# Minimalist Agile Engineering\n\nPlugin instalable para Codex que combina ingeniería minimalista, historias de\nusuario y ciclos Scrum para entregar incrementos pequeños, verificables y\najustables.\n\n## Inicio rápido\n\n1. Instala el paquete en tu harness con la ruta de [Instalación](#instalación).\n2. Pide al harness que cargue `minimalist-router`.\n3. Indica el resultado, la restricción y el incremento demostrable más pequeño.\n\n```text\nCarga `minimalist-router`. Quiero que un usuario pueda exportar su historial\nde pedidos a CSV. Mantén el cambio dentro del servicio existente y demuestra\nun archivo CSV válido con una prueba automatizada.\n```\n\n`minimalist-router` es la entrada predeterminada cuando no sabes qué ruta\naplicar.\n\n## Elegir una ruta\n\n| Situación | Ruta | Primera skill de trabajo |\n| --- | --- | --- |\n| Cambio pequeño, local y de bajo riesgo | Rápida | `minimalist-fast-change` |\n| Nueva funcionalidad o prototipo | Feature | `minimalist-brainstorming` |\n| Contratos, límites, despliegue o varios subsistemas | Arquitectónica | `minimalist-architecture` |\n| Incremento terminado pendiente de aceptación | Review | `minimalist-sprint-review` |\n| Proceso manual estable y repetido | Evaluación de automatización | `minimalist-automation` |\n\nLa constitución gobierna todas las rutas. Usa `minimalist-router` cuando haya\nduda o se apliquen varias situaciones.\n\n## Catálogo de skills\n\nLas skills comparten los directorios canónicos de [skills](skills/),\n[referencias](references/) y [plantillas](templates/).\n\n### `minimalist-constitution`\n\n**Usa cuando:** inicia cualquier ruta o debes confirmar reglas de alcance y evidencia.\n\n**Hace:** establece los límites que gobiernan todo el ciclo.\n\n**Necesita:** intención del producto y restricciones conocidas.\n\n**Siguiente:** `minimalist-router` o la skill de entrada elegida.\n\n### `minimalist-router`\n\n**Usa cuando:** la solicitud es nueva, incierta o puede requerir más de una ruta.\n\n**Hace:** decide entre cambio rápido, feature, arquitectura, review, retrospectiva o automatización.\n\n**Necesita:** resultado esperado, riesgo, alcance y evidencia disponible.\n\n**Siguiente:** la skill correspondiente a la ruta elegida.\n\n### `minimalist-fast-change`\n\n**Usa cuando:** hay un cambio pequeño, local y de bajo riesgo.\n\n**Hace:** define el cambio mínimo, aceptación y evidencia.\n\n**Necesita:** intención, límite del cambio y forma de verificarlo.\n\n**Siguiente:** verificación y handoff documentado.\n\n### `minimalist-architecture`\n\n**Usa cuando:** el trabajo afecta contratos, límites, despliegue o varios subsistemas.\n\n**Hace:** compara alternativas y registra el diseño en [design.md](templates/design.md).\n\n**Necesita:** problema, restricciones, dependencias y riesgos.\n\n**Siguiente:** diseño aprobado, luego `minimalist-specification` o `minimalist-sprint-planning`.\n\n### `minimalist-brainstorming`\n\n**Usa cuando:** empiezas una feature o prototipo y aún debes acotar el valor.\n\n**Hace:** aclara problema, no objetivos y el smallest demonstrable increment.\n\n**Necesita:** necesidad de usuario, contexto y restricciones iniciales.\n\n**Siguiente:** `minimalist-specification`.\n\n### `minimalist-specification`\n\n**Usa cuando:** existe un incremento valioso por definir antes de historias.\n\n**Hace:** produce comportamiento, límites y criterios de aceptación.\n\n**Necesita:** resultado acotado, restricciones y decisión de producto.\n\n**Siguiente:** `minimalist-story-mapping`.\n\n### `minimalist-story-mapping`\n\n**Usa cuando:** la especificación debe convertirse en historias de usuario.\n\n**Hace:** organiza historias con identificadores estables y valor independiente.\n\n**Necesita:** especificación e incremento más pequeño acordado.\n\n**Siguiente:** `minimalist-backlog-refinement`.\n\n### `minimalist-backlog-refinement`\n\n**Usa cuando:** las historias necesitan orden, división, fusión o eliminación.\n\n**Hace:** mantiene un backlog priorizado y preparado para seleccionar.\n\n**Necesita:** historias, dependencias y señales de valor/riesgo.\n\n**Siguiente:** `minimalist-sprint-selection`.\n\n### `minimalist-sprint-selection`\n\n**Usa cuando:** hay que elegir trabajo para un sprint o prototipo.\n\n**Hace:** fija un Sprint Goal y el alcance seleccionado.\n\n**Necesita:** backlog refinado, capacidad y criterios de selección.\n\n**Siguiente:** `minimalist-sprint-planning`.\n\n### `minimalist-sprint-planning`\n\n**Usa cuando:** las historias seleccionadas deben convertirse en ejecución.\n\n**Hace:** crea tareas, pruebas y Definition of Done para el sprint.\n\n**Necesita:** Sprint Goal, historias seleccionadas y restricciones técnicas.\n\n**Siguiente:** `minimalist-sprint-execution`.\n\n### `minimalist-sprint-execution`\n\n**Usa cuando:** hay un plan de sprint y se implementa el incremento seleccionado.\n\n**Hace:** ejecuta solo las historias seleccionadas y conserva verificación.\n\n**Necesita:** plan de sprint, Definition of Done y evidencia de pruebas.\n\n**Siguiente:** `minimalist-sprint-review` o trabajo carried-over.\n\n### `minimalist-sprint-review`\n\n**Usa cuando:** un incremento requiere demostración, aceptación y feedback.\n\n**Hace:** registra decisión de review, demostración y clasificación de feedback.\n\n**Necesita:** incremento verificable, aceptación y evidencia.\n\n**Siguiente:** `minimalist-sprint-retrospective` y decisiones del próximo backlog.\n\n### `minimalist-sprint-retrospective`\n\n**Usa cuando:** concluye un sprint o iteración y el equipo debe ajustar su forma de trabajo.\n\n**Hace:** registra qué conservar, quitar, cambiar y probar después.\n\n**Necesita:** evidencia de ejecución, review y feedback.\n\n**Siguiente:** la siguiente decisión de `minimalist-router` o de selección.\n\n### `minimalist-automation`\n\n**Usa cuando:** un proceso manual muestra repetición y estabilidad suficientes.\n\n**Hace:** decide adoptar, diferir o rechazar según valor y costo de mantenimiento.\n\n**Necesita:** evidencia de repetición, estabilidad, costo y riesgo operativo.\n\n**Siguiente:** decisión adopt/defer/reject; no reemplaza la verificación.\n\n## Secuencias de trabajo\n\n```text\nminimalist-constitution -> minimalist-router -> minimalist-fast-change -> verification -> handoff\n```\n\n```text\nminimalist-constitution -> minimalist-router -> minimalist-brainstorming -> minimalist-specification -> minimalist-story-mapping -> minimalist-backlog-refinement -> minimalist-sprint-selection -> minimalist-sprint-planning -> minimalist-sprint-execution -> minimalist-sprint-review -> minimalist-sprint-retrospective -> siguiente ciclo\n```\n\n```text\nminimalist-constitution -> minimalist-router -> minimalist-architecture -> diseño aprobado -> minimalist-specification o minimalist-sprint-planning -> minimalist-sprint-execution -> minimalist-sprint-review -> minimalist-sprint-retrospective\n```\n\nLa automatización es condicional después de evidencia de repetición y estabilidad.\n\n## Artefactos y evidencia\n\nLa [iniciativa](templates/initiative.md) conserva problema, resultado y restricciones. La\n[especificación](templates/spec.md) define el incremento; la [historia](templates/user-story.md)\nexpresa valor; y el [backlog](templates/backlog.md) mantiene posibilidades priorizadas.\nEl [plan de sprint](templates/sprint-plan.md) registra el subconjunto elegido, tareas,\npruebas y Definition of Done. La [verificación](templates/verification.md) enlaza evidencia.\nEl [review](templates/review.md), la [retrospectiva](templates/retrospective.md) y el\nregistro de [automatización](templates/automation.md) conservan decisiones y ajustes.\n\nEl backlog no es alcance del sprint: el primero representa producto posible y el segundo\nsolo trabajo seleccionado. Código escrito, pruebas ejecutadas y aceptación son estados\ndistintos; pruebas exitosas no son aceptación. Una nueva solicitud durante un sprint se\nregistra como historia, defecto o sustitución de alcance aprobada, nunca se añade en silencio.\n\n## Ejemplos de uso\n\n**Trabajo incierto.** “Carga `minimalist-router`. Necesito reducir abandonos en el registro,\npero no sé si basta un cambio local o hace falta una feature.”\n\n**Arreglo rápido.** “Carga `minimalist-fast-change`. Corrige el cálculo de IVA, limita el\ncambio al módulo actual y muestra una prueba de regresión.”\n\n**Prototipo.** “Carga `minimalist-brainstorming`. Quiero validar una vista de historial de\npedidos y definir el incremento demostrable más pequeño.”\n\n**Review y feedback.** “Carga `minimalist-sprint-review`. Demuestra historias terminadas,\nclasifica el feedback y prepara la retrospectiva.”\n\n**Evaluar automatización.** “Carga `minimalist-automation`. Evalúa si el reporte semanal\nrepetido es estable y decide adoptar, diferir o rechazar.”\n\n## Regla de alcance\n\nEl backlog representa el producto posible. El sprint representa solo el\nproducto seleccionado. Una nueva solicitud durante un sprint se registra como\nnueva historia, defecto o sustitución de alcance aprobada; nunca se agrega en\nsilencio.\n\n## Regla de evidencia\n\nCódigo escrito, pruebas ejecutadas, pruebas exitosas y aceptación del usuario\nson estados diferentes. Una historia se completa únicamente cuando sus\ncriterios de aceptación y Definition of Done tienen evidencia.\n\n## Desarrollo del plugin\n\nEjecuta desde la raíz del repositorio:\n\n    python -m unittest discover -s tests -v\n    python scripts/validate_repo.py\n\nSi el validador local de plugins de Codex existe en tu entorno, ejecútalo\ntambién con `python <ruta-a-validate_plugin.py> .`; si no existe, registra el\nresultado como omitido, no como aprobado.\n\nLa especificación está en docs/superpowers/specs y el plan en\ndocs/superpowers/plans.\n\n## Instalación\n\nRepositorio público:\nhttps://github.com/Equinoxe-Grammer/minimalist-agile-engineering\n\nLa preparación del repositorio no equivale a una publicación oficial en los\nmarketplaces de Codex, Claude, Cursor, Copilot o Kimi. Cuando una lista oficial\nexista, usa la acción nativa del harness; mientras tanto usa la ruta indicada y\nconserva las etiquetas de evidencia.\n\n### Instalación rápida en GitHub Copilot CLI\n\nRequisitos: una versión actual de Copilot CLI con soporte de plugins y una\nsesión autenticada en GitHub. Ejecuta:\n\n```powershell\ncopilot plugin install Equinoxe-Grammer/minimalist-agile-engineering\ncopilot plugin list\n```\n\nPara usar el marketplace local del repositorio:\n\n```powershell\ncopilot plugin marketplace add Equinoxe-Grammer/minimalist-agile-engineering\ncopilot plugin install minimalist-agile-engineering@minimalist-agile-engineering\n```\n\nActualiza o elimina el plugin con:\n\n```powershell\ncopilot plugin update minimalist-agile-engineering\ncopilot plugin uninstall minimalist-agile-engineering\n```\n\nComprueba la carga usando `/minimalist-agile-engineering/minimalist-router` o\npide a Copilot que cargue `minimalist-router`. El paquete está validado\nestructuralmente; la instalación real sigue `Not locally exercised`.\n\n### Instalación rápida en GitHub Copilot para VS Code\n\n1. Abre la paleta de comandos (`Ctrl+Shift+P`).\n2. Ejecuta `Chat: Install Plugin From Source`.\n3. Pega `https://github.com/Equinoxe-Grammer/minimalist-agile-engineering`.\n4. Revisa y acepta el aviso de confianza del código fuente.\n5. Abre `Agent Plugins - Installed` y confirma `minimalist-agile-engineering`.\n6. Ejecuta `Chat: Configure Skills` (o escribe `/` en el chat) y selecciona\n   `minimalist-router`.\n\nPara actualizar usa `Extensions: Check for Extension Updates`. Para habilitar,\ndeshabilitar o desinstalar, usa el menú contextual del plugin en\n`Agent Plugins - Installed`. Si no aparece, revisa:\n\n```text\nchat.plugins.enabled = true\ngithub.copilot.chat.skillTool.enabled = true\n```\n\nLa disponibilidad en un marketplace oficial no está reclamada y estas rutas no\nhan sido ejercitadas end-to-end localmente.\n\n### Instalación rápida en los demás harnesses\n\n- **Claude Code:** `/plugin marketplace add Equinoxe-Grammer/minimalist-agile-engineering` y `/plugin install minimalist-agile-engineering@minimalist-agile-engineering`.\n- **Gemini CLI:** `gemini extensions install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering`.\n- **Kimi Code:** `/plugins install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering`.\n- **Pi:** `pi install git:github.com/Equinoxe-Grammer/minimalist-agile-engineering`.\n- **Devin:** `devin plugins install Equinoxe-Grammer/minimalist-agile-engineering` (closed beta).\n- **OpenCode:** sigue [`.opencode/INSTALL.md`](.opencode/INSTALL.md).\n- **Agent Skills genérico:** importa juntas `skills/`, `references/` y `templates/`.\n\nConsulta la [guía detallada por harness](docs/install/harnesses.md) para los\ncomandos de actualización, desinstalación y verificación de cada entorno.\n\nPara ejemplos completos de selección de skills —incluidos un proyecto de\ncuatro meses con 40 historias y correcciones mínimas— consulta la [guía práctica\nde escenarios](docs/install/usage-scenarios.md).\n\n| Harness | Estado | Instalación principal |\n| --- | --- | --- |\n| Codex | Native package; structurally validated; Not locally exercised | La preparación de `.codex-plugin/plugin.json` está validada; la instalación en UI oficial queda pendiente de smoke test. |\n| Claude Code | Compatible marketplace; structurally validated; Not locally exercised | `/plugin marketplace add Equinoxe-Grammer/minimalist-agile-engineering` y luego `/plugin install minimalist-agile-engineering@minimalist-agile-engineering`. |\n| Gemini CLI | Native package; structurally validated; Not locally exercised | `gemini extensions install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering` |\n| Devin | Native package; structurally validated; Not locally exercised | Requiere acceso a la closed-beta de Devin; `devin plugins install Equinoxe-Grammer/minimalist-agile-engineering`. |\n| Kimi Code | Native package; structurally validated; Not locally exercised | `/plugins install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering` |\n| OpenCode | Native package; structurally validated; Not locally exercised | Ver [`.opencode/INSTALL.md`](.opencode/INSTALL.md); la configuración de OpenCode no se duplica aquí. |\n| Pi | Native package; structurally validated; Not locally exercised | `pi install git:github.com/Equinoxe-Grammer/minimalist-agile-engineering` |\n| Cursor | Native package; structurally validated; Not locally exercised | `.cursor-plugin/plugin.json` está validado; no hay operación exacta de instalación local verificada. |\n| GitHub Copilot CLI | Native package; structurally validated; Not locally exercised | Consulta la sección [GitHub Copilot CLI](docs/install/harnesses.md#github-copilot-cli); disponibilidad en marketplace no está reclamada. |\n| GitHub Copilot en VS Code | Native package; structurally validated; Not locally exercised | Consulta la sección [GitHub Copilot en VS Code](docs/install/harnesses.md#github-copilot-en-vs-code); disponibilidad en marketplace no está reclamada. |\n| Antigravity | Experimental compatibility; Not locally exercised | No hay prueba target-specific de aceptación nativa; usa solo importación compatible si tu harness la documenta. |\n| Factory Droid | Experimental compatibility; Not locally exercised | No hay prueba target-specific de aceptación nativa; usa solo importación compatible si tu harness la documenta. |\n| Agent Skills | Agent Skills compatible; Not locally exercised | Importa `skills/` junto con `references/` y `templates/` desde el repositorio completo. |\n\nComandos Claude-compatible locales:\n\n```text\n/plugin marketplace add Equinoxe-Grammer/minimalist-agile-engineering\n/plugin install minimalist-agile-engineering@minimalist-agile-engineering\n```\n\nEn Claude Code, verifica la instalación cargando la skill con el nombre\nnamespaced `/minimalist-agile-engineering:minimalist-router`.\n\nComandos de instalación con URL Git:\n\n```text\ngemini extensions install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering\n/plugins install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering\npi install git:github.com/Equinoxe-Grammer/minimalist-agile-engineering\n```\n\nDespués de instalar, pide al harness: \"Carga `minimalist-router` e inicia un\nciclo mínimo para una funcionalidad pequeña\". Debe seleccionar una ruta,\nmantener el alcance acotado y pedir evidencia antes de cerrar la historia.\n\nPara instrucciones completas de instalación, actualización, desinstalación y\nverificación por harness, consulta\n[docs/install/harnesses.md](docs/install/harnesses.md). Para preparar una\npublicación sin mezclar commit, push, tag, release ni marketplace, consulta\n[docs/install/releasing.md](docs/install/releasing.md).\n",
  "bytes": 16466,
  "sha": "3f402054f403907f36561987ad0bbfdadc5d8a9617ae3d9e2f5894d5481da5db",
  "repo_slug": "equinoxe-grammer/minimalist-agile-engineering",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_equinoxe_grammer_minimalist_agile_engine_a085754f/readme"
}