# 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

1. Instala el paquete en tu harness con la ruta de [Instalación](#instalación).
2. Pide al harness que cargue `minimalist-router`.
3. Indica el resultado, la restricción y el incremento demostrable más pequeño.

```text
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](skills/),
[referencias](references/) y [plantillas](templates/).

### `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](templates/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

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

```text
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
```

```text
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](templates/initiative.md) conserva problema, resultado y restricciones. La
[especificación](templates/spec.md) define el incremento; la [historia](templates/user-story.md)
expresa valor; y el [backlog](templates/backlog.md) mantiene posibilidades priorizadas.
El [plan de sprint](templates/sprint-plan.md) registra el subconjunto elegido, tareas,
pruebas y Definition of Done. La [verificación](templates/verification.md) enlaza evidencia.
El [review](templates/review.md), la [retrospectiva](templates/retrospective.md) y el
registro de [automatización](templates/automation.md) 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:

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

Para usar el marketplace local del repositorio:

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

Actualiza o elimina el plugin con:

```powershell
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

1. Abre la paleta de comandos (`Ctrl+Shift+P`).
2. Ejecuta `Chat: Install Plugin From Source`.
3. Pega `https://github.com/Equinoxe-Grammer/minimalist-agile-engineering`.
4. Revisa y acepta el aviso de confianza del código fuente.
5. Abre `Agent Plugins - Installed` y confirma `minimalist-agile-engineering`.
6. 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:

```text
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`](.opencode/INSTALL.md).
- **Agent Skills genérico:** importa juntas `skills/`, `references/` y `templates/`.

Consulta la [guía detallada por harness](docs/install/harnesses.md) 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](docs/install/usage-scenarios.md).

| 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`](.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](docs/install/harnesses.md#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](docs/install/harnesses.md#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:

```text
/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:

```text
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](docs/install/harnesses.md). Para preparar una
publicación sin mezclar commit, push, tag, release ni marketplace, consulta
[docs/install/releasing.md](docs/install/releasing.md).