# Protocolo de Documentación de Cambios (Changelog Protocol)

Este documento establece el protocolo estricto para registrar todos los cambios realizados en el código fuente de la aplicación. Este protocolo debe ser seguido por todos los desarrolladores y agentes de IA que trabajen en el proyecto.

## 1. Cambios Globales (Sistema Core, Configuración General)

Cualquier cambio que afecte al núcleo del sistema (framework), archivos de configuración globales, o que tenga un impacto en toda la aplicación, debe ser documentado en el directorio `/changelogs` ubicado en la raíz del proyecto.

- **Ubicación:** `/changelogs/`
- **Formato del Archivo:** Markdown (`.md`)
- **Convención de Nombres:** `YYYY-MM-DD-descripcion-breve.md` (Ejemplo: `2024-05-20-fix-debug-toolbar-json.md`)

### Estructura del Documento Global
El archivo debe contener al menos:
- **Título:** Descripción clara del cambio.
- **Autor:** Jose Alexis Correa Valencia
- **Fecha:** Fecha del cambio.
- **Descripción:** Explicación detallada del por qué y qué se cambió.
- **Archivos Afectados:** Lista de archivos modificados.

## 2. Cambios en Módulos (Funcionalidades Específicas)

Los cambios que se limiten a un módulo específico, componente o funcionalidad aislada, deben documentarse dentro del directorio del módulo correspondiente.

- **Ubicación:** `/[ruta-del-modulo]/changelogs/` o simplemente un archivo `.md` en la raíz del módulo si no existe carpeta de logs.
- **Formato:** Markdown (`.md`)
- **Convención:** Similar a la global, o un archivo acumulativo `CHANGELOG.md` dentro del módulo si se prefiere historial único por módulo.

## 3. Formato General

Todos los documentos deben ser legibles y claros. Se recomienda el uso de bloques de código para mostrar diferencias críticas si es necesario, pero manteniendo la brevedad.

---
*Este documento es la referencia para la IA y los desarrolladores sobre cómo gestionar el historial de cambios.*