From 7428718f5619a352a37c97dad41d26ee25fccce9 Mon Sep 17 00:00:00 2001 From: Vinh Nguyen Date: Tue, 31 Mar 2026 15:56:03 +0700 Subject: [PATCH] docs: fix broken wiki-links, sync en/vn structure & clean legacy files --- README.vn.md | 10 +- en/bmad-method/0. Overview.md | 6 +- en/bmad-method/1. Architecture and Logic.md | 6 +- en/bmad-method/2. Playbook.md | 6 +- en/bmad-method/3. Decision Guide.md | 6 +- en/bmad-method/4. CC Friendliness.md | 71 ++++++++++++ .../claude-code-hooks/0. Overview.md | 6 +- .../1. Architecture and Logic.md | 8 +- .../claude-code-hooks/2. Playbook.md | 8 +- .../claude-code-hooks/3. Decision Guide.md | 8 +- .../claude-code-memory/0. Overview.md | 4 +- .../1. Architecture and Logic.md | 4 +- .../claude-code-memory/2. Playbook.md | 4 +- .../claude-code-memory/3. Decision Guide.md | 6 +- .../claude-code-plugins/0. Overview.md | 4 +- .../1. Architecture and Logic.md | 6 +- .../claude-code-plugins/2. Playbook.md | 6 +- .../claude-code-plugins/3. Decision Guide.md | 6 +- .../claude-code-skills/0. Overview.md | 6 +- .../1. Architecture and Logic.md | 6 +- .../claude-code-skills/2. Playbook.md | 6 +- .../claude-code-skills/3. Decision Guide.md | 6 +- .../claude-code-sub-agents/0. Overview.md | 6 +- .../1. Architecture and Logic.md | 6 +- .../claude-code-sub-agents/2. Playbook.md | 6 +- .../3. Decision Guide.md | 6 +- .../how-claude-code-works/0. Overview.md | 4 +- .../1. Architecture and Logic.md | 4 +- .../how-claude-code-works/2. Playbook.md | 4 +- .../3. Decision Guide.md | 6 +- en/gemini-cli/0. Overview.md | 4 +- en/gemini-cli/1. Architecture and Logic.md | 4 +- en/gemini-cli/2. Playbook.md | 6 +- en/gemini-cli/3. Gemini CLI vs Claude Code.md | 10 +- en/get-shit-done/0. Overview.md | 6 +- en/get-shit-done/1. Architecture and Logic.md | 8 +- en/get-shit-done/2. Playbook.md | 8 +- en/get-shit-done/3. Decision Guide.md | 10 +- en/get-shit-done/4. CC Friendliness.md | 79 ++++++++++++++ en/superpowers/0. Overview.md | 6 +- en/superpowers/1. Architecture and Logic.md | 8 +- en/superpowers/2. Playbook.md | 8 +- en/superpowers/3. Decision Guide.md | 8 +- en/superpowers/4. CC Friendliness.md | 77 +++++++++++++ vn/README.md | 102 ------------------ vn/bmad-method/4. CC Friendliness.md | 1 - .../claude-code-hooks/0. Overview.md | 4 +- .../1. Architecture and Logic.md | 4 +- .../claude-code-hooks/2. Playbook.md | 12 +-- .../claude-code-hooks/3. Decision Guide.md | 6 +- .../claude-code-memory/0. Overview.md | 4 +- .../1. Architecture and Logic.md | 4 +- .../claude-code-memory/2. Playbook.md | 4 +- .../claude-code-memory/3. Decision Guide.md | 6 +- .../claude-code-plugins/0. Overview.md | 4 +- .../1. Architecture and Logic.md | 4 +- .../claude-code-plugins/2. Playbook.md | 6 +- .../claude-code-plugins/3. Decision Guide.md | 6 +- .../claude-code-skills/0. Overview.md | 4 +- .../1. Architecture and Logic.md | 4 +- .../claude-code-skills/2. Playbook.md | 4 +- .../claude-code-skills/3. Decision Guide.md | 6 +- .../claude-code-sub-agents/0. Overview.md | 4 +- .../1. Architecture and Logic.md | 4 +- .../claude-code-sub-agents/2. Playbook.md | 4 +- .../3. Decision Guide.md | 6 +- .../how-claude-code-works/0. Overview.md | 4 +- .../1. Architecture and Logic.md | 4 +- .../how-claude-code-works/2. Playbook.md | 4 +- .../3. Decision Guide.md | 6 +- vn/gemini-cli/0. Overview.md | 4 +- vn/gemini-cli/1. Architecture and Logic.md | 4 +- vn/gemini-cli/2. Playbook.md | 6 +- vn/gemini-cli/3. Gemini CLI vs Claude Code.md | 10 +- vn/get-shit-done/4. CC Friendliness.md | 1 - ...md => getting-started-with-claude-code.md} | 0 vn/superpowers/4. CC Friendliness.md | 1 - 77 files changed, 430 insertions(+), 300 deletions(-) create mode 100644 en/bmad-method/4. CC Friendliness.md create mode 100644 en/get-shit-done/4. CC Friendliness.md create mode 100644 en/superpowers/4. CC Friendliness.md delete mode 100644 vn/README.md rename vn/{lam-quen-voi-claude-code.md => getting-started-with-claude-code.md} (100%) diff --git a/README.vn.md b/README.vn.md index 7f6346e..e13b67c 100644 --- 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 index 7931f42..66b9abb 100644 --- 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 index 7b44acf..dd5d936 100644 --- 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 index a689d30..5872226 100644 --- 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 index b7c5e55..345f9a0 100644 --- 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 new file mode 100644 index 0000000..6f8a3d8 --- /dev/null +++ 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 index 0190696..a3e53e7 100644 --- 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 index da70c3f..dccccdd 100644 --- 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 index 3c8f30a..3f4c1cb 100644 --- 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 index 538ac83..39ae263 100644 --- 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 index 6a4cb2c..5e97774 100644 --- 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 index 260bb08..3ec83aa 100644 --- 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 index ea22ff9..54b4df1 100644 --- 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 index 17339a7..5be13e3 100644 --- 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 index 1732df0..f61e06b 100644 --- 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 index cf064e2..56fe948 100644 --- 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 index 086e2f8..9105f41 100644 --- 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 index d8159b3..c519ac6 100644 --- 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 index b5173d5..861dcd6 100644 --- 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 diff --git a/en/claude-code/claude-code-skills/1. Architecture and Logic.md b/en/claude-code/claude-code-skills/1. Architecture and Logic.md index 127a373..7a353d8 100644 --- a/en/claude-code/claude-code-skills/1. Architecture and Logic.md +++ b/en/claude-code/claude-code-skills/1. Architecture and Logic.md @@ -192,6 +192,6 @@ Supporting files are referenced from SKILL.md and loaded when needed. ## See Also -- [[3-Research/Claude Code/claude-code-skills/0. Overview]] — Overview and key features -- [[3-Research/Claude Code/claude-code-skills/2. Playbook]] — Setup, creating skills, cheat sheet -- [[3-Research/Claude Code/claude-code-skills/3. Decision Guide]] — Comparison, use cases, decision matrix +- [0. Overview](./0. Overview.md) — Overview and key features +- [2. Playbook](./2. Playbook.md) — Setup, creating skills, cheat sheet +- [3. Decision Guide](./3. Decision Guide.md) — Comparison, use cases, decision matrix diff --git a/en/claude-code/claude-code-skills/2. Playbook.md b/en/claude-code/claude-code-skills/2. Playbook.md index fddf6a4..36d5d0f 100644 --- a/en/claude-code/claude-code-skills/2. Playbook.md +++ b/en/claude-code/claude-code-skills/2. Playbook.md @@ -240,6 +240,6 @@ Personal skills > Plugin skills (same name) ## See Also -- [[3-Research/Claude Code/claude-code-skills/0. Overview]] — Overview and key features -- [[3-Research/Claude Code/claude-code-skills/1. Architecture and Logic]] — Internal architecture details -- [[3-Research/Claude Code/claude-code-skills/3. Decision Guide]] — Comparison, use cases, 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, use cases, decision matrix diff --git a/en/claude-code/claude-code-skills/3. Decision Guide.md b/en/claude-code/claude-code-skills/3. Decision Guide.md index 2c31b24..ebc170b 100644 --- a/en/claude-code/claude-code-skills/3. Decision Guide.md +++ b/en/claude-code/claude-code-skills/3. Decision Guide.md @@ -115,6 +115,6 @@ flowchart TD ## See Also -- [[3-Research/Claude Code/claude-code-skills/0. Overview]] — Overview and key features -- [[3-Research/Claude Code/claude-code-skills/1. Architecture and Logic]] — Internal architecture details -- [[3-Research/Claude Code/claude-code-skills/2. Playbook]] — Setup, creating skills, troubleshooting +- [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) — Setup, creating skills, troubleshooting diff --git a/en/claude-code/claude-code-sub-agents/0. Overview.md b/en/claude-code/claude-code-sub-agents/0. Overview.md index e16070b..911794b 100644 --- a/en/claude-code/claude-code-sub-agents/0. Overview.md +++ b/en/claude-code/claude-code-sub-agents/0. Overview.md @@ -125,6 +125,6 @@ Focus on: SQL injection, XSS, auth bypass, secret exposure. ## See Also -- [[3-Research/Claude Code/claude-code-sub-agents/1. Architecture and Logic]] — Internal architecture, data flow, configuration -- [[3-Research/Claude Code/claude-code-sub-agents/2. Playbook]] — Setup, creating agents, cheat sheet, troubleshooting -- [[3-Research/Claude Code/claude-code-sub-agents/3. Decision Guide]] — Comparison, use cases, decision matrix +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture, data flow, configuration +- [2. Playbook](./2. Playbook.md) — Setup, creating agents, cheat sheet, troubleshooting +- [3. Decision Guide](./3. Decision Guide.md) — Comparison, use cases, decision matrix diff --git a/en/claude-code/claude-code-sub-agents/1. Architecture and Logic.md b/en/claude-code/claude-code-sub-agents/1. Architecture and Logic.md index 526b61e..9198603 100644 --- a/en/claude-code/claude-code-sub-agents/1. Architecture and Logic.md +++ b/en/claude-code/claude-code-sub-agents/1. Architecture and Logic.md @@ -199,6 +199,6 @@ Sub-agents can trigger and be affected by hooks: ## See Also -- [[3-Research/Claude Code/claude-code-sub-agents/0. Overview]] — Overview and key features -- [[3-Research/Claude Code/claude-code-sub-agents/2. Playbook]] — Setup, creating agents, troubleshooting -- [[3-Research/Claude Code/claude-code-sub-agents/3. Decision Guide]] — Comparison, use cases, decision matrix +- [0. Overview](./0. Overview.md) — Overview and key features +- [2. Playbook](./2. Playbook.md) — Setup, creating agents, troubleshooting +- [3. Decision Guide](./3. Decision Guide.md) — Comparison, use cases, decision matrix diff --git a/en/claude-code/claude-code-sub-agents/2. Playbook.md b/en/claude-code/claude-code-sub-agents/2. Playbook.md index dec4472..c896755 100644 --- a/en/claude-code/claude-code-sub-agents/2. Playbook.md +++ b/en/claude-code/claude-code-sub-agents/2. Playbook.md @@ -246,6 +246,6 @@ You are a documentation specialist. ## See Also -- [[3-Research/Claude Code/claude-code-sub-agents/0. Overview]] — Overview and key features -- [[3-Research/Claude Code/claude-code-sub-agents/1. Architecture and Logic]] — Internal architecture details -- [[3-Research/Claude Code/claude-code-sub-agents/3. Decision Guide]] — Comparison, use cases, 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, use cases, decision matrix diff --git a/en/claude-code/claude-code-sub-agents/3. Decision Guide.md b/en/claude-code/claude-code-sub-agents/3. Decision Guide.md index 6c2c595..1c54c70 100644 --- a/en/claude-code/claude-code-sub-agents/3. Decision Guide.md +++ b/en/claude-code/claude-code-sub-agents/3. Decision Guide.md @@ -117,6 +117,6 @@ flowchart TD ## See Also -- [[3-Research/Claude Code/claude-code-sub-agents/0. Overview]] — Overview and key features -- [[3-Research/Claude Code/claude-code-sub-agents/1. Architecture and Logic]] — Internal architecture details -- [[3-Research/Claude Code/claude-code-sub-agents/2. Playbook]] — Setup, creating agents, troubleshooting +- [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) — Setup, creating agents, troubleshooting diff --git a/en/claude-code/how-claude-code-works/0. Overview.md b/en/claude-code/how-claude-code-works/0. Overview.md index a15cbe7..c027d3f 100644 --- a/en/claude-code/how-claude-code-works/0. Overview.md +++ b/en/claude-code/how-claude-code-works/0. Overview.md @@ -254,5 +254,5 @@ Use Claude Code **everywhere**: ## See Also -- [[3-Research/Claude Code/how-claude-code-works/1. Architecture and Logic]] — Detailed data flow, modules, internal operating mechanisms -- [[3-Research/Claude Code/how-claude-code-works/2. Playbook]] — Installation guide, Day 1 workflow, cheat sheet, troubleshooting +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Detailed data flow, modules, internal operating mechanisms +- [2. Playbook](./2. Playbook.md) — Installation guide, Day 1 workflow, cheat sheet, troubleshooting diff --git a/en/claude-code/how-claude-code-works/1. Architecture and Logic.md b/en/claude-code/how-claude-code-works/1. Architecture and Logic.md index cf66f37..981738b 100644 --- a/en/claude-code/how-claude-code-works/1. Architecture and Logic.md +++ b/en/claude-code/how-claude-code-works/1. Architecture and Logic.md @@ -543,5 +543,5 @@ graph TB ## See Also -- [[3-Research/Claude Code/how-claude-code-works/0. Overview]] — Overview, comparison, key features -- [[3-Research/Claude Code/how-claude-code-works/2. Playbook]] — Installation guide, operations, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Overview, comparison, key features +- [2. Playbook](./2. Playbook.md) — Installation guide, operations, cheat sheet, troubleshooting diff --git a/en/claude-code/how-claude-code-works/2. Playbook.md b/en/claude-code/how-claude-code-works/2. Playbook.md index d74cc33..aafc49c 100644 --- a/en/claude-code/how-claude-code-works/2. Playbook.md +++ b/en/claude-code/how-claude-code-works/2. Playbook.md @@ -541,5 +541,5 @@ claude -p "Review the diff against main, write a PR description, and commit with ## See Also -- [[3-Research/Claude Code/how-claude-code-works/0. Overview]] — Overview, comparison, key features -- [[3-Research/Claude Code/how-claude-code-works/1. Architecture and Logic]] — Detailed data flow, modules, internal operating mechanisms +- [0. Overview](./0. Overview.md) — Overview, comparison, key features +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Detailed data flow, modules, internal operating mechanisms diff --git a/en/claude-code/how-claude-code-works/3. Decision Guide.md b/en/claude-code/how-claude-code-works/3. Decision Guide.md index a31c2d6..0a361c9 100644 --- a/en/claude-code/how-claude-code-works/3. Decision Guide.md +++ b/en/claude-code/how-claude-code-works/3. Decision Guide.md @@ -345,6 +345,6 @@ flowchart TD ## See Also -- [[3-Research/Claude Code/how-claude-code-works/0. Overview]] — Overview, quick comparison, key features -- [[3-Research/Claude Code/how-claude-code-works/1. Architecture and Logic]] — Data flow, modules, internal operating mechanisms -- [[3-Research/Claude Code/how-claude-code-works/2. Playbook]] — Installation guide, operations, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Overview, quick comparison, key features +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow, modules, internal operating mechanisms +- [2. Playbook](./2. Playbook.md) — Installation guide, operations, cheat sheet, troubleshooting diff --git a/en/gemini-cli/0. Overview.md b/en/gemini-cli/0. Overview.md index 4a6fa17..bcf205c 100644 --- a/en/gemini-cli/0. Overview.md +++ b/en/gemini-cli/0. Overview.md @@ -249,5 +249,5 @@ flowchart LR ## See Also -- [[1. Architecture and Logic]] — Detailed data flow, core modules, internal mechanisms -- [[2. Playbook]] — Installation, Day 1, cheat sheet, troubleshooting +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Detailed data flow, core modules, internal mechanisms +- [2. Playbook](./2. Playbook.md) — Installation, Day 1, cheat sheet, troubleshooting diff --git a/en/gemini-cli/1. Architecture and Logic.md b/en/gemini-cli/1. Architecture and Logic.md index 5a5e0ef..a3a185b 100644 --- a/en/gemini-cli/1. Architecture and Logic.md +++ b/en/gemini-cli/1. Architecture and Logic.md @@ -499,5 +499,5 @@ flowchart LR ## See Also -- [[0. Overview]] — Overview, features, comparisons -- [[2. Playbook]] — Installation, Day 1, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Overview, features, comparisons +- [2. Playbook](./2. Playbook.md) — Installation, Day 1, cheat sheet, troubleshooting diff --git a/en/gemini-cli/2. Playbook.md b/en/gemini-cli/2. Playbook.md index a30dc87..bcb5543 100644 --- a/en/gemini-cli/2. Playbook.md +++ b/en/gemini-cli/2. Playbook.md @@ -557,6 +557,6 @@ gemini-cli/ ## See Also -- [[0. Overview]] — Overview, features, comparisons -- [[1. Architecture and Logic]] — Detailed data flow, core modules, internal mechanisms -- [[3. Gemini CLI vs Claude Code]] — Equivalent command comparison table with Claude Code +- [0. Overview](./0. Overview.md) — Overview, features, comparisons +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Detailed data flow, core modules, internal mechanisms +- [3. Gemini CLI vs Claude Code](./3. Gemini CLI vs Claude Code.md) — Equivalent command comparison table with Claude Code diff --git a/en/gemini-cli/3. Gemini CLI vs Claude Code.md b/en/gemini-cli/3. Gemini CLI vs Claude Code.md index 643aa4d..1ef25aa 100644 --- a/en/gemini-cli/3. Gemini CLI vs Claude Code.md +++ b/en/gemini-cli/3. Gemini CLI vs Claude Code.md @@ -325,8 +325,8 @@ cp GEMINI.md CLAUDE.md ## See Also -- [[0. Overview]] — Gemini CLI Overview -- [[1. Architecture and Logic]] — Gemini CLI Internal Architecture -- [[2. Playbook]] — Gemini CLI Usage Guide -- [[3-Research/Claude Code/how-claude-code-works/0. Overview]] — Claude Code Overview -- [[3-Research/Claude Code/how-claude-code-works/2. Playbook]] — Claude Code Usage Guide +- [0. Overview](./0. Overview.md) — Gemini CLI Overview +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Gemini CLI Internal Architecture +- [2. Playbook](./2. Playbook.md) — Gemini CLI Usage Guide +- [0. Overview](./0. Overview.md) — Claude Code Overview +- [2. Playbook](./2. Playbook.md) — Claude Code Usage Guide diff --git a/en/get-shit-done/0. Overview.md b/en/get-shit-done/0. Overview.md index 8dad460..0df4853 100644 --- a/en/get-shit-done/0. Overview.md +++ b/en/get-shit-done/0. Overview.md @@ -290,8 +290,8 @@ New system that maps test coverage to requirements **before writing code**: ## See Also -- [[3-Research/Github/Get Shit Done/1. Architecture and Logic]] — Internal architecture, data flow, and detailed operational mechanisms -- [[3-Research/Github/Get Shit Done/2. Playbook]] — Practical operations playbook for developers -- [[3-Research/Github/Get Shit Done/3. Decision Guide]] — Comparisons, use cases, costs, and decision guide +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture, data flow, and detailed operational mechanisms +- [2. Playbook](./2. Playbook.md) — Practical operations playbook for developers +- [3. Decision Guide](./3. Decision Guide.md) — Comparisons, use cases, costs, and decision guide - [Official User Guide](https://github.com/gsd-build/get-shit-done/blob/main/docs/USER-GUIDE.md) - [Discord Community](https://discord.gg/gsd) diff --git a/en/get-shit-done/1. Architecture and Logic.md b/en/get-shit-done/1. Architecture and Logic.md index a7ae4bd..6021be4 100644 --- a/en/get-shit-done/1. Architecture and Logic.md +++ b/en/get-shit-done/1. Architecture and Logic.md @@ -21,7 +21,7 @@ version: 1.22.4 # GSD System Architecture & Logic — Deep Dive > [!NOTE] -> This document goes deep into **internal operational mechanisms** of GSD. Read [[3-Research/Github/Get Shit Done/0. Overview]] first for the big picture. +> This document goes deep into **internal operational mechanisms** of GSD. Read [0. Overview](./0. Overview.md) first for the big picture. --- @@ -519,6 +519,6 @@ graph TD ## See Also -- [[3-Research/Github/Get Shit Done/0. Overview]] — GSD system overview -- [[3-Research/Github/Get Shit Done/2. Playbook]] — Practical operations playbook -- [[3-Research/Github/Get Shit Done/3. Decision Guide]] — Comparisons, use cases, costs, and decision guide +- [0. Overview](./0. Overview.md) — GSD system overview +- [2. Playbook](./2. Playbook.md) — Practical operations playbook +- [3. Decision Guide](./3. Decision Guide.md) — Comparisons, use cases, costs, and decision guide diff --git a/en/get-shit-done/2. Playbook.md b/en/get-shit-done/2. Playbook.md index 4261da6..936272d 100644 --- a/en/get-shit-done/2. Playbook.md +++ b/en/get-shit-done/2. Playbook.md @@ -20,7 +20,7 @@ version: 1.22.4 # GSD Operations Playbook — Practical Playbook v1.22 > [!NOTE] -> This is an **action-oriented** document. Read [[3-Research/Github/Get Shit Done/0. Overview]] to understand what GSD is, [[3-Research/Github/Get Shit Done/1. Architecture and Logic]] to understand internal mechanisms. +> This is an **action-oriented** document. Read [0. Overview](./0. Overview.md) to understand what GSD is, [1. Architecture and Logic](./1. Architecture and Logic.md) to understand internal mechanisms. --- @@ -652,8 +652,8 @@ npx get-shit-done-cc --codex --local --uninstall ## See Also -- [[3-Research/Github/Get Shit Done/0. Overview]] — GSD system overview -- [[3-Research/Github/Get Shit Done/1. Architecture and Logic]] — Internal architecture and operational mechanisms -- [[3-Research/Github/Get Shit Done/3. Decision Guide]] — Comparisons, use cases, costs, and decision guide +- [0. Overview](./0. Overview.md) — GSD system overview +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture and operational mechanisms +- [3. Decision Guide](./3. Decision Guide.md) — Comparisons, use cases, costs, and decision guide - [Official User Guide](https://github.com/gsd-build/get-shit-done/blob/main/docs/USER-GUIDE.md) - [Discord Community](https://discord.gg/gsd) diff --git a/en/get-shit-done/3. Decision Guide.md b/en/get-shit-done/3. Decision Guide.md index 258fbce..fdffdbb 100644 --- a/en/get-shit-done/3. Decision Guide.md +++ b/en/get-shit-done/3. Decision Guide.md @@ -20,7 +20,7 @@ version: 1.22.4 # Decision Guide — GSD (Get Shit Done) v1.22 > [!NOTE] -> Read this document BEFORE deciding to adopt GSD. Read [[3-Research/Github/Get Shit Done/0. Overview]] if you don't know what GSD is yet. +> Read this document BEFORE deciding to adopt GSD. Read [0. Overview](./0. Overview.md) if you don't know what GSD is yet. --- @@ -113,7 +113,7 @@ version: 1.22.4 | Limitation | Description | Workaround | |---|---|---| | **Claude-centric** | Primarily optimized for Claude Code; Gemini/OpenCode/Codex are secondary support | Use Claude Code for best experience | -| **Learning curve** | Need to understand 4-step workflow + slash commands | Read [[3-Research/Github/Get Shit Done/2. Playbook]] before starting | +| **Learning curve** | Need to understand 4-step workflow + slash commands | Read [2. Playbook](./2. Playbook.md) before starting | | **Token consumption** | Multi-agent = many API calls, especially at "quality" profile | Use `budget` profile, turn off research/plan_check | | **No GUI** | Entirely CLI-based, no dashboard | Use `/gsd:progress` instead of dashboard | | **No team collaboration** | No sharing, permissions, multi-user | Combine with Git PR workflow | @@ -277,6 +277,6 @@ graph TD ## See Also -- [[3-Research/Github/Get Shit Done/0. Overview]] — GSD system overview -- [[3-Research/Github/Get Shit Done/1. Architecture and Logic]] — Internal architecture and operational mechanisms -- [[3-Research/Github/Get Shit Done/2. Playbook]] — Practical operations playbook +- [0. Overview](./0. Overview.md) — GSD system overview +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture and operational mechanisms +- [2. Playbook](./2. Playbook.md) — Practical operations playbook diff --git a/en/get-shit-done/4. CC Friendliness.md b/en/get-shit-done/4. CC Friendliness.md new file mode 100644 index 0000000..c0c73ea --- /dev/null +++ b/en/get-shit-done/4. CC Friendliness.md @@ -0,0 +1,79 @@ +# GSD (Get Shit Done) — Claude Code Friendliness + +## Result: 🥇 A — 82/100 (Highly Optimized, ↑ from 76) + +``` +╔══════════════════════════════════════════════════════════════╗ +║ CLAUDE CODE FRIENDLINESS SCORECARD ║ +╠══════════════════════════════════════════════════════════════╣ +║ Repo: GSD (Get Shit Done) v1.26 ║ +║ Date: 2026-03-19 (re-eval from 2026-03-13) ║ +╠══════════════════════════════════════════════════════════════╣ +║ Category │ Score │ Max │ % ║ +╠═══════════════════════════════════╪════════╪═══════╪═══════╣ +║ 1. Memory & Context │ 15 │ 20 │ 75% ║ +║ 2. Agentic Architecture │ 18 │ 20 │ 90% ║ +║ 3. Extension Ecosystem │ 14 │ 15 │ 93% ║ +║ 4. Safety & Permissions │ 7 │ 10 │ 70% ║ +║ 5. Developer Experience │ 13 │ 15 │ 87% ║ +║ 6. Cost & Efficiency │ 8 │ 10 │ 80% ║ +║ 7. Documentation & Onboarding │ 7 │ 10 │ 70% ║ +╠═══════════════════════════════════╪════════╪═══════╪═══════╣ +║ TOTAL │ 82 │ 100 │ 82% ║ +╠══════════════════════════════════════════════════════════════╣ +║ Rating: 🥇 A — Highly Optimized (↑ from 76) ║ +╚══════════════════════════════════════════════════════════════╝ +``` + +## Changes from previous evaluation (v1.22.4 → v1.26) + +| Category | Previously | Now | Δ | Reason | +|---|---|---|---|---| +| **Memory & Context** | 14 | 15 | +1 | HANDOFF.json machine-readable handoff, WAITING.json signal file, persistent debug knowledge base | +| **Agentic** | 16 | 18 | +2 | Node repair operator (autonomous recovery), `/gsd:autonomous` mode, `/gsd:profile-user` autonomous profiling, MCP tool awareness for subagents, interactive executor mode | +| **Extensions** | 13 | 14 | +1 | Skills format for Codex + Antigravity, Codex hooks support, `/gsd:ship` native PR automation | +| **Safety** | 7 | 7 | 0 | Unchanged — still relies on deny list | +| **DX** | 11 | 13 | +2 | `/gsd:do` natural language router, `/gsd:note` zero-friction capture, `/gsd:next` auto-advance, `/gsd:stats` dashboard, programmatic set-profile | +| **Cost** | 8 | 8 | 0 | `inherit` profile added but overall unchanged | +| **Docs** | 7 | 7 | 0 | Comprehensive `docs/` directory (9 files) but still cross-platform focus | + +## Detailed evaluation + +| Category | Strengths | Weaknesses | +|---|---|---| +| **Memory** | `.planning/` is very detailed. HANDOFF.json + WAITING.json for machine-readable cross-session continuity. Persistent debug knowledge base avoids cold-start investigations. `resume-work` + frontmatter STATE.md. | Still uses custom system instead of native CLAUDE.md hierarchy | +| **Agentic** | ✅ **18/20** — 16 agents with model routing. Node repair (RETRY/DECOMPOSE/PRUNE) = autonomous recovery. `/gsd:autonomous` mode runs full pipeline. MCP tool awareness for subagents. Cross-phase regression gate. Interactive executor mode. | Verify step still needs human (by design) | +| **Extensions** | ✅ 3 native CC hooks + Codex hooks. Skills format for Codex/Antigravity. `/gsd:ship` native PR automation. Good slash commands. | No custom MCP server yet. No marketplace distribution | +| **Safety** | Atomic commits, plan→execute separation, always_confirm_destructive gate. | No Claude Code specific permission rules | +| **DX** | ✅ `/gsd:do` (natural language!), `/gsd:next` (auto-advance), `/gsd:note`, `/gsd:stats`, programmatic set-profile. 42 commands with composable flags. | Lifecyle understanding required before being fully productive | +| **Cost** | ✅ Explicit model routing (Haiku/Sonnet/Opus). `inherit` profile for dynamic switching. Fresh 200K per task. | Each agent is a new session | +| **Docs** | Comprehensive `docs/` directory (AGENTS.md, ARCHITECTURE.md, CLI-TOOLS.md, etc.). Vietnamese and English READMEs. | No Claude Code-specific integration guide yet | + +## Extension Ecosystem — Hooks detail + +| Hook | Event | Function | Cross-runtime | +|---|---|---|---| +| `gsd-statusline.js` | `Notification` | Model name, current task, context usage progress bar. Bridge file for context-monitor | Claude Code, Gemini | +| `gsd-context-monitor.js` | `PostToolUse` / `AfterTool` | Inject `additionalContext` warning when context is low. WARNING @ 35%, CRITICAL @ 25%. GSD-aware messages | Claude Code, Gemini | +| `gsd-check-update.js` | `SessionStart` | Background npm registry check. Cache. Statusline `⬆ /gsd:update` | Claude Code, Codex | + +## Highlight + +> GSD v1.26 **increased significantly** thanks to: node repair operator (autonomous task recovery), `/gsd:autonomous` mode, MCP tool awareness, HANDOFF.json/WAITING.json (machine-readable signals), `/gsd:do` natural language routing, and cross-phase regression gates. **Agentic score 18/20** — nearly optimal, only missing full HOTL mode for verify step (still requires human by design). **DX 13/15** thanks to `/gsd:do` which entirely eliminates the learning curve. + +## Recommendations to increase CC score + +| Recommendation | Impact | Difficulty | +|---|---|---| +| Add CLAUDE.md rules integration (`.claude/rules/`) | +2 Memory | Low | +| MCP server for project state querying | +1 Extensions | Medium | +| Optional auto-verify mode (skip human UAT) | +2 Agentic | Low | +| Claude Code-specific integration guide | +1 Docs | Low | +| Permission rules template (deny list auto-setup) | +1 Safety | Low | + +## See Also + +- [0. Overview](./0.%20Overview.md) — GSD 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 GSD diff --git a/en/superpowers/0. Overview.md b/en/superpowers/0. Overview.md index 1d49b87..4b4fe62 100644 --- a/en/superpowers/0. Overview.md +++ b/en/superpowers/0. Overview.md @@ -189,6 +189,6 @@ When tests fail: ## See Also -- [[3-Research/Github/Superpowers/1. Architecture and Logic]] — Internal architecture, data flow, skill mechanics -- [[3-Research/Github/Superpowers/2. Playbook]] — Installation, Day 1 workflow, cheat sheet, troubleshooting -- [[3-Research/Github/Superpowers/3. Decision Guide]] — Comparison with alternatives, use cases, costs, decision guide +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Internal architecture, data flow, skill mechanics +- [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, decision guide diff --git a/en/superpowers/1. Architecture and Logic.md b/en/superpowers/1. Architecture and Logic.md index a0f912c..409f9eb 100644 --- a/en/superpowers/1. Architecture and Logic.md +++ b/en/superpowers/1. Architecture and Logic.md @@ -19,7 +19,7 @@ version: 0.9.18 # Superpowers — Architecture and Logic > [!NOTE] -> This document dives deep into **internal workings** of Superpowers. Read [[3-Research/Github/Superpowers/0. Overview]] first for the big picture. +> This document dives deep into **internal workings** of Superpowers. Read [0. Overview](./0. Overview.md) first for the big picture. --- @@ -343,6 +343,6 @@ Superpowers suggests appropriate models based on task type: ## See Also -- [[3-Research/Github/Superpowers/0. Overview]] — Overview, philosophy, key features -- [[3-Research/Github/Superpowers/2. Playbook]] — Installation, Day 1 workflow, cheat sheet, troubleshooting -- [[3-Research/Github/Superpowers/3. Decision Guide]] — Comparison with alternatives, use cases, costs, decision guide +- [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, decision guide diff --git a/en/superpowers/2. Playbook.md b/en/superpowers/2. Playbook.md index 096eca9..64dbe36 100644 --- a/en/superpowers/2. Playbook.md +++ b/en/superpowers/2. Playbook.md @@ -19,7 +19,7 @@ version: 0.9.18 # Superpowers — Playbook > [!NOTE] -> This is an **action-oriented** document. Read [[3-Research/Github/Superpowers/0. Overview]] to understand what Superpowers is, [[3-Research/Github/Superpowers/1. Architecture and Logic]] to understand internal mechanisms. +> This is an **action-oriented** document. Read [0. Overview](./0. Overview.md) to understand what Superpowers is, [1. Architecture and Logic](./1. Architecture and Logic.md) to understand internal mechanisms. --- @@ -324,6 +324,6 @@ Error → Read full output → 3+ hypotheses → Test hypotheses → Fix → Def ## See Also -- [[3-Research/Github/Superpowers/0. Overview]] — Overview of the Superpowers framework -- [[3-Research/Github/Superpowers/1. Architecture and Logic]] — Internal architecture and mechanisms -- [[3-Research/Github/Superpowers/3. Decision Guide]] — Comparison, use cases, decision guide +- [0. Overview](./0. Overview.md) — Overview of the Superpowers framework +- [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/superpowers/3. Decision Guide.md b/en/superpowers/3. Decision Guide.md index 05a7069..ecd989d 100644 --- a/en/superpowers/3. Decision Guide.md +++ b/en/superpowers/3. Decision Guide.md @@ -18,7 +18,7 @@ version: 0.9.18 # Superpowers — Decision Guide > [!NOTE] -> Read this document BEFORE deciding to adopt Superpowers. Read [[3-Research/Github/Superpowers/0. Overview]] if you don't know what Superpowers is yet. +> Read this document BEFORE deciding to adopt Superpowers. Read [0. Overview](./0. Overview.md) if you don't know what Superpowers is yet. --- @@ -213,6 +213,6 @@ flowchart TD ## See Also -- [[3-Research/Github/Superpowers/0. Overview]] — Overview of the Superpowers framework -- [[3-Research/Github/Superpowers/1. Architecture and Logic]] — Internal architecture and mechanisms -- [[3-Research/Github/Superpowers/2. Playbook]] — Practical operations guide +- [0. Overview](./0. Overview.md) — Overview of the Superpowers framework +- [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/superpowers/4. CC Friendliness.md b/en/superpowers/4. CC Friendliness.md new file mode 100644 index 0000000..356ff6f --- /dev/null +++ b/en/superpowers/4. CC Friendliness.md @@ -0,0 +1,77 @@ +# Superpowers — Claude Code Friendliness + +## Result: 🥇 A — 81/100 (Highly Optimized, ↑ from 78) + +``` +╔══════════════════════════════════════════════════════════════╗ +║ CLAUDE CODE FRIENDLINESS SCORECARD ║ +╠══════════════════════════════════════════════════════════════╣ +║ Repo: Superpowers (obra) v5.0.5 ║ +║ Date: 2026-03-19 (re-eval from 2026-03-13) ║ +║ Source: https://github.com/obra/superpowers ║ +╠══════════════════════════════════════════════════════════════╣ +║ Category │ Score │ Max │ % ║ +╠═══════════════════════════════════╪════════╪═══════╪═══════╣ +║ 1. Memory & Context │ 14 │ 20 │ 70% ║ +║ 2. Agentic Architecture │ 18 │ 20 │ 90% ║ +║ 3. Extension Ecosystem │ 14 │ 15 │ 93% ║ +║ 4. Safety & Permissions │ 7 │ 10 │ 70% ║ +║ 5. Developer Experience │ 13 │ 15 │ 87% ║ +║ 6. Cost & Efficiency │ 8 │ 10 │ 80% ║ +║ 7. Documentation & Onboarding │ 7 │ 10 │ 70% ║ +╠═══════════════════════════════════╪════════╪═══════╪═══════╣ +║ TOTAL │ 81 │ 100 │ 81% ║ +╠══════════════════════════════════════════════════════════════╣ +║ Rating: 🥇 A — Highly Optimized (↑ from 78) ║ +╚══════════════════════════════════════════════════════════════╝ +``` + +## Changes from previous evaluation (v5.0.0 → v5.0.5) + +| Category | Previously | Now | Δ | Reason | +|---|---|---|---|---| +| **Memory & Context** | 14 | 14 | 0 | No change — still lacks session continuity and CLAUDE.md | +| **Agentic** | 17 | 18 | +1 | Execution handoff (v5.0.5) for user choice SDD vs inline → better HITL control. Subagent context isolation (v5.0.2) — agents receive only needed context | +| **Extensions** | 13 | 14 | +1 | Gemini CLI native extension (v5.0.1). 5 platforms instead of 4 | +| **Safety** | 7 | 7 | 0 | No change | +| **DX** | 12 | 13 | +1 | OpenCode one-line install (v5.0.4). Cursor hooks auto-detected (v5.0.3). User review gate (v5.0.1). Cross-platform fixes reduction friction | +| **Cost** | 7 | 8 | +1 | Review loop refinements (v5.0.4): max 3 iterations, single whole-plan review = ~30-40% token savings. Inline execution option (v5.0.5) = ~70% subagent cost reduction | +| **Docs** | 8 | 7 | -1 | Slash commands deprecated but not replaced with equivalent discoverability. Gemini docs helpful but no CC-specific guide | + +## Detailed evaluation + +| Category | Strengths | Weaknesses | +|---|---|---| +| **Memory** | ✅ Instruction Priority (User > Skills > System), skill injection via hooks, fresh context per subagent, context isolation (v5.0.2) | No CLAUDE.md creation, lacks session continuity/resume mechanism | +| **Agentic** | ✅ **18/20** — Explicit HITL/HOTL. SDD fire-and-forget for hours. User chooses execution mode (v5.0.5). Implementer status protocol. Context isolation. Spec review → user gate → plan review pipeline | Does not use `.claude/agents/` format yet | +| **Extensions** | ✅ 14 skills, native CC hooks, official marketplace, Gemini CLI extension (v5.0.1), 5 platforms. CSO skill descriptions. SUBAGENT-STOP gate | No custom MCP server | +| **Safety** | Worktree isolation, SUBAGENT-STOP, discard confirmation, main branch protection, context isolation | Lacks `.claude/settings.json` permission rules | +| **DX** | ✅ Zero config setup. 5-platform support. One-line OpenCode install (v5.0.4). Cursor auto-detected (v5.0.3). User review gate (v5.0.1). Cross-platform fixes (Bash 5.3+, POSIX, Windows) | Lacks progressive disclosure tracks | +| **Cost** | ✅ Model selection guidance. Fresh context per task. Review loop optimized (v5.0.4): 30-40% savings. Inline execution option (v5.0.5): 70% subagent savings. Caching-friendly | SDD still token-heavy when enabled | +| **Docs** | Comprehensive RELEASE-NOTES.md (53KB). Multi-platform install docs. Architecture rationale | Slash commands deprecated with no equivalent, Gemini limitations not prominently documented | + +## Highlight + +> Superpowers v5.0.5 **increased 78→81** thanks to: execution handoff (+1 Agentic — user chooses SDD vs inline), Gemini CLI native extension (+1 Extensions — 5 platforms), review loop optimization (+1 Cost — token savings 30-40%), and cross-platform DX improvements (+1 DX). +> +> Noteworthy: v5.0.5 restoring execution choice (SDD no longer mandatory) is a **calibration move** — giving users flexibility instead of dogmatic enforcement. Inline execution option also significantly reduces token cost for simple features. +> +> **Agentic Architecture 18/20** — matched GSD. Different strengths: Superpowers = TDD Iron Law + composable skills; GSD = context engineering + node repair + PR automation. + +## Recommendations to increase CC score + +| Recommendation | Impact | Difficulty | +|---|---|---| +| Add `/gsd:resume-work` equivalent (session continuity) | +2 Memory | Medium | +| Add CLAUDE.md template during installation | +2 Memory | Low | +| Use `.claude/agents/` format for reviewers | +1 Agentic | Low | +| Add `.claude/settings.json` permission rules | +2 Safety | Low | +| MCP server for brainstorming companion | +2 Extensions | Medium | +| Progressive disclosure (beginner/advanced) | +1 DX | Low | + +## See Also + +- [0. Overview](./0.%20Overview.md) — Superpowers 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 Superpowers diff --git a/vn/README.md b/vn/README.md deleted file mode 100644 index eb5693f..0000000 --- a/vn/README.md +++ /dev/null @@ -1,102 +0,0 @@ -# 🧪 Agentic Coding Lab - -> **Phòng nghiên cứu thế hệ mới của công nghệ phần mềm: AI-Agent Orchestration.** - -Chào mừng bạn đến với **Agentic Coding Lab**. Repository này đóng vai trò là kho tàng kiến thức để khám phá, phân tích và làm chủ các quy trình "Agentic Coding" — nơi các lập trình viên không chỉ viết code, mà còn điều phối hệ thống các AI Agent để xây dựng phần mềm. - -[🇬🇧 **English (Phiên bản Tiếng Anh)**](../README.md) - ---- - -## 🧭 Sứ mệnh - -Mục tiêu của phòng thí nghiệm này là tài liệu hóa và chuẩn hóa các phương pháp làm việc với AI Agent. Chúng tôi hướng tới việc vượt qua các phương pháp "code qua chat" đơn giản (Vibe Coding) để tiến tới **Điều phối Agent Hệ thống (Systematic Agent Orchestration)**. - -## 🔬 Các mảng nghiên cứu cốt lõi - -### 1. Scrum & Quản Trị Dự Án -*Cấu trúc Đội ngũ Agentic* - -Áp dụng phương pháp Scrum cho quy trình phát triển có sự hỗ trợ của AI, định nghĩa vai trò và trách nhiệm trong môi trường làm việc kết hợp người-agent. - -- **[Tổng Quan Scrum](understand-scrum/index.md)**: Cấu trúc đội ngũ, các vai trò và thuật ngữ. - -### 2. Phương pháp BMAD -*Business Methodology and Architecture Development* - -Một framework quy củ, phân theo giai đoạn để chuyển đổi ngôn ngữ tự nhiên thành phần mềm cấp doanh nghiệp. Nó là cầu nối giữa một ý tưởng mơ hồ và mã nguồn chạy được thông qua hệ thống "giàn giáo" kiến trúc nghiêm ngặt. - -- **[Phân tích Kiến trúc](understand-bmad/BMAD-Architecture-Analysis.md)**: Cấu trúc của BMAD. -- **[Quy trình Chuyên sâu](understand-bmad/BMAD-Workflow-Deep-Dive.md)**: 5 giai đoạn phát triển. -- **[Logic Thực thi Lệnh](understand-bmad/BMAD-Command-Execution-Logic.md)**: Cách các slash command điều khiển động cơ agent. - -### 3. Beads: Quản lý Tác vụ Agent -*Hệ thống "Jira" dành cho AI Agent* - -Một hệ thống theo dõi vấn đề chuyên biệt được thiết kế cho agent, giải quyết vấn đề "Mất trí nhớ của Agent" (Agent Amnesia) bằng cách lưu trữ ngữ cảnh và trạng thái bên ngoài cửa sổ context. - -- **[Tìm hiểu về Beads](understand-beads.md)**: Tại sao task list bằng Markdown lại thất bại và cách Beads thành công. - -### 4. Làm chủ Claude Code -*Hướng dẫn V2 Nâng cao* - -Các kỹ thuật để kiểm soát coding agent mạnh mẽ nhất hiện nay, tập trung vào hành vi xác định (deterministic) thông qua hooks và các lớp thực thi (enforcement layers). - -- **[Claude Code từ Newbie đến Pro](lam-quen-voi-claude-code.md)**: Scaffolding toàn cục, hooks, và các cổng bảo mật. - -### 5. Gemini CLI -*AI Agent mã nguồn mở cho Terminal* - -Nghiên cứu chi tiết về nền tảng agentic coding mã nguồn mở của Google, hỗ trợ MCP, sandboxing và multimodal với 1M token context. - -| Tài liệu | Nội dung | Liên kết | -| :--- | :--- | :--- | -| **Tổng quan** | Gemini CLI là gì, so sánh, triết lý thiết kế | [📖](gemini-cli/0.%20Overview.md) | -| **Kiến trúc & Logic** | Data flow, tool system, cơ chế nội bộ | [🏗️](gemini-cli/1.%20Architecture%20and%20Logic.md) | -| **Playbook** | Cài đặt, Day 1, cheat sheet, troubleshooting | [🛠️](gemini-cli/2.%20Playbook.md) | -| **So sánh với Claude Code** | Bảng so sánh lệnh tương đương chi tiết | [⚖️](gemini-cli/3.%20Gemini%20CLI%20vs%20Claude%20Code.md) | - ---- - -## 📚 Khóa học: Làm chủ BMAD - -Một giáo trình hoàn chỉnh được thiết kế để biến bạn thành một Technical Agent Lead. - -| Module | Mô tả | Liên kết | -| :--- | :--- | :--- | -| **Module 1** | **Tư duy & Khái niệm**
Triết lý "Workflow-First". | [🇬🇧 English](../en/understand-bmad/course/module-1-concept.md) • [🇻🇳 Tiếng Việt](understand-bmad/course/module-1-concept.md) | -| **Module 2** | **Câu lệnh**
Bộ công cụ cho từng giai đoạn dự án. | [🇬🇧 English](../en/understand-bmad/course/module-2-commands.md) • [🇻🇳 Tiếng Việt](understand-bmad/course/module-2-commands.md) | -| **Case Study 1** | **Greenfield**
Xây dựng tính năng mới từ đầu. | [🇬🇧 English](../en/understand-bmad/course/case-study-1-greenfield.md) • [🇻🇳 Tiếng Việt](understand-bmad/course/case-study-1-greenfield.md) | -| **Case Study 2** | **Brownfield**
Làm chủ mã nguồn cũ (Legacy). | [🇬🇧 English](../en/understand-bmad/course/case-study-2-brownfield.md) • [🇻🇳 Tiếng Việt](understand-bmad/course/case-study-2-brownfield.md) | -| **Case Study 3** | **Sáng tạo**
Giải quyết vấn đề kinh doanh & Đổi mới. | [🇬🇧 English](../en/understand-bmad/course/case-study-3-creative.md) • [🇻🇳 Tiếng Việt](understand-bmad/course/case-study-3-creative.md) | - ---- - -## 🛠 Cấu trúc Repository - -``` -agentic-coding-lab/ -├── en/ # 🇬🇧 Tài liệu Tiếng Anh -│ ├── claude-code/ # Deep dive Claude Code -│ ├── gemini-cli/ # Deep dive Gemini CLI -│ ├── get-shit-done/ # GSD framework -│ ├── bmad-method/ # BMad framework -│ ├── superpowers/ # Superpowers framework -│ ├── understand-scrum/ -│ ├── understand-beads.md -│ └── ... -└── vn/ # 🇻🇳 Tài liệu Tiếng Việt (Bạn đang ở đây) - ├── claude-code/ - ├── gemini-cli/ - ├── get-shit-done/ - ├── bmad-method/ - ├── superpowers/ - └── ... -``` - -## 🤝 Đóng góp - -Đây là một repo nghiên cứu sống. Nếu bạn tìm thấy các pattern agentic mới hoặc muốn cải thiện bản dịch, hãy thoải mái tạo PR. - ---- -*Duy trì bởi Astragentic Team.* diff --git a/vn/bmad-method/4. CC Friendliness.md b/vn/bmad-method/4. CC Friendliness.md index ce1831b..27fae43 100644 --- a/vn/bmad-method/4. CC Friendliness.md +++ b/vn/bmad-method/4. CC Friendliness.md @@ -69,4 +69,3 @@ - [1. Architecture and Logic](./1. Architecture and Logic.md) — Kiến trúc chi tiết - [2. Playbook](./2. Playbook.md) — Hướng dẫn vận hành - [3. Decision Guide](./3. Decision Guide.md) — Khi nào dùng BMad -- — Checklist đánh giá diff --git a/vn/claude-code/claude-code-hooks/0. Overview.md b/vn/claude-code/claude-code-hooks/0. Overview.md index 847b54d..f3a81ff 100644 --- a/vn/claude-code/claude-code-hooks/0. Overview.md +++ b/vn/claude-code/claude-code-hooks/0. Overview.md @@ -246,5 +246,5 @@ Chạy hooks ở background, không block Claude's workflow: ## Xem thêm -- [[3-Research/Claude Code/claude-code-hooks/1. Architecture and Logic]] — Data flow chi tiết, cơ chế matcher, JSON I/O schema -- [[3-Research/Claude Code/claude-code-hooks/2. Playbook]] — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow chi tiết, cơ chế matcher, JSON I/O schema +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting diff --git a/vn/claude-code/claude-code-hooks/1. Architecture and Logic.md b/vn/claude-code/claude-code-hooks/1. Architecture and Logic.md index 5a596c0..5b86841 100644 --- a/vn/claude-code/claude-code-hooks/1. Architecture and Logic.md +++ b/vn/claude-code/claude-code-hooks/1. Architecture and Logic.md @@ -534,5 +534,5 @@ Debug output mẫu: ## Xem thêm -- [[3-Research/Claude Code/claude-code-hooks/0. Overview]] — Tổng quan hệ thống, vấn đề giải quyết, so sánh -- [[3-Research/Claude Code/claude-code-hooks/2. Playbook]] — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Tổng quan hệ thống, vấn đề giải quyết, so sánh +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting diff --git a/vn/claude-code/claude-code-hooks/2. Playbook.md b/vn/claude-code/claude-code-hooks/2. Playbook.md index 5dd0268..23ebb83 100644 --- a/vn/claude-code/claude-code-hooks/2. Playbook.md +++ b/vn/claude-code/claude-code-hooks/2. Playbook.md @@ -113,7 +113,7 @@ FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty') PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/") for pattern in "${PROTECTED_PATTERNS[@]}"; do - if [[ "$FILE_PATH" == *"$pattern"* ]]; then + if ["$FILE_PATH" == *"$pattern"*](./"$FILE_PATH" == *"$pattern"*.md); then echo "Blocked: $FILE_PATH matches protected pattern '$pattern'" >&2 exit 2 fi @@ -489,7 +489,7 @@ fi | **Script không chạy** | Thiếu execute permission | `chmod +x .claude/hooks/script.sh` | | **`/hooks` shows no hooks** | JSON invalid hoặc chưa reload | Kiểm tra JSON syntax (no trailing commas), restart session hoặc mở `/hooks` | | **Stop hook chạy vô hạn** | Không check `stop_hook_active` | Thêm guard: `if stop_hook_active == true → exit 0` | -| **JSON validation failed** | Shell startup scripts (`.zshrc`) output text | Wrap output trong `if [[ $- == *i* ]]` check | +| **JSON validation failed** | Shell startup scripts (`.zshrc`) output text | Wrap output trong `if [$- == *i*](./$- == *i*.md)` check | | **Hook error in output** | Script exit non-zero bất ngờ | Test manual: `echo '{"tool_name":"Bash"}' \| ./hook.sh && echo $?` | | **PermissionRequest hook không fire** | Đang ở non-interactive mode (`-p`) | Dùng `PreToolUse` thay vì `PermissionRequest` | | **Async hook output mất** | Session idle | Output deliver ở next user interaction turn | @@ -550,7 +550,7 @@ jq . < .claude/settings.json |---|---|---| | **Không check `stop_hook_active`** | Stop hook → Claude continues → trigger Stop hook → vô hạn | Thêm guard check | | **Edit JSON tay không reload** | Hooks không load changes | Dùng `/hooks` menu hoặc restart session | -| **Shell output trong `.zshrc`** | Polute hook JSON parsing | Wrap trong `[[ $- == *i* ]]` | +| **Shell output trong `.zshrc`** | Polute hook JSON parsing | Wrap trong `[$- == *i*](./$- == *i*.md)` | | **PermissionRequest + non-interactive** | Hook không fire | Dùng `PreToolUse` thay thế | | **PostToolUse để undo** | Tool đã chạy rồi, không undo được | Dùng `PreToolUse` để chặn trước | | **Async hook cho decisions** | Async không block, decision vô nghĩa | Dùng sync hooks cho decisions | @@ -607,7 +607,7 @@ INPUT=$(cat) FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty') # Only run tests for source files -if [[ "$FILE_PATH" != *.ts && "$FILE_PATH" != *.js ]]; then +if ["$FILE_PATH" != *.ts && "$FILE_PATH" != *.js](./"$FILE_PATH" != *.ts && "$FILE_PATH" != *.js.md); then exit 0 fi @@ -657,5 +657,5 @@ hooks: ## Xem thêm -- [[3-Research/Claude Code/claude-code-hooks/0. Overview]] — Tổng quan hệ thống, vấn đề giải quyết, so sánh -- [[3-Research/Claude Code/claude-code-hooks/1. Architecture and Logic]] — Data flow chi tiết, JSON schemas, decision control +- [0. Overview](./0. Overview.md) — Tổng quan hệ thống, vấn đề giải quyết, so sánh +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow chi tiết, JSON schemas, decision control diff --git a/vn/claude-code/claude-code-hooks/3. Decision Guide.md b/vn/claude-code/claude-code-hooks/3. Decision Guide.md index 7f4dc6d..02e0a15 100644 --- a/vn/claude-code/claude-code-hooks/3. Decision Guide.md +++ b/vn/claude-code/claude-code-hooks/3. Decision Guide.md @@ -328,6 +328,6 @@ graph LR ## Xem thêm -- [[3-Research/Claude Code/claude-code-hooks/0. Overview]] — Tổng quan hệ thống, vấn đề giải quyết, kiến trúc -- [[3-Research/Claude Code/claude-code-hooks/1. Architecture and Logic]] — Data flow chi tiết, JSON schemas, decision control -- [[3-Research/Claude Code/claude-code-hooks/2. Playbook]] — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Tổng quan hệ thống, vấn đề giải quyết, kiến trúc +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow chi tiết, JSON schemas, decision control +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting diff --git a/vn/claude-code/claude-code-memory/0. Overview.md b/vn/claude-code/claude-code-memory/0. Overview.md index 923e760..b4429ed 100644 --- a/vn/claude-code/claude-code-memory/0. Overview.md +++ b/vn/claude-code/claude-code-memory/0. Overview.md @@ -210,5 +210,5 @@ flowchart LR ## 10. Xem thêm -- [[1. Architecture and Logic]] — Cơ chế load, data flow, path resolution chi tiết -- [[2. Playbook]] — Hướng dẫn cài đặt, cấu hình, và vận hành Memory +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Cơ chế load, data flow, path resolution chi tiết +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, cấu hình, và vận hành Memory diff --git a/vn/claude-code/claude-code-memory/1. Architecture and Logic.md b/vn/claude-code/claude-code-memory/1. Architecture and Logic.md index 862afbd..9d66c57 100644 --- a/vn/claude-code/claude-code-memory/1. Architecture and Logic.md +++ b/vn/claude-code/claude-code-memory/1. Architecture and Logic.md @@ -475,5 +475,5 @@ paths: ## 8. Xem thêm -- [[0. Overview]] — Tổng quan hệ thống Memory, so sánh, tính năng nổi bật -- [[2. Playbook]] — Hướng dẫn thực hành cài đặt, cấu hình, và vận hành +- [0. Overview](./0. Overview.md) — Tổng quan hệ thống Memory, so sánh, tính năng nổi bật +- [2. Playbook](./2. Playbook.md) — Hướng dẫn thực hành cài đặt, cấu hình, và vận hành diff --git a/vn/claude-code/claude-code-memory/2. Playbook.md b/vn/claude-code/claude-code-memory/2. Playbook.md index 5568ff2..bae9ccd 100644 --- a/vn/claude-code/claude-code-memory/2. Playbook.md +++ b/vn/claude-code/claude-code-memory/2. Playbook.md @@ -524,5 +524,5 @@ grep -r "claudeMdExcludes" .claude/ 2>/dev/null ## 8. Xem thêm -- [[0. Overview]] — Tổng quan hệ thống Memory, so sánh cơ chế, tính năng nổi bật -- [[1. Architecture and Logic]] — Cơ chế load, data flow, path resolution chi tiết +- [0. Overview](./0. Overview.md) — Tổng quan hệ thống Memory, so sánh cơ chế, tính năng nổi bật +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Cơ chế load, data flow, path resolution chi tiết diff --git a/vn/claude-code/claude-code-memory/3. Decision Guide.md b/vn/claude-code/claude-code-memory/3. Decision Guide.md index 34c370e..3e49a54 100644 --- a/vn/claude-code/claude-code-memory/3. Decision Guide.md +++ b/vn/claude-code/claude-code-memory/3. Decision Guide.md @@ -308,6 +308,6 @@ claude ## 9. Xem thêm -- [[0. Overview]] — Tổng quan hệ thống Memory, kiến trúc, tính năng nổi bật -- [[1. Architecture and Logic]] — Cơ chế load chi tiết, data flow, path resolution -- [[2. Playbook]] — Hướng dẫn thực hành cài đặt, cấu hình, và vận hành +- [0. Overview](./0. Overview.md) — Tổng quan hệ thống Memory, kiến trúc, tính năng nổi bật +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Cơ chế load chi tiết, data flow, path resolution +- [2. Playbook](./2. Playbook.md) — Hướng dẫn thực hành cài đặt, cấu hình, và vận hành diff --git a/vn/claude-code/claude-code-plugins/0. Overview.md b/vn/claude-code/claude-code-plugins/0. Overview.md index f6fc528..198c03a 100644 --- a/vn/claude-code/claude-code-plugins/0. Overview.md +++ b/vn/claude-code/claude-code-plugins/0. Overview.md @@ -242,5 +242,5 @@ Environment variable trỏ tới plugin root, giúp hooks/scripts reference file ## Xem thêm -- [[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]] — Cài đặt, tạo plugin, cheat sheet, troubleshooting +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow, component specs, manifest schema +- [2. Playbook](./2. Playbook.md) — Cài đặt, tạo plugin, cheat sheet, troubleshooting diff --git a/vn/claude-code/claude-code-plugins/1. Architecture and Logic.md b/vn/claude-code/claude-code-plugins/1. Architecture and Logic.md index 0bf4fcd..1af53bf 100644 --- a/vn/claude-code/claude-code-plugins/1. Architecture and Logic.md +++ b/vn/claude-code/claude-code-plugins/1. Architecture and Logic.md @@ -616,5 +616,5 @@ flowchart TD ## Xem thêm -- [[3-Research/Claude Code/claude-code-plugins/0. Overview]] — Tổng quan, triết lý, tính năng nổi bật -- [[3-Research/Claude Code/claude-code-plugins/2. Playbook]] — Hướng dẫn thực hành, cài đặt, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Tổng quan, triết lý, tính năng nổi bật +- [2. Playbook](./2. Playbook.md) — Hướng dẫn thực hành, cài đặt, cheat sheet, troubleshooting diff --git a/vn/claude-code/claude-code-plugins/2. Playbook.md b/vn/claude-code/claude-code-plugins/2. Playbook.md index 344869d..091f94f 100644 --- a/vn/claude-code/claude-code-plugins/2. Playbook.md +++ b/vn/claude-code/claude-code-plugins/2. Playbook.md @@ -168,7 +168,7 @@ cat > my-first-plugin/scripts/format-code.sh << 'EOF' #!/bin/bash # Auto-format code after Claude edits file_path=$(jq -r '.tool_input.file_path' < /dev/stdin) -if [[ "$file_path" == *.ts ]] || [[ "$file_path" == *.js ]]; then +if ["$file_path" == *.ts](./"$file_path" == *.ts.md) || ["$file_path" == *.js](./"$file_path" == *.js.md); then npx prettier --write "$file_path" 2>/dev/null fi EOF @@ -554,5 +554,5 @@ rm -rf ~/.claude/plugins/cache ## Xem thêm -- [[3-Research/Claude Code/claude-code-plugins/0. Overview]] — Tổng quan system, triết lý, so sánh -- [[3-Research/Claude Code/claude-code-plugins/1. Architecture and Logic]] — Data flow, schemas, component specs chi tiết +- [0. Overview](./0. Overview.md) — Tổng quan system, triết lý, so sánh +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow, schemas, component specs chi tiết diff --git a/vn/claude-code/claude-code-plugins/3. Decision Guide.md b/vn/claude-code/claude-code-plugins/3. Decision Guide.md index 07ddce7..a326fc8 100644 --- a/vn/claude-code/claude-code-plugins/3. Decision Guide.md +++ b/vn/claude-code/claude-code-plugins/3. Decision Guide.md @@ -337,6 +337,6 @@ flowchart TD ## Xem thêm -- [[3-Research/Claude Code/claude-code-plugins/0. Overview]] — Tổng quan system, triết lý, tính năng -- [[3-Research/Claude Code/claude-code-plugins/1. Architecture and Logic]] — Data flow, schemas, component specs -- [[3-Research/Claude Code/claude-code-plugins/2. Playbook]] — Hướng dẫn thực hành, cài đặt, cheat sheet +- [0. Overview](./0. Overview.md) — Tổng quan system, triết lý, tính năng +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow, schemas, component specs +- [2. Playbook](./2. Playbook.md) — Hướng dẫn thực hành, cài đặt, cheat sheet diff --git a/vn/claude-code/claude-code-skills/0. Overview.md b/vn/claude-code/claude-code-skills/0. Overview.md index 15729df..2092177 100644 --- a/vn/claude-code/claude-code-skills/0. Overview.md +++ b/vn/claude-code/claude-code-skills/0. Overview.md @@ -233,5 +233,5 @@ agent: Explore # hoặc Plan, general-purpose, custom agent ## Xem thêm -- [[3-Research/Claude Code/claude-code-skills/1. Architecture and Logic]] — Chi tiết kiến trúc nội bộ, data flow, frontmatter reference -- [[3-Research/Claude Code/claude-code-skills/2. Playbook]] — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Chi tiết kiến trúc nội bộ, data flow, frontmatter reference +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting diff --git a/vn/claude-code/claude-code-skills/1. Architecture and Logic.md b/vn/claude-code/claude-code-skills/1. Architecture and Logic.md index 63c3e9c..8068277 100644 --- a/vn/claude-code/claude-code-skills/1. Architecture and Logic.md +++ b/vn/claude-code/claude-code-skills/1. Architecture and Logic.md @@ -397,5 +397,5 @@ graph LR ## Xem thêm -- [[3-Research/Claude Code/claude-code-skills/0. Overview]] — Tổng quan, vấn đề giải quyết, tính năng nổi bật -- [[3-Research/Claude Code/claude-code-skills/2. Playbook]] — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Tổng quan, vấn đề giải quyết, tính năng nổi bật +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting diff --git a/vn/claude-code/claude-code-skills/2. Playbook.md b/vn/claude-code/claude-code-skills/2. Playbook.md index 4ae2887..7ce22d2 100644 --- a/vn/claude-code/claude-code-skills/2. Playbook.md +++ b/vn/claude-code/claude-code-skills/2. Playbook.md @@ -477,5 +477,5 @@ Skills sẽ available dưới dạng `/my-plugin:code-review`. ## Xem thêm -- [[3-Research/Claude Code/claude-code-skills/0. Overview]] — Tổng quan, vấn đề giải quyết, tính năng nổi bật -- [[3-Research/Claude Code/claude-code-skills/1. Architecture and Logic]] — Chi tiết kiến trúc nội bộ, data flow, frontmatter reference +- [0. Overview](./0. Overview.md) — Tổng quan, vấn đề giải quyết, tính năng nổi bật +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Chi tiết kiến trúc nội bộ, data flow, frontmatter reference diff --git a/vn/claude-code/claude-code-skills/3. Decision Guide.md b/vn/claude-code/claude-code-skills/3. Decision Guide.md index 0ebe490..3ecb51e 100644 --- a/vn/claude-code/claude-code-skills/3. Decision Guide.md +++ b/vn/claude-code/claude-code-skills/3. Decision Guide.md @@ -406,6 +406,6 @@ graph LR ## Xem thêm -- [[3-Research/Claude Code/claude-code-skills/0. Overview]] — Tổng quan, vấn đề giải quyết, tính năng nổi bật -- [[3-Research/Claude Code/claude-code-skills/1. Architecture and Logic]] — Chi tiết kiến trúc nội bộ, data flow, frontmatter reference -- [[3-Research/Claude Code/claude-code-skills/2. Playbook]] — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Tổng quan, vấn đề giải quyết, tính năng nổi bật +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Chi tiết kiến trúc nội bộ, data flow, frontmatter reference +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting diff --git a/vn/claude-code/claude-code-sub-agents/0. Overview.md b/vn/claude-code/claude-code-sub-agents/0. Overview.md index 9e1ee46..9c1b7b2 100644 --- a/vn/claude-code/claude-code-sub-agents/0. Overview.md +++ b/vn/claude-code/claude-code-sub-agents/0. Overview.md @@ -173,5 +173,5 @@ flowchart LR ## Xem thêm -- [[3-Research/Claude Code/claude-code-sub-agents/1. Architecture and Logic]] — Data flow chi tiết, cấu hình nâng cao, hooks system -- [[3-Research/Claude Code/claude-code-sub-agents/2. Playbook]] — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow chi tiết, cấu hình nâng cao, hooks system +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting diff --git a/vn/claude-code/claude-code-sub-agents/1. Architecture and Logic.md b/vn/claude-code/claude-code-sub-agents/1. Architecture and Logic.md index e87979f..1e62db5 100644 --- a/vn/claude-code/claude-code-sub-agents/1. Architecture and Logic.md +++ b/vn/claude-code/claude-code-sub-agents/1. Architecture and Logic.md @@ -466,5 +466,5 @@ tools: Agent(worker, researcher), Read, Bash ## Xem thêm -- [[3-Research/Claude Code/claude-code-sub-agents/0. Overview]] — Tổng quan về Sub-agents, so sánh với Agent Teams -- [[3-Research/Claude Code/claude-code-sub-agents/2. Playbook]] — Hướng dẫn thực hành, Day 1 workflow, cheat sheet +- [0. Overview](./0. Overview.md) — Tổng quan về Sub-agents, so sánh với Agent Teams +- [2. Playbook](./2. Playbook.md) — Hướng dẫn thực hành, Day 1 workflow, cheat sheet diff --git a/vn/claude-code/claude-code-sub-agents/2. Playbook.md b/vn/claude-code/claude-code-sub-agents/2. Playbook.md index 7b09dfa..0bd6fcb 100644 --- a/vn/claude-code/claude-code-sub-agents/2. Playbook.md +++ b/vn/claude-code/claude-code-sub-agents/2. Playbook.md @@ -479,5 +479,5 @@ or modify schema, explain that you only have read access. ## 8. Xem thêm -- [[3-Research/Claude Code/claude-code-sub-agents/0. Overview]] — Tổng quan về Sub-agents, vấn đề giải quyết, tính năng nổi bật -- [[3-Research/Claude Code/claude-code-sub-agents/1. Architecture and Logic]] — Kiến trúc chi tiết, data flow, hooks system, memory system +- [0. Overview](./0. Overview.md) — Tổng quan về Sub-agents, vấn đề giải quyết, tính năng nổi bật +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Kiến trúc chi tiết, data flow, hooks system, memory system diff --git a/vn/claude-code/claude-code-sub-agents/3. Decision Guide.md b/vn/claude-code/claude-code-sub-agents/3. Decision Guide.md index 65af210..a39b125 100644 --- a/vn/claude-code/claude-code-sub-agents/3. Decision Guide.md +++ b/vn/claude-code/claude-code-sub-agents/3. Decision Guide.md @@ -328,6 +328,6 @@ flowchart TD ## 9. Xem thêm -- [[3-Research/Claude Code/claude-code-sub-agents/0. Overview]] — Tổng quan, vấn đề giải quyết, kiến trúc, tính năng nổi bật -- [[3-Research/Claude Code/claude-code-sub-agents/1. Architecture and Logic]] — Data flow chi tiết, hooks system, memory, config -- [[3-Research/Claude Code/claude-code-sub-agents/2. Playbook]] — Cài đặt, Day 1 workflow, cheat sheet, troubleshooting, templates +- [0. Overview](./0. Overview.md) — Tổng quan, vấn đề giải quyết, kiến trúc, tính năng nổi bật +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow chi tiết, hooks system, memory, config +- [2. Playbook](./2. Playbook.md) — Cài đặt, Day 1 workflow, cheat sheet, troubleshooting, templates diff --git a/vn/claude-code/how-claude-code-works/0. Overview.md b/vn/claude-code/how-claude-code-works/0. Overview.md index 8802486..bbf6c85 100644 --- a/vn/claude-code/how-claude-code-works/0. Overview.md +++ b/vn/claude-code/how-claude-code-works/0. Overview.md @@ -254,5 +254,5 @@ Sử dụng Claude Code ở **mọi nơi**: ## Xem thêm -- [[3-Research/Claude Code/how-claude-code-works/1. Architecture and Logic]] — Data flow chi tiết, modules, cơ chế hoạt động nội bộ -- [[3-Research/Claude Code/how-claude-code-works/2. Playbook]] — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow chi tiết, modules, cơ chế hoạt động nội bộ +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, Day 1 workflow, cheat sheet, troubleshooting diff --git a/vn/claude-code/how-claude-code-works/1. Architecture and Logic.md b/vn/claude-code/how-claude-code-works/1. Architecture and Logic.md index 8d33201..64ba50e 100644 --- a/vn/claude-code/how-claude-code-works/1. Architecture and Logic.md +++ b/vn/claude-code/how-claude-code-works/1. Architecture and Logic.md @@ -543,5 +543,5 @@ graph TB ## Xem thêm -- [[3-Research/Claude Code/how-claude-code-works/0. Overview]] — Tổng quan, so sánh, tính năng nổi bật -- [[3-Research/Claude Code/how-claude-code-works/2. Playbook]] — Hướng dẫn cài đặt, vận hành, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Tổng quan, so sánh, tính năng nổi bật +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, vận hành, cheat sheet, troubleshooting diff --git a/vn/claude-code/how-claude-code-works/2. Playbook.md b/vn/claude-code/how-claude-code-works/2. Playbook.md index fa72e94..08b800f 100644 --- a/vn/claude-code/how-claude-code-works/2. Playbook.md +++ b/vn/claude-code/how-claude-code-works/2. Playbook.md @@ -541,5 +541,5 @@ claude -p "Review the diff against main, write a PR description, and commit with ## Xem thêm -- [[3-Research/Claude Code/how-claude-code-works/0. Overview]] — Tổng quan, so sánh, tính năng nổi bật -- [[3-Research/Claude Code/how-claude-code-works/1. Architecture and Logic]] — Data flow chi tiết, modules, cơ chế hoạt động nội bộ +- [0. Overview](./0. Overview.md) — Tổng quan, so sánh, tính năng nổi bật +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow chi tiết, modules, cơ chế hoạt động nội bộ diff --git a/vn/claude-code/how-claude-code-works/3. Decision Guide.md b/vn/claude-code/how-claude-code-works/3. Decision Guide.md index 2dbce4b..6abb2d6 100644 --- a/vn/claude-code/how-claude-code-works/3. Decision Guide.md +++ b/vn/claude-code/how-claude-code-works/3. Decision Guide.md @@ -345,6 +345,6 @@ flowchart TD ## Xem thêm -- [[3-Research/Claude Code/how-claude-code-works/0. Overview]] — Tổng quan, so sánh nhanh, tính năng nổi bật -- [[3-Research/Claude Code/how-claude-code-works/1. Architecture and Logic]] — Data flow, modules, cơ chế hoạt động nội bộ -- [[3-Research/Claude Code/how-claude-code-works/2. Playbook]] — Hướng dẫn cài đặt, vận hành, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Tổng quan, so sánh nhanh, tính năng nổi bật +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow, modules, cơ chế hoạt động nội bộ +- [2. Playbook](./2. Playbook.md) — Hướng dẫn cài đặt, vận hành, cheat sheet, troubleshooting diff --git a/vn/gemini-cli/0. Overview.md b/vn/gemini-cli/0. Overview.md index 8b83be4..62e9b90 100644 --- a/vn/gemini-cli/0. Overview.md +++ b/vn/gemini-cli/0. Overview.md @@ -249,5 +249,5 @@ flowchart LR ## Xem thêm -- [[1. Architecture and Logic]] — Data flow chi tiết, core modules, cơ chế nội bộ -- [[2. Playbook]] — Cài đặt, Day 1, cheat sheet, troubleshooting +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow chi tiết, core modules, cơ chế nội bộ +- [2. Playbook](./2. Playbook.md) — Cài đặt, Day 1, cheat sheet, troubleshooting diff --git a/vn/gemini-cli/1. Architecture and Logic.md b/vn/gemini-cli/1. Architecture and Logic.md index 4ed0a3e..a69053a 100644 --- a/vn/gemini-cli/1. Architecture and Logic.md +++ b/vn/gemini-cli/1. Architecture and Logic.md @@ -499,5 +499,5 @@ flowchart LR ## Xem thêm -- [[0. Overview]] — Tổng quan, tính năng, so sánh -- [[2. Playbook]] — Cài đặt, Day 1, cheat sheet, troubleshooting +- [0. Overview](./0. Overview.md) — Tổng quan, tính năng, so sánh +- [2. Playbook](./2. Playbook.md) — Cài đặt, Day 1, cheat sheet, troubleshooting diff --git a/vn/gemini-cli/2. Playbook.md b/vn/gemini-cli/2. Playbook.md index 60c414c..86d91c7 100644 --- a/vn/gemini-cli/2. Playbook.md +++ b/vn/gemini-cli/2. Playbook.md @@ -556,7 +556,7 @@ gemini-cli/ ``` ## Xem thêm -- [[0. Overview]] — Tổng quan, tính năng, so sánh -- [[1. Architecture and Logic]] — Data flow chi tiết, core modules, cơ chế nội bộ -- [[3. Gemini CLI vs Claude Code]] — Bảng so sánh lệnh tương đương với Claude Code +- [0. Overview](./0. Overview.md) — Tổng quan, tính năng, so sánh +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Data flow chi tiết, core modules, cơ chế nội bộ +- [3. Gemini CLI vs Claude Code](./3. Gemini CLI vs Claude Code.md) — Bảng so sánh lệnh tương đương với Claude Code diff --git a/vn/gemini-cli/3. Gemini CLI vs Claude Code.md b/vn/gemini-cli/3. Gemini CLI vs Claude Code.md index 6de8825..b1c22c0 100644 --- a/vn/gemini-cli/3. Gemini CLI vs Claude Code.md +++ b/vn/gemini-cli/3. Gemini CLI vs Claude Code.md @@ -325,8 +325,8 @@ cp GEMINI.md CLAUDE.md ## Xem thêm -- [[0. Overview]] — Tổng quan Gemini CLI -- [[1. Architecture and Logic]] — Kiến trúc nội bộ Gemini CLI -- [[2. Playbook]] — Hướng dẫn sử dụng Gemini CLI -- [[3-Research/Claude Code/how-claude-code-works/0. Overview]] — Tổng quan Claude Code -- [[3-Research/Claude Code/how-claude-code-works/2. Playbook]] — Hướng dẫn sử dụng Claude Code +- [0. Overview](./0. Overview.md) — Tổng quan Gemini CLI +- [1. Architecture and Logic](./1. Architecture and Logic.md) — Kiến trúc nội bộ Gemini CLI +- [2. Playbook](./2. Playbook.md) — Hướng dẫn sử dụng Gemini CLI +- [0. Overview](./0. Overview.md) — Tổng quan Claude Code +- [2. Playbook](./2. Playbook.md) — Hướng dẫn sử dụng Claude Code diff --git a/vn/get-shit-done/4. CC Friendliness.md b/vn/get-shit-done/4. CC Friendliness.md index 747cad8..d4787d2 100644 --- a/vn/get-shit-done/4. CC Friendliness.md +++ b/vn/get-shit-done/4. CC Friendliness.md @@ -77,4 +77,3 @@ - [1. Architecture and Logic](./1. Architecture and Logic.md) — Kiến trúc chi tiết - [2. Playbook](./2. Playbook.md) — Hướng dẫn vận hành - [3. Decision Guide](./3. Decision Guide.md) — Khi nào dùng GSD -- — Checklist đánh giá diff --git a/vn/lam-quen-voi-claude-code.md b/vn/getting-started-with-claude-code.md similarity index 100% rename from vn/lam-quen-voi-claude-code.md rename to vn/getting-started-with-claude-code.md diff --git a/vn/superpowers/4. CC Friendliness.md b/vn/superpowers/4. CC Friendliness.md index 3763016..b8ec208 100644 --- a/vn/superpowers/4. CC Friendliness.md +++ b/vn/superpowers/4. CC Friendliness.md @@ -76,4 +76,3 @@ - [1. Architecture and Logic](./1. Architecture and Logic.md) — Kiến trúc chi tiết - [2. Playbook](./2. Playbook.md) — Hướng dẫn vận hành - [3. Decision Guide](./3. Decision Guide.md) — Khi nào dùng Superpowers -- — Checklist đánh giá