Saltar al contenido

BIENVENIDO.txt

Synaptech Solutions es el estudio independiente de ingeniería de Germán Martínez, con base en Uruguay. Construyo sistemas de IA, LLM y backend listos para producción (asistentes con IA, integraciones con ERP y MCP, pipelines de datos) para equipos de Latinoamérica, Estados Unidos y Europa.

synaptech.sh — zsh
  • whoami
  • Germán Martínez
  • Ingeniero de Software / ML Semi-Senior
  • Especialista en aplicaciones con LLM
  • Consultor independiente en sistemas de IA
  • cat mision.txt
  • Software práctico. IA honesta.
  • Sistemas listos para producción, para equipos que necesitan que la IA funcione de forma confiable.
  • ls experiencia/
  • sistemas backend
  • infraestructura para LLM
  • orquestación de agentes
  • pipelines de datos
  • automatización de procesos
  • integraciones de IA aplicada
  • cat forma-de-trabajo.txt
  • conversación técnica directa sobre el producto
  • arquitectura clara antes de implementar
  • colaboración pensada para trabajo asincrónico
  • nada de hype vago sobre IA
  • tradeoffs honestos, decisiones documentadas
  • uptime
  • más de 7 años construyendo sistemas de software
  • consultor independiente
  • mentalidad orientada a producción
  • cat ubicacion.txt
  • Radicado en Uruguay
  • Remoto, ante todo
  • Disponible para equipos de LATAM, EE. UU. y con horario de la UE

bot.platform.architecture

Diagrama de arquitectura de la plataforma de bots
Una sola app FastAPI sirve el Studio renderizado en el servidor (sesiones con cookies, protección CSRF, Jinja2 y HTMX) y una API /v2 versionada, protegida con JWT Bearer y control de roles. Las solicitudes pasan por routers, servicios y repositorios hasta MySQL. Las llamadas a bots externos pasan por una allowlist contra SSRF y usan credenciales cifradas, y las importaciones largas y los backfills de analítica corren como jobs guardados en la base de datos, que un proceso worker aparte toma y reserva temporalmente.
8
proyectos en el portfolio
ERP
MCP · bots · analítica
0
NDA violados

COMO_TRABAJO.md

01.
Especificación antes que código.

Todo proyecto empieza con una especificación técnica por escrito. Sin especificación, no hay código. Así se evita que el alcance se desvíe y los dos sabemos qué significa "terminado" antes de escribir una línea.

02.
Comunicación asincrónica, ante todo.

Trabajo en ciclos asincrónicos y documentados. Actualizaciones semanales por escrito, no standups diarios. Tu tiempo vale; lo respeto siendo preciso y autónomo.

03.
Evaluación honesta del alcance.

Si tu plazo es imposible, te lo digo de entrada. Si tu presupuesto no cierra con el alcance, lo renegociamos antes de empezar. Sin sorpresas a la hora de facturar.

04.
Transferencia de propiedad por defecto.

Todo lo que se construye es tuyo. Repos prolijos, APIs documentadas y runbooks incluidos. No genero dependencia.

CON_QUIEN_NO_TRABAJO.md

✗
Fundadores alérgicos a las especificaciones.

Si "lo vamos resolviendo sobre la marcha" es tu filosofía de ingeniería, no somos compatibles. La ambigüedad sale cara y me niego a cobrarte por la confusión.

✗
Hype de IA por encima de su utilidad.

No construyo envoltorios de LLM disfrazados de producto. Si necesitás "ChatGPT pero para X" sin una ventaja clara ni una tesis de por qué es defendible, voy a declinar con amabilidad.

✗
Solo equity, después del lanzamiento.

Pre-seed con un prototipo real: posible. Empresa en Serie A que pide "sweat equity": no. Mi alquiler no es una apuesta de riesgo sobre tu cap table.

✗
Vigilancia o patrones oscuros.

Seguimiento de usuarios sin consentimiento, manipulación del engagement o UX engañosa. Un no rotundo. Reviso los casos de uso antes de firmar cualquier acuerdo.

hacé clic para expandir
filosofía de ingeniería
CREENCIA_CENTRAL.txt
"El software no es un producto.
Es una decisión
que se vuelve permanente en el código."

Cada decisión de arquitectura, cada abstracción, cada atajo — todo se acumula. Trato el código como un pasivo a largo plazo, no como un entregable de corto plazo.

escrito por
Germán Martínez
Ingeniero de Software / ML Semi-Senior
M.01

La complejidad es una deuda, no un activo.

Cada capa de abstracción que sumás tiene que justificar su existencia con valor medible. Los equipos se derrumban bajo arquitecturas que impresionaron en un pitch deck pero no sobrevivieron a un incidente un martes de mañana.

M.02

La IA es infraestructura, no magia.

Los LLM son sistemas probabilísticos. Fallan en silencio, se desvían con el tiempo y alucinan bajo presión. Tratarlos como APIs deterministas es la forma de poner un pasivo en producción. Construyo con evals, guardrails y fallbacks.

M.03

El mejor sistema es el que llega a producción.

La perfección es enemiga de la producción. Priorizo la corrección, la observabilidad y la mantenibilidad — en ese orden. Un sistema que funciona con tradeoffs conocidos le gana a un sistema elegante que nunca se despliega.

M.04

Ingeniería honesta antes que mentiras cómodas.

Te voy a decir cuando tu idea no se sostiene técnicamente. Voy a señalar los riesgos de plazos antes de que se vuelvan crisis. Voy a documentar las decisiones con las que no estuve de acuerdo. La franqueza es una obligación profesional, no una opción.

M.05

Ser dueño significa irse, no quedarse.

Mi objetivo es volverme innecesario. Cada proyecto termina con documentación, runbooks y un equipo que puede operar sin mí. La dependencia es un antipatrón de la consultoría que me niego activamente a generar.

en la práctica, esto significa:
  • →Especificaciones por escrito antes de escribir código
  • →Suites de evals entregadas con cada funcionalidad de LLM
  • →Registros de decisiones de arquitectura para cada elección importante
  • →Objeciones honestas sobre alcance y plazos cuando hace falta
  • →Nada de lock-in con proveedores sin una justificación documentada
  • →Runbooks de guardia antes de que cualquier sistema salga a producción
LLM / IA
OpenAI
Claude
Gemini
Llama / Kimi / Gemma
LangChain / LangGraph
Instructor / Outlines
DATOS / INFRA
PostgreSQL / Redis
Pinecone / Weaviate
Kafka
Airbyte / Cognee
Feast (Feature Store)
ClickHouse
PLATAFORMA
Kubernetes / Docker
AWS / GCP / Azure
Railway / Fly.io
Terraform
GitHub Actions
Modal / Replicate / RunPod
OBSERVABILIDAD
Langfuse / Helicone
RAGAS / DeepEval
Prometheus / Grafana
Datadog
Sentry
OpenTelemetry
P.01

La tecnología aburrida es una virtud.

PostgreSQL antes que una base de datos distribuida. Un cron job antes que una cola de mensajes. El sistema más mantenible es el que tu próximo ingeniero puede depurar a las 2 de la mañana sin Slack.

P.02

Evals antes del despliegue.

Todo sistema con LLM sale con una suite de benchmarks. Si no lo podés medir, no lo podés mejorar—y seguro que no se lo podés vender a un cliente enterprise con equipo legal.

P.03

Runbooks, no conocimiento tribal.

Todo sistema que construyo sale con documentación operativa. Runbooks de guardia, registros de decisiones de arquitectura, guías de despliegue. Tu equipo no debería necesitarme para que todo siga andando.