thientranhung · vinhnguyenthanhdn · Mar 31, 2026
diff --git a/README.vn.md b/README.vn.md
@@ -40,6 +40,14 @@ Nghiên cứu chi tiết về nền tảng agentic coding Claude Code và các h
 | **Claude Code Sub-agents** | [📖](vn/claude-code/claude-code-sub-agents/0.%20Overview.md) | [🏗️](vn/claude-code/claude-code-sub-agents/1.%20Architecture%20and%20Logic.md) | [🛠️](vn/claude-code/claude-code-sub-agents/2.%20Playbook.md) | [⚖️](vn/claude-code/claude-code-sub-agents/3.%20Decision%20Guide.md) |
 | **Claude Code Memory** | [📖](vn/claude-code/claude-code-memory/0.%20Overview.md) | [🏗️](vn/claude-code/claude-code-memory/1.%20Architecture%20and%20Logic.md) | [🛠️](vn/claude-code/claude-code-memory/2.%20Playbook.md) | [⚖️](vn/claude-code/claude-code-memory/3.%20Decision%20Guide.md) |
 
+### 🔷 Gemini CLI — Nghiên cứu Chuyên sâu
+
+Nghiên cứu chi tiết về AI Agent mã nguồn mở cho terminal của Google.
+
+| Chủ đề | Tổng quan | Kiến trúc | Playbook | So sánh |
+|:-------|:----------|:----------|:---------|:--------|
+| **Gemini CLI** | [📖](vn/gemini-cli/0.%20Overview.md) | [🏗️](vn/gemini-cli/1.%20Architecture%20and%20Logic.md) | [🛠️](vn/gemini-cli/2.%20Playbook.md) | [⚖️](vn/gemini-cli/3.%20Gemini%20CLI%20vs%20Claude%20Code.md) |
+
 ### 🚀 Agentic Frameworks
 
 Nghiên cứu về các framework bổ sung cấu trúc, bộ nhớ, và khả năng điều phối cho phát triển AI.
@@ -56,7 +64,7 @@ Nghiên cứu về các framework bổ sung cấu trúc, bộ nhớ, và khả n
 |:-------|:---------|:------|
 | **Scrum cho Agentic Teams** | [📖 Mục lục](vn/understand-scrum/index.md) | Áp dụng Scrum cho team kết hợp AI — [Cơ cấu Team](vn/understand-scrum/01-team-structure.md) · [Thuật ngữ](vn/understand-scrum/02-glossary.md) |
 | **Beads: Quản lý Task cho Agent** | [📖 Đọc](vn/understand-beads.md) | Hệ thống tracking được thiết kế cho AI agents, giải quyết "Agent Amnesia" |
-| **Làm quen với Claude Code** | [📖 Đọc](vn/lam-quen-voi-claude-code.md) | Hướng dẫn từ cơ bản đến nâng cao với hooks và security gates |
+| **Làm quen với Claude Code** | [📖 Đọc](vn/getting-started-with-claude-code.md) | Hướng dẫn từ cơ bản đến nâng cao với hooks và security gates |
 
 ---
 

diff --git a/en/bmad-method/0. Overview.md b/en/bmad-method/0. Overview.md
@@ -226,6 +226,6 @@ Every phase includes mandatory checklists:
 
 ## See Also
 
-- [[3-Research/Github/BMAD-METHOD/1. Architecture and Logic]] — Internal architecture, data flow, agent orchestration details
-- [[3-Research/Github/BMAD-METHOD/2. Playbook]] — Installation, Day 1 workflow, cheat sheet, troubleshooting
-- [[3-Research/Github/BMAD-METHOD/3. Decision Guide]] — Comparison with alternatives, use cases, costs, migration path
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture, data flow, agent orchestration details
+- [2. Playbook](./2. Playbook.md) — Installation, Day 1 workflow, cheat sheet, troubleshooting
+- [3. Decision Guide](./3. Decision Guide.md) — Comparison with alternatives, use cases, costs, migration path
diff --git a/en/bmad-method/1. Architecture and Logic.md b/en/bmad-method/1. Architecture and Logic.md
@@ -402,6 +402,6 @@ flowchart TD
 
 ## See Also
 
