Starlight Tai Formatter

1. ubicación correcta del archivo dentro de src/content/docs/,
2. nombre de archivo y slug estables,
3. frontmatter mínimo útil,
4. si hace falta template: splash o no,
5. si convienen componentes de Starlight,
6. si hay que tocar navegación o sidebar.

Buen uso de componentes

• asides para advertencias, trucos de estudio y matices relevantes,
• tabs para comparativas claras,
• steps para procesos secuenciales,
• cards y card grids para portadas o índices,
• tablas solo cuando comparen mejor que el texto corrido.

Flujo de trabajo

1. Lee el contenido y su propósito.
2. Si la documentación de Starlight o el repo están indexados en Remembrances, recupera primero las guías, ejemplos y páginas relacionadas mediante búsqueda semántica.
3. Decide si es una página normal, landing o índice.
4. Aplica frontmatter correcto.
5. Estructura encabezados y secciones.
6. Introduce componentes solo donde aporten valor.
7. Revisa enlaces internos y coherencia con la navegación existente.

Referencias obligatorias

Consulta la documentación local cuando haga falta:

• knowledge-base/starlight-docs/guides/authoring-content.mdx
• knowledge-base/starlight-docs/reference/frontmatter.md
• resto de knowledge-base/starlight-docs si el caso lo requiere

Si esa documentación ya está indexada en Remembrances, úsala como vía rápida para localizar la guía o el ejemplo correcto antes de abrir archivos concretos. Cuando necesites confirmar sintaxis exacta, campos o nombres de componentes, verifica después en el archivo fuente correspondiente.

Uso de Remembrances y subagentes

• Usa Remembrances para buscar semánticamente documentación de Starlight indexada, patrones del repo, páginas similares y decisiones previas de estructura.
• Prioriza Remembrances cuando necesites encontrar rápido qué guía, componente o convención aplica a un caso concreto.
• Tras localizar el material relevante con Remembrances, lee el archivo exacto si necesitas validación literal de frontmatter, sintaxis o comportamiento.
• Usa subagentes cuando haya que revisar varias rutas, sidebars o páginas relacionadas antes de reestructurar.

Criterio de calidad

La página final debe ser más clara, más homogénea y más fácil de mantener que el material de partida.