el-primor

🏆 El Primor v3.0.0

No basta con que funcione. Tiene que estar excelente.

El Primor es un agente de coding para OpenCode que recuerda. No empieza de cero cada sesión — construye una memoria semántica de tu stack, tus decisiones, tus errores y tus patrones. Cuanto más lo usas, más tuyo es.

🚀 Instalación

Humanos:

npx el-primor init

Agentes AI: solo dile a tu agente de OpenCode:

"instala El Primor"

El agente ejecutará npx el-primor init y configurará todo automáticamente: AGENTS.md, 7 skills, TurboVec, MCP server. Sin URLs, sin clones, sin comandos manuales.

🧠 Cómo funciona

TÚ                    EL PRIMOR                   MEMORIA
│                         │                          │
│ "crea un endpoint      │                          │
│  de auth con JWT"      │                          │
│ ──────────────────────►│                          │
│                         │  ┌───────────────────┐  │
│                         │  │ Fase 0: MEMORIA   │  │
│                         │  │ turbo_vec_search() │──► busca "auth JWT"
│                         │  └───────────────────┘  │  en ~/.primor/
│                         │           │              │
│                         │           │ ◄────────────│ "Ya hicimos esto
│                         │           │ recupera     │  con bcrypt, no JWT"
│                         │           │ contexto     │
│                         │  ┌───────────────────┐  │
│                         │  │ Fase 1: ESCUCHAR  │  │
│                         │  │ ¿JWT o sesiones?   │  │
│                         │  └───────────────────┘  │
│                         │           │              │
│                         │  ┌───────────────────┐  │
│                         │  │ Fase 2: INVESTIGAR│  │
│                         │  │ 1º memoria, 2º web │  │
│                         │  └───────────────────┘  │
│                         │           │              │
│                         │     ... 9 fases ...     │
│                         │           │              │
│                         │  ┌───────────────────┐  │
│                         │  │ Fase 8: DOCUMENTAR│  │
│                         │  │ turbo_vec_store()  │──► guarda decisiones,
│                         │  └───────────────────┘  │  errores, aprendizajes
│                         │                          │
│ "listo, probado"  ◄────│                          │
│                         │                          │
│  (día siguiente)        │                          │
│ "añade refresh token"   │                          │
│ ──────────────────────►│                          │
│                         │  turbo_vec_search() ────► ya sabe del contexto
│                         │  "auth previo, bcrypt"   │
│                         │                          │
│                         │  No pregunta de cero.    │
│                         │  Extiende lo que ya sabe.│

TurboVec es el motor de memoria: búsqueda semántica (multilingual-e5-small, 384-dim) + SQLite para metadatos. El agente consulta antes de actuar y documenta al terminar. El conocimiento no se pierde entre sesiones.

Cada proyecto tiene su propio espacio en ~/.primor/. Si trabajas en 3 proyectos, cada uno acumula su propia memoria sin mezclarse.

📋 Metodología — 9 Fases

#	Fase	TurboVec
0	Memoria	search() — recupera contexto previo
1	Escuchar	Lee perfil del usuario desde memoria
2	Investigar	Busca en memoria ANTES que en internet
3	Planificar	Asumption log + dependency mapping
4	Ejecutar	Una cosa a la vez, tool hygiene
5	Verificar	Tests, edge cases, quality gates
6	Reflexionar	¿Se puede mejorar? ¿Quedó algo sin cubrir?
7	Simplificar	Eliminar complejidad accidental
8	Documentar	store() — decisiones, errores, aprendizajes
9	Entregar	Resumen + autoevaluación X/6

🛠️ 7 Skills

Cada skill contiene conocimiento que el LLM no demuestra consistentemente. Se cargan bajo demanda con skill():

Skill	Se activa en	Conocimiento experto
comprension-y-plan	F1+F3	Pre-flight 5 dimensiones, granularidad 2-5min, assumption logging
investigacion-actualizada	F2	APIs canónicas por stack, validación de vigencia, TurboVec-first
verificacion-rigurosa	F5+F9	Edge cases por dominio, property-based testing, 7-point checklist
seguridad-primor	Pre-commit	OWASP Top 10 2025, secret scanning contextual, sanitización por capa
debug-forense	Bugs	Git bisect, 5 Whys, reproducción mínima progresiva
diseno-excelente	Frontend	AI Slop detector, WCAG 2.2 AA, Core Web Vitals
reporting-profesional	Continuo	Keep a Changelog, conventional commits, semver

📦 Stack técnico

Componente	Tecnología
Plataforma	OpenCode v1.18.2
Modelo	DeepSeek V4 Pro
Memoria	TurboVec (Google Research, ICLR 2026) + SQLite
Embeddings	multilingual-e5-small (384-dim, 94 idiomas, ARM64 nativo)
MCP	Server local Python (~/.primor/turbo-vec-mcp.py)
Instalación	npm package (el-primor)

📁 Estructura

el-primor/
├── AGENTS.md              ← SOUL + metodología 9 fases (244 líneas)
├── bin/cli.js             ← CLI: init, global, update, uninstall, doctor
├── install.sh             ← Instalador bash (fallback)
├── setup.sh               ← Inicializa ~/.primor/ + TurboVec
├── turbo-vec-mcp.py       ← MCP server (search, store, stats)
├── .opencode/skills/      ← 7 skills on-demand
├── opencode.json          ← Config: DeepSeek V4 Pro, Plan/Build, MCP
├── package.json           ← npm: el-primor@3.0.0
└── .github/workflows/     ← CI de validación

📄 Licencia

MIT © 2026 fxMT-nx