minimalist-agile-engineering
Minimalist agile engineering workflows for small, verifiable software increments.
Open source Open in the app JSON README (API)
About
Minimalist agile engineering workflows for small, verifiable software increments.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- equinoxe-grammer
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.3.0
- Last push
- 2026-08-27T18:30:52Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
equinoxe-grammer/minimalist-agile-engineering
README
# 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).