andresanemic/lore-plugin

Stop explaining your project to the AI every morning.
With your approval, Lore turns lessons into project criteria the AI can use next time.
Start with the 90-second guide → · Clone the repository
Not sure whether to try it? Share this repository's link with your AI agent, ask what Lore Plugin and Vespi are, and let it tell you whether it recommends installing them in one of your projects.
In plain words. Lore: your project's criteria, as plain Markdown files you approve. Save to Lore: turn a correction you made into a criterion for next time. Prune: retire rules that no longer apply. Graft: bring in an idea from outside only after checking where it loses against your criteria. Transmute: reorganize or migrate a Lore tree. Crystallize: pack a bot's criteria into one file to carry it elsewhere.
Where this is going. Today you run Lore Plugin from a terminal. Try the interactive Hive POC on the site: a UX/UI MVP where you can choose agents and save criteria and workflows in your browser, without connecting to AI.
Read in English
## The problem
Every session starts blank. Yesterday’s corrections do not carry into the next one, so you explain the project again and may repeat decisions you had already rejected. Lore gives lessons you approve a place in your project files, ready for future work.
Start
The problem ·
What is Lore ·
Who can use it ·
Start building ·
Installation
Use it
Architecture ·
The nine skills ·
Loose notes ·
Documentation
Understand it
Shared invariants ·
Case studies ·
Reach · Origin
## What is Lore?
Lore is a provider-neutral kit of nine skills and a simple structure for project criteria. You decide what gets written; the kit makes approved criteria available before later work. It does not train a model or learn on its own.
#### What it provides
A simple convention for organizing a project’s criteria.
Nine skills that work with that convention.
A reviewed process for turning experience into reusable criteria.
Each project has one contract (CLAUDE.md or AGENTS.md, depending on the host), FASES.md for current work, and lore/ for criteria that guide how it is built.
#### Start from existing work
transmute-lore can read project folders, documents, exported chat summaries, and notes to help organize criteria already in use. Your files stay as they are; nothing becomes Lore until you read and approve the result.
When criteria need to travel, CRYSTALLIZE creates a traceable Markdown snapshot that can move between models and return to a working folder. It omits sensitive filenames and rejects secret markers. It never replaces live Lore.
#### What it does not promise
Lore cannot guarantee correct work or decide when old criteria no longer fit. It gives you a reviewed way to preserve and prune lessons; both still need your judgment and time.
#### The filter
Lore keeps lessons that change future decisions. If a sentence does not constrain a future decision, it is not Lore. Other facts belong in documentation or notes.
## Who can use Lore Plugin?
Whether you are new to AI or already build with it, you can start with your own project and your own words.
New to AI: describe what you want to do; the skills guide the next step, and you approve what gets written.