lumina-wiki 1.4.0 → 1.5.1

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to Lumina-Wiki are documented here.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [1.5.0] - 2026-05-10
+
+### Added — Learning Pack: `/lumi-learning-reflect` self-reflection skill (PRs #16, #17)
+
+- New optional **learning** pack installable via `npx lumina-wiki install --packs core,learning`.
+- New skill `/lumi-learning-reflect`: guides metacognitive self-reflection sessions on any concept or source in the wiki.
+  - Creates or updates `wiki/reflections/<slug>.md` — a personal reflection page with a rewritable **"Current understanding"** section and an append-only **"Evolution"** log.
+  - AI acts as a metacognitive mirror: reads past entries, quotes the user's own words, and asks prompting questions — but **never writes reflection content**. The user always authors their own understanding.
+  - Reflection pages are a personal overlay exempt from bidirectional-link requirements (`reflections/**` added to exempt globs in `schemas.mjs`).
+- `schemas.mjs` gains the `reflections` entity type (7 required frontmatter fields: `id`, `title`, `type`, `created`, `updated`, `related_concepts`, `related_sources`, `evolution_count`) scoped to the learning pack.
+- `commands.js` registers the learning pack as a valid selectable option (`VALID_PACKS`), creates `wiki/reflections/` on install, and wires up the `/lumi-learning-reflect` skill symlink.
+- Template READMEs (EN/VI/ZH) and `lumi-help.csv` catalog updated to include the new skill and Learning Pack install option.
+- `cross-reference-packs.md` and `page-templates.md` schema docs extended with reflection page format.
+- PR #17 follow-up: locale strings (EN/VI/ZH) for the new pack prompt, `prompts.js` pack description, and `assert.rejects` CI fix.
+
 ## [1.4.0] - 2026-05-09
 
 ### Added — `/lumi-help` orientation skill (PR #9)

package/README.md

