Minimalist Agile Engineering

Plugin instalable para Codex que combina ingeniería minimalista, historias de usuario y ciclos Scrum para entregar incrementos pequeños, verificables y ajustables.

Inicio rápido

Instala el paquete en tu harness con la ruta de Instalación.
Pide al harness que cargue minimalist-router.
Indica el resultado, la restricción y el incremento demostrable más pequeño.

Carga `minimalist-router`. Quiero que un usuario pueda exportar su historial
de pedidos a CSV. Mantén el cambio dentro del servicio existente y demuestra
un archivo CSV válido con una prueba automatizada.

minimalist-router es la entrada predeterminada cuando no sabes qué ruta aplicar.

Elegir una ruta

Situación	Ruta	Primera skill de trabajo
Cambio pequeño, local y de bajo riesgo	Rápida	`minimalist-fast-change`
Nueva funcionalidad o prototipo	Feature	`minimalist-brainstorming`
Contratos, límites, despliegue o varios subsistemas	Arquitectónica	`minimalist-architecture`
Incremento terminado pendiente de aceptación	Review	`minimalist-sprint-review`
Proceso manual estable y repetido	Evaluación de automatización	`minimalist-automation`

La constitución gobierna todas las rutas. Usa minimalist-router cuando haya duda o se apliquen varias situaciones.

Catálogo de skills

Las skills comparten los directorios canónicos de skills, referencias y plantillas.

`minimalist-constitution`

Usa cuando: inicia cualquier ruta o debes confirmar reglas de alcance y evidencia.

Hace: establece los límites que gobiernan todo el ciclo.

Necesita: intención del producto y restricciones conocidas.

Siguiente: minimalist-router o la skill de entrada elegida.

`minimalist-router`

Usa cuando: la solicitud es nueva, incierta o puede requerir más de una ruta.

Hace: decide entre cambio rápido, feature, arquitectura, review, retrospectiva o automatización.

Necesita: resultado esperado, riesgo, alcance y evidencia disponible.

Siguiente: la skill correspondiente a la ruta elegida.

`minimalist-fast-change`

Usa cuando: hay un cambio pequeño, local y de bajo riesgo.

Hace: define el cambio mínimo, aceptación y evidencia.

Necesita: intención, límite del cambio y forma de verificarlo.

Siguiente: verificación y handoff documentado.

`minimalist-architecture`

Usa cuando: el trabajo afecta contratos, límites, despliegue o varios subsistemas.

Hace: compara alternativas y registra el diseño en design.md.

Necesita: problema, restricciones, dependencias y riesgos.

Siguiente: diseño aprobado, luego minimalist-specification o minimalist-sprint-planning.

`minimalist-brainstorming`

Usa cuando: empiezas una feature o prototipo y aún debes acotar el valor.

Hace: aclara problema, no objetivos y el smallest demonstrable increment.

Necesita: necesidad de usuario, contexto y restricciones iniciales.

Siguiente: minimalist-specification.

`minimalist-specification`

Usa cuando: existe un incremento valioso por definir antes de historias.

Hace: produce comportamiento, límites y criterios de aceptación.

Necesita: resultado acotado, restricciones y decisión de producto.

Siguiente: minimalist-story-mapping.

`minimalist-story-mapping`

Usa cuando: la especificación debe convertirse en historias de usuario.

Hace: organiza historias con identificadores estables y valor independiente.

Necesita: especificación e incremento más pequeño acordado.

Siguiente: minimalist-backlog-refinement.

`minimalist-backlog-refinement`

Usa cuando: las historias necesitan orden, división, fusión o eliminación.

Hace: mantiene un backlog priorizado y preparado para seleccionar.

Necesita: historias, dependencias y señales de valor/riesgo.

Siguiente: minimalist-sprint-selection.

`minimalist-sprint-selection`

Usa cuando: hay que elegir trabajo para un sprint o prototipo.

Hace: fija un Sprint Goal y el alcance seleccionado.

Necesita: backlog refinado, capacidad y criterios de selección.

Siguiente: minimalist-sprint-planning.

`minimalist-sprint-planning`

Usa cuando: las historias seleccionadas deben convertirse en ejecución.

Hace: crea tareas, pruebas y Definition of Done para el sprint.

Necesita: Sprint Goal, historias seleccionadas y restricciones técnicas.

Siguiente: minimalist-sprint-execution.

`minimalist-sprint-execution`

Usa cuando: hay un plan de sprint y se implementa el incremento seleccionado.

Hace: ejecuta solo las historias seleccionadas y conserva verificación.

Necesita: plan de sprint, Definition of Done y evidencia de pruebas.