-- [[3-Research/Github/BMAD-METHOD/0. Overview]] — Overview, philosophy, key features
-- [[3-Research/Github/BMAD-METHOD/2. Playbook]] — Installation, Day 1 workflow, cheat sheet, troubleshooting
-- [[3-Research/Github/BMAD-METHOD/3. Decision Guide]] — Comparison with alternatives, use cases, costs, migration path
+- [0. Overview](./0. Overview.md) — Overview, philosophy, key features
+- [2. Playbook](./2. Playbook.md) — Installation, Day 1 workflow, cheat sheet, troubleshooting
+- [3. Decision Guide](./3. Decision Guide.md) — Comparison with alternatives, use cases, costs, migration path
diff --git a/en/bmad-method/2. Playbook.md b/en/bmad-method/2. Playbook.md
@@ -266,6 +266,6 @@ Analysis → Planning → Solutioning → Implementation
 
 ## See Also
 
-- [[3-Research/Github/BMAD-METHOD/0. Overview]] — Overview of the BMad Method system
-- [[3-Research/Github/BMAD-METHOD/1. Architecture and Logic]] — Internal architecture and operational mechanisms
-- [[3-Research/Github/BMAD-METHOD/3. Decision Guide]] — Comparison with alternatives, decision matrices
+- [0. Overview](./0. Overview.md) — Overview of the BMad Method system
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture and operational mechanisms
+- [3. Decision Guide](./3. Decision Guide.md) — Comparison with alternatives, decision matrices
diff --git a/en/bmad-method/3. Decision Guide.md b/en/bmad-method/3. Decision Guide.md
@@ -252,6 +252,6 @@ flowchart TD
 
 ## See Also
 
