| name | project-evolution-triage |
| description | Analiza el estado reciente de un proyecto y decide de forma estructurada si conviene crear una skill permanente, una herramienta interna determinística o no crear nada todavía. Úsala cuando se pidan acciones de revisión, auditoría, validación arquitectónica, generación de estándares, preparación de automatizaciones o definición de memoria técnica reusable por meses, con soporte de perfiles de entorno generic, coolify, k8s y production. |
| version | 1.0.0 |
project-evolution-triage
Sigue este flujo de forma estricta:
- Ejecuta el análisis determinístico:
python .agents/skills/project-evolution-triage/scripts/main.py --root . --source inst.md --mode generic
- Usa
--mode para aplicar perfil de entorno sin hardcodear infraestructura:
python .agents/skills/project-evolution-triage/scripts/main.py --root . --source inst.md --mode coolify
python .agents/skills/project-evolution-triage/scripts/main.py --root . --source inst.md --mode k8s
python .agents/skills/project-evolution-triage/scripts/main.py --root . --source inst.md --mode production
- Interpreta la salida JSON para construir la respuesta final:
phase0: resumen reciente y extracción de patrones.decision: opción única A, B o C con justificación.scope: alcance y perfiles aplicables.warnings: advertencias críticas.next_actions: pasos ejecutables.
- Si
decision es A, crea la skill en .agents/skills/<skill_name>/ usando este estándar:
SKILL.md con frontmatter YAML y comandos relativos.scripts/main.py con argparse, validación de entradas, --mode, sys.exit(0|1).- Ejecuta prueba real y reporta evidencia.
- Si
decision es B, define herramienta interna como núcleo determinístico:
- tipo, entradas, salidas, lógica, prioridad, necesidad de LLM.
- implementa CLI mínimo funcional si el contexto lo permite.
- ejecuta ejemplo real y reporta evidencia.
- Si
decision es C, explica por qué no estandarizar todavía y qué evidencia falta.
Formato de salida esperado
En éxito:
- JSON válido en stdout con llaves
phase0, decision, scope, warnings, next_actions, evidence.
- Código de salida
0.
En error:
- Mensaje claro en stderr indicando el problema exacto (ruta inválida, fuente faltante, modo inválido).
- Código de salida
1.
