Roadmap
Where Lore is heading — from capture to intelligence.
The Big Picture
graph LR
A["Circles 1-2b<br/>✅ DONE<br/>Capture & Search"] --> B["Circle 3<br/>Structure"]
B --> C["Circle 4<br/>Connections"]
C --> D["...<br/>More to come"]
Today, Lore captures. Tomorrow, Lore understands, connects, and shares.
What's Done (Circles 1 + 2 + 2b)
The MVP is complete. Lore captures the "why" at commit-time and makes it searchable:
- Capture — Post-commit hook, 3 questions, Express mode, contextual detection
- Search —
lore show,lore list,lore status - Lifecycle — Retroactive docs, deletion, pending commits
- Maintenance —
lore doctor, config validation - AI — Angela draft (zero-API), polish (interactive diff + multi-pass +
--foraudience rewrite), review (corpus coherence) - Angela Standalone —
--pathflag for any Markdown directory (nolore initrequired),PlainCorpusStorewith graceful degradation (with or without YAML front matter) - Angela CI — GitHub Action composite (
action.yml), portable CI script (angela-ci.sh), works with GitHub Actions, GitLab CI, Jenkins, Bitbucket - VHS Cross-Check — Detects orphan tapes, orphan GIF references, CLI command mismatches between
.tapefiles and documentation - Language Detection — 24 languages including VHS tape syntax, auto-tagging bare code fences in
angela polish - Preflight & Cost — Token estimation, cost warnings, abort-if-too-large, timeout prediction before API calls
- Release —
lore releasegenerates notes from corpus - Bilingual — 700+ EN/FR strings, full i18n
- Distribution — Homebrew, Chocolatey, deb, rpm, apk, Go, curl
- Intelligence — Decision Engine (5 signals, scoring 0-100), LKS SQLite store
- IDE — Non-TTY detection, VS Code notifications
Circle 3 — Structure
As your corpus grows, you will need better organization. Circle 3 focuses on structuring the knowledge you have captured — grouping related documents, adapting the capture process to your team's needs, and making documentation a sustainable habit.
Themes being explored:
- Organizing documents by feature scope rather than just chronologically
- Adapting capture questions to different project contexts
- Visibility into documentation habits and team activity
Circle 4 — Connections
Today, each document stands alone. Circle 4 is about weaving them into a connected network — linking documents to each other, to code, and to free-form knowledge that does not originate from commits.
Themes being explored:
- Cross-references between documents
- Knowledge capture beyond commits (meetings, research, decisions)
- Smarter search across a growing corpus
- Health checks for link integrity
What Comes After
The corpus you build today — structured, connected, searchable — becomes the foundation for future intelligence features. The details will emerge as Circles 3 and 4 ship.
The CLI will always be free. The corpus will always be yours. And the "why" you capture today will grow more valuable with every future release.
Follow the project on GitHub to stay informed.
See Also
- Philosophy — Why Lore exists
- Architecture — How Lore is built