-- [[3-Research/Github/BMAD-METHOD/0. Overview]] — Overview of the BMad Method system
-- [[3-Research/Github/BMAD-METHOD/1. Architecture and Logic]] — Internal architecture and operational mechanisms
-- [[3-Research/Github/BMAD-METHOD/2. Playbook]] — Practical operations guide
+- [0. Overview](./0. Overview.md) — Overview of the BMad Method system
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture and operational mechanisms
+- [2. Playbook](./2. Playbook.md) — Practical operations guide
diff --git a/en/bmad-method/4. CC Friendliness.md b/en/bmad-method/4. CC Friendliness.md
@@ -0,0 +1,71 @@
+# BMad Method — Claude Code Friendliness
+
+## Result: 🥉 C+ — 60/100 (Basic Compatible, trending up)
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║          CLAUDE CODE FRIENDLINESS SCORECARD                 ║
+╠══════════════════════════════════════════════════════════════╣
+║ Repo: BMad Method (V6.2)                                   ║
+║ Date: 2026-03-19 (re-eval from 2026-03-13)                 ║
+╠══════════════════════════════════════════════════════════════╣
+║ Category                          │ Score  │ Max   │ %     ║
+╠═══════════════════════════════════╪════════╪═══════╪═══════╣
+║ 1. Memory & Context              │  13    │  20   │  65%  ║
+║ 2. Agentic Architecture          │  9     │  20   │  45%  ║
+║ 3. Extension Ecosystem           │  10    │  15   │  67%  ║
+║ 4. Safety & Permissions          │  4     │  10   │  40%  ║
+║ 5. Developer Experience          │  13    │  15   │  87%  ║
+║ 6. Cost & Efficiency             │  3     │  10   │  30%  ║
+║ 7. Documentation & Onboarding    │  8     │  10   │  80%  ║
+╠═══════════════════════════════════╪════════╪═══════╪═══════╣
+║ TOTAL                             │  60    │ 100   │  60%  ║
+╠══════════════════════════════════════════════════════════════╣
+║ Rating: 🥉 C+ — Basic Compatible (↑ from C 55/100)        ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+## Changes from previous evaluation (v6.0.4 → v6.2)
+
+| Category | Previously | Now | Δ | Reason |
+|---|---|---|---|---|
+| **Memory & Context** | 12 | 13 | +1 | Skills-based architecture improves context loading (progressive disclosure L1→L2→L3) |
+| **Agentic** | 8 | 9 | +1 | Product Brief Preview features autonomous/yolo mode, parallel subagent fan-out |
+| **Extensions** | 8 | 10 | +2 | Native skill directory format follows Agent Skills open standard, skill validator increases quality, encapsulation rules (PATH-05) |
+| **Safety** | 4 | 4 | 0 | Still lacks technical permission rules |
+| **DX** | 12 | 13 | +1 | `@next` channel, unified Quick Dev, sharded code review, more platforms |
+| **Cost** | 3 | 3 | 0 | Still HITL-heavy, no model routing |
+| **Docs** | 8 | 8 | 0 | Chinese docs added but still cross-platform focus |
+
+## Detailed evaluation
+
+| Category | Strengths | Weaknesses |
+|---|---|---|
+| **Memory** | Skills-based architecture with progressive disclosure (L1 ~100 tokens → L2 <5K → L3 unlimited). `project-context.md` captures preferences. Step-file architecture reduces context load. | Does not use native CLAUDE.md hierarchy. Skills injected into context instead of `.claude/rules/` |
+| **Agentic** | 9 specialized agents. Product Brief Preview has 3 modes (guided/yolo/autonomous) with subagent fan-out. Scale-adaptive logic. | ❌ Most of it is still HITL-heavy: PRD approval, adversarial review, party mode. Lacks sufficient fire-and-forget tasks |
+| **Extensions** | ✅ Compliant with Agent Skills open standard. Skill Validator ensures quality. PATH-05 encapsulation rule. Native `SKILL.md` import. 20+ platforms. | No MCP yet. Plugin distribution lacks marketplace. No hooks |
+| **Safety** | Workflow gates (Implementation Readiness). Sharded Code Review 3-layer system. | No technical permission rules. Relies on process instead of enforcement |
+| **DX** | ✅ Best in class — CLI installer, `bmad-help`, Quick Dev unified, `@next` channel, 20+ platforms, cheat sheet. Progressive disclosure 3 tracks. | Strong IDE-specific lock-in, Fresh Chat rule can cause context loss |
+| **Cost** | npm tarball size reduced by 91% (6.2MB → 555KB). | ❌ No model routing. HITL-heavy = waiting for human = slow. No parallel execution |
+| **Docs** | Excellent documentation. Chinese translation. Clear comparison table. Migration paths. | Docs focus on cross-platform, not Claude Code-specific |
+
+## Highlight
+
+> BMad Method **advanced significantly from 6.0 → 6.2** thanks to its skills-based architecture (compliant with Agent Skills open standard), step-file sharding, and progressive disclosure. However, the **architecture remains HITL-heavy** — most tasks require continuous human interaction → making it difficult to delegate to Claude Code subagents. **Product Brief Preview** (v6.2) is the first skill to experiment with autonomous mode and subagent fan-out — if this pattern is widely adopted, CC Friendliness will increase significantly.
+
+## Recommendations to increase CC score
+
+| Recommendation | Impact | Difficulty |
+|---|---|---|
+| Add autonomous/HOTL mode for more workflows (like Product Brief Preview) | +3-5 Agentic | Medium |
+| Use `.claude/rules/` instead of injecting into context | +2 Memory | Low |
+| Add MCP server for skill discovery/invocation | +2 Extensions | High |
+| Model routing: light for validation, heavy for creation | +2 Cost | Medium |
+| Technical permission rules (CLAUDE.md deny patterns) | +2 Safety | Low |
+
+## See Also
+
+- [0. Overview](./0.%20Overview.md) — BMad Method Overview
+- [1. Architecture and Logic](./1.%20Architecture%20and%20Logic.md) — Detailed architecture
+- [2. Playbook](./2.%20Playbook.md) — Operations playbook
+- [3. Decision Guide](./3.%20Decision%20Guide.md) — When to use BMad
diff --git a/en/claude-code/claude-code-hooks/0. Overview.md b/en/claude-code/claude-code-hooks/0. Overview.md
@@ -234,6 +234,6 @@ LLM hooks evaluate content against criteria — useful for automated code review
 
 ## See Also
 
