🤝 Protocolo de Contribución¶

Filosofía Open Source

Este proyecto vive por su comunidad. Cada PR es un ladrillo en el edificio de la soberanía digital.

Ciclo de Vida del PR

graph TD
    Issue[🐛/✨ Issue] -->|Discusión| Branch[🌿 Rama Feature]
    Branch -->|Commit| PR[🔄 Pull Request]
    PR -->|CI/CD| Review[👀 Revisión]
    Review -->|Merge| Main[🚀 Main]

    style Issue fill:#e7ae4c,stroke:#333,stroke-width:2px,color:#fff
    style Branch fill:#37a880,stroke:#333,stroke-width:2px,color:#fff
    style PR fill:#e0e7ff,stroke:#333,stroke-width:2px,color:#182232
    style Review fill:#f1f5f9,stroke:#182232,stroke-width:2px,color:#182232
    style Main fill:#e0e7ff,stroke:#333,stroke-width:2px,color:#182232

1. 🏁 Antes de Empezar¶

Asignate el trabajo para evitar colisiones.

Busca un Issue: Mira los etiquetados como good first issue.
Comenta: "Me gustaría trabajar en esto".
Crea tu Rama:
```
git checkout -b feature/mi-mejora
```

2. 📦 El Pull Request Perfecto¶

Un PR se acepta rápido si es fácil de revisar.

✅ Lo que DEBE tener❌ Lo que EVITA

Título Claro: feat(ui): añadir modo oscuro (Usa Conventional Commits).
Contexto: ¿Qué problema soluciona?
Evidencia: Capturas de pantalla o logs si cambiaste algo visual o de lógica.

Archivos innecesarios (.DS_Store, __pycache__).
Cambios de formato masivos (espacios vs tabs) en archivos que no tocaste.
Secretos o tokens.

3. 📝 Lista de Verificación (Copiar y Pegar)¶

Usa esto en la descripción de tu PR:

## 🎯 Objetivo
[Describe qué hace este cambio]

## 📸 Evidencia
- [ ] Logs de prueba local adjuntos.
- [ ] Captura de pantalla (si aplica).

## 🛡️ Checklist de Seguridad
- [ ] No incluye secretos.
- [ ] Cumple con el principio de datos locales (Local-First).

¿Necesitas Ayuda?¶

Si te atascas, comenta en el Issue o busca en la documentación existente. ¡Estamos aquí para aprender juntos!