AI Side Project
Arki : Arquitecto de Software con IA
Herramienta pre-código que genera Architecture Blueprints y Dev Specs mediante una entrevista con IA. Transforma ideas en arquitecturas sólidas antes del primer commit.
Stack tecnológico
Las tecnologías usadas y por qué.
Capturas
El problema
Bolt, v0 y Cursor hacen fácil convertir una idea en código. El problema es que nadie hace las preguntas de arquitectura antes de escribir la primera línea.
Apps que funcionan en demos
Bolt y v0 generan código funcional en minutos. Pero sin preguntas previas sobre escala, concurrencia o sensibilidad de datos, el resultado es un prototipo disfrazado de producto.
Deuda técnica desde el día cero
Cuando la arquitectura no se decide de forma explícita, igual se decide : por omisión. Y revertir esas decisiones en producción cuesta diez veces más que tomarlas bien al principio.
El arquitecto senior no siempre está disponible
No todos los equipos tienen acceso a alguien que haga las preguntas correctas antes de arrancar. Arki cierra esa brecha para founders, equipos chicos y developers independientes.
Prompts de IA sin contexto
Pegar “haceme una app de X” en Claude Code o Cursor sin especificaciones claras genera código genérico. Las dev specs de Arki le dan al agente el contexto que necesita para generar código real.
La solución
Arki se sienta entre tu idea y tu primer prompt de IA: te entrevista, entiende tu contexto y genera un blueprint completo con decisiones documentadas y dev specs listos para usar.
Entrevista guiada
Arki te hace preguntas clave sobre escala, equipo, sensibilidad de datos, necesidades de tiempo real y presupuesto. Sin formularios. Una pregunta a la vez.
Blueprint de arquitectura
Genera un documento completo con diagrama Mermaid, decisiones de arquitectura documentadas (ADRs), plan de observabilidad y stack recomendado por capa.
Dev Specs listas para usar
Exporta estructura de carpetas, schema de base de datos, contrato de API e instrucciones de agente. Pegálas en Claude Code o Cursor y arrancá a construir.
Arquitectura técnica
La decisión más importante fue usar dos modelos de Claude en secuencia: Sonnet para la entrevista (velocidad, costo) y Opus para la generación del blueprint (máxima profundidad técnica).
Por qué Next.js 15 + React 19
La app tiene dos partes muy distintas: el flujo de entrevista (streaming de tokens, UI reactiva) y la generación del blueprint (documento estructurado, posible descarga). Next.js App Router con Server Components para las partes estáticas y Client Components solo donde hay interactividad. React 19 por las mejoras en el manejo de estados de carga con Actions.
Por qué Drizzle + PostgreSQL en lugar de un ORM más común
Drizzle es type-safe por diseño : el schema de la base de datos y los tipos TypeScript viven en el mismo lugar. Para una app donde el schema evoluciona con cada feature nueva, eso elimina una categoría entera de bugs. PostgreSQL porque las sesiones de arquitectura tienen estructura semi-relacional (una sesión tiene múltiples intercambios, cada intercambio tiene un estado).
Streaming de respuestas
La entrevista usa la Vercel AI SDK para streamear los tokens de Claude Sonnet directamente al cliente. El blueprint (que puede ser largo) se genera en un API route y se guarda en la base de datos antes de mostrarse. Esto evita timeouts en Vercel con respuestas largas.
Funcionalidades
- Entrevista guiada: 6 a 10 intercambios donde Arki hace las preguntas correctas : escala esperada, sensibilidad de datos, necesidades de tiempo real, presupuesto, tamaño del equipo.
- Blueprint de arquitectura: Diagrama Mermaid completo, ADRs (Architecture Decision Records), plan de observabilidad y stack tecnológico recomendado capa por capa.
- Dev Specs exportables: Estructura de carpetas, schema de base de datos, contrato de API e instrucciones para agentes listas para pegar en Claude Code, Cursor o Bolt.
- Historial de sesiones: Guarda cada arquitectura generada. Retomá una sesión anterior, comparálas o iterá sobre un diseño existente.
- Multilingüe: Soporta español e inglés. La entrevista y el blueprint se generan en el idioma que preferís.
- Claude Sonnet + Opus: La entrevista usa Claude Sonnet para velocidad. La generación del blueprint usa Claude Opus para máxima profundidad técnica.
Estado actual
Arki está en desarrollo activo. La entrevista y generación de blueprints están funcionando en producción. Las próximas features son exportación a PDF, colaboración en equipo y templates por industria/tipo de proyecto.