# Contribuir a compliance-uy

¡Gracias por aportar! Este proyecto ayuda a empresas uruguayas a preparar su cumplimiento legal.

## Principio rector: todo citado a la ley

Toda afirmación legal **debe** poder contrastarse contra el texto oficial en `sources/` y citar
**ley + artículo + archivo**. Lo que no se pueda confirmar ahí se marca `[verificar contra fuente
oficial]`. No se aceptan afirmaciones normativas basadas solo en blogs o resúmenes secundarios.

## Cómo aportar

- **Corregir un artículo/dato:** cita la fuente oficial (IMPO / Parlamento / URCDP) y, si corresponde,
  actualiza `references/mapa-articulos-*.md` con la línea del texto.
- **Agregar un marco nuevo (pack):** crea `packs/<ley>/pack.md` (obligaciones + controles que exige +
  plantillas) y mapea sus controles en `references/controls.md` (crosswalk). Agrega su texto oficial a
  `sources/` con su entrada en `sources/FUENTES.md` (URL, SHA-256, comando de re-descarga).
- **Mejorar runbooks/plantillas:** mantén el disclaimer "no es asesoría legal" y marca `[ABOGADO]`
  donde se requiera intervención profesional.

## Flujo de trabajo (git)

1. **Forkea** el repo (o crea una rama, si tienes acceso de escritura).
2. Crea una **rama** descriptiva: `tipo/descripcion-corta` (ej. `fix/art-23-transferencias`, `feat/pack-ley-nueva`).
3. Usa [Conventional Commits](https://www.conventionalcommits.org) en español: `tipo(scope): descripción`
   (`fix`, `feat`, `docs`, `refactor`, `chore`…).
4. Abre un **Pull Request contra `main`** describiendo el cambio y citando las fuentes que tocaste.
5. Espera **al menos una revisión** antes de mergear. **No se commitea directo a `main`.**

## Estilo

- Contenido en español rioplatense (el dominio es derecho uruguayo).
- Documentos generados deben llevar placeholders `[COMPLETAR: ...]` para lo que no se sabe; no inventar
  datos de la empresa.

## Aviso

Este software genera borradores y diagnósticos; **no constituye asesoría legal**. Las contribuciones se
publican bajo la licencia [MIT](LICENSE).