Un kit de desarrollo guiado por especificaciones para constructores humanistas. Deja de reconstruir tu criterio cada vez que comienzas una nueva sesión con IA.
FAQ
lore is a Claude Code plugin with 5 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes create-area, create-project, save-to-lore. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
> /plugin marketplace add andresanemic/lore-plugin> /plugin install lore@lore-plugin
Repo: andresanemic/lore-plugin

Un kit de desarrollo guiado por especificaciones para constructores humanistas.
Deja de reconstruir tu criterio cada vez que comienzas una nueva sesión con IA.
Todo proyecto desarrollado con inteligencia artificial acumula experiencia adquirida con esfuerzo:
La mayor parte de esa experiencia desaparece.
La siguiente sesión comienza con una comprensión incompleta del proyecto, obligándote a ti —y a tu IA— a redescubrir decisiones que ya habías pagado con tiempo y esfuerzo.
Lore existe para evitar eso.
No generando más documentación,
sino preservando el criterio que debe seguir participando en las decisiones futuras.
La experiencia solo crea valor cuando puede volver a participar en una decisión futura.
Lore es un kit ligero de Spec-Driven Development (SDD) para Claude Code.
Proporciona:
A diferencia de la documentación tradicional, Lore no intenta describirlo todo.
Solo conserva aquello que modifica el comportamiento futuro.
Si una frase no restringe una decisión futura, no es Lore.
La documentación tradicional responde preguntas como:
¿Qué es esto?
¿Cómo se instala?
¿Qué API debo utilizar?
Lore responde una pregunta completamente distinta:
¿Qué aprendimos que nunca deberíamos tener que volver a aprender?
Esa diferencia lo cambia todo:
Todo problema resuelto contiene dos cosas:
La mayoría de la documentación conserva únicamente la primera.
Lore conserva la segunda.
En lugar de registrar acontecimientos, Lore los destila en Pistas Invariantes: pequeñas restricciones que siguen siendo útiles mucho tiempo después de que el contexto original haya desaparecido.
Por ejemplo, en lugar de recordar:
«Tuvimos un problema de hidratación en Next.js.»
Lore conserva:
«Nunca utilices estado del cliente para controlar la opacidad inicial.»
El evento desaparece.
El criterio permanece.
Lore organiza el criterio de cada proyecto en artefactos claramente separados y heredables.
Cada proyecto organiza su criterio utilizando exactamente seis artefactos:
| Artefacto | Propósito | Ubicación |
|---|---|---|
identidad.md | Identidad del proyecto y estándar mínimo de calidad | lore/ |
principios.md | Reglas permanentes de ingeniería y negocio | lore/ |
| Módulos temáticos | Experiencia destilada organizada por dominio | lore/ |
index.md | Mapa de navegación del Lore | lore/ |
FASES.md | Estado actual y hoja de ruta del proyecto | raíz |
CLAUDE.md | Contrato de colaboración y referencias operativas | raíz |
Los nombres mostrados son las formas canónicas en español; en tu idioma se localizan (p. ej.
identity.md,principles.md,PHASES.mden inglés).CLAUDE.md,lore/eindex.mdno cambian nunca. Véase Idioma del Lore.
Cada artefacto tiene una única responsabilidad.
Ninguno duplica a otro.
Lore escala mediante Áreas.
Un Área es una carpeta madre que posee su propio Lore.
Los proyectos heredan ese criterio en lugar de copiarlo:
Desarrollo/
│
├── lore/
│
├── Proyecto A/
│ └── lore/
│
├── Proyecto B/
│ └── lore/
│
└── Proyecto C/
└── lore/
Los criterios generales existen una sola vez.
Cada proyecto conserva únicamente aquello que le pertenece.
Así el sistema permanece DRY sin perder la experiencia acumulada.
Lore opera mediante cinco skills para Claude Code.
using-lorePunto de entrada.
Explica el modelo de Lore y te guía hacia el skill adecuado.
create-areaCrea una nueva Área con su propio Lore compartido.
create-projectCrea un proyecto dentro de una Área.
Los proyectos heredan el criterio del Área en lugar de duplicarlo.
save-to-loreEl flujo más importante.
Después de resolver un problema realmente valioso:
«save to lore»
El skill extrae el criterio detrás de esa solución.
Dispone de dos modos, que se eligen según de dónde viene el criterio:
| Modo | Fuente | Qué hace |
|---|---|---|
| capture (por defecto) | fricción vivida: un bug, un colapso, un cliente que rechaza | Destila la cicatriz en una Pista Invariante. |
| arbitrate | criterio importado: una skill, una guía de estilo, un manual ajeno | Juzga ese criterio contra la finalidad de tu proyecto. Solo entra lo que sobrevive. |
La ley del modo
arbitrate: un criterio ajeno no se destila, se arbitra.Una skill es criterio ya destilado por otro, bajo otra finalidad, y llega sin declarar dónde deja de valer. Copiarla al Lore produce literatura redundante con la autoridad de una Pista Invariante: criterio que nadie pagó con experiencia propia.
Por eso el modo
arbitratetiene un HARD-GATE de salida: el módulo resultante debe registrar dónde la fuente contradice tu estándar y pierde. Sin esa sección, no entra — o no hubo arbitraje (fue una copia), o la fuente no traía criterio.Lo que la fuente pierde vale más que lo que la fuente aporta: el resumen ya existe, y mejor escrito, en la fuente. El desacuerdo no existe en ningún otro lado.
Dos avisos que el modo arbitrate te dará:
identidad.md está vacío, no tienes vara con que medir:
frente a una fuente con autoridad, lo único que puedes hacer es obedecerla. Primero la identidad,
después la fuente.transmute-loreMigra proyectos existentes hacia la arquitectura Lore.
Dispone de tres modos:
El Lore habla tu idioma.
Los skills están escritos en inglés, pero el Lore que generan no: tanto el contenido como los nombres de los artefactos se escriben en el idioma en el que trabajas. identidad.md, principios.md, FASES.md son las formas canónicas en español; en inglés, por ejemplo, serían identity.md, principles.md, PHASES.md.
Lo que permanece fijo en todos los idiomas:
CLAUDE.md (convención de Claude Code), lore/ (el nombre del kit), index.md y golden-paths.md;Dentro de un Área o proyecto existente, mandan los nombres ya establecidos: nunca se mezclan esquemas. Si un Lore quedó en el idioma equivocado —o mezclado—, se estandariza con transmute-lore (modo translate), que traduce contenido y renombra artefactos a la vez.
/plugin marketplace add andresanemic/lore-plugin
/plugin install lore@lore-plugin
Lore es, en esencia, Markdown.
Cada skill está compuesto por:
El empaquetado del plugin es específico de Claude Code.
La arquitectura de Lore no lo es.
Puedes adaptar Lore copiando cualquier skill a la herramienta de IA que prefieras.
Este README cubre la motivación y la arquitectura. Para el resto, hay tres documentos dedicados (en español e inglés), en la raíz del repositorio:
| Documento | Para qué sirve |
|---|---|
USAGE_es.md / USAGE_en.md | Guía práctica de uso día a día: instalación, ciclo de trabajo, y cada skill con ejemplos. |
REFERENCE_es.md / REFERENCE_en.md | Referencia técnica: conceptos, especificación exacta de cada artefacto y cada skill. |
MIGRATION_es.md / MIGRATION_en.md | Cómo migrar un proyecto existente hacia Lore con transmute-lore. |
lore-plugin/
.claude-plugin/
plugin.json
marketplace.json
skills/
using-lore/
create-area/
create-project/
save-to-lore/
transmute-lore/
README.md
LICENSE
Todos los skills siguen las mismas reglas:
Un README explica un proyecto.
Lore modifica cómo se trabajará en el futuro.
| README | Lore |
|---|---|
| Explica el proyecto | Restringe decisiones futuras |
| Almacena información | Preserva criterio |
| Está escrito para humanos | Es compartido entre humanos e IA |
| Describe el pasado | Da forma al futuro |
En los videojuegos, el lore es aquello que da coherencia a un universo.
No son las mecánicas.
Es la historia acumulada.
Las reglas que siguen influyendo en todo lo que puede ocurrir después.
Lore aplica esa misma idea al desarrollo de software.
Transforma la experiencia en criterio compartido.
Los acontecimientos originales dejan de ser importantes.
El criterio permanece.
Lore nació como una destilación de LUS (Lore User System), un programa de investigación que estudia cómo un ser humano y una IA acumulan criterio compartido a lo largo de una colaboración prolongada.
LUS estudia la relación.
Lore es una implementación operativa surgida de esa investigación.
Su principio central puede resumirse en una sola idea:
La experiencia solo crea valor cuando puede volver a participar en una decisión futura.
El objetivo de Lore es convertir esa idea en una práctica cotidiana para el desarrollo asistido por IA.
Entre las principales influencias del programa se encuentran:
Puedes explorar la investigación detrás de Lore en el NotebookLM de LUS:
Lore no se diseñó en una pizarra: cada decisión de este kit salió de aplicarlo a proyectos reales y mirar qué se rompía. LUS documenta esas aplicaciones como casos de estudio. Estos son los cuatro que hoy sostienen el diseño del plugin.
Estatus: son casos, no demostraciones. n pequeño y las cuatro evidencias documentadas vienen del mismo investigador. Lo que aquí se afirma restringe cómo usamos el kit; no pretende ser una ley.
Un proyecto real (numerología) construido con Lore de principio a fin, sobre una práctica de desarrollo disciplinado (SDD). Mostró que la arquitectura de seis artefactos aguanta un proyecto completo, no solo notas sueltas: el criterio se acumula, se consulta y sigue decidiendo meses después.
Cuatro proyectos de un área real (desarrollo web) llevados al estándar con transmute-lore. Dejó
tres cosas que hoy son ley del kit:
add): un proyecto que nació sin Lore ya tenía criterio
disperso en comentarios, decisiones y cicatrices. No se inventa: se rescata.clean): los módulos genéricos viven una sola vez, en el
Área. En un proyecto, el clean borró 7 módulos redundantes (−866 líneas) sin perder nada: el
criterio no desapareció, cambió de dueño.Frontera declarada: los cuatro proyectos eran del mismo dominio. La transferibilidad entre dominios sigue siendo promesa, no evidencia.
El caso que originó el modo arbitrate de save-to-lore. Tres áreas destilaron Lore a partir de
skills de terceros, y lo observado contradijo la intuición:
Frontera declarada: las tres áreas son del mismo usuario, con la misma herramienta. El mecanismo está observado, no probado a escala.
El primer caso que cruza de software a otra disciplina. Dos áreas ajenas al desarrollo —periodismo (redacción de noticias) y estrategia de contenido (community management)— ya tenían Lore destilado real, no andamiaje: módulos temáticos derivados de trabajo real (la anatomía de una nota publicable, el cómo de una estrategia de marca), consultados por proyectos reales.
Frontera declarada: el criterio no viajó de software a periodismo — cada Lore nació fresco en su disciplina. Lo que se replica es el mecanismo, no un criterio concreto transportado entre dominios.
Aparte de los casos documentados: el repositorio ya acumula 400+ clonaciones (316 personas únicas, según la API de tráfico de GitHub). Es una señal de alcance, no una demostración — no hay evidencia de qué hizo cada quien con su copia. No cuenta como caso; no sustituye la pregunta que los casos sí responden.
A specification‑driven development kit for humanist builders.
Stop rebuilding your criteria every time you start a new session with AI.
Any project developed with artificial intelligence accumulates hard‑won experience:
Most of that experience disappears.
The next session starts with an incomplete understanding of the project, forcing you —and your AI— to rediscover decisions you already paid for with time and effort.
Lore exists to prevent that.
Not by generating more documentation,
but by preserving the criteria that must keep participating in future decisions.
Experience only creates value when it can participate in a future decision.
Lore is a lightweight Spec‑Driven Development (SDD) kit for Claude Code.
It provides:
Unlike traditional documentation, Lore does not try to describe everything.
It only preserves what changes future behavior.
If a sentence does not constrain a future decision, it is not Lore.
Traditional documentation answers questions like:
What is this?
How do I install it?
Which API should I use?
Lore answers a completely different question:
What did we learn that we should never have to learn again?
That difference changes everything:
Every solved problem contains two things:
Most documentation preserves only the first.
Lore preserves the second.
Instead of recording events, Lore distills them into Invariant Clues: small constraints that remain useful long after the original context has disappeared.
For example, instead of remembering:
“We had a hydration issue in Next.js.”
Lore keeps:
“Never use client‑side state to control initial opacity.”
The event disappears.
The criteria remain.
Lore organizes each project’s criteria into clearly separated and inheritable artifacts.
Each project uses exactly six artifacts:
| Artifact | Purpose | Location |
|---|---|---|
identidad.md | Project identity and minimum quality standard | lore/ |
principios.md | Permanent engineering and business rules | lore/ |
| Thematic modules | Distilled experience organized by domain | lore/ |
index.md | Navigation map for Lore | lore/ |
FASES.md | Current state and project roadmap | root |
CLAUDE.md | Collaboration contract and operational references | root |
The names shown are the Spanish canonical forms; in your language they localize (e.g.
identity.md,principles.md,PHASES.mdin English).CLAUDE.md,lore/, andindex.mdnever change. See Lore Language.
Each artifact has a single responsibility.
None of them duplicates another.
Lore scales through Areas.
An Area is a parent folder that owns its own Lore.
Projects inherit that criteria instead of copying it:
Development/
│
├── lore/
│
├── Project A/
│ └── lore/
│
├── Project B/
│ └── lore/
│
└── Project C/
└── lore/
General criteria exist only once.
Each project keeps only what belongs to it.
This keeps the system DRY without losing accumulated experience.
Lore operates through five skills for Claude Code.
using-loreEntry point.
Explains Lore’s model and guides you to the appropriate skill.
create-areaCreates a new Area with its own shared Lore.
create-projectCreates a project inside an Area.
Projects inherit the Area’s criteria instead of duplicating it.
save-to-loreThe most important flow.
After solving a genuinely valuable problem:
“save to lore”
The skill extracts the criteria behind that solution.
It has two modes, chosen by where the criteria comes from:
| Mode | Source | What it does |
|---|---|---|
| capture (default) | lived friction: a bug, a collapse, a client rejection | Distills the scar into an Invariant Clue. |
| arbitrate | imported criteria: a skill, a style guide, a third-party playbook | Judges that criteria against your project's purpose. Only what survives gets in. |
The law of
arbitratemode: external criteria is not distilled — it is arbitrated.A skill is criteria already distilled by someone else, under someone else's purpose, and it arrives without declaring where it stops being valid. Copying it into your Lore produces redundant literature wearing the authority of an Invariant Clue: criteria nobody paid for with real experience.
That is why
arbitratehas an exit HARD GATE: the resulting module must record where the source contradicts your standard and loses. No defeats section, no entry — either nothing was arbitrated (it was a copy), or the source carried no criteria at all.What the source loses is worth more than what the source offers: the summary already exists, better written, in the source. The disagreement exists nowhere else.
Two warnings arbitrate mode will give you:
identidad.md is empty, you have no yardstick: facing an
authoritative source, all you can do is obey it. Identity first, source second.transmute-loreMigrates existing projects into Lore’s architecture.
It has three modes:
Lore speaks your language.
The skills are written in English, but the Lore they generate is not: both the content and the artifact filenames are written in the language you work in. identidad.md, principios.md, FASES.md are the Spanish canonical forms; in English, for example, they become identity.md, principles.md, PHASES.md.
What stays fixed in every language:
CLAUDE.md (a Claude Code convention), lore/ (the kit’s own name), index.md, and golden-paths.md;Inside an existing Area or project, the established names win: naming schemes are never mixed. If a Lore ended up in the wrong language —or mixed— it is standardized with transmute-lore (translate mode), which translates content and renames artifacts together.
/plugin marketplace add andresanemic/lore-plugin
/plugin install lore@lore-plugin
At its core, Lore is Markdown.
Each skill is made of:
The plugin packaging is specific to Claude Code.
Lore’s architecture is not.
You can adapt Lore by copying any skill into the AI tool of your choice.
This README covers motivation and architecture. For everything else, there are three dedicated documents (in Spanish and English), at the repository root:
| Document | What it's for |
|---|---|
USAGE_en.md / USAGE_es.md | Practical day‑to‑day usage guide: installation, core loop, and each skill with examples. |
REFERENCE_en.md / REFERENCE_es.md | Technical reference: core concepts, the exact spec for each artifact and each skill. |
MIGRATION_en.md / MIGRATION_es.md | How to migrate an existing project into Lore using transmute-lore. |
lore-plugin/
.claude-plugin/
plugin.json
marketplace.json
skills/
using-lore/
create-area/
create-project/
save-to-lore/
transmute-lore/
README.md
LICENSE
All skills follow the same rules:
A README explains a project.
Lore changes how future work will be done.
| README | Lore |
|---|---|
| Explains the project | Constrains future decisions |
| Stores information | Preserves criteria |
| Written for humans | Shared between humans and AI |
| Describes the past | Shapes the future |
In video games, lore is what gives a universe coherence.
It is not the mechanics.
It is the accumulated story.
The rules that keep influencing everything that can happen afterwards.
Lore applies that same idea to software development.
It turns experience into shared criteria.
The original events stop being important.
The criteria remain.
Lore was born as a distillation of LUS (Lore User System), a research program that studies how a human and an AI accumulate shared criteria over a long‑term collaboration.
LUS studies the relationship.
Lore is an operational implementation that emerged from that research.
Its core principle can be summarized in a single idea:
Experience only creates value when it can participate in a future decision.
Lore’s goal is to turn that idea into everyday practice for AI‑assisted development.
Some of the main influences behind the program are:
You can explore the research behind Lore in the LUS NotebookLM:
Lore was not designed on a whiteboard: every decision in this kit came from applying it to real projects and watching what broke. LUS documents those applications as case studies. These are the four that currently hold up the plugin's design.
Status: these are cases, not proofs. Small n, and all four documented cases come from the same researcher. What they claim constrains how we use the kit; it does not pretend to be a law.
A real project (numerología) built with Lore from start to finish, on top of a disciplined development practice (SDD). It showed that the six-artifact architecture holds up across a whole project, not just scattered notes: criteria accumulate, get consulted, and keep making decisions months later.
Four projects of a real area (web development) migrated to the standard with transmute-lore. It
left three things that are now law in this kit:
add mode): a project born without Lore already had criteria scattered
across comments, decisions, and scars. It is never invented: it is rescued.clean mode): generic modules live once, in the Area. In one
project, clean deleted 7 redundant modules (−866 lines) losing nothing: the criteria did not
disappear, it changed owner.Declared boundary: all four projects were in the same domain. Transferability across domains remains a promise, not evidence.
The case that produced save-to-lore's arbitrate mode. Three areas distilled Lore from third-party
skills, and what we observed contradicted the intuition:
Declared boundary: all three areas belong to the same user, using the same tool. The mechanism is observed, not proven at scale.
The first case that crosses from software into another discipline. Two areas outside development — journalism (news writing) and content strategy (community management) — already had real distilled Lore, not scaffolding: thematic modules derived from real work (the anatomy of a publishable article, the how-to of a brand strategy), consulted by real projects.
Declared boundary: criteria did not travel from software to journalism — each Lore was born fresh in its own discipline. What replicates is the mechanism, not a concrete criterion transported across domains.
Beyond the documented cases: the repository has already been cloned 400+ times (316 unique cloners, per GitHub's traffic API). That's a reach signal, not a demonstration — there's no evidence of what anyone did with their copy. It doesn't count as a case; it doesn't answer the question the cases do.
.claude-plugin/
marketplace.json
plugin.json
.github/
ISSUE_TEMPLATE/
feature_request.md
workflows/
traffic.yml
CODE_OF_CONDUCT.md
data/
traffic/
clones.json
LICENSE
MIGRATION_en.md
MIGRATION_es.md
README.md
REFERENCE_en.md
REFERENCE_es.md
skills/
create-area/
SKILL.md
create-project/
SKILL.md
save-to-lore/
SKILL.md
transmute-lore/
SKILL.md
using-lore/
SKILL.md
USAGE_en.md
USAGE_es.md© 2026 Flowy · Free and open source
Built for Claude Code · Not affiliated with Anthropic