Estándares y mantenimiento de la documentación

Documente comportamiento verificable

La jerarquía PLAT → SYS → MOD → FEAT organiza el producto. Cada página identifica finalidad, estado, fuentes y relaciones. Una feature describe precondiciones, flujo, alternativas, postcondiciones, reglas y criterios de aceptación. Los datos, APIs y operaciones necesitan límites explícitos. En Orkastery, el número de una FEAT nueva sale de ork roadmap feat, reservado entre máquinas; nunca del mayor número de su branch.

ork roadmap feat --thread <thread>
ork docs verificar
ork docs sincronizar

Separe los planes de la disponibilidad

El roadmap registra problema, objetivo, alcance, dependencias, decisiones y criterios de validación. Código fusionado, pruebas aprobadas, despliegue y exposición al usuario son hechos distintos. En estos sitios, el roadmap aparece solo como resumen mensual con enlace a su fuente.

En Orkastery, ork docs sincronizar actualiza el estado del código desde el ledger y git, y la sección sdlc desde la thread; nunca modifica ciclo, documentación, despliegue, exposición o habilitación. En la worktree de una thread solo toca su elemento; --so elige los elementos y --todos vuelve a cubrirlos todos. Cerrar la thread libera la reserva del elemento o la pasa a otra thread abierta del mismo elemento.

Revisión editorial y visual

Use mayúscula inicial en títulos y etiquetas; conserve siglas, comandos y nombres propios. Los diagramas tienen título, descripción y una secuencia legible sin depender del color. Los índices y modelos orientan la edición; los recursos de marca permanecen en la fuente y no representan funcionalidades adicionales.

La instantánea pública registra rutas relativas y hashes. Sincronizar una fuente modificada invalida las revisiones afectadas. Los tres idiomas requieren revisión explícita y el build usa la instantánea versionada sin obtener contenido remoto.

Un contrato no es un resultado medido

KG1 define contratos separados de grafo y benchmark. El grafo conserva procedencia y restricciones de acceso y recalcula las identidades por contenido. El benchmark fija pares A/B, tareas, controles, intentos y fuentes de medida. El corpus sintético valida el contrato; no demuestra ahorro de tokens, latencia ni significancia. Una medida ausente queda null con motivo. La extracción de KG2 y el índice con consulta de KG3 llegaron sin cambiar el contrato. La primera medida del coste de consulta de KG3 registra bytes y latencia de ambos brazos, sin tokens medidos; no es la línea de base del benchmark ni permite concluir ahorro. El consumo por las fases sigue fuera.