-- [[3-Research/Github/Claude Code Hooks/1. Architecture and Logic]] — Internal architecture, data flow, processing pipeline details
-- [[3-Research/Github/Claude Code Hooks/2. Playbook]] — Installation, Day 1 workflow, cheat sheet, troubleshooting
-- [[3-Research/Github/Claude Code Hooks/3. Decision Guide]] — Comparison, use cases, costs, decision guide
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture, data flow, processing pipeline details
+- [2. Playbook](./2. Playbook.md) — Installation, Day 1 workflow, cheat sheet, troubleshooting
+- [3. Decision Guide](./3. Decision Guide.md) — Comparison, use cases, costs, decision guide
diff --git a/en/claude-code/claude-code-hooks/1. Architecture and Logic.md b/en/claude-code/claude-code-hooks/1. Architecture and Logic.md
@@ -19,7 +19,7 @@ version: Claude Code 1.0.34+
 # Claude Code Hooks — Architecture and Logic
 
 > [!NOTE]
-> This document dives deep into the **internal workings** of the Hook system. Read [[3-Research/Github/Claude Code Hooks/0. Overview]] first to grasp the big picture.
+> This document dives deep into the **internal workings** of the Hook system. Read [0. Overview](./0. Overview.md) first to grasp the big picture.
 
 ---
 
@@ -330,6 +330,6 @@ graph TD
 
 ## See Also
 
-- [[3-Research/Github/Claude Code Hooks/0. Overview]] — Overview, philosophy, key features
-- [[3-Research/Github/Claude Code Hooks/2. Playbook]] — Practical guide, cheat sheet, troubleshooting
-- [[3-Research/Github/Claude Code Hooks/3. Decision Guide]] — Comparison, use cases, decision guide
+- [0. Overview](./0. Overview.md) — Overview, philosophy, key features
+- [2. Playbook](./2. Playbook.md) — Practical guide, cheat sheet, troubleshooting
+- [3. Decision Guide](./3. Decision Guide.md) — Comparison, use cases, decision guide
diff --git a/en/claude-code/claude-code-hooks/2. Playbook.md b/en/claude-code/claude-code-hooks/2. Playbook.md
@@ -19,7 +19,7 @@ version: Claude Code 1.0.34+
 # Claude Code Hooks — Playbook
 
 > [!NOTE]
-> This is an **action-oriented** document. Read [[3-Research/Github/Claude Code Hooks/0. Overview]] to understand what Hooks are, [[3-Research/Github/Claude Code Hooks/1. Architecture and Logic]] to understand internal mechanisms.
+> This is an **action-oriented** document. Read [0. Overview](./0. Overview.md) to understand what Hooks are, [1. Architecture and Logic](./1. Architecture and Logic.md) to understand internal mechanisms.
 
 ---
 
@@ -426,6 +426,6 @@ exit 0
 
 ## See Also
 
