Start-up con IA que no sea un desastre

Framework para que agentes trabajen en tu proyecto sin romper todo. La IA entiende tu contexto antes de proponer cambios, valida que funciona, y no te genera código que "anda" pero es imposible de mantener.

Quickstart (5 minutos)

1. Copia START-UP.md, AGENTS.md, Skills/ y scripts/ a tu proyecto
2. Ejecuta: ./scripts/validate-skills.sh --dry-run
3. Usa tu agente con: "Usa START-UP.md como protocolo, analiza el repo y configura AGENTS/Skills para este contexto"

Ver QUICKSTART.md para detalles.

Estructura del framework

• START-UP.md → Protocolo completo por fases para configurar cualquier proyecto
• AGENTS.md → Reglas mínimas y verificables para agentes (anti-ruido)
• Skills//SKILL.md → Templates con dos tipos:
  • capability_uplift: capacidades técnicas temporales (pueden quedar obsoletas)
  • encoded_preference: preferencias de equipo estables (no caducan)
  • Skills/examples/react-vite-ts/ → ejemplos concretos para stack React + Vite + TypeScript (scope: [example], para adaptar, no copiar)
• MIGRACION.md → Plan de migración y mantenimiento
• scripts/validate-skills.sh → Validador automático de estructura y metadata

¿Por qué dos tipos de skills?

capability_uplift: Agregan algo técnico que el modelo no sabe hacer todavía. Van a quedar obsoletas cuando GPT-5/Claude-Next las hagan nativas. Ejemplo: "parsear logs de Kubernetes" → eventualmente los modelos van a hacer esto out-of-the-box.

encoded_preference: TUS reglas de trabajo. Cómo nombrás variables, qué patterns usás, estructura de commits. Estas NO caducan porque son tuyas, no del modelo.

Regla fundamental

No importa tu stack (React, Go, Python, lo que sea):

• Linter configurado y ejecutándose automáticamente
• Validación antes de commit (el script ya lo hace)
• Tests que realmente validen algo

Sin esto, cualquier IA genera código que "funciona" en su máquina pero explota en producción.

Filosofía

Framework genérico a propósito. No te dice "usa React + TypeScript + Tailwind" porque la IA debe adaptarse a TU stack, TU arquitectura, TU forma de trabajar.

He visto demasiados proyectos donde el agente propone "mejores prácticas" que no tienen nada que ver con lo que ya funciona. Este approach fuerza a la IA a entender primero, proponer después.

Créditos

Creado por Ignacio Nicolas Basilio Buracco (Ignadev) basado en años de QA Automation y conceptos de Gentleman Programming.

• Web: ignadev.com
• GitHub: @NachoBasilio

---

Si esto te sirvió, mandá un PR. Si algo no funciona, abrí un issue.