Protocolo de Documentación "Smart Fusion"

Tu objetivo es mantener la documentación viva sin matar la historia. Eres un Bibliotecario, no una trituradora de papel.

[!CRITICAL] PROTOCOLO DE SEGURIDAD DE DATOS: Antes de guardar cualquier archivo

.md

, debes tener el contenido ORIGINAL completo en tu contexto. Si no leíste el archivo entero, NO LO TOQUES.

1. El Flujo de Fusión (The Fusion Flow)

Cuando debas actualizar un documento (ej.

docs/CHATS_LOGIC.md

tras agregar una función):

1. Lectura Total: Lee el archivo objetivo completo (

   read_file

   ).
2. Identificación de Anclaje: Busca un título o sección donde lógicamente encaje lo nuevo.
   • Ejemplo: Si agregaste "Botón de Pánico", busca

     ## 2. Endpoints & Payloads

     o crea

     ## 3. Nuevas Funcionalidades

     .
3. Construcción en Memoria:

   • [Contenido Viejo Superior]

   • + [Tu Nuevo Contenido]

   • [Contenido Viejo Inferior]

4. Escritura: Guarda el archivo completo fusionado.

2. Estrategias de Actualización

A. Estrategia "Append" (La más segura)

Úsala para bitácoras, changelogs o guías de migración.

• Acción: No toques nada de lo existente. Agrega una nueva sección H2 (

  ##

  ) al final del documento con la fecha y el cambio.
• Ejemplo:

  ## [v6.2] Nueva integración Chatwoot - Enero 2026

  al final de

  REPORTE_MASTER.md

  .

B. Estrategia "Injection" (Listas y Tablas)

Úsala para agregar endpoints a

API_REFERENCE.md

o variables a

INFRASTRUCTURE.md

.

• Acción: Localiza la tabla o lista existente. Inserta la nueva fila respetando el formato Markdown (

  | Col | Col |

  ). Mantén el resto de filas intactas.

C. Estrategia "Deprecation" (Reemplazo)

Úsala SOLO si una función vieja dejó de existir.

• Acción: En lugar de borrar el texto viejo, envuélvelo en un bloque de alerta:

  > [!WARNING] DEPRECATED (v6.0)
  > El siguiente método ya no se usa, pero se mantiene por referencia histórica.
  > [Texto Viejo...]
  
  ### Nueva Implementación (v6.2)
  [Texto Nuevo...]
  

3. Verificación de Integridad (Safety Check)

Antes de ejecutar el comando

write_file

o guardar, hazte estas preguntas:

1. "¿El nuevo contenido es drásticamente más corto que el original?"
   • Si el archivo original tenía 500 líneas y tu propuesta tiene 50, DETENTE. Estás a punto de borrar información.
2. "¿He mantenido los headers y la estructura de navegación?"
3. "¿Estoy alucinando secciones que no leí?"

4. Ejecución Táctica

1. Analizar Código: Lee el archivo de código modificado (ej.

   Chats.tsx

   o

   meta_service.py

   ).
2. Leer Doc: Lee el documento correspondiente en

   docs/

   .
3. Redactar: Crea el párrafo técnico explicando el cambio.
4. Fusionar: Combina

   Doc Original

   +

   Nuevo Párrafo

   .
5. Guardar: Escribe el resultado final.

5. Caso Especial: Actualizar Skills (

SKILL.md

)

Si actualizas una Skill:

1. NUNCA toques el Frontmatter (YAML) a menos que se pida explícitamente.
2. Agrega nuevas reglas en la sección pertinente.
3. Ejecuta la skill "Skill Synchronizer" al finalizar para re-indexar.