evnict-kit 0.2.2 → 0.2.4

package/templates/skills/evnict-kit-frontend-design/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: evnict-kit-frontend-design
+description: Hướng dẫn tư duy thiết kế UI chất lượng cao cho Angular. Tập trung vào design thinking, aesthetics, typography, color, motion — tránh UI generic "AI slop". Dùng khi tạo component, page, hoặc cải thiện giao diện.
+compatibility: Angular 16+
+---
+
+# evnict-kit-frontend-design — Thiết kế UI Chất lượng Cao
+
+## Khi nào dùng
+- Tạo UI component/page mới
+- Cải thiện giao diện hiện có
+- Thiết kế landing page, dashboard, form phức tạp
+- Khi cần UI vượt trội hơn mức "tạm được"
+
+## Nguyên tắc cốt lõi
+> **UI do AI sinh ra PHẢI trông như được thiết kế bởi designer chuyên nghiệp,
+> KHÔNG phải output generic của AI.**
+
+---
+
+## 1. Design Thinking — TRƯỚC KHI CODE
+
+Trước khi viết bất kỳ dòng code nào, Agent PHẢI trả lời 4 câu hỏi:
+
+### 1.1 Purpose — Giao diện này giải quyết vấn đề gì?
+- Ai là người dùng? (admin, nhân viên, khách hàng?)
+- Họ cần làm gì? (nhập liệu, tra cứu, phê duyệt?)
+- Tần suất sử dụng? (hàng ngày vs. thi thoảng)
+
+### 1.2 Tone — Chọn hướng thẩm mỹ RÕ RÀNG
+Không dùng "trung tính an toàn". Chọn 1 hướng và đẩy mạnh:
+- **Refined/Professional** — enterprise app, dashboard, quản trị
+- **Minimalist/Clean** — form nhập liệu, workflow step-by-step
+- **Data-Dense/Utilitarian** — bảng dữ liệu lớn, reporting
+- **Modern/Dynamic** — landing page, portal, user-facing
+- **Soft/Approachable** — onboarding, wizard, hướng dẫn
+
+### 1.3 Constraints — Ràng buộc kỹ thuật
+- Framework: Angular (tuân thủ Angular conventions)
+- Component library đang dùng trong project
+- Responsive requirements
+- Accessibility requirements
+- Performance constraints
+
+### 1.4 Differentiation — Điểm nhấn đáng nhớ
+- UI này có gì KHÁC BIỆT so với template mặc định?
+- Người dùng sẽ nhớ gì sau khi rời trang?
+- Micro-interaction nào tạo cảm giác "chuyên nghiệp"?
+
+---
+
+## 2. Nguyên tắc Thẩm mỹ — Frontend Aesthetics
+
+### 2.1 Typography — Chữ phải ĐẸP và CÓ CÁ TÍNH
+- **KHÔNG dùng** font generic mặc định (Arial, system fonts)
+- **Chọn font có cá tính** phù hợp với tone của ứng dụng
+- **Pair fonts:** 1 display font nổi bật + 1 body font dễ đọc
+- **Hierarchy rõ ràng:** heading > subheading > body > caption
+- **Spacing:** line-height, letter-spacing phải được tinh chỉnh — không dùng default
+
+### 2.2 Color & Theme — Màu sắc PHẢI có chủ đích
+- **Commit vào 1 color palette nhất quán** — dùng CSS variables
+- **Dominant + Accent:** 1 màu chủ đạo mạnh + 1-2 màu nhấn, tốt hơn nhiều màu đều nhau
+- **TRÁNH:** tím gradient trên nền trắng (AI cliché), màu quá generic (red/blue/green thuần)
+- **Dark mode:** Nếu phù hợp — dark theme tạo cảm giác premium cho enterprise app
+- **Semantic colors:** success/warning/error/info phải nhất quán toàn app
+
+### 2.3 Motion & Micro-interactions — Sống động nhưng KHÔNG rối
+- **Ưu tiên CSS-only:** transitions, animations — không cần thêm lib nếu không cần thiết
+- **High-impact moments:** page load staggered reveal, hover state, expand/collapse
+- **Scroll-triggered effects:** chỉ dùng khi phù hợp (landing page, dashboard)
+- **Form feedback:** input focus, validation animation, submit loading state
+- **NGUYÊN TẮC:** 1 animation tốt > 10 animation rời rạc
+
+### 2.4 Spatial Composition — Bố cục KHÔNG nhàm chán
+- **TRÁNH:** layout đối xứng hoàn toàn, mọi thứ căn giữa
+- **Negative space:** khoảng trống có chủ đích tạo sự thoáng
+- **Grid-breaking:** 1-2 element phá grid tạo điểm nhấn
+- **Card depth:** shadow, border, background tạo layer hierarchy
+- **Responsive:** mobile-first, breakpoints hợp lý
+
+### 2.5 Backgrounds & Visual Details — Tạo chiều sâu
+- **KHÔNG mặc định nền trắng/xám nhạt** — cân nhắc gradient nhẹ, pattern, texture
+- **Depth effects:** shadow layers, glassmorphism (nếu phù hợp)
+- **Decorative elements:** border styles, dividers, icons có phong cách
+- **NGUYÊN TẮC:** Mỗi pixel phải có lý do tồn tại
+
+---
+
+## 3. Anti-Patterns — TUYỆT ĐỐI TRÁNH
+
+### ❌ "AI Slop" — Dấu hiệu UI sinh bởi AI kém chất lượng
+- Font Inter/Roboto/Arial trên mọi project
+- Tím gradient (#6366f1 → #8b5cf6) trên nền trắng
+- Card bo góc 8px + shadow nhẹ — mọi component giống nhau
+- Layout 100% đối xứng, không có điểm nhấn
+- Icon generic không có phong cách riêng
+- Spacing đều đặn máy móc, không có rhythm
+
+### ✅ Dấu hiệu UI được THIẾT KẾ tốt
+- Font choice phản ánh tính cách ứng dụng
+- Color palette có chủ đích, nhất quán
+- Layout có hierarchy rõ, mắt biết nhìn đâu trước
+- Micro-interactions tạo feedback tự nhiên
+- Mỗi trang/component có "cá tính" riêng — không copy-paste aesthetic
+
+---
+
+## 4. Áp dụng cho Angular
+
+### 4.1 Component Design
+- Mỗi component nên có CSS riêng — KHÔNG dùng inline styles tràn lan
+- Dùng CSS variables cho theme consistency
+- `:host` styling để component self-contained
+- `@media` queries cho responsive — mobile-first
+
+### 4.2 Theming
+- Định nghĩa design tokens (colors, spacing, typography) ở root/shared level
+- Component consume tokens — KHÔNG hardcode values
+- Support theme switching nếu dự án yêu cầu
+
+### 4.3 Animation trong Angular
+- Ưu tiên CSS transitions/animations
+- Angular Animations API cho complex state transitions
+- `@defer` cho lazy-loaded content với loading states đẹp
+
+### 4.4 Responsive
+- Breakpoints nhất quán toàn project
+- Mobile layout PHẢI được thiết kế — không chỉ "co lại"
+- Table → card view trên mobile
+- Navigation → hamburger/drawer trên mobile
+
+---
+
+## 5. Quy trình áp dụng
+
+```
+1. Đọc yêu cầu → Trả lời 4 câu hỏi Design Thinking
+2. Chọn tone + color palette + typography
+3. Sketch layout (mô tả text hoặc wireframe đơn giản)
+4. Implement component với full styling
+5. Review: so sánh với Anti-Patterns checklist
+6. Polish: micro-interactions, responsive, accessibility
+```
+
+> **QUAN TRỌNG:** Match complexity với vision.
+> - Design maximalist → code phải elaborate (animations, effects, layers)
+> - Design minimalist → code phải precise (spacing, typography, subtle details)
+> - Elegance = thực thi đúng vision, không phải nhiều hay ít code
+
+---
+
+## Tiêu chí chất lượng
+- [ ] Design Thinking 4 câu hỏi đã trả lời
+- [ ] Tone thẩm mỹ rõ ràng, nhất quán
+- [ ] Typography: font có cá tính, hierarchy rõ
+- [ ] Color: palette nhất quán, có dominant + accent
+- [ ] Layout: có hierarchy, không đối xứng nhàm chán
+- [ ] Motion: ít nhất 1 micro-interaction có ý nghĩa
+- [ ] Responsive: mobile-first, breakpoints hợp lý
+- [ ] KHÔNG có dấu hiệu "AI slop"

package/templates/skills/evnict-kit-spec/SKILL.md

@@ -24,7 +24,7 @@ compatibility: Java Spring Boot, Angular, ASP.NET Core
 1. Đọc `.evnict/config.yaml` → lấy project name, tech stack, wiki path
 2. Đọc `.agent/rules/05-evnict-kit-project-conventions.md` → nắm conventions dự án
 3. Query wiki (nếu có):
-   - Đọc index từ `{wiki_path}/processed/`
+   - Đọc index từ `{wiki_path}/wiki/`
    - Tìm theo keyword/domain/tags từ mô tả feature
    - Nếu tìm được context liên quan → đưa vào spec
 4. Scan codebase:

package/templates/skills/evnict-kit-wiki/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: evnict-kit-wiki
 description: Quản lý knowledge base dự án bằng LLM Wiki. Push tri thức, query, ingest, status, scan-code. Tích hợp sẵn vào cuối mọi workflow.
-compatibility: Node.js 18+
+compatibility: AI Agent (Claude Code / Antigravity)
 ---
 
 # evnict-kit-wiki — Project Knowledge Base
@@ -119,21 +119,8 @@ cp {generated_file} {wiki_path}/raw/notes/{domain}-{slug}.md
 ```
 
 #### Bước 4: TỰ ĐỘNG chạy ingest
-**KHÔNG bắt user chạy npm thủ công.** Agent TRỰC TIẾP chạy:
-```bash
-cd {wiki_path} && node scripts/ingest.js
-```
-
-Nếu `scripts/ingest.js` không tồn tại → thử:
-```bash
-cd {wiki_path} && npm run ingest
-```
-
-Nếu vẫn fail → retry 1 lần → nếu vẫn fail → báo lỗi cụ thể:
-```
-❌ Ingest failed: {error message}
-   Thử: cd {wiki_path} && npm install && node scripts/ingest.js
-```
+**KHÔNG bắt user chạy node/npm.** Agent TRỰC TIẾP chạy ingest:
+Thực hiện ingest procedure (tiến hành theo hướng dẫn Sub-command INGEST).
 
 #### Bước 5: Confirm
 ```
@@ -155,7 +142,7 @@ Nếu vẫn fail → retry 1 lần → nếu vẫn fail → báo lỗi cụ th
 
 #### Bước 1: Đọc wiki INDEX
 ```bash
-cat {wiki_path}/wiki/INDEX.md 2>/dev/null || cat {wiki_path}/processed/INDEX.md 2>/dev/null
+cat {wiki_path}/wiki/INDEX.md 2>/dev/null || cat {wiki_path}/wiki/INDEX.md 2>/dev/null
 ```
 Map keywords từ input vào index.
 
@@ -163,7 +150,7 @@ Map keywords từ input vào index.
 ```bash
 # Tìm trong wiki pages
 grep -rl "{keyword}" {wiki_path}/wiki/ --include="*.md" 2>/dev/null
-grep -rl "{keyword}" {wiki_path}/processed/ --include="*.md" 2>/dev/null
+grep -rl "{keyword}" {wiki_path}/wiki/ --include="*.md" 2>/dev/null
 # Tìm trong raw notes
 grep -rl "{keyword}" {wiki_path}/raw/notes/ --include="*.md" 2>/dev/null
 ```
@@ -193,34 +180,13 @@ grep -rl "{keyword}" {wiki_path}/raw/notes/ --include="*.md" 2>/dev/null
 
 ---
 
-## Sub-command: INGEST — Xử lý raw → wiki pages
-
-### Quy trình
-
-#### Bước 1: Scan raw sources
-```bash
-ls {wiki_path}/raw/notes/ | wc -l    # Đếm raw files
-ls {wiki_path}/wiki/ | wc -l         # Đếm wiki pages
-```
-
-#### Bước 2: Chạy ingest script
-Agent TRỰC TIẾP chạy (KHÔNG bắt user):
-```bash
-cd {wiki_path} && node scripts/ingest.js
-```
-
-#### Bước 3: Verify kết quả
-Với mỗi raw file đã xử lý:
-- Source summary → `wiki/sources/`
-- Entities extracted → `wiki/entities/`
-- Concepts extracted → `wiki/concepts/`
-- Cross-references thêm vào
-
-#### Bước 4: Cập nhật index
-```bash
-cat {wiki_path}/wiki/INDEX.md   # Verify index updated
-cat {wiki_path}/wiki/LOG.md     # Check log
-```
+## Sub-command: INGEST (từ project qua symlink)
+1. Wiki path: {project_name}-wiki/ (symlink)
+2. Đọc {wiki_path}/CLAUDE.md → hiểu schema
+3. Scan {wiki_path}/raw/notes/ → tìm file chưa có trong history.json
+4. Sinh wiki/sources/, wiki/entities/, wiki/concepts/
+5. Cập nhật INDEX.md + LOG.md + history.json
+→ Agent tự làm hết, KHÔNG cần mở Agent riêng
 
 ### QUAN TRỌNG
 - **KHÔNG BAO GIỜ** sửa file trong `raw/`
@@ -281,9 +247,7 @@ Với mỗi note đã sinh → copy vào `raw/notes/`
 Naming: `{domain}-{type}-{slug}.md`
 
 #### Bước 5: Chạy ingest
-```bash
-cd {wiki_path} && node scripts/ingest.js
-```
+Thực hiện ingest procedure (tiến hành theo hướng dẫn Sub-command INGEST).
 
 #### Bước 6: Report
 ```
@@ -392,13 +356,11 @@ B) Không — skip, tôi sẽ push thủ công sau
 
 ### DỪNG khi:
 - Wiki folder không tồn tại → *"Chạy `/evnict-kit:init-wiki` trước"*
-- `node scripts/ingest.js` fail → Retry 1 lần → hiển thị error cụ thể
+- Error file config → Verify `config.yaml`
 - Frontmatter thiếu required fields → KHÔNG push, sửa trước
 
 ### Auto-recovery:
-- ingest fail lần 1 → retry lần 2
-- scripts/ingest.js không tồn tại → thử npm run ingest
-- npm run ingest fail → báo: "cd {wiki_path} && npm install"
+- Agent tự động bổ sung file chưa hoàn thiện.
 
 ---
 
@@ -406,7 +368,7 @@ B) Không — skip, tôi sẽ push thủ công sau
 - [ ] File markdown tạo đúng format frontmatter (llm-wiki chuẩn)
 - [ ] Nội dung đầy đủ (API, DB, BR, files, lessons)
 - [ ] File đã copy vào `raw/notes/` đúng naming
-- [ ] Ingest đã trigger TỰ ĐỘNG (node scripts/ingest.js)
+- [ ] Ingest đã thực hiện hoàn tất TỰ ĐỘNG
 - [ ] Query trả về results có format rõ ràng + gap detection
 - [ ] scan-code sinh được wiki notes từ codebase
 - [ ] Status cho health check chính xác

package/templates/wiki/AGENTS.md

@@ -0,0 +1,280 @@
+# LLM Wiki — Schema & Quy tắc vận hành
+
+> Hệ thống knowledge base cá nhân dựa trên pattern của Andrej Karpathy.
+> LLM xây dựng và duy trì wiki từ nguồn thô. Con người chỉ đọc wiki và hỏi đáp.
+
+## Kiến trúc 3 lớp
+
+```
+raw/        → Nguồn thô (bất biến — LLM CHỈ ĐỌC, KHÔNG BAO GIỜ SỬA)
+wiki/       → Wiki do LLM viết & duy trì hoàn toàn
+outputs/    → Kết quả query, reports, phân tích
+config.yaml → Cấu hình topics, feeds, lịch chạy
+```
+
+## Cấu trúc thư mục
+
+```
+llm-wiki/
+├── CLAUDE.md              ← File này — schema & quy tắc
+├── config.yaml            ← Cấu hình hệ thống
+├── raw/                   ← Nguồn thô (KHÔNG ĐƯỢC SỬA)
+│   ├── articles/          ← Web articles (markdown, text)
+│   ├── papers/            ← PDF, research papers
+│   ├── notes/             ← Ghi chú cá nhân
+│   ├── media/             ← Screenshots, diagrams
+│   └── assets/            ← Downloaded images từ articles
+├── wiki/                  ← LLM sở hữu toàn bộ
+│   ├── INDEX.md           ← Catalog mọi trang wiki
+│   ├── LOG.md             ← Timeline sự kiện
+│   ├── entities/          ← Người, tổ chức, tool, project
+│   ├── concepts/          ← Khái niệm, pattern, methodology
+│   ├── sources/           ← Summary từng raw source
+│   └── syntheses/         ← Phân tích tổng hợp, so sánh
+├── outputs/               ← Kết quả query & reports
+└── .discoveries/          ← Metadata cho auto-discovery
+    ├── feeds.json         ← Nguồn đang theo dõi
+    ├── gaps.json          ← Knowledge gaps cần lấp
+    └── history.json       ← Nguồn đã xử lý (tránh trùng)
+```
+
+## Quy tắc vàng
+
+### 1. Raw sources là bất biến
+- KHÔNG BAO GIỜ sửa, xóa, hoặc di chuyển file trong `raw/`
+- Đây là source of truth — mọi thứ trong wiki phải truy ngược được về raw
+
+### 2. Wiki do LLM sở hữu hoàn toàn
+- Con người KHÔNG sửa wiki bằng tay
+- LLM tạo, cập nhật, xóa trang wiki
+- Mỗi thay đổi phải được ghi vào LOG.md
+
+### 3. Mỗi topic một file
+- Mỗi entity, concept, source summary là một file `.md` riêng
+- File name: `kebab-case.md` (VD: `andrej-karpathy.md`, `llm-agents.md`)
+- Không tạo file quá dài — tách thành nhiều file nếu > 500 dòng
+
+### 4. Cross-reference bằng wiki links
+- Dùng format `[[tên-file]]` để liên kết giữa các trang
+- Mỗi trang nên có ít nhất 2 liên kết đến trang khác
+- Orphan pages (không ai liên kết đến) cần được phát hiện khi lint
+
+### 5. INDEX.md luôn cập nhật
+- Mỗi lần tạo/xóa trang → cập nhật INDEX.md
+- Format: `- [Tên trang](path) — mô tả một dòng`
+- Phân nhóm theo category: entities, concepts, sources, syntheses
+
+### 6. LOG.md ghi nhận mọi hoạt động
+- Format: `## [YYYY-MM-DD HH:mm] action | Mô tả`
+- Actions: `ingest`, `query`, `lint`, `discover`, `update`
+- Mỗi entry ghi rõ: files đã tạo/sửa, số trang bị ảnh hưởng
+
+## Workflows
+
+### Ingest (Nhập nguồn mới)
+
+```
+1. Đọc file mới trong raw/
+2. Tạo source summary trong wiki/sources/
+3. Trích xuất entities → tạo/cập nhật wiki/entities/
+4. Trích xuất concepts → tạo/cập nhật wiki/concepts/
+5. Tìm connections với trang đã có → thêm cross-references
+6. Phát hiện contradictions với nội dung cũ → ghi chú
+7. Cập nhật INDEX.md
+8. Ghi LOG.md
+9. Cập nhật .discoveries/history.json
+```
+
+**Quy tắc ingest:**
+- Một source có thể ảnh hưởng 5-15 wiki pages
+- Luôn trích dẫn nguồn: `[Nguồn: tên-file-raw](../raw/path)`
+- Nếu thông tin mới mâu thuẫn với cũ → giữ cả hai, ghi rõ mâu thuẫn
+- Không bịa thông tin — chỉ viết những gì có trong raw sources
+
+### Query (Hỏi đáp)
+
+```
+1. Đọc INDEX.md để tìm trang liên quan
+2. Đọc các trang wiki liên quan
+3. Tổng hợp câu trả lời với citations
+4. Nếu câu trả lời có giá trị → lưu vào outputs/ hoặc wiki/syntheses/
+5. Ghi LOG.md
+```
+
+**Quy tắc query:**
+- Trả lời dựa trên wiki, KHÔNG dựa trên kiến thức ngoài
+- Nếu wiki không có đủ thông tin → nói rõ và gợi ý nguồn cần tìm
+- Câu trả lời hay (so sánh, phân tích) → file lại thành wiki page mới
+
+### Lint (Kiểm tra sức khỏe)
+
+```
+1. Kiểm tra contradictions giữa các trang
+2. Tìm orphan pages (không ai liên kết đến)
+3. Tìm mentioned-but-missing (nhắc đến nhưng chưa có trang)
+4. Tìm stale claims (thông tin cũ bị nguồn mới bác bỏ)
+5. Tìm knowledge gaps (lĩnh vực thiếu coverage)
+6. Kiểm tra broken wiki links
+7. Đề xuất trang mới cần tạo
+8. Đề xuất nguồn mới cần tìm
+9. Ghi kết quả vào outputs/ và LOG.md
+```
+
+### Discover (Tự động tìm nguồn)
+
+```
+1. Đọc config.yaml → lấy danh sách topics & feeds
+2. Đọc .discoveries/gaps.json → lấy knowledge gaps
+3. Web search theo topics + gaps
+4. Scrape articles tìm được → lưu vào raw/articles/
+5. Cập nhật .discoveries/feeds.json & history.json
+6. Trigger ingest cho nguồn mới
+7. Ghi LOG.md
+```
+
+**Quy tắc discover:**
+- Chỉ tìm nguồn liên quan đến topics trong config.yaml
+- Không tải lại nguồn đã có trong history.json
+- Ưu tiên: gaps.json > trending topics > feeds định kỳ
+- Mỗi lần discover tối đa 5-10 nguồn mới (tránh overload)
+
+## Format trang wiki
+
+### Entity page (wiki/entities/)
+
+```markdown
+---
+type: entity
+category: person | organization | tool | project
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+sources: [danh sách raw sources]
+---
+
+# Tên Entity
+
+Mô tả ngắn 1-2 câu.
+
+## Tổng quan
+[Mô tả chi tiết]
+
+## Điểm đáng chú ý
+- [Bullet points]
+
+## Liên kết
+- [[concept-liên-quan]]
+- [[entity-liên-quan]]
+
+## Nguồn
+- [Source 1](../raw/path)
+- [Source 2](../raw/path)
+```
+
+### Concept page (wiki/concepts/)
+
+```markdown
+---
+type: concept
+domain: ai | engineering | business | ...
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+sources: [danh sách raw sources]
+---
+
+# Tên Concept
+
+Mô tả ngắn 1-2 câu.
+
+## Định nghĩa
+[Giải thích rõ ràng]
+
+## Cách hoạt động
+[Chi tiết kỹ thuật nếu cần]
+
+## Ví dụ
+[Ví dụ cụ thể]
+
+## Liên kết
+- [[concept-liên-quan]]
+- [[entity-liên-quan]]
+
+## Nguồn
+- [Source 1](../raw/path)
+```
+
+### Source summary (wiki/sources/)
+
+```markdown
+---
+type: source
+format: article | paper | note | video | podcast
+raw_path: raw/articles/ten-file.md
+ingested: YYYY-MM-DD
+---
+
+# Tên Source
+
+## Tóm tắt
+[2-3 đoạn tóm tắt nội dung chính]
+
+## Key takeaways
+- [Bullet points — điểm quan trọng nhất]
+
+## Entities được nhắc đến
+- [[entity-1]]
+- [[entity-2]]
+
+## Concepts được nhắc đến
+- [[concept-1]]
+- [[concept-2]]
+
+## Trích dẫn đáng chú ý
+> "Quote quan trọng từ nguồn"
+```
+
+### Synthesis page (wiki/syntheses/)
+
+```markdown
+---
+type: synthesis
+topic: chủ đề phân tích
+created: YYYY-MM-DD
+sources_count: N
+---
+
+# Tiêu đề phân tích
+
+## Câu hỏi gốc
+[Câu hỏi hoặc mục đích phân tích]
+
+## Phân tích
+[Nội dung phân tích tổng hợp]
+
+## Kết luận
+[Tóm tắt kết luận]
+
+## Nguồn sử dụng
+- [[source-1]]
+- [[source-2]]
+```
+
+## Auto-Discovery
+
+Hệ thống tự động tìm nguồn mới dựa trên:
+
+1. **Topics** trong config.yaml — web search định kỳ
+2. **Knowledge gaps** — lint phát hiện thiếu gì → discover tự tìm
+3. **Feeds** — RSS, GitHub repos, YouTube channels
+4. **Snowball** — đọc references trong sources đã có → follow links
+
+Chu kỳ tự động (cấu hình trong config.yaml):
+- Discover: mỗi ngày (hoặc theo cron)
+- Ingest: ngay khi có file mới trong raw/
+- Lint: hàng tuần
+- Full recompile: hàng tháng (nếu cần)
+
+## Ngôn ngữ
+
+- Wiki content viết bằng **tiếng Việt có dấu** (trừ thuật ngữ kỹ thuật giữ tiếng Anh)
+- File names: tiếng Anh, kebab-case
+- Frontmatter: tiếng Anh