@@ -78,7 +78,7 @@ npx lumina-wiki install
 
 > **Note for Windows users:** For the best experience, enable [Developer Mode](https://learn.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) so the installer can use symlinks correctly. If Developer Mode is off, the installer falls back to copying skill files; everything still works, but updates are less ideal.
 
-The installer will guide you through a quick setup, including optional **Packs** such as `research` and `reading`.
+The installer will guide you through a quick setup, including optional **Packs** such as `research`, `reading`, and `learning`.
 
 ### **Step 2 (Optional): Configure the Research Pack**
 
@@ -117,7 +117,7 @@ Interact with your wiki using these commands in your AI chat interface, such as
 -   `/lumi-edit [path/to/wiki/page]`: Request a change or correction to a specific wiki page.
 -   `/lumi-check`: Check the whole wiki for errors, such as broken links or orphan pages.
 
-*Additional skills may be available if you installed optional packs such as `research` or `reading`.*
+*Additional skills may be available if you installed optional packs such as `research`, `reading`, or `learning`.*
 
 ---
 
@@ -188,6 +188,7 @@ These are the commands you can use when chatting with your AI agent.
 | | `/lumi-reading-character-track` | Track characters and their relationships in a story. |
 | | `/lumi-reading-theme-map` | Identify and map themes in a narrative. |
 | | `/lumi-reading-plot-recap` | Provide a progressive plot recap. |
+| **Learning** | `/lumi-learning-reflect` | Guide a self-reflection session on a concept or source you have studied. Creates a personal reflection page in `wiki/reflections/` with a rewritable "Current understanding" section and an append-only "Evolution" log. The AI acts as a metacognitive mirror — it quotes your past words and asks questions — but never writes the reflection for you. |
 
 The scripts behind these skills live in `_lumina/scripts/` and `_lumina/tools/`; you usually do not need to call them directly.
 
@@ -198,16 +199,18 @@ The scripts behind these skills live in `_lumina/scripts/` and `_lumina/tools/`;
 Lumina-Wiki is evolving rapidly. Here is our user-facing roadmap:
 
 **Near-term (Stability & New Ingestion)**
-- [x] **`/lumi-help` Skill:** A smart assistant that reads your workspace state and tells you the one thing to do next; `skills` shows every command, `explain <topic>` answers how Lumina itself works.
+- [x] **`/lumi-help` Skill:** A smart assistant that reads your workspace state and tells you the one thing to do next; `skills` shows every command, `explain <topic>` answers how Lumina itself works. *(shipped in v1.4)*
+- [x] **Learning Pack:** Self-reflection sessions that track how your understanding of a concept evolves over time. *(shipped in v1.4)*
 - [x] **Multilingual setup:** Choose English, Vietnamese, or Chinese as your primary language during install. *(shipped in v1.2)*
 - [x] **Native DOCX, RTF & EPUB ingestion:** Pull Word, Rich Text, and EPUB books straight into your wiki via the research pack. *(shipped in v1.x)*
-- [ ] **Image OCR & Scanned PDFs:** Ingest screenshots and scanned PDFs into your wiki.
-- [ ] **Advanced Paper Ranking:** See influence scores and quality signals for your research papers.
 - [x] **Improved CI/CD:** Native support for Bun and Node 22 environments. *(shipped in v1.2)*
+- [ ] **Global Source Expansion:** Direct integration with OpenAlex, CORE, and Unpaywall for reliable DOI-to-PDF resolution.
+- [ ] **RSS & Blog Monitoring:** Automatically surface new papers from your favorite lab blogs and journals.
+- [ ] **Advanced Paper Ranking:** See influence scores and quality signals for your research papers.
 
 **Long-term (Deep Research & Integration)**
-- [ ] **Global Source Expansion:** Direct integration with OpenAlex, CORE, and Unpaywall.
-- [ ] **RSS & Blog Monitoring:** Automatically identify new papers from your favorite lab blogs.
+- [ ] **Image OCR & Scanned PDFs:** Ingest screenshots and scanned PDFs into your wiki.
+- [ ] **Paper Version Tracking:** Get notified when an already-ingested paper has a new revision or published version.
 - [ ] **Google Workspace:** Ingest Google Docs and Sheets directly into your graph.
 - [ ] **Multimedia Support:** Process YouTube videos and Audio recordings via transcripts.
 - [ ] **Knowledge Graph Auditing:** Automated checks for contradictions and structural drift.

package/README.vi.md

@@ -78,7 +78,7 @@ npx lumina-wiki install
 
 > **Lưu ý cho người dùng Windows:** Để có trải nghiệm tốt nhất, bạn nên [bật Chế độ nhà phát triển (Developer Mode)](https://learn.microsoft.com/vi-vn/windows/apps/get-started/enable-your-device-for-development) để trình cài đặt có thể sử dụng symlink một cách chính xác. Nếu Developer Mode bị tắt, trình cài đặt sẽ chuyển sang sao chép các file skill; chức năng vẫn hoạt động nhưng sẽ không lý tưởng bằng cho việc cập nhật.
 
-Trình cài đặt sẽ hướng dẫn bạn qua một vài bước thiết lập nhanh, bao gồm cả việc lựa chọn các **Gói (Packs)** tùy chọn như `research` (nghiên cứu) và `reading` (đọc hiểu).
+Trình cài đặt sẽ hướng dẫn bạn qua một vài bước thiết lập nhanh, bao gồm cả việc lựa chọn các **Gói (Packs)** tùy chọn như `research` (nghiên cứu), `reading` (đọc hiểu) và `learning` (học tập).
 
 ### **Bước 2 (Tùy chọn): Cấu hình Gói Research**
 
@@ -117,7 +117,7 @@ Tương tác với wiki của bạn bằng cách sử dụng các lệnh này tr
 -   `/lumi-edit [đường/dẫn/tới/trang/wiki]`: Yêu cầu thay đổi hoặc sửa lỗi cho một trang wiki cụ thể.
 -   `/lumi-check`: Kiểm tra toàn bộ wiki để tìm lỗi (liên kết hỏng, trang mồ côi, v.v.).
 
-*Các kỹ năng bổ sung có thể có sẵn nếu bạn đã cài đặt các gói tùy chọn như `research` hoặc `reading`.*
+*Các kỹ năng bổ sung có thể có sẵn nếu bạn đã cài đặt các gói tùy chọn như `research`, `reading` hoặc `learning`.*
 
 ---
 
@@ -188,6 +188,7 @@ Xem [Hướng dẫn Nâng cao](docs/user-guide/advanced-qmd.vi.md) để biết
 | | `/lumi-reading-character-track`| Theo dõi các nhân vật và mối quan hệ của họ trong truyện. |
 | | `/lumi-reading-theme-map` | Xác định và lập bản đồ các chủ đề trong một câu chuyện. |
 | | `/lumi-reading-plot-recap` | Cung cấp một bản tóm tắt tuần tự của cốt truyện. |
+| **Learning** | `/lumi-learning-reflect` | Hướng dẫn một buổi phản tư (self-reflection) về một khái niệm hoặc tài liệu bạn đã học. Tạo trang phản tư cá nhân trong `wiki/reflections/` với phần "Hiểu biết hiện tại" có thể chỉnh sửa và nhật ký "Quá trình phát triển" chỉ được ghi thêm (không xóa). AI đóng vai trò gương nhận thức — trích dẫn lại lời bạn và đặt câu hỏi — nhưng không bao giờ viết nội dung phản tư thay bạn. |
 
 Các script chạy nền nằm trong `_lumina/scripts/` và `_lumina/tools/`; thông thường bạn không cần gọi trực tiếp.
 
@@ -198,16 +199,18 @@ Các script chạy nền nằm trong `_lumina/scripts/` và `_lumina/tools/`; th
 Lumina-Wiki đang phát triển nhanh chóng. Dưới đây là lộ trình hướng tới người dùng của chúng tôi:
 
 **Sắp tới (Ổn định & Mở rộng nạp tài liệu)**
-- [x] **Kỹ năng `/lumi-help`:** Trợ lý thông minh đọc trạng thái workspace và mách bạn bước tiếp theo; gõ `/lumi-help skills` để xem toàn bộ lệnh, hoặc `/lumi-help explain <chủ đề>` để hỏi Lumina hoạt động ra sao.
+- [x] **Kỹ năng `/lumi-help`:** Trợ lý thông minh đọc trạng thái workspace và mách bạn bước tiếp theo; gõ `/lumi-help skills` để xem toàn bộ lệnh, hoặc `/lumi-help explain <chủ đề>` để hỏi Lumina hoạt động ra sao. *(đã phát hành trong v1.4)*
+- [x] **Gói Learning:** Các buổi phản tư cá nhân giúp bạn theo dõi sự tiến triển trong hiểu biết về một khái niệm theo thời gian. *(đã phát hành trong v1.4)*
 - [x] **Cài đặt đa ngôn ngữ:** Chọn Tiếng Anh, Tiếng Việt hoặc Tiếng Trung làm ngôn ngữ chính khi cài đặt. *(đã phát hành trong v1.2)*
 - [x] **Nạp DOCX, RTF & EPUB native:** Đưa thẳng file Word, Rich Text và sách EPUB vào wiki qua research pack. *(đã phát hành trong v1.x)*
-- [ ] **OCR ảnh & PDF scan:** Nạp ảnh chụp màn hình và PDF dạng scan vào wiki.
-- [ ] **Xếp hạng bài báo nâng cao:** Xem điểm số ảnh hưởng và tín hiệu chất lượng cho các nghiên cứu của bạn.
 - [x] **Cải thiện CI/CD:** Hỗ trợ chính thức cho môi trường Bun và Node 22. *(đã phát hành trong v1.2)*
+- [ ] **Mở rộng nguồn dữ liệu toàn cầu:** Tích hợp trực tiếp với OpenAlex, CORE và Unpaywall để tra cứu DOI-to-PDF đáng tin cậy.
+- [ ] **Theo dõi RSS & Blog:** Tự động phát hiện bài báo mới từ các blog phòng thí nghiệm và tạp chí yêu thích.
+- [ ] **Xếp hạng bài báo nâng cao:** Xem điểm số ảnh hưởng và tín hiệu chất lượng cho các nghiên cứu của bạn.
 
 **Dài hạn (Nghiên cứu sâu & Tích hợp)**
-- [ ] **Mở rộng nguồn dữ liệu toàn cầu:** Tích hợp trực tiếp với OpenAlex, CORE và Unpaywall.
-- [ ] **Theo dõi RSS & Blog:** Tự động tìm bài báo mới từ các blog phòng thí nghiệm yêu thích.
+- [ ] **OCR ảnh & PDF scan:** Nạp ảnh chụp màn hình và PDF dạng scan vào wiki.
+- [ ] **Theo dõi phiên bản bài báo:** Nhận thông báo khi một bài báo đã nạp có bản sửa đổi hoặc phiên bản xuất bản chính thức mới.
 - [ ] **Google Workspace:** Nạp trực tiếp Google Docs và Sheets vào đồ thị tri thức.
 - [ ] **Hỗ trợ đa phương tiện:** Xử lý video YouTube và ghi âm Audio thông qua transcript.
 - [ ] **Kiểm định đồ thị tri thức:** Tự động phát hiện mâu thuẫn và sai lệch cấu trúc.

package/README.zh.md

@@ -78,7 +78,7 @@ npx lumina-wiki install
 
 > **Windows 用户注意：** 为了获得最佳体验，建议[启用开发者模式](https://learn.microsoft.com/zh-cn/windows/apps/get-started/enable-your-device-for-development)，以便安装程序正确使用符号链接。如果开发者模式关闭，安装程序会退回到复制 skill 文件；功能仍然可用，但对后续更新不如符号链接理想。
 
-安装程序会引导您完成几个快速设置步骤，包括选择可选的 **Packs**，例如 `research`（研究）和 `reading`（阅读）。
+安装程序会引导您完成几个快速设置步骤，包括选择可选的 **Packs**，例如 `research`（研究）、`reading`（阅读）和 `learning`（学习）。
 
 ### **第二步（可选）：配置 Research Pack**
 
@@ -117,7 +117,7 @@ node _lumina/scripts/wiki.mjs migrate --add-defaults
 -   `/lumi-edit [path/to/wiki/page]`: 要求修改或修正某个具体 wiki 页面。
 -   `/lumi-check`: 检查整个 wiki 的问题（断链、孤立页面等）。
 
-*如果您安装了 `research` 或 `reading` 等可选包，还会有额外技能可用。*
+*如果您安装了 `research`、`reading` 或 `learning` 等可选包，还会有额外技能可用。*
 
 ---
 
@@ -189,6 +189,7 @@ npx skills add https://github.com/tobi/qmd --skill qmd
 | | `/lumi-reading-character-track`| 追踪故事中的角色及其关系。 |
 | | `/lumi-reading-theme-map` | 识别并映射故事主题。 |
 | | `/lumi-reading-plot-recap` | 提供情节的顺序回顾。 |
+| **Learning** | `/lumi-learning-reflect` | 引导一次针对某个概念或资料的自我反思（self-reflection）。在 `wiki/reflections/` 中创建个人反思页，包含可改写的"当前理解"部分和只能追加的"演变日志"。AI 充当认知镜——引用你过去说的话并提问——但从不替你撰写反思内容。 |
 
 后台脚本位于 `_lumina/scripts/` 和 `_lumina/tools/`；通常您不需要直接调用它们。
 
@@ -199,16 +200,18 @@ npx skills add https://github.com/tobi/qmd --skill qmd
 Lumina-Wiki 正在快速演进。这是我们的用户路线图：
 
 **近期计划（稳定性与新导入支持）**
-- [x] **`/lumi-help` 技能：** 智能助手读取工作区状态并告诉你下一步该做什么；加参数 `/lumi-help skills` 可查看全部命令清单，或 `/lumi-help explain <主题>` 询问 Lumina 本身的工作原理。
+- [x] **`/lumi-help` 技能：** 智能助手读取工作区状态并告诉你下一步该做什么；加参数 `/lumi-help skills` 可查看全部命令清单，或 `/lumi-help explain <主题>` 询问 Lumina 本身的工作原理。*（v1.4 已发布）*
+- [x] **学习包（Learning Pack）：** 自我反思功能，帮助您追踪对某个概念的理解随时间的演变。*（v1.4 已发布）*
 - [x] **多语言安装：** 安装时可选英文、越南文或中文作为主语言。*（v1.2 已发布）*
 - [x] **原生 DOCX、RTF 与 EPUB 导入：** 通过 research pack 将 Word、Rich Text 与 EPUB 电子书直接导入维基。*（v1.x 已发布）*
-- [ ] **图片 OCR 与扫描 PDF：** 将截图与扫描版 PDF 导入维基。
-- [ ] **高级论文排名：** 查看研究论文的影响力评分和质量信号。
 - [x] **改进的 CI/CD：** 正式支持 Bun 和 Node 22 环境。*（v1.2 已发布）*
+- [ ] **全球数据源扩展：** 直接集成 OpenAlex、CORE 和 Unpaywall，实现可靠的 DOI-to-PDF 解析。
+- [ ] **RSS 与博客监控：** 自动从您喜爱的实验室博客和期刊中发现新论文。
+- [ ] **高级论文排名：** 查看研究论文的影响力评分和质量信号。
 
 **长期计划（深度研究与集成）**
-- [ ] **全球数据源扩展：** 直接集成 OpenAlex、CORE 和 Unpaywall。
-- [ ] **RSS 与博客监控：** 自动从您喜爱的实验室博客中发现新论文。
+- [ ] **图片 OCR 与扫描 PDF：** 将截图与扫描版 PDF 导入维基。
+- [ ] **论文版本追踪：** 当已导入的论文出现新修订版或正式发表版本时发出通知。
 - [ ] **Google Workspace：** 直接将 Google Docs 和 Sheets 导入知识图谱。
 - [ ] **多媒体支持：** 通过转录处理 YouTube 视频和音频录音。
 - [ ] **知识图谱审计：** 自动检测矛盾和结构偏移。

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "lumina-wiki",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Domain-agnostic, multi-IDE wiki scaffolder — Karpathy's LLM-Wiki vision, cross-platform and pack-based.",
   "keywords": [
     "llm-wiki",
@@ -84,7 +84,7 @@
   "scripts": {
     "test": "npm run test:installer",
     "test:installer": "node --test bin/lumina.flags.test.js bin/lumina.deprecations.test.js bin/lumina.cancel.test.js src/installer/commands.test.js src/installer/fs.test.js src/installer/locales.test.js src/installer/manifest.test.js src/installer/prompts.test.js src/installer/readme-templates.test.js src/installer/template-engine.test.js src/installer/update-check.test.js",
-    "test:scripts": "node --test src/scripts/lint.test.mjs src/scripts/reset.test.mjs src/scripts/wiki.test.mjs src/scripts/discover-runner.test.mjs src/scripts/external-ids.test.mjs src/scripts/parse-ids.test.mjs src/scripts/merge-ids.test.mjs src/scripts/build-source.test.mjs src/scripts/wiki-yaml-object.test.mjs",
+    "test:scripts": "node --test src/scripts/lint.test.mjs src/scripts/reset.test.mjs src/scripts/wiki.test.mjs src/scripts/discover-runner.test.mjs src/scripts/external-ids.test.mjs src/scripts/parse-ids.test.mjs src/scripts/merge-ids.test.mjs src/scripts/build-source.test.mjs src/scripts/wiki-yaml-object.test.mjs src/scripts/schemas.test.mjs",
     "test:python": "node scripts/run-pytest.mjs",
     "test:all": "npm run test:installer && npm run test:scripts && npm run test:python",
     "test:catalog": "node --test scripts/verify-lumi-help.test.mjs",

package/src/installer/commands.js

@@ -112,6 +112,7 @@ const CORE_WIKI_DIRS = [
 
 const RESEARCH_WIKI_DIRS = ['wiki/foundations', 'wiki/topics'];
 const READING_WIKI_DIRS  = ['wiki/chapters', 'wiki/characters', 'wiki/themes', 'wiki/plot'];
+const LEARNING_WIKI_DIRS = ['wiki/reflections'];
 
 const CORE_RAW_DIRS = ['raw/sources', 'raw/notes', 'raw/assets', 'raw/tmp', 'raw/download'];
 const RESEARCH_RAW_DIRS = ['raw/discovered'];
@@ -124,7 +125,7 @@ const LUMINA_DIRS = [
   '_lumina/_state',
 ];
 
-const VALID_PACKS = new Set(['core', 'research', 'reading']);
+const VALID_PACKS = new Set(['core', 'research', 'reading', 'learning']);
 const VALID_IDE_TARGETS = new Set(['claude_code', 'codex', 'cursor', 'gemini_cli', 'qwen', 'iflow', 'generic']);
 
 // ---------------------------------------------------------------------------
@@ -221,6 +222,7 @@ export async function installCommand(opts = {}) {
   const { projectName, researchPurpose, ideTargets, packs, communicationLang, documentOutputLang, locale } = answers;
   const hasResearch = packs.includes('research');
   const hasReading  = packs.includes('reading');
+  const hasLearning = packs.includes('learning');
 
   console.log('');
   if (isUpgrade) {
@@ -242,6 +244,9 @@ export async function installCommand(opts = {}) {
   if (hasReading) {
     dirsToCreate.push(...READING_WIKI_DIRS);
   }
+  if (hasLearning) {
+    dirsToCreate.push(...LEARNING_WIKI_DIRS);
+  }
 
   for (const dir of dirsToCreate) {
     await ensureDir(join(projectRoot, dir));
@@ -256,6 +261,7 @@ export async function installCommand(opts = {}) {
     pack_core:     true,
     pack_research: hasResearch,
     pack_reading:  hasReading,
+    pack_learning: hasLearning,
     created_at:    new Date().toISOString().slice(0, 10),
     schema_version: String(MANIFEST_SCHEMA_VERSION),
   };
@@ -764,6 +770,7 @@ async function renderAndWriteConfig(projectRoot, templateVars, answers) {
       core:     true,
       research: answers.packs.includes('research'),
       reading:  answers.packs.includes('reading'),
+      learning: answers.packs.includes('learning'),
     },
     paths: {
       raw:     'raw',
@@ -779,7 +786,7 @@ async function renderAndWriteConfig(projectRoot, templateVars, answers) {
       log_prefix:   '## [{{date}}] {{skill}} | {{details}}',
       bidirectional_links: {
         mode: 'exempt-only',
-        exemptions: ['foundations/**', 'outputs/**', '*://*'],
+        exemptions: ['foundations/**', 'outputs/**', '*://*', ...(answers.packs.includes('learning') ? ['reflections/**'] : [])],
       },
       graph: {
         enabled: true,
@@ -1063,6 +1070,15 @@ function getSkillDefs(packs) {
     }
   }
 
+  if (packs.includes('learning')) {
+    const learningSkills = [
+      { name: 'reflect', canonicalId: 'lumi-learning-reflect', displayName: '/lumi-learning-reflect' },
+    ];
+    for (const s of learningSkills) {
+      defs.push({ ...s, pack: 'learning', srcPackPath: 'packs/learning' });
+    }
+  }
+
   return defs;
 }
 

package/src/installer/locales/en.mjs

@@ -37,6 +37,8 @@ export default {
   'prompt.packs.option.research.hint':         'discover/survey/prefill/setup skills + source-fetcher tools',
   'prompt.packs.option.reading.label':         'Reading',
   'prompt.packs.option.reading.hint':          'chapter-ingest/character-track/theme-map/plot-recap skills',
+  'prompt.packs.option.learning.label':        'Learning',
+  'prompt.packs.option.learning.hint':         'self-reflection skills (reflect skill + wiki/reflections/)',
 
   // ── Language pair ──────────────────────────────────────────────────────────
   'prompt.communication_language.message':     'Communication language (how the LLM talks to you)',

package/src/installer/locales/vi.mjs

@@ -36,6 +36,8 @@ export default {
   'prompt.packs.option.research.hint':         'kỹ năng discover/survey/prefill/setup + công cụ lấy nguồn',
   'prompt.packs.option.reading.label':         'Reading',
   'prompt.packs.option.reading.hint':          'kỹ năng chapter-ingest/character-track/theme-map/plot-recap',
+  'prompt.packs.option.learning.label':        'Learning',
+  'prompt.packs.option.learning.hint':         'kỹ năng tự phản tư (reflect + wiki/reflections/)',
 
   // ── Language pair ──────────────────────────────────────────────────────────
   'prompt.communication_language.message':     'Ngôn ngữ giao tiếp (LLM trò chuyện với bạn)',

package/src/installer/locales/zh.mjs

@@ -42,6 +42,8 @@ export default {
   'prompt.packs.option.research.hint':         'discover/survey/prefill/setup 技能 + 来源抓取工具',
   'prompt.packs.option.reading.label':         'Reading',
   'prompt.packs.option.reading.hint':          'chapter-ingest/character-track/theme-map/plot-recap 技能',
+  'prompt.packs.option.learning.label':        'Learning',
+  'prompt.packs.option.learning.hint':         '自我反思技能 (reflect 技能 + wiki/reflections/)',
 
   // ── Language pair ──────────────────────────────────────────────────────────
   'prompt.communication_language.message':     '交流语言(LLM 与你对话使用的语言)',

package/src/installer/prompts.js

@@ -151,7 +151,7 @@ export function buildPromptList(existingManifest, defaultLocale = 'en') {
  * @param {Function} [opts.t]                   - Locale translator function.
  * @returns {Promise<InstallAnswers>}
  */
-export async function runInstallPrompts({ acceptDefaults = false, cwd = process.cwd(), existingManifest = null, defaultLocale = 'en', t = null } = {}) {
+export async function runInstallPrompts({ acceptDefaults = false, cwd = process.cwd(), existingManifest = null, defaultLocale = 'en', t: initialT = null } = {}) {
   if (acceptDefaults) {
     const loc = existingManifest?.locale ?? defaultLocale;
     return defaultAnswers(cwd, loc);
@@ -159,6 +159,11 @@ export async function runInstallPrompts({ acceptDefaults = false, cwd = process.
 
   const { intro, outro, text, multiselect, select, confirm, isCancel, cancel } = await getClack();
 
+  // t starts as whatever the caller passed (may be null on fresh install where
+  // locale is unknown). After Prompt 0 selects the locale, we rebind t to the
+  // user-chosen locale so prompts 1-5 are localized.
+  let t = initialT;
+
   // t may not be available yet at intro time (locale not yet selected);
   // use hardcoded EN for intro — this is the chicken-and-egg prompt.
   intro('Lumina Wiki Installer');
@@ -179,14 +184,26 @@ export async function runInstallPrompts({ acceptDefaults = false, cwd = process.
   const locale = localeRaw;
   const langDefault = LOCALE_LANGUAGE_NAME[locale] ?? 'English';
 
+  // Rebind t to the just-selected locale so the remaining prompts render in
+  // the user's chosen language. Without this, prompts 1-5 silently fall back
+  // to EN literals even when the user picked vi/zh at Prompt 0.
+  try {
+    const { loadLocale } = await import('./locales.js');
+    const localeMod = await loadLocale(locale);
+    t = localeMod.t;
+  } catch {
+    // Keep whatever t we had (possibly null → EN literals); never block install.
+  }
+
   // Interactive locale-switch confirmation (Phase 5 §60-63):
   // If user picks a locale different from the installed one on an upgrade,
   // require explicit confirmation before destructively rewriting README.md
   // and IDE stubs. Default N — protects user content.
   if (existingManifest?.locale && existingManifest.locale !== locale) {
     const proceed = await confirm({
-      // Use trilingual literal — t() not yet bound to chosen locale and the
-      // user is mid-switch; both old and new locales are relevant context.
+      // Use trilingual literal — user is mid-switch, so both old and new
+      // locales are relevant context. t() is available here but intentionally
+      // not used so the warning is legible in either locale.
       message: `Locale change ${existingManifest.locale} -> ${locale} will rewrite README.md and IDE stubs in the new locale. Outside-schema edits are preserved. Continue?`,
       initialValue: false,
     });
@@ -241,6 +258,7 @@ export async function runInstallPrompts({ acceptDefaults = false, cwd = process.
     options: [
       { value: 'research', label: t ? t('prompt.packs.option.research.label') : 'Research', hint: t ? t('prompt.packs.option.research.hint') : 'discover/survey/prefill/setup skills + source-fetcher tools' },
       { value: 'reading',  label: t ? t('prompt.packs.option.reading.label') : 'Reading',   hint: t ? t('prompt.packs.option.reading.hint') : 'chapter-ingest/character-track/theme-map/plot-recap skills' },
+      { value: 'learning', label: t ? t('prompt.packs.option.learning.label') : 'Learning', hint: t ? t('prompt.packs.option.learning.hint') : 'self-reflection skills (reflect skill + wiki/reflections/)' },
     ],
     required: false,
   });

package/src/scripts/lint.mjs

@@ -1178,7 +1178,8 @@ async function runLint(projectRoot, opts) {
   allFindings.push(...checkL08(edges));
 
   if (indexContent !== undefined) {
-    allFindings.push(...checkL09(indexPath, indexContent, entityFiles));
+    const indexEntityFiles = entityFiles.filter(f => !f.startsWith('reflections/'));
+    allFindings.push(...checkL09(indexPath, indexContent, indexEntityFiles));
   }
 
   // L10: collect all foundation frontmatters in one pass, then check for alias conflicts.
@@ -1284,7 +1285,7 @@ async function applyFixes(findings, wikiRoot, edgesPath, indexPath, indexContent
   // Fix L09.
   const l09findings = findings.filter(f => f.id === 'L09-index-stale');
   if (l09findings.length > 0) {
-    const { newContent, preview } = fixL09(indexContent, entityFiles);
+    const { newContent, preview } = fixL09(indexContent, entityFiles.filter(f => !f.startsWith('reflections/')));
     if (newContent !== indexContent) {
       if (opts.dryRun) {
         for (const f of l09findings) { f.proposed_fix = preview; }

package/src/scripts/schemas.mjs

@@ -35,6 +35,7 @@ export const SCHEMA_VERSION = '0.1.0';
 export const EXEMPTION_GLOBS = [
   'foundations/**',
   'outputs/**',
+  'reflections/**',
   '*://*',
 ];
 
@@ -86,7 +87,7 @@ export const ENUMS = {
 // ---------------------------------------------------------------------------
 
 /**
- * @typedef {'core'|'research'|'reading'} Pack
+ * @typedef {'core'|'research'|'reading'|'learning'} Pack
  */
 
 /**
@@ -114,6 +115,9 @@ export const ENTITY_DIRS = {
   characters:  { dir: 'characters/',  pack: 'reading' },
   themes:      { dir: 'themes/',      pack: 'reading' },
   plot:        { dir: 'plot/',        pack: 'reading' },
+
+  // learning pack
+  reflections: { dir: 'reflections/', pack: 'learning' },
 };
 
 // ---------------------------------------------------------------------------
@@ -374,6 +378,18 @@ export const REQUIRED_FRONTMATTER = {
     { key: 'book',      type: 'string',   required: true,  pack: 'reading' },
     { key: 'up_to_chapter', type: 'number', required: true, pack: 'reading' },
   ],
+
+  // Learning pack: reflection page (personal overlay — exempt from bidi links)
+  reflections: [
+    { key: 'id',               type: 'string',   required: true,  pack: 'learning' },
+    { key: 'title',            type: 'string',   required: true,  pack: 'learning' },
+    { key: 'type',             type: 'string',   required: true,  pack: 'learning' },
+    { key: 'created',          type: 'iso-date', required: true,  pack: 'learning' },
+    { key: 'updated',          type: 'iso-date', required: true,  pack: 'learning' },
+    { key: 'related_concepts', type: 'array',    required: true,  pack: 'learning' },
+    { key: 'related_sources',  type: 'array',    required: true,  pack: 'learning' },
+    { key: 'evolution_count',  type: 'number',   required: true,  pack: 'learning' },
+  ],
 };
 
 // ---------------------------------------------------------------------------

package/src/skills/core/help/SKILL.md

@@ -86,6 +86,7 @@ core → research → reading → other (alphabetical). Pack labels are hardcode
 - `core` → "Core (always installed)"
 - `research` → "Research pack"
 - `reading` → "Reading pack"
+- `learning` → "Learning pack"
 - other → pack name with first letter capitalized
 
 Each entry: `` `[<menu>]` `/<id>` <args if non-empty> — <description> ``. End with

package/src/skills/packs/learning/reflect/SKILL.md

@@ -0,0 +1,190 @@
+---
+name: lumi-learning-reflect
+description: >
+  Guide a self-reflection session on a concept, source, or topic the user has studied.
+  Creates or updates a personal reflection page in wiki/reflections/ with a rewritable
+  "Current understanding" section and an append-only "Evolution" log. AI acts as a
+  metacognitive mirror — quotes the user's past words and asks questions — but never
+  writes reflection content. Use whenever the user invokes /lumi-learning-reflect, says
+  "reflect on <concept>", "update my reflection on <topic>", "what do I think about
+  <concept>?", "I want to journal about <topic>", "phản tư về <concept>", "suy ngẫm về
+  <topic>", "反思 <concept>", "我对 <topic> 的理解", or any phrasing indicating they want
+  to record or revisit their personal understanding of a wiki concept or source.
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Edit
+---
+
+# /lumi-learning-reflect
+
+Read `README.md` at the project root before this SKILL.md.
+
+## TL;DR
+
+Creates or updates a `wiki/reflections/<slug>.md` personal reflection page. AI acts as a
+metacognitive mirror — it reads past entries, quotes the user's own words, and asks
+questions — but **never writes reflection content**. The user writes their own understanding.
+
+Reflection pages are a **personal overlay**. They do not write graph edges. They do not
+require reverse links from academic pages. `reflections/**` is exempt from bidirectional-
+link requirements.
+
+## When to use
+
+Invoke when the user wants to:
+- Record their current understanding of a concept for the first time
+- Revisit and update an existing reflection after learning more
+- Compare their past understanding to their current one
+- Receive prompting questions to deepen their thinking
+
+This skill is **personal-layer only**. It does not modify concept, source, or any other
+academic wiki pages.
+
+## Inputs
+
+- `<concept-id>` — optional. The slug of the concept, source, or topic to reflect on
+  (e.g. `cognitive-offloading`, `the-memory-paradox`). If omitted, ask the user what they
+  want to reflect on before proceeding.
+
+## Preconditions
+
+Before running:
+1. Read `_lumina/config/lumina.config.yaml` to confirm `packs.learning: true`. If not
+   present, halt and inform the user that the learning pack is not installed.
+2. Read `_lumina/schema/page-templates.md` for the Reflection page template.
+3. If `<concept-id>` is provided, check whether a reflection page already exists at
+   `wiki/reflections/<concept-id>.md`.
+
+## Workflow
+
+### Step 1 — Load context (READ ONLY)
+
+1. If the reflection page exists, read it fully. Note:
+   - The current `## Current understanding` text.
+   - The `## Evolution` log: how many entries, dates, and the trajectory of change.
+   - The `evolution_count` frontmatter field.
+2. If related concept/source pages exist (from `related_concepts:` / `related_sources:`),
+   read their `## Definition` and `## Summary` sections only — do not scan the full page.
+3. **Do not write anything yet.**
+
+### Step 2 — Mirror mode (PROMPT ONLY)
+
+Present to the user in their communication language (`communication_language` from
+`_lumina/config/lumina.config.yaml`):
+
+**If this is a new reflection (no existing page):**
+> "There's no reflection yet on [Concept]. Before you write, tell me: what does
+> [Concept] mean to you right now, in your own words?"
+
+**If this is an existing reflection (page found):**
+Quote 1–2 sentences from the user's most recent `## Evolution` entry (or from
+`## Current understanding` if no Evolution entries exist). Then ask:
+> "You wrote: '[quoted text]'. Has your understanding shifted since then? What would
+> you add, remove, or change?"
+
+Do **not** summarize the concept from the academic pages. Do not explain what the concept
+means. Do not suggest answers. Just prompt and wait.
+
+### Step 3 — User writes (WAIT)
+
+Wait for the user to respond with their own words. **Do not proceed until the user
+has provided content.** If the user asks "what should I write?" or "can you write it for
+me?", respond:
+> "This reflection is yours to write — I can only prompt you. What comes to mind when
+> you think about [Concept]?"
+
+### Step 4 — Ask follow-up questions (OPTIONAL, 1 round)
+
+After the user has written something, you may ask **one clarifying question** to deepen
+the reflection. Choose from question types appropriate to the trajectory:
+
+- **Contrast**: "How is this different from [related concept] in your mind?"
+- **Application**: "Can you think of a moment in your own learning where this happened?"
+- **Uncertainty**: "What part of [Concept] are you least confident about?"
+- **Implication**: "What would change in how you study if this is true?"
+
+Then wait for the user's response, or let them decline to answer.
+
+### Step 5 — Write the reflection page
+
+Using the user's words (not a paraphrase, not a summary — their exact words), construct
+or update the reflection page:
+
+**Frontmatter updates:**
+- `updated`: today's ISO date
+- `evolution_count`: increment by 1 (or set to 1 for new pages)
+- `related_concepts`: list any concept slugs the user mentioned or that were the focus
+- `related_sources`: list any source slugs the user mentioned
+
+**`## Current understanding` section:**
+- Replace entirely with the user's written response from Step 3 (and any follow-up from
+  Step 4 if provided). This section is always the user's most recent understanding.
+- Do **not** add any AI-generated text, qualifiers, or commentary.
+
+**`## Evolution` section:**
+- **Append only** — never edit or delete existing entries.
+- Add a new entry at the **bottom** of the section:
+  ```markdown
+  ### YYYY-MM-DD — <brief label in 3–5 words>
+  <1–3 sentence summary of what the user wrote or changed in this session>
+  ```
+- The brief label should describe the shift (e.g. "First understanding", "Added contrast
+  with spaced repetition", "Revised after reading Memory Paradox").
+- The summary in the Evolution entry may be written by the AI — it is a record of what
+  was written, not the reflection itself.
+
+**Frontmatter `id` field (new pages only):** `reflection-<concept-id>` — flat slug with
+`reflection-` prefix (e.g. `reflection-cognitive-offloading`). Do not use path-prefixed form.
+
+**File path:**
+- New page: `wiki/reflections/<concept-id>.md` — use `Write` tool
+- Existing page: same path — use `Edit` tool. When editing, use the exact section heading
+  `## Current understanding` as the start anchor and `## Evolution` as the end boundary.
+  The `old_string` must span from `## Current understanding` through (but not including)
+  `## Evolution` — never let the match region cross into the Evolution log.
+
+### Step 6 — Log and confirm
+
+Append a log entry via the wiki engine:
+
+```bash
+node _lumina/scripts/wiki.mjs log lumi-learning-reflect "reflected on <concept-id>; evolution_count=<N>"
+```
+
+Then report to the user:
+- Page path written/updated
+- `evolution_count` after this session
+- A one-sentence confirmation that their reflection is saved
+
+## Output / DoD
+
+- `wiki/reflections/<concept-id>.md` exists with valid frontmatter (`id`, `title`, `type:
+  reflection`, `created`, `updated`, `related_concepts`, `related_sources`, `evolution_count`).
+- `## Current understanding` contains only the user's own words from this session.
+- `## Evolution` has a new entry appended at the bottom; no existing entries are modified.
+- `wiki/log.md` has one new appended line for this session.
+- No academic pages (`wiki/concepts/`, `wiki/sources/`, `wiki/people/`, etc.) were modified.
+- No graph edges were written (`edges.jsonl` unchanged).
+
+## Boundary constraints (non-negotiable)
+
+- **Never write to academic pages**: no edits to `wiki/concepts/`, `wiki/sources/`,
+  `wiki/people/`, or any non-reflection path.
+- **Never write graph edges**: do not call `wiki.mjs add-edge` or modify `edges.jsonl`.
+  Frontmatter `related_concepts:` and `related_sources:` are the only connection mechanism.
+- **Never generate reflection content**: the `## Current understanding` section must
+  contain only the user's own words. AI may only edit the Evolution entry summary and
+  the frontmatter fields.
+- **No wikilinks in body**: reflection pages must not use `[[concept-slug]]` inline links.
+  Frontmatter lists only.
+
+## Error cases
+
+| Situation | Response |
+|-----------|----------|
+| Learning pack not installed (`packs.learning` not in config) | Halt. Inform user the learning pack is required. |
+| User declines to write | Acknowledge and exit. Do not create an empty page. |
+| `concept-id` not found in `wiki/concepts/` | Proceed anyway — reflections can be on any topic, not just existing concept pages. Note to user that no concept page was found. |
+| Evolution entry already exists for today | Append a second entry for today with a different label. Do not merge. |

package/src/templates/README.md

@@ -48,6 +48,9 @@ Keep this mental map in immediate context:
 {{#if pack_reading}}
 - `wiki/chapters/`, `wiki/characters/`, `wiki/themes/`, `wiki/plot/` (pack: reading)
 {{/if}}
+{{#if pack_learning}}
+- `wiki/reflections/` — personal reflection pages (pack: learning; personal overlay, not part of the academic graph)
+{{/if}}
 
 ### `raw/` is user-owned
 
@@ -96,6 +99,7 @@ Every wiki page has a defined type, frontmatter, and section structure. **Open `
 | Character  | `characters/` | Character profile with arcs, relationships, key chapters (reading)   |
 | Theme      | `themes/`     | Thematic thread traced across the work (reading)                     |
 | Plot       | `plot/`       | Plot threads, beats, and timeline (reading)                          |
+{{/if}}{{#if pack_learning}}| Reflection | `reflections/`| Personal understanding of a concept; rewritable + append-only log (learning) |
 {{/if}}
 
 ---
@@ -136,6 +140,8 @@ Some links are intentionally one-way. Defaults:
 {{#if pack_research}}- **`foundations/**`** — terminal pages
 {{/if}}- **`outputs/**`** — ephemeral artifacts
 - **External URLs** (`*://*`) — out of wiki scope
+{{#if pack_learning}}- **`reflections/**`** — personal overlay; never requires reverse links from academic pages
+{{/if}}
 
 Anything outside an exemption glob must be bidirectional.
 
@@ -197,6 +203,10 @@ Adds `/lumi-research-discover` (ranked candidate shortlist), `/lumi-research-wat
 
 Adds `/lumi-reading-chapter-ingest` (file a chapter, update characters/themes/plot pages), `/lumi-reading-character-track` (build or refresh a character profile across chapters), `/lumi-reading-theme-map` (trace a theme across chapters with citations), `/lumi-reading-plot-recap` (summarize plot up to a chapter, spoiler-bounded).
 {{/if}}
+{{#if pack_learning}}### Pack: learning
+
+Adds `/lumi-learning-reflect` (guide a self-reflection session; creates or updates a personal `wiki/reflections/` page with a rewritable `## Current understanding` section and an append-only `## Evolution` log; AI acts as a metacognitive mirror — quotes your past words and asks questions — but never writes reflection content for you).
+{{/if}}
 
 ---
 

package/src/templates/README.vi.md

@@ -48,6 +48,9 @@ Ghi nhớ bản đồ tư duy này trong ngữ cảnh tức thì:
 {{#if pack_reading}}
 - `wiki/chapters/`, `wiki/characters/`, `wiki/themes/`, `wiki/plot/` (gói: reading)
 {{/if}}
+{{#if pack_learning}}
+- `wiki/reflections/` — trang phản tư cá nhân (gói: learning; lớp phủ cá nhân, không thuộc đồ thị học thuật)
+{{/if}}
 
 ### `raw/` thuộc quyền sở hữu của người dùng
 
@@ -96,6 +99,7 @@ Mỗi trang wiki có loại, frontmatter và cấu trúc phần được định
 | Character  | `characters/` | Hồ sơ nhân vật với diễn biến, mối quan hệ, các chương chính (reading)   |
 | Theme      | `themes/`     | Chủ đề xuyên suốt tác phẩm (reading)                                    |
 | Plot       | `plot/`       | Các luồng cốt truyện, nhịp điệu và dòng thời gian (reading)             |
+{{/if}}{{#if pack_learning}}| Reflection | `reflections/`| Hiểu biết cá nhân về một khái niệm; có thể cập nhật + nhật ký chỉ thêm (learning) |
 {{/if}}
 
 ---
@@ -136,6 +140,8 @@ Một số liên kết cố ý chỉ một chiều. Mặc định:
 {{#if pack_research}}- **`foundations/**`** — trang cuối cùng
 {{/if}}- **`outputs/**`** — tạo phẩm tạm thời
 - **URL bên ngoài** (`*://*`) — ngoài phạm vi wiki
+{{#if pack_learning}}- **`reflections/**`** — lớp phủ cá nhân; không yêu cầu liên kết ngược từ các trang học thuật
+{{/if}}
 
 Bất kỳ thứ gì ngoài glob miễn trừ phải là hai chiều.
 
@@ -196,6 +202,10 @@ Thêm `/lumi-research-discover` (danh sách ứng viên được xếp hạng),
 
 Thêm `/lumi-reading-chapter-ingest` (lưu chương, cập nhật trang nhân vật/chủ đề/cốt truyện), `/lumi-reading-character-track` (xây dựng hoặc làm mới hồ sơ nhân vật qua các chương), `/lumi-reading-theme-map` (truy tìm chủ đề qua các chương với trích dẫn), `/lumi-reading-plot-recap` (tóm tắt cốt truyện đến một chương, giới hạn spoiler).
 {{/if}}
+{{#if pack_learning}}### Gói: learning
+
+Thêm `/lumi-learning-reflect` (hướng dẫn phiên phản tư; tạo hoặc cập nhật trang `wiki/reflections/` với phần `## Hiểu biết hiện tại` có thể cập nhật và nhật ký `## Tiến trình` chỉ thêm; AI hoạt động như gương nhận thức — trích dẫn lời bạn nói trước đây và đặt câu hỏi — nhưng không bao giờ tự viết nội dung phản tư).
+{{/if}}
 
 ---
 

package/src/templates/README.zh.md

@@ -49,6 +49,9 @@
 {{#if pack_reading}}
 - `wiki/chapters/`、`wiki/characters/`、`wiki/themes/`、`wiki/plot/`（包：reading）
 {{/if}}
+{{#if pack_learning}}
+- `wiki/reflections/` — 个人反思页面（包：learning；个人叠加层，不属于学术图谱）
+{{/if}}
 
 ### `raw/` 属于用户
 
@@ -97,6 +100,7 @@
 | Character  | `characters/` | 包含弧线、关系、关键章节的人物档案（reading）                        |
 | Theme      | `themes/`     | 贯穿作品的主题线索（reading）                                        |
 | Plot       | `plot/`       | 情节线索、节拍和时间线（reading）                                    |
+{{/if}}{{#if pack_learning}}| Reflection | `reflections/`| 对某个概念的个人理解；可更新内容 + 只追加的演化日志（learning） |
 {{/if}}
 
 ---
@@ -137,6 +141,8 @@
 {{#if pack_research}}- **`foundations/**`** — 终端页面
 {{/if}}- **`outputs/**`** — 临时工件
 - **外部 URL**（`*://*`）— 超出 wiki 范围
+{{#if pack_learning}}- **`reflections/**`** — 个人叠加层；不需要学术页面的反向链接
+{{/if}}
 
 豁免 glob 之外的任何内容必须是双向的。
 
@@ -197,6 +203,10 @@
 
 添加 `/lumi-reading-chapter-ingest`（归档章节，更新人物/主题/情节页面）、`/lumi-reading-character-track`（跨章节构建或刷新人物档案）、`/lumi-reading-theme-map`（带引用地跨章节追踪主题）、`/lumi-reading-plot-recap`（总结到某章为止的情节，受 spoiler 限制）。
 {{/if}}
+{{#if pack_learning}}### 包：learning
+
+添加 `/lumi-learning-reflect`（引导自我反思会话；创建或更新 `wiki/reflections/` 页面，包含可更新的 `## 当前理解` 部分和只追加的 `## 演化` 日志；AI 充当认知镜子 — 引用您过去的话语并提问 — 但绝不为您撰写反思内容）。
+{{/if}}
 
 ---
 

package/src/templates/_lumina/schema/cross-reference-packs.md

@@ -41,3 +41,17 @@ These apply in all workspaces regardless of installed packs.
 | `chapters/C` -> `themes/T`          | `themes/T` -> `chapters/C`              | No         |
 | `characters/P` -> `characters/Q`    | `characters/Q` -> `characters/P`        | No         |
 {{/if}}
+{{#if pack_learning}}
+
+---
+
+## Learning pack cross-reference rules
+
+**No bidirectional-link rules.** `reflections/**` is listed in `EXEMPTION_GLOBS` — the entire directory is a personal overlay and is exempt from reverse-link requirements.
+
+Reflection pages reference academic pages via frontmatter (`related_concepts:`, `related_sources:`) only. No graph edges are written and no reverse links are required from concept or source pages back to reflections.
+
+| Forward link                        | Required reverse link                     | Exemption? |
+|-------------------------------------|-------------------------------------------|------------|
+| `reflections/R` -> anything         | (no reverse required — personal overlay) | Yes        |
+{{/if}}

package/src/templates/_lumina/schema/lumi-help-runbook.md

@@ -38,6 +38,9 @@ templated form.
 - *Plus Lumina noun*: `lumi-`, `wiki`, `raw`, `foundations`, `outputs`,
   `summary`, `concepts`, `sources`, `ingest`, `bidirectional`, `link`, `edge`,
   `graph`, `frontmatter`, `slug`, `pack`, `lint`, `manifest`, `Lumina`.
+{{#if pack_learning}}
+  Learning pack adds: `reflections`, `reflect`, `phản tư`, `反思`.
+{{/if}}
 
 If the question is about wiki *content* (not framework), bridge to `/lumi-ask`
 instead of Mode C.
@@ -159,6 +162,9 @@ Pack labels (hardcoded):
 - `core` → "Core (always installed)"
 - `research` → "Research pack"
 - `reading` → "Reading pack"
+{{#if pack_learning}}
+- `learning` → "Learning pack"
+{{/if}}
 - other → pack name with first letter capitalized
 
 Output:

package/src/templates/_lumina/schema/lumi-help.csv

@@ -21,3 +21,6 @@ lumi-reading-character-track,RCT,reading,3-query,lumi-reading-chapter-ingest,,fa
 lumi-reading-theme-map,RTM,reading,3-query,lumi-reading-chapter-ingest,,false,,wiki/themes/**,trace a theme across chapters with citations
 lumi-reading-plot-recap,RPR,reading,3-query,lumi-reading-chapter-ingest,,false,,wiki/plot/**,spoiler-bounded plot summary up to a chapter
 {{/if}}
+{{#if pack_learning}}
+lumi-learning-reflect,LR,learning,anytime,,,false,[concept-id],wiki/reflections/**,guide a self-reflection session; create or update a personal reflection page
+{{/if}}

package/src/templates/_lumina/schema/page-templates.md

@@ -213,3 +213,38 @@ book: book-slug
 - `## Related themes`
 - `## Notes`
 {{/if}}
+{{#if pack_learning}}
+
+---
+
+## Reflection page — `wiki/reflections/<slug>.md` (learning pack)
+
+Created and updated via `/lumi-learning-reflect`. AI never writes reflection content.
+
+```yaml
+---
+id: reflection-<slug>
+title: "My understanding of <Concept Name>"
+type: reflection
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+related_concepts:
+  - concept-slug
+related_sources:
+  - source-slug
+evolution_count: 1
+---
+```
+
+**Sections:**
+- `## Current understanding` — **rewritable**: the user's latest thinking in their own words; AI may quote past versions to prompt reflection but never edits this section
+- `## Evolution` — **append-only**: one dated entry per reflection session; never edit or delete entries
+
+**Evolution entry format:**
+```markdown
+### YYYY-MM-DD — <brief label>
+<What you wrote or changed in this session (1–3 sentences)>
+```
+
+**Boundary rule:** Reflection pages are **personal overlay** — they reference academic pages via frontmatter only (no wikilinks that create graph edges). Do not write `[[concept-slug]]` inline body links; reference concepts only in `related_concepts:` frontmatter. No reverse link is required from concept/source pages back to reflections.
+{{/if}}