Lore — scrolls de conocimiento inyectados a demanda

Lore es la capa de conocimiento curado de Korva. Los scrolls Markdown se cargan automáticamente cuando sus triggers (file globs, keywords, frases de tarea) coinciden con la sesión de IA. Veinticinco scrolls vienen en el release v1.0.

Actualizado: 2026-04-30

Lore es la capa de conocimiento curado de Korva. Cada “scroll” es un archivo Markdown autocontenido que se inyecta en la sesión de IA cuando sus triggers coinciden con el archivo que el developer acaba de abrir, las keywords del prompt o el tipo de tarea que se está realizando.

El resultado: cuando abres src/payments/checkout.ts, tu IA ya conoce la idempotencia de Stripe, el cumplimiento PCI y la precisión decimal — sin que escribas una sola palabra.

Anatomía de un scroll

Cada scroll tiene un frontmatter YAML:

---
id: nestjs-hexagonal           # kebab-case, debe coincidir con el nombre del directorio
version: 1.2.0                 # semver — sube cuando el comportamiento cambie
team: backend                  # backend | frontend | devops | qa | security | all
stack: NestJS, TypeScript, Hexagonal Architecture
last_updated: 2026-04-30       # fecha ISO
---

…tres ejes de triggers (cualquier coincidencia gana):

files — globs (*.ts, *.config.ts, Dockerfile)
keywords — términos encontrados en el prompt o snippet (5–12 típicos)
tasks — frases imperativas (“creating a controller”, “writing tests”)

…y una estructura de cuerpo fija:

Context (2–4 frases) — por qué importa, los riesgos en producción
Rules (5–10 reglas) — cada una con código ejecutable y nombres de dominio realistas
Anti-patterns (3–5 pares) — ❌ BAD con explicación + ✅ GOOD con la corrección

Token budgets

Los scrolls tienen topes duros para que no revienten la ventana de contexto de la IA:

Tier	Cap	Cuándo se carga
Hot path	< 1.500 tokens	Cada sesión que lo dispare
Common	< 4.000 tokens	Cuando lo dispara archivo/keyword
Reference	< 8.000 tokens	Solo a petición explícita

La mayoría de scrolls están en el tier Common.

Los 25 scrolls curados (v1.0)

ID	Team	Stack
`forge-sdd`	all	El propio workflow Spec-Driven Development de 5 fases
`skill-authoring`	all	Cómo escribir scrolls que puntúen bien al disparar
`claude-api`	all	Anthropic SDK — caching, streaming, tool use, batch
`mcp-builder`	all	Construir servidores MCP — naming, esquemas, errores
`security-patterns`	backend	bcrypt, JWT, timing-safe, RBAC, rate limiting
`token-efficiency`	all	Read-before-write, edit-over-rewrite, presupuesto de contexto
`nestjs-hexagonal`	backend	Ports, adapters, domain/application/infrastructure
`nestjs-bff`	backend	Patrón BFF, stateless, circuits a APIs externas
`error-handling`	backend	Errores en Go, tipos Result, mapeo de errores HTTP
`testing-jest`	backend	AAA, mocks de ports, fixtures, cobertura
`typescript`	backend	Branded types, discriminated unions, type guards
`payments-stripe`	backend	Idempotencia de webhooks, cumplimiento PCI, dedup
`api-design`	backend	REST: versionado, paginación, envelopes, OpenAPI
`cloud-sync`	backend	Dedup de chunks, idempotencia, outbox, resolución de conflictos
`sqlite-concurrency`	backend	Cola de escritura, busy_timeout, “database is locked”
`release-engineering`	devops	Conventional commits, semver, release-please
`observability`	backend	OpenTelemetry: logs, métricas, traces
`docker-k8s`	devops	Resource limits, probes, gestión de secretos
`gitlab-ci`	devops	Builds multi-stage, integración con Vault, Harbor
`nx-monorepo`	backend	Libs scoped, paths de import, caching, generators
`playwright-e2e`	qa	Page objects, regresión visual, integración
`plugin-architecture`	backend	Registries, versionado de manifest, sandboxing
`frontend-design`	frontend	Patrones UI, theming, animación, dark mode
`react-nextjs`	frontend	React 19, Next 15, App Router, server components
`angular-wc`	frontend	Angular 20, Signals, Web Components, OnPush

Puente con la comunidad de Lore

Más allá de los 25 scrolls curados, lore/community/autoskills/SCROLL.md es un registry-bridge que mapea 60+ tecnologías a skills de la comunidad alojadas en skills.sh — React, Next.js, Vue, Nuxt, Angular, Astro, Node.js, Go, Python, FastAPI, Django, Rails, Prisma, Stripe, Clerk, Vercel, Cloudflare, Playwright y más. Combinado con tus scrolls privados de equipo, esto le da a cada proyecto una base de conocimiento autoritativa sin esfuerzo.

Ciclo de vida de un scroll dentro de una sesión de IA

El asistente de IA arranca y llama a vault_context con project, prompt y file_paths.
El Vault matchea triggers contra los scrolls activos (curados bajo ~/.korva/lore/curated/ y scrolls del equipo bajo lore/private/).
Los scrolls que coinciden se devuelven como auto_skills inline en la respuesta.
La IA los consume silenciosamente como guidance autoritativa.
El developer experimenta a la IA “ya conociendo” las reglas del equipo.

Escribir tu propio scroll

El camino más rápido es korva lore add (interactivo) o copiar lore/SCROLL_TEMPLATE.md, completar el frontmatter y dejar el archivo en lore/private/<id>/SCROLL.md. Ver skill-authoring para el ejemplo canónico.

Forge SDD — cómo se cargan los scrolls entre fases
Administración de Teams — distribuir scrolls privados al equipo