-- [[3-Research/Github/Claude Code Hooks/0. Overview]] — Overview of the Claude Code Hooks system
-- [[3-Research/Github/Claude Code Hooks/1. Architecture and Logic]] — Internal architecture and mechanisms
-- [[3-Research/Github/Claude Code Hooks/3. Decision Guide]] — Comparison, use cases, decision guide
+- [0. Overview](./0. Overview.md) — Overview of the Claude Code Hooks system
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture and mechanisms
+- [3. Decision Guide](./3. Decision Guide.md) — Comparison, use cases, decision guide
diff --git a/en/claude-code/claude-code-hooks/3. Decision Guide.md b/en/claude-code/claude-code-hooks/3. Decision Guide.md
@@ -18,7 +18,7 @@ version: Claude Code 1.0.34+
 # Claude Code Hooks — Decision Guide
 
 > [!NOTE]
-> Read this document BEFORE deciding to use Hooks. Read [[3-Research/Github/Claude Code Hooks/0. Overview]] if you don't know what Hooks are yet.
+> Read this document BEFORE deciding to use Hooks. Read [0. Overview](./0. Overview.md) if you don't know what Hooks are yet.
 
 ---
 
@@ -183,6 +183,6 @@ flowchart TD
 
 ## See Also
 
-- [[3-Research/Github/Claude Code Hooks/0. Overview]] — Overview of the Claude Code Hooks system
-- [[3-Research/Github/Claude Code Hooks/1. Architecture and Logic]] — Internal architecture and mechanisms
-- [[3-Research/Github/Claude Code Hooks/2. Playbook]] — Practical operations guide
+- [0. Overview](./0. Overview.md) — Overview of the Claude Code Hooks system
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture and mechanisms
+- [2. Playbook](./2. Playbook.md) — Practical operations guide
diff --git a/en/claude-code/claude-code-memory/0. Overview.md b/en/claude-code/claude-code-memory/0. Overview.md
@@ -210,5 +210,5 @@ flowchart LR
 
 ## 10. See Also
 
-- [[1. Architecture and Logic]] — Load mechanisms, data flow, path resolution in detail
-- [[2. Playbook]] — Installation, configuration, and Memory operation guide
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Load mechanisms, data flow, path resolution in detail
+- [2. Playbook](./2. Playbook.md) — Installation, configuration, and Memory operation guide
diff --git a/en/claude-code/claude-code-memory/1. Architecture and Logic.md b/en/claude-code/claude-code-memory/1. Architecture and Logic.md
@@ -475,5 +475,5 @@ paths:
 
 ## 8. See Also
 
-- [[0. Overview]] — Memory system overview, comparison, key features
-- [[2. Playbook]] — Practical guide for installation, configuration, and operation
+- [0. Overview](./0. Overview.md) — Memory system overview, comparison, key features
+- [2. Playbook](./2. Playbook.md) — Practical guide for installation, configuration, and operation
diff --git a/en/claude-code/claude-code-memory/2. Playbook.md b/en/claude-code/claude-code-memory/2. Playbook.md
@@ -524,5 +524,5 @@ grep -r "claudeMdExcludes" .claude/ 2>/dev/null
 
 ## 8. See Also
 
-- [[0. Overview]] — Memory system overview, comparison of mechanisms, key features
-- [[1. Architecture and Logic]] — Load mechanisms, data flow, path resolution in detail
+- [0. Overview](./0. Overview.md) — Memory system overview, comparison of mechanisms, key features
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Load mechanisms, data flow, path resolution in detail
diff --git a/en/claude-code/claude-code-memory/3. Decision Guide.md b/en/claude-code/claude-code-memory/3. Decision Guide.md
@@ -308,6 +308,6 @@ claude
 
 ## 9. See Also
 
-- [[0. Overview]] — Memory system overview, architecture, key features
-- [[1. Architecture and Logic]] — Detailed load mechanisms, data flow, path resolution
-- [[2. Playbook]] — Practical guide for installation, configuration, and operation
+- [0. Overview](./0. Overview.md) — Memory system overview, architecture, key features
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Detailed load mechanisms, data flow, path resolution
+- [2. Playbook](./2. Playbook.md) — Practical guide for installation, configuration, and operation
diff --git a/en/claude-code/claude-code-plugins/0. Overview.md b/en/claude-code/claude-code-plugins/0. Overview.md
@@ -242,5 +242,5 @@ Environment variable pointing to plugin root, helping hooks/scripts reference re
 
 ## See Also
 
