Skip to content

Latest commit

 

History

250 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lore

Language / Idioma: English | Español

Lore

Version AI provider: neutral Validated against writing-skills spec-kit compatible Local fine-tuning Obsidian compatible Status

Stop explaining your project to the AI every morning.
Lore keeps the criteria behind your decisions and loads it into the next session.


Read in English

The problem

Every session starts blank: everything you taught the agent yesterday — every correction, every back-and-forth — gets erased, and you open the next one explaining the project again. Your Lore is where that stays.

In Groundhog Day (Harold Ramis, 1993), Phil Connors wakes up to the same radio every February 2nd and nobody in town remembers a thing about yesterday — only him. Your agent is the town, not Phil: every session opens on that same morning, and the one who walks in carrying the memory is you, again, for free.

Meanwhile, the things you actually paid to learn keep piling up: architecture decisions, production incidents, failed experiments, dozens of "let's never do that again" moments. That is the real cost — and none of it survives the session.

It is a loop of re-explanations and mediocre solutions you had already rejected. Lore calls this ephemeral experience: the facts may survive, but the learning never became a reusable structure.


+44.5 points of cross-domain first-pass compliance.

An SDD kit that gives you local fine-tuning for your own tasks — and the one doing the training is you.


Start

The problem · What is Lore · Who can use it · Start building · Benchmark · Installation

Use it

Architecture · The eight skills · Obsidian · Documentation

Understand it

Shared invariants · Case studies · Reach · Origin


What is Lore?

A lightweight, provider-neutral Spec-Driven Development kit for AI agents. Or, in one line: local fine-tuning for your own tasks, and the one doing the training is you.

The same destination as a fine-tune, by the other road

A fine-tune conditions a model on thousands of examples until it stops answering like a generalist. Lore gets to the same place from the other side: one written constraint per thing that went wrong. No training happens and no weights move, so your criteria stays as plain text you can read, correct in one line, and carry to a different model tomorrow.

A fine-tune stops asking things of you the day it ships. Lore never stops: one distillation, every time something breaks. That is the cost, and it is worth knowing before you install anything.

What it provides

Three things:

  • a simple convention for organizing a project's criteria;
  • eight skills that operate that convention;
  • and a continuous loop for distilling experience into reusable criteria.

Spec-driven is not a label here: one contract per project (CLAUDE.md or AGENTS.md, whichever your host reads), FASES.md for where the work stands, lore/ for what constrains how it gets built.

You can start from what you already have

In ADD mode, transmute-lore reads what you already have — project folders, documents, exported chat summaries, loose notes — and proposes the criteria, canon and routing hidden inside. Sources remain sources: nothing becomes Lore until you approve the distillation.

When that criterion needs to travel, CRYSTALLIZE creates a traceable single-Markdown “memory card”: portable across models, usable wherever Markdown instructions are accepted, shareable on your terms and extractable back into a working folder. It is a snapshot, never a replacement for the live Lore.

What it does not promise

That the work will come out right. Accumulated criteria does not end uncertainty: it only shrinks the space of ways to be wrong. Albert Camus, in The Myth of Sisyphus (1942), argued that the absurd is not solved but inhabited, and the line this kit takes from him is its own: a system of criteria does not reduce the absurd; it knows what to do when the absurd shows up. Lore does not promise the deploy holds. It promises there is a next step for the morning it does not, and that you chose that step back when you still had time to think.

The only filter

Lore does not try to describe everything — that is what documentation is for. It preserves what changes future behavior. A README answers "what is this?"; Lore answers something else: What did we learn that we should never have to learn again?

If a sentence does not constrain a future decision, it is not Lore. That rule is the whole filter, and it is what keeps the system from becoming another graveyard of documents.

The filter is borrowed, and it is worth naming its owner. Gregory Bateson, in Steps to an Ecology of Mind (1972), defined information as "a difference that makes a difference": a difference that changes nothing downstream is not information, it is noise. Lore applies that test to experience. What happened yesterday only becomes criteria if it would change what you do tomorrow — everything else is a log.


Who can use Lore Plugin?

  • Professionals early in working with AI — if you want what you learn to compound instead of evaporating, start here: a professional memory card that outlasts any project or model, where your professional criterion refines how real work gets done.
  • People who read the benchmark before anything else, willing to try something that is not mainstream yet if the numbers hold up.
  • Researchers curious about LUS itself — less the kit than the question behind it: what changes when a person and an AI accumulate criteria together over time. Lore is where that question gets answered one decision at a time.
  • Teams already running spec-kit, SDD pipelines or another automation framework. Those manage process — constitution, plan, tasks, quality gates — and none asks whether the knowledge behind those gates is still alive. That gap is what MYCELIUM and PRUNE close, and Lore runs alongside spec-kit rather than replacing it (see SPEC_KIT_en.md).

The LUS hypothesis this kit tests: a richer, more stable human–AI Between can mean fewer repeated mistakes and better work, at less cost.

The word is Martin Buber's, from I and Thou (1923): what matters does not live inside either party but in the relation between them. This kit takes the structure, not the theology — what accumulates here is neither yours nor the model's: it is the criteria the two of you built.


Start building your Lore

Every solved problem contains two things: the solution, and the reason that solution exists. Documentation keeps the first. Lore keeps the second.

Instead of recording what happened, it distills it into an Invariant Clue: a small constraint that stays useful long after the original context is gone.

Instead of remembering Lore keeps
"The AI wrote a report that was too technical for the reader" "Before drafting, identify who will read it and explain every unfamiliar term in plain language"
"A meeting summary omitted who was responsible for each task" "Every meeting summary ends with each task, its owner and its deadline"

The event is forgotten. The criteria keeps working.

The loop

Lore

Every step of the loop moves the same way: it is proposed, you approve, and only then is it written. That gate is the threshold, and it is the reason nothing reaches your Lore that you did not read first.

The shape behind that gate has a name. Andy Clark and David Chalmers called it the extended mind ("The Extended Mind", 1998): an external store stops being a filing cabinet and starts participating in the thinking when the system reaches for it by default and trusts what it finds. Documentation sits beside the work; Lore is loaded before the work starts — reaching for it is not a step you remember to take, it is how the work begins.

And the process has a name too. Gilbert Simondon called it transduction: an operation that advances through a domain step by step, each phase founded on the structuration of the one before. One distillation is exactly that — friction crystallizes into a constraint that changes the next interaction, and then the next, until the accumulated structure becomes a body of criteria no one ever designed in advance: your Lore.

So that is the mechanism: not documentation, not a memory dump — a threshold between what happened and what gets to constrain tomorrow. The next section takes you from zero to a running install.


Installation

Pick the route that matches your setup — just don't mix hosts. Claude Code and Codex install through each host's plugin manager, which verifies the package. OpenCode, Cursor and Antigravity below are manual copies — the install is only as good as the copy, confirmed by hand.

Claude Code

Run these commands inside Claude Code:

/plugin marketplace add andresanemic/lore-plugin
/plugin install lore@lore-plugin

Or run their CLI equivalents from a terminal:

claude plugin marketplace add andresanemic/lore-plugin
claude plugin install lore@lore-plugin

Codex CLI

Run these commands in your terminal:

codex plugin marketplace add andresanemic/lore-plugin
codex plugin add lore@lore-plugin
Other hosts — manual copy, unverified (OpenCode, Cursor, Antigravity, direct install)

OpenCode

From a local clone, copy Lore's eight skill folders into OpenCode's global directory:

mkdir -p ~/.config/opencode/skills
cp -R skills/* ~/.config/opencode/skills/

Restart OpenCode. For one project, use .opencode/skills/ instead.

Cursor

Cursor already discovers skills installed under ~/.codex/skills/ or ~/.agents/skills/. To keep a separate Cursor copy, use its global directory and restart Cursor:

mkdir -p ~/.cursor/skills
cp -R skills/* ~/.cursor/skills/

Google Antigravity

Antigravity loads global skills from ~/.gemini/config/skills/ and workspace skills from .agents/skills/. From a local clone:

mkdir -p ~/.gemini/config/skills
cp -R skills/* ~/.gemini/config/skills/

Restart Antigravity after copying them.

Direct install from the repository

Use this provider-neutral route when you prefer a local clone or want to prepare both CLIs. It requires Git and Node.js:

git clone https://github.com/andresanemic/lore-plugin.git
cd lore-plugin
node scripts/lore-plugin.mjs install --target all
codex plugin add lore@personal

Replace all with claude or codex to target only one CLI. The installer configures Claude directly; for Codex it prepares the local personal marketplace and prints the final codex plugin add command.

Then open a new CLI session. If this is your first time, you do not need to know a single command — write «I want to start using Lore Plugin, help me» and the kit opens a brainstorming, not a menu: it looks at your tree first, asks one question at a time, and ends with your first artifact created, never with a recommendation. If you already know what you want, use-lore routes you.

One question at a time is not a courtesy, and a form would be faster. The questions are what keep you and the model two things instead of one — no fusion, and no sparing each other the friction — long enough for an answer neither of you had alone.

What it looks like in practice

You just shipped a landing page and the feedback is: "I didn't know what to do on the page." The CTA was below the fold and the headline talked about the product, not the outcome. You fixed it. Instead of closing the tab:

› save to lore
  Distilled this:

  [cta] CTA not visible — headline without outcome

  Context ······· landing page had the CTA below the fold
  Root cause ···· headline described the product, not the
                  result for the reader
  Clue ·········· place the main CTA above the fold and
                  write the headline around the outcome,
                  not the feature
  Confidence ···· confirmed — fixed on live page

  → projects/client-a/lore/cta.md
  → this clue is generic and confirmed: promote it to the Area
    so the other 3 projects see it?

  Write it?

Three months later, another project in the same Area ships a landing page. The criteria is already loaded, so that mistake does not happen again.

None of it was written without a human saying yes. The same gate governs all eight skills.


Architecture

The six pieces

Every project organizes its criteria and state into six structural pieces. They are not necessarily six files: thematic modules are one piece, implemented across as many focused files as the work requires.

Piece What it holds Where
identidad.md What the project is, its purpose and its quality floor lore/
principios.md Invariant laws, technical and business: prohibitions and imperatives lore/
Thematic modules Technical scars by domain (animation, layout, scroll…) lore/
index.md Navigation map: one line per pattern lore/
FASES.md State and roadmap: current phase, focus root
CLAUDE.md or AGENTS.md One collaboration contract, selected by primary host and slimmed to pointers root

Each has one responsibility. None duplicates another.

Lore is criteria (it persists); FASES.md is state (it advances). They never mix, and FASES.md never lives inside lore/.

They are kept apart because they age at different speeds: who you are and how you work stay true next month; which phase the project is in does not. Mixing them means re-reading a document where half the sentences expired and nothing says which half.

The canonical names are Spanish; in your language they are localized.

The always-on block

The contract is the only artifact both hosts load without being asked, which is why Lore stamps a delimited pointer section into it — the kit's always-on channel to the session.

The exact mechanics (ceiling, variants, how it gets stamped)
<!-- lore:always-on -->
…what Lore governs here · where it lives · where the state lives · when to invoke instead of writing by hand…
<!-- /lore:always-on -->

Four items and no more, under a hard ceiling of 25 lines. It points to lore/ and to FASES.md — criteria and state live apart, but the session that receives them can only read once. An agent that gets the criteria without the phase will propose the right thing at the wrong time. The block never reproduces a clue. If a variant does not fit, move content into lore/; do not raise the ceiling.

Three variants: an area points to its own lore/; a project points to its own layer and to its mother area's; a bot points to canon/ and to its routing table — never to the federated Lores one by one. That is why a bot that reaches twenty bodies of criteria still fits.

The owning skills stamp it idempotently inside their existing threshold; UPGRADE adds it to older contracts. Hand-edited divergence is reported, never overwritten.

Area → Project inheritance

Lore scales through Areas. An Area is a mother folder with its own Lore, and projects inherit it instead of copying it:

web-development/
│
├── lore/                      ← general criteria lives ONCE
│     identity · principles · index · animation · scroll · layout
│
├── PHASES.md                  ← the Area's project registry
├── CLAUDE.md or AGENTS.md     ← the Area's one host-selected contract
│
└── projects/
    ├── client-a/
    │   └── lore/              ← only its own; the index points at the Area
    ├── client-b/
    │   └── lore/
    └── client-c/
        └── lore/

Fix a generic clue once in the Area and every project sees it. Each project keeps only what is truly its own — the system stays DRY without losing accumulated experience.

The third shape: a bot

Area Project Bot
Holds projects one piece of work a work session
Its Lore governs the domain's method that work how the agent behaves
Opened to see the registry advance that work work on any of several projects

Areas and projects are places; a bot is a lens you carry into them. An Area that collects criteria it never earned starts receiving promotions that belong somewhere else.


The eight skills

This kit moves with Superpowers' writing-skills discipline, not past it. Every skill is checked against it before it ships, every time it changes.

The skills are written in English; the Lore they produce is not — content and filenames included, in your language. The English in a SKILL.md is the portable substrate that lets the kit run on other hosts, not the language of the kit. Do not open one to explain a mode to someone (we learned this in Case 12, live) — that is what the table and the two docs below are for.

Skill What for When
use-lore Entry point: explains the model and routes you to the right skill first, always
brainstorming-lore Designs changes to Lore artifacts without colliding with general-purpose brainstorming skills before creating or materially restructuring Lore
create-area Creates an Area with its shared Lore opening a new domain
create-project Creates a project that inherits from the Area starting a piece of work
save-to-lore Distills a lesson and decides whether it rises to the Area every day
transmute-lore Migrates, cleans, translates, upgrades, prunes or exports a safe snapshot of Lore inheriting, maintaining, updating or sharing Lore
create-bot One place to open a session and work across several Areas at once from zero, or once there is Lore to federate
obsidian-lore Mines loose notes and routes what survives once the inbox gets heavy

Day one needs two of these: use-lore routes you to whatever comes next, and save-to-lore is the one you will actually type — "save to lore", after solving something that cost you. How to use each one, with worked examples, lives in USAGE_es.md; the full mechanism for each mode lives in REFERENCE_es.md.

What each skill does

use-lore

2.0 rename: using-lore is now use-lore. Remove the old name when updating; duplicate entry points make routing ambiguous.

The entry point — explains the model and routes you to the right skill. Read it before invoking any other. For complex deliverables it fixes the owner project, the routed Lore and an approved precedent before work starts.

brainstorming-lore

The kit's own design conversation for Lore artifacts — narrow on purpose, one decision at a time; create-area, create-project, create-bot and structural transmute-lore modes inherit its contract.

save-to-lore

The daily flow: solve something that cost you, type "save to lore" — candidates stay parked until a milestone, where destination, wording and why-now are shown before anything is written. Specific lessons stay in the project; generic confirmed ones are proposed for the Area; nothing promotes automatically. Two modes: capture distills lived friction into an Invariant Clue; graft arbitrates imported criteria against your project's purpose and records where the source loses. A skill that only executes is a dependency, not Lore.

transmute-lore

Operates existing Lore in eight modes: add rescues scattered criteria into the six-piece architecture; clean removes what the Area already owns; translate standardizes language without changing meaning; upgrade sorts findings into Missing, Superseded, Earned or Stale; prune does the same against a Lore decayed by accumulating correct things; mycelium (2.3.0) reports clues no step runs; leave removes governance but keeps lore/, reversible; crystallize exports a safe single-Markdown snapshot. The Reference carries the full gates for each.

create-bot

One place to work across several Areas at once — federating. Think of a blockchain lab: website, social media, research, technology transfer, each already an Area with its own Lore; a bot routes them all into one folder. It does not answer questions about the projects: it works in them.

Its north, and the only test that matters: a short instruction is enough. If the project had to be explained to the bot to get the result, criteria were missing from the load.

Two modes: nuevo builds provisional canon from a brainstorm, refined through a reviewed first victory; federar routes to criteria that already exists — raw folders earn real Lore in their own Area first, adopted by path, without moving it. Three bodies never merge: canon/ is what the bot is, lore/ maintains it, borrowed criteria stays per project — federating is pointing, not copying.

Optional Lore encryption remains experimental and off by default; see ENCRYPTION.md.


Obsidian notes

Point Obsidian at the mother folder of your Areas and add a notes/ (or notas/) folder inside any project, Area or bot — the same tree is your workspace and your vault. When you want the AI to read what you left there, run:

"review my Obsidian notes and see what belongs in my lore"

obsidian-lore scans the folder, separates criteria from tasks and noise, proposes the owning Lore and waits for your approval. It marks each mined note with date and destination and never deletes it. A bot routes notes more reliably because it already knows each project's purpose. A note is source, never criteria — nothing crosses without explicit distillation and an approved diff.


Shared invariants

All eight skills follow the same rules:

  • Lore is written in your language.
  • Criteria is never invented. Everything comes from real experience.
  • A note is source, never criteria.
  • Discarded noise is reported, never silently deleted.
  • Every change passes a threshold before being written.
  • Nothing commits automatically. You review the final diff.

Those last two are the whole bet. Agent frameworks increasingly keep a memory of their own successes and failures and generate reusable skills from the patterns they find — a real capability, and the opposite choice: there, the agent gets better; here, the person does. Lore's criteria live in files you own, in your language, and nothing enters them without your approval with the content in view. If you want a system that learns behind your back, this is not it, and it never will be.

These rules were not designed in the abstract — one was bought. A README asked to shrink by 40% came back cut by nearly 80%: the instruction had stopped being a floor anyone could stand on, and collaborating had quietly turned into supervising. The six rules above exist to make that afternoon structurally impossible.


Benchmark

Audited Lore benchmark: 44.5 points more cross-domain first-pass compliance, every measured goal reached and 15.2 percent less observed time

Lore acts as stability infrastructure when the domain changes. The result weighs Web work and Editorial work (community management, news writing) equally, so a good Web run cannot hide a bad Editorial one. Same model, prompt and tools on both arms — gpt-5.6-sol, medium reasoning effort. Lore reached every goal it was measured on. On Web alone (72 runs): Cold Codex 25/36 (69.4%), Codex + Lore 33/36 (91.7%).

The harness, frozen tasks, graders, raw outputs and declared limits are in bench/. These are Codex results, not a universal model claim.


Documentation

This README covers motivation and architecture. Everything else lives in its own document:

Document What it's for
90_SECONDS_en.md Start here. The whole mechanism, short enough to read before deciding whether to install anything.
USAGE_en.md Practical day-to-day usage guide: installation, core loop, and each skill with examples.
REFERENCE_en.md Technical reference: core concepts, the exact spec for each artifact and each skill.
MIGRATION_en.md How to migrate an existing project into Lore using transmute-lore.
ENCRYPTION.md The optional, experimental encryption for a bot's criteria: what it protects and what it does not.
CASES_en.md The eighteen case studies, each with its declared boundary.
SPEC_KIT_en.md Lore alongside GitHub's spec-kit: who governs what. Optional — Lore never depends on it.
bench/ The benchmark: Web, Editorial and UPGRADE harnesses; frozen tasks; method; declared limits; and raw results.

Case studies

Lore was not designed ahead of time: every decision came from applying it to real projects and watching what broke — documented as eighteen case studies, each with its declared boundary, several turning the kit on itself. Case 12 is the first install run by someone who is not the author.

Status: cases, not proofs — small n, and seventeen of the eighteen come from the same researcher (Case 12 is the exception). They constrain how we use the kit; they do not pretend to be law. The measured claim belongs to Case 08 and its benchmark; the rest are qualitative evidence.

Read the eighteen case studies →


Reach

1,000+ clones and counting

1,916 clones 50 days 38 a day 225 peak

GitHub traffic windows preserved in data/traffic/clones.json.

Lore Plugin is the technical arm of LUS, not a productivity system with philosophy attached — the LUS hypothesis, only partly tested by the benchmark, is above.

Morin gives this work its ethical north: in UNESCO's Seven Complex Lessons in Education for the Future he writes that “the notion of wager should be generalized to every faith” (our translation) — giving up the best of all worlds is not giving up a better world. Lore makes that wager actionable through projects and bots; evidence stays bounded to what was measured.

A reach signal, not a demonstration. Nobody knows what anyone did with their copy — installed, distilled, opened once? It is no case, and answers none of the questions the case studies do. And the API's "unique cloners" are unique per day, not people: they cannot be summed into a headcount.


Origin

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 its operational implementation. One idea sums up its core principle:

Experience only creates value when it can participate in a future decision.

That makes us gardeners of the Between: the shared space where a human and an AI change what the other can do next. We do not preserve every experience. We cultivate the ones that deserve to orient another decision, prune what no longer constrains anything, and keep the trace of what was discarded. Lore is not the garden; it is the practice that keeps this shared ground alive.

The research and the software remain separate: an observation from using Lore is not automatically a scientific result, and a research hypothesis does not become a skill rule without evidence and review.

The program began with a foundational bibliography whose concepts map directly onto the practice:

  • Martin Buber · Ich und Du (1923) — the Between: knowledge emerges in the relation, not in the prompt or the model alone.
  • Louis Althusser · "Ideology and Ideological State Apparatuses" (1970) — interpellation: the AI does not merely answer; it calls the human into a position of judgment and responsibility.
  • Gilbert Simondon · Individuation in Light of Notions of Form and Information (1958) — transduction: friction crystallizes into a structure that changes the next interaction.
  • Claude Shannon and Warren Weaver · The Mathematical Theory of Communication (1949) — signal, entropy and noise: why raw logs are filtered into Context, Root cause and Invariant Clue.
  • Gregory Bateson · Steps to an Ecology of Mind (1972) — "a difference that makes a difference": the test for whether an experience can constrain a future action.
  • Norbert Wiener · Cybernetics (1948) — feedback: the error from real work returns to stabilize the human–AI system.
  • Edgar Morin · Introduction to Complex Thought (1990) — dialogic and organizational recursion: parts and whole keep reshaping one another. His UNESCO lessons give this work its ethical north.
  • Andy Clark and David Chalmers · "The Extended Mind" (1998) — coupled external memory: Lore can participate in cognition instead of sitting beside it as passive documentation.
  • Hubert Dreyfus · What Computers Still Can't Do (1992) — situated, tacit knowledge: the human friction Lore translates into usable constraints for a general model.
  • Francisco Varela, Evan Thompson and Eleanor Rosch · The Embodied Mind (1991) — enaction: criteria is not stored, it is brought forth by acting.

They are interlocutors, not borrowed authority: LUS uses them to expose convergences, differences and tensions in its claims about the Between, accumulated criterion and Lore.

Extended bibliography

Four interlocutors who widen the frame, and two more that were read straight against LUS — those two carry, inside the entry, where the source loses.

  • Edwin Hutchins · Cognition in the Wild (1995) — distributed cognition: the unit that thinks is the system, not the head inside it.
  • Daniel Wegner · transactive memory (1985) — who remembers what: a pair remembers more than its two members, and only while it knows who holds which part.
  • Karl Weick · Sensemaking in Organizations (1995) — sensemaking: meaning is made retrospectively, which is why a clue is written after the friction and not during it.
  • Heinz von Foerster · Understanding Understanding (2003) — second-order cybernetics: the observer is inside the system being described.
  • Albert Camus · The Myth of Sisyphus (1942) · The Stranger (1942) · The Misunderstanding (1944) · The Rebel (1951) · Summer (1954), for "Helen's Exile" and "The Almond Trees" — entered as criterion, in one affirmation: a system of criteria does not reduce the absurd; it knows what to do when it appears. The play carries it: a mother and sister kill the son who came home because he would not say his name — no malice, no faulty reasoning, only what was known failing to reach where it was decided. Where Camus loses: his mesure is an ethical-political limit on rebellion, not an epistemic rule of routing; he enters as a declared analogy and grounds none.
  • Martin Heidegger · Being and Time (1927) — entered as bibliography, and NOT as criterion. Finitude assumed is what makes an existence authentic, and the intuition it was brought in for is that the Between is finite too. But in Being and Time death is je meines — radically one's own, not shareable — and that incompartibility is the engine of the argument: death individualizes. The unit of LUS is the relation. Adopting it would mean contradicting Heidegger exactly where his thesis rests, and that work is not done. What he leaves open is worth more than anything adoptable today: how can a relation anticipate an ending that neither of its parts can anticipate on the other's behalf?

That is the argued genealogy. The felt one — what shaped taste rather than claims — is separate on purpose:

Affective genealogy — the works that taught the sensibility

Registry, not rule. These works constrain no decision and govern nothing. They are recorded because the aesthetics and the intuitions of a technical artifact are never neutral, and knowing where they came from is what lets someone tell inherited taste from argument the day anybody proposes changing them. It belongs to LUS, not to the kit. Only one still appears in the body of this README, next to what it illustrates: Groundhog Day. The rest were pulled out of the argument and left here, because a work that has to be explained before it illustrates anything is charging the reader for the author's taste.

  • Fire · Waxahatchee (2020) — growing up as moving without the whole picture. What accumulated criteria actually buys: not the end of uncertainty, a smaller space of ways to be wrong.
  • Loving · Land of Talk (2017) — a bond that holds two people without dissolving either of them. The shape behind asking one question at a time.
  • 50 First Dates · Peter Segal (2004) — the video Lucy watches every morning, which works because it hands her identity and state at once and still keeps them apart.
  • "1998" · Chet Faker and BANKS (2015) — the afternoon collaborating turns into supervising, between two people.
  • Tales of Berseria · Bandai Namco (2016) — aesthetic, not conceptual: the art direction of this kit comes from here before any software design reference. Genealogy of the form.
  • Keep Running · Tei Shi — keeping up with who the other is now. Criteria nobody revisits does not go neutral: it keeps operating, on someone who already changed.
  • Running Back to You · The Juan MacLean — autonomy with return (H13). It does not demand constant contact; it demands a point where both catch up before drift makes the shared work unrecognizable.
  • Aliso · Malena Zavala (2018) — "admired, not reset". And on translation: the damage is not in one party, it is in the language two of them broke.

Explore the research in the LUS NotebookLM

How to read it: NotebookLM is the accessible introduction, not the source of record — for what the kit does, this repository wins; for a number, the current benchmark cut.

Why "Lore"?

In video games, lore is the accumulated story and rules that keep a universe coherent — what can and cannot happen next. We borrow the image and shift the weight: specific events fade, and what remains is the criteria that keeps the next work coherent. The visual debt is explicit too: the anime palette comes from Tales of Berseria (Bandai Namco, 2016), the author's favorite game — naming that provenance separates a design decision from inherited taste.

Author

Andrés Peña Mellado — principal researcher of LUS.

Web3 founder of two blockchain projects and community manager at ChatterPay; formerly on the editorial teams of Polkadot Español and BeInCrypto.

He helped establish UTEM's Design Thinking course and taught it from 2023 to 2025. Speaker at KCD El Salvador 2023.

GitHub X LinkedIn Telegram Discord Email


Leer en español

Lore

Language / Idioma: English | Español

Lore

Versión Proveedor IA: neutral Validado contra writing-skills spec-kit compatible Fine-tuning local Compatible con Obsidian Estado

Deja de explicarle tu proyecto a la IA todas las mañanas.
Lore guarda el criterio detrás de tus decisiones y lo carga en la siguiente sesión.


El problema

Cada sesión arranca en blanco: todo lo que le enseñaste al agente ayer —cada corrección, cada ida y vuelta— se borra, y abres la siguiente explicando otra vez el proyecto. Tu Lore es donde eso sí permanece.

En El día de la marmota (Harold Ramis, 1993), Phil Connors despierta con la misma radio cada 2 de febrero y nadie en el pueblo recuerda nada de lo de ayer — solo él. Tu agente es el pueblo, no Phil: cada sesión abre en esa misma mañana, y el único que entra con memoria eres tú, de nuevo, gratis.

Mientras tanto, lo que de verdad te costó aprender se sigue acumulando: decisiones de arquitectura, incidentes en producción, experimentos fallidos, decenas de momentos de «nunca volvamos a hacer esto». Ese es el costo real — y nada de eso sobrevive a la sesión.

Es un bucle de reexplicaciones y soluciones mediocres que ya habías descartado. Lore llama a esto experiencia efímera: los datos pueden sobrevivir, pero el aprendizaje nunca se convirtió en una estructura reutilizable.


+44,5 puntos de cumplimiento multidominio al primer intento.

Un kit SDD que te permite hacer fine-tuning local de tus tareas — y el que entrena eres tú.


Empezar

El problema · Qué es Lore · Quién puede usarlo · Comienza a construir · Benchmark · Instalación

Usarlo

Arquitectura · Las ocho skills · Obsidian · Documentación

Entenderlo

Invariantes · Casos de estudio · Alcance · Origen


¿Qué es Lore?

Un kit ligero y neutral al proveedor de Spec-Driven Development para agentes de IA. O, en una línea: fine-tuning local de tus tareas, y el que entrena eres tú.

El mismo destino que un fine-tune, por el otro camino

Un fine-tune condiciona un modelo con miles de ejemplos hasta que deja de responder como generalista. Lore llega al mismo lugar por el otro lado: una restricción escrita por cada cosa que salió mal. No se entrena nada y ningún peso se mueve, así que tu criterio se queda en texto plano que puedes leer, corregir en una línea y llevarte mañana a otro modelo.

Un fine-tune deja de pedirte cosas el día que está listo. Lore no para nunca: una destilación, cada vez que algo se rompe. Ese es el costo, y conviene saberlo antes de instalar nada.

Qué aporta

Tres cosas:

  • una convención sencilla para organizar el criterio de un proyecto;
  • ocho skills que operan esa convención;
  • y un ciclo continuo para destilar experiencia en criterio reutilizable.

Lo de spec-driven no es una etiqueta: un contrato por proyecto (CLAUDE.md o AGENTS.md, el que lea tu host), FASES.md para dónde está el trabajo, lore/ para lo que restringe cómo se construye.

Puedes empezar desde lo que ya tienes

En modo ADD, transmute-lore lee lo que ya tienes —carpetas del proyecto, documentos, resúmenes de chats exportados, notas sueltas— y propone el criterio, el canon y el enrutamiento que viven dispersos ahí. Las fuentes siguen siendo fuentes: nada se vuelve Lore hasta que apruebas la destilación.

Cuando ese criterio necesita viajar, CRYSTALLIZE crea una «memory card» trazable en un solo Markdown: portable entre modelos, utilizable donde se acepten instrucciones Markdown, compartible en tus términos y extraíble de vuelta a una carpeta de trabajo. Es una fotografía, nunca un reemplazo del Lore vivo.

Qué no promete

Que el trabajo salga bien. El criterio acumulado no termina con la incertidumbre: apenas achica el espacio de maneras de equivocarse. Albert Camus, en El mito de Sísifo (1942), sostuvo que el absurdo no se resuelve sino que se habita, y la línea que este kit toma de ahí es suya propia: un sistema de criterio no reduce el absurdo; sabe qué hacer cuando el absurdo aparece. Lore no promete que el despliegue aguante. Promete que hay un paso siguiente para la mañana en que no aguante, y que ese paso lo elegiste cuando todavía tenías tiempo de pensarlo.

El único filtro

Lore no intenta describirlo todo — para eso está la documentación. Conserva aquello que modifica el comportamiento futuro. Un README responde «¿qué es esto?»; Lore responde otra cosa: ¿Qué aprendimos que nunca deberíamos tener que volver a aprender?

Si una frase no restringe una decisión futura, no es Lore. Esa regla es todo el filtro, y es lo que impide que el sistema se convierta en otro cementerio de documentos.

El filtro es prestado, y conviene decir de quién. Gregory Bateson, en Pasos hacia una ecología de la mente (1972), definió la información como «una diferencia que hace una diferencia»: una diferencia que no cambia nada más adelante no es información, es ruido. Lore le aplica esa prueba a la experiencia. Lo que pasó ayer se vuelve criterio solo si cambiaría lo que haces mañana — todo lo demás es un registro.


¿Quién puede usar Lore Plugin?

  • Si recién empiezas a trabajar con IA y quieres que lo aprendido se acumule en vez de evaporarse, empieza por acá: una memory card profesional que sobrevive a cualquier proyecto o modelo, donde tu criterio profesional afina el uso real con cada decisión.
  • Quienes leen el benchmark antes que cualquier otra cosa, dispuestos a probar algo que todavía no es mainstream si los números se sostienen.
  • Investigadores curiosos por LUS en sí — menos por el kit que por la pregunta detrás: qué cambia cuando una persona y una IA acumulan criterio juntas a lo largo del tiempo. Lore es donde esa pregunta se responde una decisión a la vez.
  • Equipos que ya corren spec-kit, pipelines SDD u otro framework de automatización. Esos gestionan proceso — constitución, plan, tareas, puertas de calidad — y ninguno pregunta si el conocimiento detrás de esas puertas sigue vivo. Ese hueco es el que cierran MYCELIUM y PRUNE, y Lore corre junto a spec-kit en vez de reemplazarlo (ver SPEC_KIT_es.md).

La hipótesis de LUS que este kit pone a prueba: un Entre humano–IA más rico y estable puede significar menos errores repetidos y mejor trabajo, a menor costo.

La palabra es de Martin Buber, en Yo y Tú (1923): lo que importa no vive dentro de ninguna de las dos partes sino en la relación entre ellas. Este kit toma la estructura, no la teología — lo que se acumula acá no es tuyo ni del modelo: es el criterio que construyeron los dos.


Comienza a construir tu Lore

Todo problema resuelto contiene dos cosas: la solución, y la razón por la que esa solución existe. La documentación conserva la primera. Lore conserva la segunda.

En lugar de registrar lo que pasó, lo destila en una Pista Invariante: una restricción pequeña que sigue sirviendo mucho después de que el contexto original desapareció.

En vez de recordar Lore guarda
«La IA escribió un informe demasiado técnico para quien debía leerlo» «Antes de redactar, identifica quién lo leerá y explica en lenguaje simple cada término poco familiar»
«El resumen de una reunión omitió quién era responsable de cada tarea» «Todo resumen de reunión termina con cada tarea, su responsable y su fecha límite»

El acontecimiento se olvida. El criterio sigue trabajando.

El ciclo

Lore

Cada paso del ciclo avanza igual: se propone, apruebas, y recién entonces se escribe. Esa puerta es el umbral, y es la razón de que nada llegue a tu Lore sin que lo hayas leído antes.

La forma detrás de esa puerta tiene nombre. Andy Clark y David Chalmers la llamaron mente extendida («The Extended Mind», 1998): un almacén externo deja de ser un archivador y empieza a participar del pensamiento cuando el sistema lo consulta por defecto y confía en lo que encuentra. La documentación queda al lado del trabajo; el Lore se carga antes de empezarlo — alcanzarlo no es un paso que recuerdas dar, es la forma en que el trabajo empieza.

Y el proceso también tiene nombre. Gilbert Simondon lo llamó transducción: una operación que avanza por un dominio paso a paso, cada fase fundada en la estructuración de la anterior. Una destilación es exactamente eso — la fricción cristaliza en una restricción que modifica la siguiente interacción, y luego la siguiente, hasta que la estructura acumulada se vuelve un cuerpo de criterio que nadie diseñó de antemano: tu Lore.

Ese es el mecanismo: no es documentación ni un volcado de memoria, es un umbral entre lo que pasó y lo que puede condicionar mañana. La sección siguiente te lleva de cero a tenerlo corriendo.


Instalación

Elige la ruta que coincida con tu equipo — solo no mezcles hosts. Claude Code y Codex instalan a través del gestor de plugins de cada host, que verifica el paquete. OpenCode, Cursor y Antigravity, más abajo, son copias manuales — la instalación vale lo que valga la copia, confirmada a mano.

Claude Code

Ejecuta estos comandos dentro de Claude Code:

/plugin marketplace add andresanemic/lore-plugin
/plugin install lore@lore-plugin

O ejecuta sus equivalentes desde una terminal:

claude plugin marketplace add andresanemic/lore-plugin
claude plugin install lore@lore-plugin

Codex CLI

Ejecuta estos comandos en tu terminal:

codex plugin marketplace add andresanemic/lore-plugin
codex plugin add lore@lore-plugin
Otros hosts — copia manual, sin verificación (OpenCode, Cursor, Antigravity, instalación directa)

OpenCode

Desde un clon local, copia las ocho carpetas de Lore en el directorio global de OpenCode:

mkdir -p ~/.config/opencode/skills
cp -R skills/* ~/.config/opencode/skills/

Reinicia OpenCode. Para un solo proyecto usa .opencode/skills/.

Cursor

Cursor ya descubre las skills instaladas en ~/.codex/skills/ o ~/.agents/skills/. Si prefieres una copia separada para Cursor, usa su directorio global y reinícialo:

mkdir -p ~/.cursor/skills
cp -R skills/* ~/.cursor/skills/

Google Antigravity

Antigravity carga skills globales desde ~/.gemini/config/skills/ y skills del proyecto desde .agents/skills/. Desde un clon local:

mkdir -p ~/.gemini/config/skills
cp -R skills/* ~/.gemini/config/skills/

Reinicia Antigravity después de copiarlas.

Instalación directa desde el repositorio

Usa esta ruta neutral al proveedor si prefieres un clon local o quieres preparar ambas CLI. Requiere Git y Node.js:

git clone https://github.com/andresanemic/lore-plugin.git
cd lore-plugin
node scripts/lore-plugin.mjs install --target all
codex plugin add lore@personal

Reemplaza all por claude o codex para preparar solo una CLI. El instalador configura Claude directamente; para Codex prepara el marketplace local personal e imprime el comando final codex plugin add.

Después abre una sesión nueva en la CLI. Si es tu primera vez, no necesitas saber ningún comando — escribe «quiero comenzar a usar Lore Plugin, ayúdame» y el kit abre un brainstorming, no un menú: primero mira tu árbol, después pregunta de a una cosa por vez, y termina con tu primer artefacto creado, nunca con una recomendación. Si ya sabes qué quieres, use-lore te enruta.

Preguntar de a una cosa por vez no es cortesía, y un formulario sería más rápido. Las preguntas son lo que te mantiene a ti y al modelo siendo dos cosas y no una —sin fusión y sin ahorrarse la fricción—, el rato suficiente para que aparezca una respuesta que ninguno tenía por separado.

Así se ve en la práctica

Acabas de publicar una landing y el feedback es: "No sabía qué hacer en la página". El CTA quedaba abajo y el titular hablaba del producto, no del resultado. Lo corregiste. En vez de cerrar la pestaña:

› guarda en lore
  Destilé esto:

  [cta] CTA poco visible — titular sin resultado

  Contexto ······ la landing tenía el CTA debajo del pliegue
  Causa raíz ···· el titular describía el producto, no el
                  resultado para quien lee
  Pista ········· poner el CTA principal arriba del pliegue y
                  escribir el titular alrededor del resultado,
                  no de la funcionalidad
  Confianza ····· confirmada — corregido en la página publicada

  → proyectos/cliente-a/lore/cta.md
  → esta pista es genérica y confirmada: ¿la promuevo al Área
    para que la vean los otros 3 proyectos?

  ¿Escribo?

Tres meses después, otro proyecto del Área publica una landing. El criterio ya está cargado y ese error no se repite.


Arquitectura

Las seis piezas

Cada proyecto organiza su criterio y su estado en seis piezas estructurales. No son necesariamente seis archivos: los módulos temáticos son una sola pieza, repartida en tantos archivos enfocados como el trabajo requiera.

Pieza Qué guarda Dónde
identidad.md Qué es el proyecto, su propósito y su piso de calidad lore/
principios.md Leyes invariantes, técnicas y de negocio lore/
Módulos temáticos Cicatrices técnicas por dominio lore/
index.md Mapa de navegación: una línea por patrón lore/
FASES.md Estado y hoja de ruta raíz
CLAUDE.md o AGENTS.md Un contrato de colaboración, elegido por host principal y reducido a punteros raíz

Cada uno tiene una responsabilidad. Ninguno duplica a otro.

El Lore es criterio (persiste); FASES.md es estado (avanza). Nunca se mezclan, y FASES.md nunca vive dentro de lore/.

Se mantienen aparte porque envejecen a velocidades distintas: quién eres y cómo trabajas sigue siendo cierto el mes que viene; en qué fase está el proyecto, no. Mezclarlos significa releer un documento donde la mitad de las frases venció y nada dice cuál mitad.

El bloque siempre-activo

El contrato es el único artefacto que los dos hosts cargan sin que nadie se lo pida, y por eso Lore le estampa una sección de punteros delimitada — el canal siempre activo del kit hacia la sesión.

La mecánica exacta (techo, variantes, cómo se estampa)
<!-- lore:always-on -->
…qué Lore gobierna acá · dónde vive · dónde vive el estado · cuándo invocar en vez de escribir a mano…
<!-- /lore:always-on -->

Cuatro elementos y no más, con un techo duro de 25 líneas. Apunta a lore/ y a FASES.md: el criterio y el estado viven separados, pero la sesión que los recibe solo puede leer una vez. Un agente que recibe el criterio sin la fase propone lo correcto en el momento equivocado. El bloque nunca reproduce una pista. Si una variante no entra, mueve contenido a lore/; no subas el techo.

Tres variantes: un área apunta a su propio lore/; un proyecto apunta al suyo y al del área madre; un bot apunta a canon/ y a su tabla de enrutamiento — nunca a los Lore federados uno por uno. Por eso un bot que alcanza veinte cuerpos de criterio sigue entrando.

Las skills dueñas lo estampan de forma idempotente dentro de su umbral; UPGRADE lo agrega a contratos antiguos. Una divergencia editada a mano se reporta y nunca se sobrescribe.

Herencia Área → Proyecto

desarrollo-web/
│
├── lore/                      ← el criterio general vive UNA sola vez
│     identidad · principios · index · animacion · scroll · layout
│
├── FASES.md                   ← registro de proyectos del Área
├── CLAUDE.md o AGENTS.md      ← contrato único del Área, elegido por host
│
└── proyectos/
    ├── cliente-a/
    │   └── lore/              ← solo lo propio; el index apunta al Área
    ├── cliente-b/
    │   └── lore/
    └── cliente-c/
        └── lore/

Arreglas una Pista genérica una vez, en el Área, y todos los proyectos la ven.

La tercera forma: un bot

Área Proyecto Bot
Contiene proyectos un trabajo una sesión de trabajo
Su Lore gobierna el método del dominio ese trabajo cómo se comporta el agente
Se abre para ver el registro avanzar eso trabajar en varios proyectos

Las Áreas y los proyectos son lugares; un bot es una lente que llevas a ellos.


Las ocho skills

Este kit avanza junto a la disciplina writing-skills de Superpowers, no por delante de ella. Cada skill se revisa contra esa disciplina antes de publicarse, cada vez que cambia.

Las skills están escritas en inglés y el Lore que producen, no — contenido y nombres de archivo incluidos, en tu idioma. El inglés del SKILL.md es el sustrato portable con el que el kit funciona en otros hosts, no el idioma del kit. No abras uno para explicarle a alguien qué hace un modo (lo aprendimos en el Caso 12, en vivo) — para eso está la tabla y los dos docs de abajo.

Skill Para qué Cuándo
use-lore Punto de entrada: explica el modelo y te manda a la skill correcta primero, siempre
brainstorming-lore Diseña cambios en los artefactos Lore sin chocar con skills generales de brainstorming; sostiene la continuidad reconocible del Entre y su esfuerzo fértil antes de crear o reestructurar Lore de forma material
create-area Crea un Área con su Lore compartido al abrir un dominio nuevo
create-project Crea un proyecto que hereda del Área al empezar un trabajo
save-to-lore Destila una lección y decide si sube al Área todos los días
transmute-lore Migra, limpia, traduce, actualiza, poda o exporta una fotografía segura del Lore al heredar, mantener, actualizar o compartir Lore
create-bot Un lugar donde abrir sesión y trabajar sobre varias Áreas a la vez desde cero, o cuando ya hay Lore que federar
obsidian-lore Mina tus notas sueltas y enruta lo que sobrevive cuando la bandeja pesa

El primer día necesitas dos de estas: use-lore te enruta hacia lo que sigue, y save-to-lore es la que vas a escribir de verdad — "guarda en lore", después de resolver algo que te costó. Cómo usar cada una, con ejemplos trabajados, vive en USAGE_es.md; el mecanismo completo de cada modo vive en REFERENCE_es.md.

Qué hace cada skill

use-lore

Cambio de nombre en 2.0: using-lore ahora es use-lore. Al actualizar, elimina el nombre anterior; puntos de entrada duplicados vuelven ambiguo el enrutamiento.

El punto de entrada — explica el modelo y te guía hacia la skill adecuada. Léelo antes de invocar cualquier otro.

brainstorming-lore

La conversación de diseño propia del kit para artefactos Lore — específica a propósito, una decisión por vez; create-area, create-project, create-bot y los modos estructurales de transmute-lore heredan su contrato.

save-to-lore

El flujo diario: resolvés algo que te costó, escribís "guarda en lore" — las candidatas quedan estacionadas hasta un hito, donde se muestran destino, redacción y por qué ahora antes de escribir nada. Lo específico se queda en el proyecto; lo genérico y confirmado se propone para el Área; nada se promueve automáticamente. Dos modos: capture destila una fricción vivida en una Pista Invariante; graft arbitra criterio importado contra la finalidad de tu proyecto y registra dónde la fuente pierde. Una skill que solo ejecuta es una dependencia, no Lore.

transmute-lore

Opera un Lore existente en ocho modos: add rescata criterio disperso hacia la arquitectura de seis piezas; clean elimina lo que el Área ya posee; translate estandariza el idioma sin alterar el significado; upgrade clasifica hallazgos en Missing, Superseded, Earned o Stale; prune hace lo mismo contra un Lore degradado por acumular cosas correctas; mycelium (2.3.0) reporta las pistas que ningún paso corre; leave quita gobierno pero conserva lore/, reversible; crystallize exporta una fotografía segura en un solo Markdown. La Referencia conserva las puertas completas de cada uno.

create-bot

Un solo lugar para abrir sesión y trabajar sobre varias Áreas a la vez — federar. Piensa en un laboratorio de blockchain: sitio web, redes sociales, investigación, transferencia tecnológica, cada una ya un Área con su propio Lore; un bot las enruta todas hacia una misma carpeta. No responde preguntas sobre los proyectos: trabaja en ellos.

Su norte, y el único test que importa: una instrucción corta basta. Si hubo que explicarle el proyecto al bot para obtener el resultado, faltaba criterio cargado.

Dos modos: nuevo construye canon provisional desde un brainstorm, refinado con una primera victoria revisada; federar enruta hacia criterio que ya existe — las carpetas en bruto primero ganan Lore real en su propia Área, adoptadas por ruta, sin moverlas. Tres cuerpos nunca se mezclan: canon/ es lo que el bot es, lore/ lo mantiene, el criterio prestado sigue por proyecto — federar es apuntar, no copiar.

El cifrado del Lore sigue experimental y apagado por defecto; consulta ENCRYPTION.md.


Notas Obsidian

Apunta Obsidian a la carpeta madre de tus Áreas y agrega una carpeta notas/ (o notes/) dentro del proyecto, Área o bot donde estés trabajando — el mismo árbol es tu espacio de trabajo y tu vault. Cuando quieras que la IA lo lea, activa la skill:

«revisa mis notas de Obsidian y checa si algo se puede guardar en mi lore»

obsidian-lore hace el barrido, separa criterio de tareas y ruido, propone el Lore dueño y espera tu aprobación. Marca cada nota minada con fecha y destino y nunca la borra. Un bot enruta mejor porque ya conoce la finalidad de cada proyecto. Una nota es fuente, nunca criterio: nada cruza sin destilación explícita y un diff aprobado.


Invariantes compartidas

  • El Lore se escribe en tu idioma.
  • El criterio nunca se inventa. Todo proviene de experiencia real.
  • Una nota es fuente, nunca criterio.
  • El ruido descartado se informa, nunca se elimina en silencio.
  • Todo cambio pasa por un umbral antes de escribirse.
  • Nada hace commit automáticamente. Tú revisas el diff final.

Esas dos últimas son la apuesta entera. Hay una clase creciente de frameworks de agentes que guarda memoria de sus propios éxitos y fracasos y genera skills a partir de sus patrones — una capacidad real, y la elección contraria: ahí mejora el agente; acá mejoras tú. El criterio vive en archivos tuyos, en tu idioma, y nada entra sin tu aprobación con el contenido a la vista. Si quieres un sistema que aprenda a tus espaldas, este no es, y no va a serlo.

Estas reglas no son abstractas: una se pagó. A un README se le pidió encoger un 40% y volvió recortado casi al 80% — la instrucción dejó de ser un piso donde pararse, y colaborar se había vuelto supervisar. Las seis reglas de arriba existen para volver esa tarde estructuralmente imposible.


El benchmark

Benchmark auditado de Lore: 44,5 puntos más de cumplimiento multidominio al primer intento, todas las metas medidas alcanzadas y 15,2 por ciento menos tiempo observado

Lore funciona como infraestructura de estabilidad cuando cambia el dominio. El resultado pesa igual el trabajo Web y el Editorial (community management, redacción de noticias), así una buena corrida Web no tapa una mala Editorial. Mismo modelo, prompt y herramientas en los dos brazos — gpt-5.6-sol, esfuerzo de razonamiento medio. Lore alcanzó todas las metas medidas. Solo en Web (72 corridas): Codex frío 25/36 (69,4%), Codex + Lore 33/36 (91,7%).

El harness, las tareas congeladas, los graders, las salidas crudas y las fronteras declaradas están en bench/. Son resultados de Codex, no una afirmación universal sobre modelos.


Documentación

Documento Para qué sirve
90_SECONDS_es.md Empieza acá. El mecanismo completo, corto como para leerlo antes de decidir si instalas algo.
USAGE_es.md Guía práctica de uso día a día, con ejemplos.
REFERENCE_es.md Referencia técnica de cada artefacto y cada skill.
MIGRATION_es.md Cómo migrar un proyecto existente con transmute-lore.
ENCRYPTION.md El cifrado opcional y experimental del criterio de un bot: qué protege y qué no.
CASES_es.md Los dieciocho casos de estudio, cada uno con su frontera declarada.
SPEC_KIT_es.md Lore junto a spec-kit de GitHub: quién gobierna qué. Opcional — Lore no depende de él.
bench/ El benchmark: harnesses Web, Editorial y UPGRADE; tareas congeladas; método; fronteras declaradas; y resultados crudos.

Casos de estudio

Lore no se diseñó de antemano: cada decisión salió de aplicarlo a proyectos reales y mirar qué se rompía — documentado como dieciocho casos de estudio, cada uno con su frontera declarada, varios vuelven el kit contra sí mismo. El Caso 12 es la primera instalación hecha por alguien que no es el autor.

Estatus: casos, no demostraciones — n pequeño, y diecisiete de los dieciocho vienen del mismo investigador (la excepción es el Caso 12). Restringen cómo usamos el kit; no pretenden ser ley. La afirmación medida pertenece al Caso 08 y su benchmark; los demás aportan evidencia cualitativa.

Leer los dieciocho casos de estudio →


Alcance

1.000+ clonaciones y sumando

1.916 clonaciones 50 días 38 al día 225 pico

Ventanas GitHub preservadas en data/traffic/clones.json.

Lore Plugin es el brazo técnico de LUS, no un sistema de productividad con filosofía agregada — la hipótesis de LUS, solo parcialmente puesta a prueba por el benchmark, está arriba.

Morin le da a este trabajo su norte ético: en la edición de UNESCO de Los siete saberes necesarios para la educación del futuro escribe que «la noción de apuesta se debe generalizar para cualquier fe» — renunciar al mejor de los mundos no es renunciar a un mundo mejor. Lore vuelve esa apuesta operable mediante proyectos y bots; la evidencia se limita a lo realmente medido.

Una señal de alcance, no una demostración. Nadie sabe qué hizo cada quien con su copia — ¿instalada, destilada, abierta una vez? No es un caso y no responde lo que responden los casos de estudio. Y los «clonadores únicos» de la API son únicos por día, no personas: no se pueden sumar para contar cabezas.


Origen

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 su implementación operativa. Un principio lo resume:

La experiencia solo crea valor cuando puede volver a participar en una decisión futura.

Eso nos vuelve jardineros del Entre: el espacio compartido donde un ser humano y una IA modifican lo que el otro puede hacer después. No preservamos toda experiencia. Cultivamos la que merece orientar otra decisión, podamos lo que ya no restringe nada y conservamos el rastro de lo descartado. Lore no es el jardín: es la práctica que mantiene vivo ese terreno común.

La investigación y el software permanecen separados: una observación al usar Lore no se vuelve automáticamente un resultado científico, y una hipótesis no se vuelve regla de una skill sin evidencia y revisión.

El programa comenzó con una bibliografía fundacional cuyos conceptos se traducen directamente en la práctica:

  • Martin Buber · Yo y Tú (1923) — el Entre: el conocimiento emerge en la relación, no en el prompt ni en el modelo.
  • Louis Althusser · «Ideología y aparatos ideológicos de Estado» (1970) — la interpelación: la IA no se limita a responder; llama al humano a ocupar una posición de criterio y responsabilidad.
  • Gilbert Simondon · La individuación a la luz de las nociones de forma y de información (1958) — la transducción: la fricción cristaliza en una estructura que modifica la siguiente interacción.
  • Claude Shannon y Warren Weaver · The Mathematical Theory of Communication (1949) — señal, entropía y ruido: por qué los registros crudos se filtran en Contexto, Causa y Pista Invariante.
  • Gregory Bateson · Pasos hacia una ecología de la mente (1972) — «una diferencia que hace una diferencia»: la prueba de que una experiencia puede restringir una acción futura.
  • Norbert Wiener · Cibernética (1948) — la retroalimentación: el error del trabajo real vuelve para estabilizar el sistema humano–IA.
  • Edgar Morin · Introducción al pensamiento complejo (1990) — dialógica y recursividad organizacional: las partes y el todo se transforman mutuamente. Sus saberes de la UNESCO le dan a este trabajo su norte ético.
  • Andy Clark y David Chalmers · «The Extended Mind» (1998) — memoria externa acoplada: el Lore puede participar en la cognición en vez de quedar al lado como documentación pasiva.
  • Hubert Dreyfus · What Computers Still Can't Do (1992) — conocimiento situado y tácito: la fricción humana que Lore traduce en restricciones útiles para un modelo generalista.
  • Francisco Varela, Evan Thompson y Eleanor Rosch · De cuerpo presente (1991) — la enacción: el criterio no se almacena, se hace emerger actuando.

Son interlocutores, no autoridad prestada: LUS los usa para hacer visibles convergencias, diferencias y tensiones en sus afirmaciones sobre el Entre, el criterio acumulado y el Lore.

Bibliografía extendida

Cuatro interlocutores que amplían el marco, y dos más que se leyeron de frente contra LUS — esos dos llevan escrito, dentro de la entrada, dónde pierde la fuente.

  • Edwin Hutchins · Cognition in the Wild (1995) — cognición distribuida: la unidad que piensa es el sistema, no la cabeza que está adentro.
  • Daniel Wegner · memoria transactiva (1985) — quién recuerda qué: una pareja recuerda más que sus dos miembros, y solo mientras sepa quién guarda cada parte.
  • Karl Weick · Sensemaking in Organizations (1995) — el sentido se construye hacia atrás, que es por qué una Pista se escribe después de la fricción y no durante.
  • Heinz von Foerster · Understanding Understanding (2003) — cibernética de segundo orden: el observador está adentro del sistema que describe.
  • Albert Camus · El mito de Sísifo (1942) · El extranjero (1942) · El malentendido (1944) · El hombre rebelde (1951) · El verano (1954), por «El exilio de Helena» y «Los almendros» — entró como criterio, en una sola afirmación: un sistema de criterio no reduce el absurdo; sabe qué hacer cuando aparece. La obra de teatro lo lleva adentro: una madre y una hermana matan al hijo que volvió porque él no dice su nombre — sin malicia y sin error de razonamiento, solo lo que se sabía sin llegar a donde se decidía. Dónde pierde Camus: su mesure es un límite ético-político a la rebelión, no una regla epistémica de enrutamiento: entra como analogía declarada y no funda ninguna.
  • Martin Heidegger · Ser y tiempo (1927) — entró como bibliografía, y NO como criterio. La finitud asumida es lo que vuelve auténtica una existencia, y la intuición que lo trajo a esta mesa es que el Entre también es finito. Pero en Ser y tiempo la muerte es je meines —radicalmente propia, no compartible— y esa incompartibilidad es el motor del argumento: la muerte individualiza. La unidad de LUS es la relación. Adoptarlo exigiría contradecir a Heidegger justo donde su tesis se apoya, y ese trabajo no está hecho. Lo que deja abierto vale más que cualquier cosa adoptable hoy: ¿cómo puede una relación anticipar un final que ninguna de sus partes puede anticipar por la otra?

Esa es la genealogía argumentada. La sentida —lo que formó el gusto y no una afirmación— va aparte, a propósito:

Genealogía afectiva — las obras que formaron la sensibilidad

Registro, no regla. Estas obras no restringen ninguna decisión y no gobiernan nada. Se anotan porque la estética y las intuiciones de un artefacto técnico nunca son neutrales, y saber de dónde vienen es lo único que permite distinguir el gusto heredado del argumento el día que alguien proponga cambiarlas. Pertenece a LUS, no al kit. De todas ellas, solo una sigue apareciendo en el cuerpo de este README, al lado de lo que ilustra: El día de la marmota. El resto se sacó del argumento y quedó acá, porque una obra que hay que explicar antes de que ilustre algo le está cobrando al lector el gusto del autor.

  • Fire · Waxahatchee (2020) — madurar como avanzar sin la visión completa. Lo que de verdad compra el criterio acumulado: no el fin de la incertidumbre, un espacio más chico de maneras de equivocarse.

  • Loving · Land of Talk (2017) — un vínculo que sostiene a dos sin disolver a ninguno. La forma detrás de preguntar de a una cosa por vez.

  • 50 primeras citas · Peter Segal (2004) — el video que Lucy ve cada mañana, que funciona porque le entrega identidad y estado juntos y aun así los mantiene separados.

  • «1998» · Chet Faker y BANKS (2015) — la tarde en que colaborar se vuelve supervisar, entre dos personas.

  • Tales of Berseria · Bandai Namco (2016) — aporte estético y no conceptual: la dirección de arte de este kit viene de acá antes que de cualquier referencia de diseño de software. Genealogía de la forma.

  • Keep Running · Tei Shi — mantenerse al día con quién es el otro ahora. Un criterio que no se revisa no queda neutral: sigue operando, sobre alguien que ya cambió.

  • Running Back to You · The Juan MacLean — autonomía con retorno (H13). No exige contacto constante; exige un punto donde las dos partes vuelvan a ponerse al día antes de que la deriva vuelva irreconocible el trabajo compartido.

  • Aliso · Malena Zavala (2018) — «admired, not reset». Y sobre traducir: el daño no está en una parte, está en el lenguaje que dos rompieron.

Explora la investigación en el NotebookLM de LUS

Cómo leerlo: NotebookLM es la introducción accesible, no la fuente de registro — para qué hace el kit manda este repositorio; para una cifra, el corte vigente del benchmark.

¿Por qué «Lore»?

En los videojuegos, el lore es la historia y las reglas acumuladas que mantienen coherente un universo —qué puede y qué no puede pasar después. Tomamos esa imagen y cambiamos el peso: los hechos puntuales se desvanecen, y lo que permanece es el criterio que mantiene coherente el próximo trabajo. La deuda visual también es explícita: la paleta anime viene de Tales of Berseria (Bandai Namco, 2016), el juego favorito del autor — nombrar esa procedencia separa una decisión de diseño de un gusto heredado.

Autor

Andrés Peña Mellado — investigador principal de LUS.

Construyendo en Web3: dos proyectos blockchain como founder, y community management en ChatterPay. Antes, parte del equipo editorial de Polkadot Español y editor en BeInCrypto.

Docencia e investigación: integró el equipo que estableció las bases bibliográficas y metodológicas de la asignatura Design Thinking de la Escuela de Ingeniería en Informática de la UTEM (2023), y la dictó desde 2023 hasta 2025. Speaker en KCD El Salvador 2023.

GitHub X LinkedIn Telegram Discord Email

About

Local fine-tuning for your own work. A provider-neutral kit that turns project experience into reusable criteria for AI agents — distilled at a threshold you control, pruned when it grows, and portable between models.

Topics

Resources

Code of conduct

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages