Ir al contenido

format

Ya escribiste algo: un volcado mental, notas en bruto, prosa a medio formar. format lo lleva a la forma sin añadirle nada.

Funciona sobre un Blueprint de colección, o sobre un documento de nivel superior libre que hayas añadido. Este último no tiene shape con el que casar, así que se organiza según el estilo de la casa en lugar de comprobarse contra uno.

Conserva tu redacción. Reubica frases en la sección a la que pertenecen y arregla la gramática y el markdown. No reescribe tu voz ni infla tres palabras hasta convertirlas en un párrafo.

No añade nada de sustancia. Ni comportamientos, ni intención, ni decisiones, ni alcance, ni criterios de aceptación inventados. Las decisiones de producto que no están en la página no le corresponden al agente.

Saca a la luz los huecos; no los rellena. Una sección sin nada debajo se omite: el shape es un andamio, no una lista de comprobación. Para una que claramente debería tener contenido, casi siempre la de no-objetivos, conserva el encabezado con un <!-- TODO: … --> corto y lo señala. Un agujero honesto es mejor que contenido inventado.

Marca cualquier cosa inferida. Si adivina un title, o archiva una frase suelta bajo un encabezado que eligió, lo señala para que puedas confirmarlo o corregirlo.

Más que mover párrafos. Dentro y debajo de las secciones del shape, hará:

  • Sacar contenido rico de una sola línea: un modelo de datos a una tabla, una secuencia a una lista numerada.
  • Añadir subencabezados #### dentro de una sección con estructura interna.
  • Mantener cortas las afirmaciones comprobables, apuntando a una tabla o subsección para el detalle en lugar de embutirlo en una línea.
  • Convertir referencias a otros Blueprints en enlaces markdown, según la convención de nombres del Framework. Convertir un nombre en un enlace es formato, no añadir contenido, así que está de lleno dentro del alcance.

Desarrollar contenido nuevo es eidos. Pensar una idea antes de escribir nada es iterate. format es una pasada de mover y dar forma dentro de un solo archivo.