OpenSpec: convertir una petición de código en documentos revisables
Medir el coste de OpenSpec: planificación y trabajo repetido
Diseña una evaluación sin confundir documentos o casillas marcadas con productividad.
Qué aprenderás
- Definir cambios comparables
- Contabilizar el asistente aparte
- Incluir fallos e incertidumbre
Antes de empezar
- Conocimientos básicos de Git y Node
- Repositorio de ejemplo desechable
Explica dependencias y evidencia pendiente sin ejecutar automáticamente el comando recomendado.
Conclusiones clave
- Mide cambios aceptados.
- El asistente tiene costes separados.
- Ordenar bien no demuestra productividad.
Definir cambios comparables
Escoge cambios pequeños con pruebas de aceptación conocidas. Registra aclaración, planificación, revisión y correcciones por separado. La unidad útil es un cambio aceptado, no el número de documentos generados.
No compares una tarea trivial preparada con una función desconocida entre servicios y atribuyas la diferencia a OpenSpec. Registra familiaridad con el repositorio, versión del asistente y ambigüedad del requisito.
Contabilizar el asistente aparte
La licencia MIT de OpenSpec no paga el asistente externo ni el uso del modelo. Registra llamadas y revisión si el entorno lo permite. No introduzcas precios actuales en una publicación estática sin una fuente fechada.
Una especificación puede reducir contexto repetido, mientras un plan duplicado puede aumentarlo. Mide consumo real y propuestas rechazadas en vez de suponer que cada documento adicional ahorra tokens.
Incluir fallos e incertidumbre
Conserva escenarios omitidos, correcciones y planes abandonados antes de programar. Un flujo puede tardar más en planificar y evitar trabajo posterior; ambos resultados deben aparecer en el informe.
Aquí no se ejecutaron benchmarks de latencia, coste o productividad. La tabla es un diseño experimental. Las seis comprobaciones del grafo solo respaldan su comportamiento de ordenación, no porcentajes de mejora.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Selecciona cambios y pruebas comparables.
- 2
Separa planificación, revisión y correcciones.
- 3
Publica fallos y límites de medición.
Ejemplo para copiar
change,scope,planning_minutes,review_minutes,rework_minutes,accepted,assistant_usage
trial-export,small,,,,,Preguntas frecuentes
¿Sirve contar tareas completadas?
No: su alcance varía y pueden marcarse sin evidencia suficiente.
¿Se demostraron ahorros aquí?
No se realizó un benchmark comparativo del flujo.
Fuentes
- OpenSpec / README.mdFuente verificada 2026-09-23
- OpenSpec / src/core/artifact-graph/graph.tsFuente verificada 2026-09-23