-- [[3-Research/Claude Code/claude-code-plugins/1. Architecture and Logic]] — Data flow, component specs, manifest schema
-- [[3-Research/Claude Code/claude-code-plugins/2. Playbook]] — Installation, plugin creation, cheat sheet, troubleshooting
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow, component specs, manifest schema
+- [2. Playbook](./2. Playbook.md) — Installation, plugin creation, cheat sheet, troubleshooting
diff --git a/en/claude-code/claude-code-plugins/1. Architecture and Logic.md b/en/claude-code/claude-code-plugins/1. Architecture and Logic.md
@@ -398,6 +398,6 @@ flowchart TD
 
 ## See Also
 
-- [[3-Research/Claude Code/claude-code-plugins/0. Overview]] — Overview, philosophy, key features
-- [[3-Research/Claude Code/claude-code-plugins/2. Playbook]] — Installation, plugin creation, cheat sheet
-- [[3-Research/Claude Code/claude-code-plugins/3. Decision Guide]] — Comparison, use cases, decision matrix
+- [0. Overview](./0. Overview.md) — Overview, philosophy, key features
+- [2. Playbook](./2. Playbook.md) — Installation, plugin creation, cheat sheet
+- [3. Decision Guide](./3. Decision Guide.md) — Comparison, use cases, decision matrix
diff --git a/en/claude-code/claude-code-plugins/2. Playbook.md b/en/claude-code/claude-code-plugins/2. Playbook.md
@@ -340,6 +340,6 @@ my-plugin/
 
 ## See Also
 
-- [[3-Research/Claude Code/claude-code-plugins/0. Overview]] — Overview and key features
-- [[3-Research/Claude Code/claude-code-plugins/1. Architecture and Logic]] — Internal architecture details
-- [[3-Research/Claude Code/claude-code-plugins/3. Decision Guide]] — Comparison and decision matrix
+- [0. Overview](./0. Overview.md) — Overview and key features
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture details
+- [3. Decision Guide](./3. Decision Guide.md) — Comparison and decision matrix
diff --git a/en/claude-code/claude-code-plugins/3. Decision Guide.md b/en/claude-code/claude-code-plugins/3. Decision Guide.md
@@ -106,6 +106,6 @@ flowchart TD
 
 ## See Also
 
-- [[3-Research/Claude Code/claude-code-plugins/0. Overview]] — Overview and key features
-- [[3-Research/Claude Code/claude-code-plugins/1. Architecture and Logic]] — Internal architecture details
-- [[3-Research/Claude Code/claude-code-plugins/2. Playbook]] — Installation and operations guide
+- [0. Overview](./0. Overview.md) — Overview and key features
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture details
+- [2. Playbook](./2. Playbook.md) — Installation and operations guide
diff --git a/en/claude-code/claude-code-skills/0. Overview.md b/en/claude-code/claude-code-skills/0. Overview.md
@@ -143,6 +143,6 @@ Skills are loaded on-demand, not all at once — keeping context clean.
 
 ## See Also
 
-- [[3-Research/Claude Code/claude-code-skills/1. Architecture and Logic]] — Internal architecture, data flow, invocation mechanism
-- [[3-Research/Claude Code/claude-code-skills/2. Playbook]] — Setup, creating skills, cheat sheet, troubleshooting
-- [[3-Research/Claude Code/claude-code-skills/3. Decision Guide]] — Comparison, use cases, decision matrix
+- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture, data flow, invocation mechanism
+- [2. Playbook](./2. Playbook.md) — Setup, creating skills, cheat sheet, troubleshooting
+- [3. Decision Guide](./3. Decision Guide.md) — Comparison, use cases, decision matrix