Plataforma SaaS modular agent-first: 1 feature = 1 repo = 1 agente

Resumen Busco un ingeniero de software senior para construir desde cero la infraestructura base de una plataforma SaaS modular cuyo eje es: cada feature de negocio vive en su propio repositorio Git y es mantenida por un agente de IA (estilo Claude Code) con responsabilidad sobre código, tests, migraciones y documentación de su repo. No busco que el freelancer construya las features de negocio. Busco que entregue el andamiaje que permite que decenas de features futuras se desarrollen así. Nota importante. Este es un proyecto personal de emprendimiento, no una contratación corporativa. Estoy iniciando algo nuevo y busco una relación de corto a mediano plazo mientras la plataforma agarra tracción y se pule. Si lo que entregas funciona y la plataforma despega, hay margen para extender — pero la propuesta debe dimensionarse para una colaboración acotada, no para un contrato indefinido. Contexto Vengo del mundo del software aplicado a operaciones de negocio. Actualmente opero un SaaS en producción construido como monorepo con 18 features y estoy migrándolo a polyrepo agrupado por dominio (8 repos). Esa experiencia me dio el aprendizaje arquitectónico, pero el proyecto que aquí se contrata es independiente: una plataforma nueva, propia, diseñada desde el día cero para desarrollo asistido por agentes con granularidad por feature individual. No es portar nada. Es construir una infraestructura limpia que después yo mismo (con agentes) iré poblando de features de negocio. Visión técnica Tres capas CapaReposFunciónNúcleoplatform-backend-core, platform-frontend-coreShell de FastAPI y React. Auto-discovery de features. Auth, infra de BD, middleware, utilidades compartidas. No conoce ninguna feature de negocio.Featuresfeature-<nombre> (1 repo por feature)Slice vertical: backend (routes, models, repo, service, schemas, tests, migraciones Alembic) + frontend (componentes, hooks, services). Un agente por repo.Integraciónplatform-integrationCoordinador. Submodules de todos los repos. Docker Compose para levantar el sistema completo. Tests E2E. Único repo desde el que se hace deploy a producción. Sistema de agentes Cada repo de feature debe contener: AGENT.md — instrucciones operativas del agente: contratos públicos, dependencias permitidas, reglas de cambio, criterios de aceptación. CONTRACT.md — interfaz pública del feature (endpoints, eventos, tipos exportados). Es el único punto de contacto con otras features. Suite de tests que valida el contrato. Workflow de CI que ejecuta los tests y dispara el workflow de integración cuando se mergea a main. El agente solo puede modificar archivos dentro de su repo. Cualquier cambio que rompa el contrato debe pasar por el repo de integración. Reglas no negociables Ningún feature importa código de otro feature directamente. Las dependencias entre features se resuelven por interfaces declaradas (contratos), no por imports. Cada feature gestiona sus propias migraciones de BD con revision_id UUID para evitar colisiones. El repo de integración es el único que despliega a producción. El monorepo de desarrollo nunca existe — desde el día cero todo es polyrepo. Alcance del proyecto Incluye Repo platform-backend-core con FastAPI, auto-discovery de features, auth JWT, middleware de tenant isolation, infraestructura Alembic maestra. Repo platform-frontend-core con React + TypeScript, router con carga dinámica de features, contexto de auth, sistema de design tokens. Repo platform-integration con Docker Compose, Makefile, submodules, workflow de CI E2E, deploy automatizado. Dos features de ejemplo (feature-auth, feature-usuarios) implementadas íntegramente bajo el patrón, con AGENT.md y CONTRACT.md operativos. Plantilla feature-template que sirva de scaffolding para crear nuevos repos de feature. CI/CD por repo con GitHub Actions: tests en push y PR, dispatch al repo de integración al mergear a main. Documentación de arquitectura (ADR), guía de creación de nuevos features y manual operativo del agente. No incluye Features de negocio más allá de las dos de ejemplo. Diseño visual del frontend (basta con shell funcional y design tokens). Implementación del agente IA en sí — el sistema debe ser compatible con Claude Code u otra herramienta similar, pero el freelancer no construye el agente. Migración de datos desde sistemas existentes. Stack técnico esperado ComponenteTecnologíaBackendPython 3.12, FastAPI, SQLAlchemy 2.x, Alembic, Pydantic v2FrontendReact 18, TypeScript, Vite o CRA, TailwindCSSBase de datosPostgreSQL 16ContenedoresDocker, Docker ComposeCI/CDGitHub ActionsHosting objetivoRailway o similar (a definir) Si el candidato propone variaciones justificadas (ej. Next.js en lugar de CRA, Turso en lugar de Postgres para algún caso), evaluamos. Entregables #EntregableCriterio de aceptación14 repos en GitHub funcionando (core BE, core FE, integration, template)make setup && make up levanta el sistema en menos de 5 minutos en una máquina limpia22 features de ejemplo (auth, usuarios)Tests pasan, contratos documentados, integran con el core3CI verde en los 6 reposWorkflows ejecutan en GitHub Actions sin intervención manual4Documentación de arquitecturaADRs, guía de creación de features, AGENT.md operativo5Sesión de handover2 horas en video, código revisado en vivo Perfil del freelancer Experiencia comprobable construyendo arquitecturas modulares en producción (mostrar repos públicos o privados con permiso). Dominio de FastAPI, SQLAlchemy y Alembic en proyectos reales. Experiencia con Git submodules o monorepos modulares (Nx, Turborepo). Experiencia con GitHub Actions y deploy automatizado. Bonus: experiencia previa con desarrollo asistido por LLMs (Claude Code, Cursor agents, Aider). Modalidad Tipo de contrato: precio fijo contra entregables. Duración estimada: 4 a 6 semanas para el alcance descrito. Naturaleza de la relación: corto a mediano plazo. La idea es entregar la infraestructura, validar que funciona, y mantener una colaboración puntual para ajustes y soporte mientras la plataforma agarra tracción. No busco un equipo permanente ni un consultor de planta — busco un profesional que arranque algo bien hecho y me deje en posición de seguir solo (con agentes). Posible continuidad: si el resultado es bueno y la plataforma despega, hay espacio para iteraciones posteriores (features adicionales, optimización, nuevas plataformas). Eso se acuerda al cierre, no como compromiso previo. Comunicación: español o inglés. Reuniones semanales por video. Pago: 30% al inicio, 40% al entregar el core funcional, 30% al cierre con CI verde.