Especificaciones y tablero
Especificaciones escritas por personas y agentes, seguidas de la revisión a la construcción
Una persona redacta una especificación en el editor. Un agente archiva lo que produjo como artifact. Cuando cualquiera de los dos está listo, pasa al tablero, donde la revisión y la implementación son dos preguntas distintas.
Dos autores
Un solo lugar para lo que escriben personas y agentes
Los documentos sincronizados vienen de tu repository y siguen siendo de solo lectura. Lo que está a su lado se escribe aquí, y el registro siempre dice quién lo escribió.
Borradores, escritos por una persona
Una especificación que alguien del equipo está escribiendo en el editor. Hasta que se exporta, los agentes no pueden verla ni ver sus notas: una especificación a medio escribir que un agente puede leer es una que empezará a construir.
Artifacts, escritos por un agente
Un agente archiva una especificación, un plan de migración o una revisión con write_artifact. Cada escritura es una nueva versión junto a tu documentación, con un enlace que una persona puede abrir. Ninguna herramienta elimina un artifact.
Exportar al tablero
El eje de implementación llega con la promoción
Exportar al tablero es la única puerta, y va en un solo sentido. El elemento conserva su id, sus versiones, sus notas y su estado, y sigue en su propia pantalla marcado como en el tablero.
Antes de exportarse, un borrador o un artifact solo tiene revisión. Nadie puede marcar una idea como construida, y un agente no puede reclamar trabajo sobre su propia producción.
Después de exportarse sigue siendo editable. Una nueva versión marca su estado como desviado hasta que alguien lo revise de nuevo, y el editor lo avisa antes de guardar.
docs/runbooks/01-payouts.md
Ciclo de vida de los pagos
En revisiónEn curso
Validado contra9f1c04e
Contenido actual9f1c04e
Alguien lo está leyendo. La construcción está en marcha.
El tablero
Dos ejes, uno cada vez
Validado y todavía en curso es el estado más común de una especificación real. El tablero muestra un eje como columnas y el otro como una etiqueta en cada tarjeta.
Revisión
- Sin clasificar
- Borrador
- En revisión
- Validado
- Rechazado
Implementación
- Por hacer
- En curso
- Implementado
- En pruebas
- Hecho
- Cancelado
- Sin clasificar significa que nadie ha fijado un estado todavía, así que la tarjeta no lleva etiqueta.
- Implementado significa que un agente dice que lo construyó y nadie lo ha confirmado. Una persona responde sacando la tarjeta de esa columna.
- Rechazado exige un motivo, escrito como nota en el documento en el mismo paso.
- La desviación compara el contenido, nunca una fecha. Una especificación editada después de validarse aparece como desviada hasta que alguien la revise de nuevo.
Mostrando
Sin clasificar1
Borrador1
en curso1
En revisión1
en curso2
Validado1
hecho · desfasado
Rechazado
Cuatro documentos, un eje. El otro va en la tarjeta.
Los agentes reclaman, las personas cierran
Un agente puede decir que el trabajo está hecho. Una persona decide.
Son reglas del producto, aplicadas en el servidor, no una política en un documento.
- Agente
search_docs«idempotency» en 6 repositories · 3 resultados
- 01AgenteUn agente reclama la construcciónreport_implementation lleva una especificación a Implementado, nunca a Hecho, y deja una nota que espera a una persona.
- 02AgenteUn agente responde a los comentariosPuede estar de acuerdo, discrepar, pedir una aclaración o decir que la nota está atendida. Atendida lleva la nota a pendiente de confirmación y no más allá.
- 03PersonaUna persona la cierraCerrar una nota, confirmar una reclamación y rechazar una especificación son actos humanos. La credencial de un agente no alcanza ninguno de ellos.
Planes
Starter y superiores
El estado de revisión e implementación, el tablero, las notas y el acceso de escritura de un agente forman parte de Starter, Team, Business y Enterprise. La lectura, la búsqueda y las herramientas de lectura para agentes están en todos los planes, Free incluido.
- Estado, desviación y el tablero
- Notas y respuestas de agentes
- Artifacts escritos por agentes
Lleva tu próxima especificación al tablero
Conecta un repository, exporta un borrador y mira cómo se mueven los dos ejes.
Empieza gratis