Skip to content

jorgevelez8/enlace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Enlace

Un asistente ejecutivo para funcionarios públicos que pelean con formatos.

Enlace convierte notas sueltas de una reunión en documentos oficiales completos: actas de comité, informes periódicos y reportes de avance de equipo. Funciona para cualquier entidad pública colombiana: alcaldías, gobernaciones, ICBF, personerías, ONG, entidades del orden nacional.

Corre dentro de Claude Code. No hay código, no hay servidores, no hay claves de API. Es una carpeta con instrucciones y plantillas. Instalas Claude Code, abres esta carpeta, y ya.


Por qué existe

Soy enlace regional: coordino programas de atención a población víctima y vulnerable en más de 100 municipios de Cundinamarca. Llevo 14 años en eso.

Una parte grande de ese trabajo no es coordinar: es redactar. Cada comité municipal produce un acta con su orden del día, su desarrollo, su tabla de compromisos con responsables y fechas, su listado de asistentes y sus anexos. Cada trimestre hay un informe consolidado. Cada mes hay un reporte de equipo.

Son documentos que tienen que estar bien —de ellos dependen compromisos institucionales reales— pero que consumen las horas que uno debería estar usando en el territorio.

Enlace no reemplaza el criterio. Reemplaza el tiempo de transcribir.


Qué hace

Le hablas en español, normal:

genera el acta del comité de San Vicente del Río con las notas de la sesión de julio

Y produce el documento completo, con la estructura oficial, señalando en [POR CONFIRMAR] todo lo que faltó en tus notas. También lo convierte a .docx automáticamente.

Si tu entidad tiene formato oficial propio (con membrete, logos, pie de página), Enlace abre ese formato y lo rellena en lugar de generar uno desde cero.

Otros comandos frecuentes:

genera el acta del comité de X en formato ICBF
consolida el informe trimestral con los datos del último corte
resume el avance de metas del equipo para el corte de junio
revisa este acta y dime qué le falta
configura mi entidad

El último configura Enlace para tu formato oficial en menos de cinco minutos.


Cómo usarlo

1. Instala Claude Codeinstrucciones oficiales

2. Clona esta carpeta

git clone https://github.com/TU-USUARIO/enlace.git
cd enlace

3. Instala la dependencia Python

pip install python-docx

4. Ábrela con Claude Code

claude

5. Prueba con el ejemplo

genera el acta del comité de San Vicente del Río con las notas del archivo de ejemplo

El archivo datos/ejemplo.md trae notas ficticias para que pruebes sin cargar nada tuyo.


Configurar tu entidad en cinco pasos

Si tu entidad tiene un formato oficial de acta (Word con membrete y logos), Enlace puede usarlo directamente:

configura mi entidad

Claude te guía:

  1. Te pregunta el nombre de la entidad
  2. Te pide que pongas el formato en plantillas/[entidad]/formato.docx
  3. Analiza el formato y detecta su estructura
  4. Genera plantillas/[entidad]/perfil.md con el glosario y el marco normativo
  5. Te dice qué marcadores {{}} agregar al .docx para el llenado automático

Desde ese momento:

genera el acta del comité de X en formato [tu entidad]

produce el .docx oficial, con tu membrete y logos intactos, con los campos rellenos.


Estructura

enlace/
├── CLAUDE.md                   contexto institucional: cómo trabaja el asistente,
│                               marco normativo genérico, reglas de redacción
├── plantillas/
│   └── _generico/              formato por defecto (sin membrete)
│       ├── acta-comite.md      estructura de un acta ordinaria
│       ├── informe-trimestral.md
│       ├── reporte-equipo.md
│       └── perfil.md           glosario + marco normativo + reglas
│   └── [entidad]/              creado al configurar una entidad
│       ├── formato.docx        formato oficial (tú lo pones)
│       └── perfil.md           perfil generado por Enlace
├── herramientas/
│   ├── md_a_docx.py            convierte .md a .docx desde cero (_generico)
│   ├── leer_formato.py         extrae la estructura de un formato.docx oficial
│   └── llenar_formato.py       rellena un formato.docx oficial con el acta
├── datos/
│   └── ejemplo.md              datos ficticios de prueba
└── salidas/                    aquí caen los documentos generados (.md y .docx)

CLAUDE.md es el corazón del proyecto. Ahí está el contexto que convierte un asistente genérico en uno que entiende qué es un comité territorial de justicia transicional, qué exige la Ley 1448 y por qué un compromiso sin fecha no sirve para nada.

plantillas/[entidad]/perfil.md es la clave de la adaptación. Contiene la estructura exacta, el glosario y el marco normativo propios de cada entidad.


Sobre los datos sensibles

Este proyecto trabaja con información de población víctima del conflicto armado. En Colombia esos datos están protegidos por la Ley 1581 de 2012 y por el principio de confidencialidad de la Ley 1448. No es un tecnicismo: divulgar la ubicación de una persona en riesgo puede costarle la vida.

Por eso:

  • Enlace corre local. Tus archivos no van a ningún servidor de terceros.
  • Este repositorio no contiene un solo dato real. Los municipios, las personas y las cifras del ejemplo son inventados.
  • Las plantillas son genéricas. No reproducen formatos internos de ninguna entidad. Los formatos oficiales que pongas en plantillas/[entidad]/ tampoco deben subirse a repositorios públicos.
  • Si le pegas datos personales reales al asistente, está instruido para advertírtelo.

Si vas a publicar tu propia versión: revisa datos/ y plantillas/ antes de hacer commit.


Por qué se llama Enlace

Enlace es mi cargo. En el sector público colombiano, un enlace es la persona que conecta el nivel nacional con el territorio: quien traduce la política en algo que efectivamente pasa en un municipio.

Esta herramienta hace lo mismo en pequeño: conecta lo que ocurrió en una reunión con el documento que la institución necesita para que eso cuente.


Contribuir

Si adaptaste Enlace a otra entidad o a otro tipo de documento, abre un issue o un pull request. Ver CONTRIBUTING.md.

Me interesa especialmente saber si funcionó en alcaldías pequeñas, que son donde menos apoyo técnico hay y más se necesita.


Aviso

Proyecto personal. No es un producto oficial de ninguna entidad pública.


Licencia

MIT. Úsalo, modifícalo, véndelo si quieres. Ver LICENSE.


Proyecto del curso de Claude Code para No Programadores de Platzi.

About

Asistente en Claude Code para funcionarios públicos: convierte notas de reunión en actas e informes oficiales

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages