🚀 Start here — new contributor guide & good first issues

[vgpastor]

👋 Welcome! This is the entry point for new contributors. / ¡Bienvenido/a!
Este es el punto de entrada para nuevos contribuidores.

ResponseGrid ChatBot is the Telegram + WhatsApp assistant for the
ResponseGrid humanitarian-aid platform. It's open
source (AGPL-3.0) and contributions are very welcome.

1. Read these first / Léete esto primero

• 📖 README (español) — what it is + quickstart
• 🤝 CONTRIBUTING.md — dev setup, standards, PR flow
• 🔒 SECURITY.md — report vulnerabilities privately
• 📜 Code of Conduct

2. Set up in 2 minutes / Monta el entorno en 2 minutos

npm install          # Node 24+ (see .nvmrc)
cp .env.example .env
cp accounts.example.json accounts.json
npm test             # should pass
npm run dev

You don't need WhatsApp/Meta credentials to work on most things — tests run
offline and Telegram just needs a free @Botfather token. / No necesitas
credenciales de WhatsApp/Meta para casi nada: los tests corren offline y Telegram
solo pide un token gratis de @Botfather.

3. Pick something to work on / Elige por dónde empezar

Good first issues (small, self-contained):

• Add a /health endpoint to the WhatsApp webhook server #1 — Add a /health endpoint to the WhatsApp webhook server
• Add a CHANGELOG.md (Keep a Changelog) #2 — Add a CHANGELOG.md
• Log a masked account summary on startup #3 — Log a masked account summary on startup
• Conversation stats script from structured logs #4 — Conversation stats script from structured logs

Help wanted (bigger / more open-ended):

• Ambiguous references ("the previous option") can drop items #5 — Ambiguous references ("the previous option") can drop items (bug)
• Reduce per-turn latency (currently ~5-11s) #6 — Reduce per-turn latency (~5–11s)

Comment on an issue to claim it before starting. / Comenta la issue para
reclamarla antes de empezar.

4. How the code is organized / Cómo está organizado el código

Hexagonal / DDD: domain → application → infrastructure. Each channel
(Telegram, WhatsApp) is an adapter behind the MessagingChannel port. See the
project structure in the README.

Questions? Open a Discussion or ask on the issue you're working
on. / ¿Dudas? Abre una Discussion o pregunta en la issue.