¿Qué hace Informe de progreso?
El informe es una proyección determinista. Nunca crees, retengas, envíes mensajes o consultes un agente únicamente para mantenerlo. Registra únicamente los hechos que falten: asignaciones, decisiones o bloqueadores.
Ejecuta la CLI desde la raíz del repositorio: progress representa a python <directorio_del_skill>/scripts/progress.py
(.claude/skills/progress-report, .agents/skills/progress-report, o $CLAUDE_PLUGIN_ROOT/skills/progress-report).
Escribe el comando completo cada vez. Los verbos imprimen una línea (refresh no imprime nada); transmítelo.
Cuándo usarlo
- Un archivo de plan (Markdown con elementos
- [ ]/- [x]) dirige el trabajo: modo plan, no se necesita Spec Kit. - Una funcionalidad de Spec Kit tiene
specs/<funcionalidad>/tasks.md: modo feature; los archivos de Workflow se recopilan cuando están presentes.
Inicio rápido en modo plan
progress hooks install --host claude(ocodex; añade--scope userpara una instalación como plugin) una vez, para modelo, esfuerzo, contexto y agentes hijos. Si lo omites, las tareas aún se rastrean.progress init --plan docs/plan.mdcrea.progress/plan/(ver--name,--dir) e imprimebind=<nonce>; el siguiente hook se vincula (hooks installimprime uno si existe un informe).- Marca elementos como completados en el archivo de plan; el informe sigue el cambio. Progress nunca escribe en el plan.
progress statusmuestra el estado en una línea; la vista está en.progress/plan/.view/index.html.
Los elementos mantienen un id escrito (T001); otros obtienen IDs estables P001... Con un solo plan o funcionalidad activa no se necesita indicar objetivo; de lo contrario, pasa --plan NOMBRE o --feature DIR.
Verbos
| Necesidad | Comando |
|---|---|
| Crear un informe | progress init --plan RUTA [--name N] [--dir D] o progress init (Spec Kit) |
| Estado en una línea | progress status |
| Asignar un carril | progress lane L1 --tasks P001-P004 --owner ID --harness H --model M --effort E |
| Cerrar un carril | progress lane L1 --close |
| Bloqueador | progress block P007 --by L2 (o P003, ext:"texto"); progress unblock B4 |
| Decisión | progress decide ask "pregunta" --options a,b; progress decide made D2 b --by user |
| Nota | progress note "texto" --target P005 |
| Exportar | progress export --format md |
| Hooks | `progress hooks install |
Reglas
- Registra un carril cuando asignes trabajo (
L#; los hijos del hostC#aparecen solos). Los inicios, finalizaciones y reintentos no necesitan comando. - Nunca pongas secretos, rutas absolutas ni texto de transcripción en una nota (200 caracteres como máximo).
- Los valores desconocidos se quedan como desconocidos. No estimes modelo, esfuerzo, contexto ni tiempo.
- Los errores leen
progress: error CÓDIGO; corrige la causa, no reintentes en un bucle.
Detalles: references/verbs.md; contrato docs/contracts.md; banderas docs/commands.md.