Siguiente: minimalist-sprint-review o trabajo carried-over.

`minimalist-sprint-review`

Usa cuando: un incremento requiere demostración, aceptación y feedback.

Hace: registra decisión de review, demostración y clasificación de feedback.

Necesita: incremento verificable, aceptación y evidencia.

Siguiente: minimalist-sprint-retrospective y decisiones del próximo backlog.

`minimalist-sprint-retrospective`

Usa cuando: concluye un sprint o iteración y el equipo debe ajustar su forma de trabajo.

Hace: registra qué conservar, quitar, cambiar y probar después.

Necesita: evidencia de ejecución, review y feedback.

Siguiente: la siguiente decisión de minimalist-router o de selección.

`minimalist-automation`

Usa cuando: un proceso manual muestra repetición y estabilidad suficientes.

Hace: decide adoptar, diferir o rechazar según valor y costo de mantenimiento.

Necesita: evidencia de repetición, estabilidad, costo y riesgo operativo.

Siguiente: decisión adopt/defer/reject; no reemplaza la verificación.

Secuencias de trabajo

minimalist-constitution -> minimalist-router -> minimalist-fast-change -> verification -> handoff

minimalist-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

minimalist-constitution -> minimalist-router -> minimalist-architecture -> diseño aprobado -> minimalist-specification o minimalist-sprint-planning -> minimalist-sprint-execution -> minimalist-sprint-review -> minimalist-sprint-retrospective

La automatización es condicional después de evidencia de repetición y estabilidad.

Artefactos y evidencia

La iniciativa conserva problema, resultado y restricciones. La especificación define el incremento; la historia expresa valor; y el backlog mantiene posibilidades priorizadas. El plan de sprint registra el subconjunto elegido, tareas, pruebas y Definition of Done. La verificación enlaza evidencia. El review, la retrospectiva y el registro de automatización conservan decisiones y ajustes.

El backlog no es alcance del sprint: el primero representa producto posible y el segundo solo trabajo seleccionado. Código escrito, pruebas ejecutadas y aceptación son estados distintos; pruebas exitosas no son aceptación. Una nueva solicitud durante un sprint se registra como historia, defecto o sustitución de alcance aprobada, nunca se añade en silencio.

Ejemplos de uso

Trabajo incierto. “Carga minimalist-router. Necesito reducir abandonos en el registro, pero no sé si basta un cambio local o hace falta una feature.”

Arreglo rápido. “Carga minimalist-fast-change. Corrige el cálculo de IVA, limita el cambio al módulo actual y muestra una prueba de regresión.”

Prototipo. “Carga minimalist-brainstorming. Quiero validar una vista de historial de pedidos y definir el incremento demostrable más pequeño.”

Review y feedback. “Carga minimalist-sprint-review. Demuestra historias terminadas, clasifica el feedback y prepara la retrospectiva.”

Evaluar automatización. “Carga minimalist-automation. Evalúa si el reporte semanal repetido es estable y decide adoptar, diferir o rechazar.”

Regla de alcance

El backlog representa el producto posible. El sprint representa solo el producto seleccionado. Una nueva solicitud durante un sprint se registra como nueva historia, defecto o sustitución de alcance aprobada; nunca se agrega en silencio.

Regla de evidencia

Código escrito, pruebas ejecutadas, pruebas exitosas y aceptación del usuario son estados diferentes. Una historia se completa únicamente cuando sus criterios de aceptación y Definition of Done tienen evidencia.

Desarrollo del plugin

Ejecuta desde la raíz del repositorio:

python -m unittest discover -s tests -v
python scripts/validate_repo.py

Si el validador local de plugins de Codex existe en tu entorno, ejecútalo también con python <ruta-a-validate_plugin.py> .; si no existe, registra el resultado como omitido, no como aprobado.

La especificación está en docs/superpowers/specs y el plan en docs/superpowers/plans.

Instalación

Repositorio público: https://github.com/Equinoxe-Grammer/minimalist-agile-engineering

La preparación del repositorio no equivale a una publicación oficial en los marketplaces de Codex, Claude, Cursor, Copilot o Kimi. Cuando una lista oficial exista, usa la acción nativa del harness; mientras tanto usa la ruta indicada y conserva las etiquetas de evidencia.

Instalación rápida en GitHub Copilot CLI

Requisitos: una versión actual de Copilot CLI con soporte de plugins y una sesión autenticada en GitHub. Ejecuta:

copilot plugin install Equinoxe-Grammer/minimalist-agile-engineering
copilot plugin list

Para usar el marketplace local del repositorio:

copilot plugin marketplace add Equinoxe-Grammer/minimalist-agile-engineering
copilot plugin install minimalist-agile-engineering@minimalist-agile-engineering

Actualiza o elimina el plugin con:

copilot plugin update minimalist-agile-engineering
copilot plugin uninstall minimalist-agile-engineering

Comprueba la carga usando /minimalist-agile-engineering/minimalist-router o pide a Copilot que cargue minimalist-router. El paquete está validado estructuralmente; la instalación real sigue Not locally exercised.

Instalación rápida en GitHub Copilot para VS Code

Abre la paleta de comandos (Ctrl+Shift+P).
Ejecuta Chat: Install Plugin From Source.
Pega https://github.com/Equinoxe-Grammer/minimalist-agile-engineering.
Revisa y acepta el aviso de confianza del código fuente.
Abre Agent Plugins - Installed y confirma minimalist-agile-engineering.
Ejecuta Chat: Configure Skills (o escribe / en el chat) y selecciona minimalist-router.

Para actualizar usa Extensions: Check for Extension Updates. Para habilitar, deshabilitar o desinstalar, usa el menú contextual del plugin en Agent Plugins - Installed. Si no aparece, revisa:

chat.plugins.enabled = true
github.copilot.chat.skillTool.enabled = true

La disponibilidad en un marketplace oficial no está reclamada y estas rutas no han sido ejercitadas end-to-end localmente.

Instalación rápida en los demás harnesses

Claude Code: /plugin marketplace add Equinoxe-Grammer/minimalist-agile-engineering y /plugin install minimalist-agile-engineering@minimalist-agile-engineering.
Gemini CLI: gemini extensions install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering.
Kimi Code: /plugins install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering.
Pi: pi install git:github.com/Equinoxe-Grammer/minimalist-agile-engineering.
Devin: devin plugins install Equinoxe-Grammer/minimalist-agile-engineering (closed beta).
OpenCode: sigue .opencode/INSTALL.md.
Agent Skills genérico: importa juntas skills/, references/ y templates/.

Consulta la guía detallada por harness para los comandos de actualización, desinstalación y verificación de cada entorno.

Para ejemplos completos de selección de skills —incluidos un proyecto de cuatro meses con 40 historias y correcciones mínimas— consulta la guía práctica de escenarios.

Harness	Estado	Instalación principal
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.
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`.
Gemini CLI	Native package; structurally validated; Not locally exercised	`gemini extensions install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering`
Devin	Native package; structurally validated; Not locally exercised	Requiere acceso a la closed-beta de Devin; `devin plugins install Equinoxe-Grammer/minimalist-agile-engineering`.
Kimi Code	Native package; structurally validated; Not locally exercised	`/plugins install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering`
OpenCode	Native package; structurally validated; Not locally exercised	Ver `.opencode/INSTALL.md`; la configuración de OpenCode no se duplica aquí.
Pi	Native package; structurally validated; Not locally exercised	`pi install git:github.com/Equinoxe-Grammer/minimalist-agile-engineering`
Cursor	Native package; structurally validated; Not locally exercised	`.cursor-plugin/plugin.json` está validado; no hay operación exacta de instalación local verificada.
GitHub Copilot CLI	Native package; structurally validated; Not locally exercised	Consulta la sección GitHub Copilot CLI; disponibilidad en marketplace no está reclamada.
GitHub Copilot en VS Code	Native package; structurally validated; Not locally exercised	Consulta la sección GitHub Copilot en VS Code; disponibilidad en marketplace no está reclamada.
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.
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.
Agent Skills	Agent Skills compatible; Not locally exercised	Importa `skills/` junto con `references/` y `templates/` desde el repositorio completo.

Comandos Claude-compatible locales:

/plugin marketplace add Equinoxe-Grammer/minimalist-agile-engineering
/plugin install minimalist-agile-engineering@minimalist-agile-engineering

En Claude Code, verifica la instalación cargando la skill con el nombre namespaced /minimalist-agile-engineering:minimalist-router.

Comandos de instalación con URL Git:

gemini extensions install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering
/plugins install https://github.com/Equinoxe-Grammer/minimalist-agile-engineering
pi install git:github.com/Equinoxe-Grammer/minimalist-agile-engineering

Después de instalar, pide al harness: "Carga minimalist-router e inicia un ciclo mínimo para una funcionalidad pequeña". Debe seleccionar una ruta, mantener el alcance acotado y pedir evidencia antes de cerrar la historia.

Para instrucciones completas de instalación, actualización, desinstalación y verificación por harness, consulta docs/install/harnesses.md. Para preparar una publicación sin mezclar commit, push, tag, release ni marketplace, consulta docs/install/releasing.md.