@ngocsangairvds/vsaf 4.1.9 → 4.1.10

package/skills/vds-skill/runtime/docs/vi/agents/reference/sonarqube-orchestrator.md

@@ -0,0 +1,71 @@
+<!-- diátaxis: reference -->
+<!-- lang: vi -->
+<!-- draft-translation: needs-human-review -->
+
+> ⚠️ **BẢN DỊCH NHÁP — CẦN CON NGƯỜI RÀ SOÁT**
+>
+> Đây là bản dịch tiếng Việt do máy tạo ra từ nguồn tiếng Anh tại `../../../agents/reference/sonarqube-orchestrator.md`.
+> Theo `.gpt-5.4/specs/who-project-documentation-enhancement/requirements.md`, tài liệu tiếng Việt phải do con người dịch trước khi được xem là chính thức. Người rà soát cần kiểm tra, chỉnh sửa thuật ngữ kỹ thuật, và xóa banner này trước khi file trở thành chính thức.
+>
+> Theo dõi: [`docs/vi/TRANSLATION-BACKLOG.md`](../../TRANSLATION-BACKLOG.md)
+
+# SonarQube orchestrator
+
+> Quét chất lượng mã và quản lý issue SonarQube cho các repo VDS.
+
+## Phạm vi
+
+- **Làm:** Truy vấn project SonarQube, liệt kê issue và hotspot, kiểm tra health, và xuất chỉ số chất lượng.
+- **Không làm:** Thực thi quét (cần Maven hoặc sonar-scanner trong PATH), quản lý cấu hình SonarQube server.
+- **Người dùng chính:** AI agent (kiểm tra quality gate), nhà phát triển (xử lý issue).
+
+## Điểm vào CLI
+
+```bash
+# Qua router thống nhất
+vds-cli sonarqube --help
+
+# Direct entry
+vds-cli sonarqube --help
+```
+
+## Lệnh chính
+
+| Lệnh | Mục đích | Flag thường dùng |
+|------|----------|------------------|
+| `ping` | Kiểm tra kết nối và xác thực | — |
+| `projects` | Liệt kê project SonarQube truy cập được | `--query`, `--limit` |
+| `issues` | Liệt kê issue của project | `--project`, `--status`, `--severity` |
+| `hotspots` | Liệt kê security hotspot | `--project`, `--status` |
+| `measures` | Lấy chỉ số chất lượng của project | `--project`, `--metrics` |
+
+## Ví dụ quy trình
+
+```bash
+# Health check
+vds-cli sonarqube ping
+
+# Liệt kê project
+vds-cli sonarqube projects --limit 50
+
+# Liệt kê issue OPEN
+vds-cli sonarqube issues list --project ekyc-business --status OPEN
+
+# Liệt kê issue mức cao
+vds-cli sonarqube issues list --project ekyc-business --severity CRITICAL,BLOCKER
+
+# Lấy chỉ số chất lượng
+vds-cli sonarqube measures --project ekyc-business --metrics coverage,bugs,vulnerabilities
+
+# JSON-only
+vds-cli sonarqube --json-only ping
+```
+
+## Cấu hình
+
+Yêu cầu `VDS_SONAR_TOKEN` hoặc `VDS_SONAR_USER`/`VDS_SONAR_PASSWORD` trong `~/.vds/.env`.
+
+## Liên quan
+
+- **Orchestrators:** [grafana](grafana-orchestrator.md), [elastic](elastic-orchestrator.md)
+- **Confluence:** [WHO SonarQube](http://confluence.digital.vn/display/TTCN24/WHO-Project+Ecosystem+Documentation)

package/skills/vds-skill/runtime/docs/vi/agents/reference/spec-orchestrator.md

@@ -0,0 +1,56 @@
+<!-- diátaxis: reference -->
+
+# Điều Phối Viên Đặc Tả
+
+> Tạo, xác thực và duy trì bộ ba đặc tả VDS chuẩn.
+
+## Phạm vi
+
+- **Thực hiện:** Dựng khung thư mục đặc tả, xác thực tính nhất quán của bộ ba, kiểm tra sự liên kết giữa requirements/design/tasks, thực thi dòng đồng bộ AGENTS.md.
+- **Không thực hiện:** Viết nội dung đặc tả thay bạn, tự động tạo thiết kế từ không khí, thay thế xem xét của con người.
+- **Người dùng chính:** AI agent (tạo đặc tả), người phụ trách (xem xét và phê duyệt).
+
+## Điểm vào CLI
+
+```bash
+# Qua bộ định tuyến thống nhất
+vds-cli spec --help
+
+# Điểm vào trực tiếp
+vds-cli spec --help
+```
+
+## Các Lệnh Chính
+
+| Lệnh | Mục đích | Cờ thường dùng |
+|------|----------|----------------|
+| `validate <path>` | Xác thực một bộ ba đặc tả | — |
+| `check-alignment <path>` | Đối chiếu chéo FR và task | — |
+| `validate-sync <name>` | Kiểm tra đồng bộ với AGENTS.md | `--agents-label` |
+| `create <name>` | Dựng khung thư mục đặc tả mới | — |
+
+## Quy Trình Thường Gặp
+
+### Quy trình: Tạo Đặc Tả Giai Đoạn Mới
+
+1. Xác định phạm vi và tiêu chí chấp nhận
+2. Chạy `vds-cli spec create <tên>` để dựng khung bộ ba
+3. Điền `requirements.md`, `design.md`, `tasks.md`
+4. Chạy `vds-cli spec validate <đường_dẫn>` để xác minh cấu trúc
+5. Chạy `vds-cli spec check-alignment <đường_dẫn>` để đối chiếu chéo
+6. Cập nhật dòng đồng bộ AGENTS.md
+7. Chạy `vds-cli spec validate-sync <tên> --agents-label "..."`
+
+### Quy trình: Xác Thực Đặc Tả Hiện Có
+
+1. Chạy `vds-cli spec validate <đường_dẫn>` — kiểm tra sự liên kết phiên bản, sự hiện diện của FR, gói task
+2. Chạy `vds-cli spec check-alignment <đường_dẫn>` — xác minh tham chiếu chéo FR/task
+3. Sửa các khoảng trống được báo cáo
+4. Chạy lại cho đến khi tất cả kiểm tra đều đạt
+
+## Liên Quan
+
+- **Điều phối viên:** [tasks](tasks-orchestrator.md), [audit](audit-triage-playbook.md), [research](research-orchestrator.md)
+- **Skill:** [spec-creation-skill](../../../../vds-skills/skills/spec-creation-skill/SKILL.md)
+- **Confluence:** [WHO Specs](http://confluence.digital.vn/display/TTCN24/WHO-Project+Ecosystem+Documentation)
+- **Bitbucket:** [vds-scripts source](https://bitbucket.digital.vn/projects/WHO/repos/vds-scripts/browse)

package/skills/vds-skill/runtime/docs/vi/agents/reference/structure-orchestrator.md

@@ -0,0 +1,78 @@
+<!-- diátaxis: reference -->
+<!-- lang: vi -->
+<!-- draft-translation: needs-human-review -->
+
+> ⚠️ **BẢN DỊCH NHÁP — CẦN CON NGƯỜI RÀ SOÁT**
+>
+> Đây là bản dịch tiếng Việt do máy tạo ra từ nguồn tiếng Anh tại `../../../agents/reference/structure-orchestrator.md`.
+> Theo `.gpt-5.4/specs/who-project-documentation-enhancement/requirements.md`, tài liệu tiếng Việt phải do con người dịch trước khi được xem là chính thức. Người rà soát cần kiểm tra, chỉnh sửa thuật ngữ kỹ thuật, và xóa banner này trước khi file trở thành chính thức.
+>
+> Theo dõi: [`docs/vi/TRANSLATION-BACKLOG.md`](../../TRANSLATION-BACKLOG.md)
+
+# Structure orchestrator
+
+> Xác thực cấu trúc tài liệu VDS và tính nhất quán thư mục project.
+
+## Phạm vi
+
+- **Làm:** Xác thực cấu trúc tài liệu target-state, kiểm tra tính nhất quán thư mục giữa các project, và sinh báo cáo tuân thủ cấu trúc.
+- **Không làm:** Tự động tạo thư mục thiếu hoặc xác thực nội dung file.
+- **Người dùng chính:** AI agent (kiểm tra sẵn sàng docs), người bảo trì project.
+
+## Điểm vào CLI
+
+```bash
+# Qua router thống nhất
+vds-cli structure --help
+
+# Direct entry
+vds-structure --help
+```
+
+## Lệnh chính
+
+| Lệnh | Mục đích | Flag thường dùng |
+|------|----------|------------------|
+| `validate` | Xác thực cấu trúc (target-state hoặc tính nhất quán thư mục) | `--mode`, `--root`, `--report` |
+
+## Chế độ xác thực
+
+- `target-state` — xác thực cây tài liệu target-state
+- `folder-consistency` — so sánh cấu trúc thư mục giữa các project và chấm điểm nhất quán
+
+## Ví dụ quy trình
+
+```bash
+# Xác thực target-state
+vds-structure validate --mode target-state
+
+# Xác thực với root tuỳ chỉnh
+vds-structure validate --mode target-state --root ./docs
+
+# Kiểm tra nhất quán thư mục giữa các project
+vds-structure validate --mode folder-consistency --root ./projects
+
+# Ghi báo cáo JSON
+vds-structure validate --mode target-state --report structure-report.json
+
+# JSON-only
+vds-structure --json-only validate --mode target-state
+```
+
+## Nội dung báo cáo
+
+Báo cáo folder-consistency gồm:
+- Tổng số project và số project được phân tích
+- Điểm nhất quán (tính theo phần trăm)
+- Danh sách project bị thiếu
+- Các thư mục và file chung
+- Chi tiết mismatch theo từng project
+
+## Biến môi trường
+
+- `VDS_INSURANCE_DOCS_ROOT` — ghi đè gốc discovery tài liệu mặc định
+
+## Liên quan
+
+- **Orchestrators:** [links](links-orchestrator.md), [brd](brd-orchestrator.md)
+- **Confluence:** [WHO Structure](http://confluence.digital.vn/display/TTCN24/WHO-Project+Ecosystem+Documentation)

package/skills/vds-skill/runtime/docs/vi/agents/reference/system-requirements.md

@@ -0,0 +1,30 @@
+---
+diátaxis: reference
+audience: human
+complexity: basic
+last_updated: 2026-04-30
+phase_ref: 180
+language: vi
+---
+
+# Yêu cầu Hệ thống
+
+| Thành phần | Phiên bản | Kiểm tra |
+|-----------|---------|---------------|
+| Python | 3.14+ | `python3 --version` |
+| uv | Mới nhất | `uv --version` |
+| Git | 2.40+ | `git --version` |
+| Docker | 24.0+ | `docker --version` |
+
+## Các dịch vụ (Docker)
+
+| Dịch vụ | Cổng | Image |
+|---------|------|-------|
+| Postgres | 5432 | postgres:16 |
+| Redis | 6379 | redis:7 |
+| Qdrant | 6333 | qdrant/qdrant |
+
+## Xem thêm
+
+- Tiếng Anh: [system-requirements.md](../../agents/reference/system-requirements.md)
+- [Hệ sinh thái WHO](../../explanation/who-ecosystem-introduction.md)

package/skills/vds-skill/runtime/docs/vi/agents/reference/tasks-orchestrator.md

@@ -0,0 +1,45 @@
+<!-- diátaxis: reference -->
+
+# Điều Phối Viên Tác Vụ
+
+> Quản lý và theo dõi tác vụ xuyên các giai đoạn và gói công việc VDS.
+
+## Phạm vi
+
+- **Thực hiện:** Tạo tác vụ, cập nhật trạng thái, theo dõi hoàn thành, tạo báo cáo tác vụ.
+- **Không thực hiện:** Thay thế Jira cho quản lý dự án phức tạp, tự động phân công tác vụ.
+- **Người dùng chính:** AI agent (theo dõi tác vụ), người phụ trách (xem xét tiến độ).
+
+## Điểm vào CLI
+
+```bash
+# Qua bộ định tuyến thống nhất
+vds-cli tasks --help
+
+# Điểm vào trực tiếp
+vds-cli tasks --help
+```
+
+## Các Lệnh Chính
+
+| Lệnh | Mục đích | Cờ thường dùng |
+|------|----------|----------------|
+| `list` | Liệt kê tác vụ đang hoạt động | `--phase`, `--status` |
+| `create` | Tạo tác vụ mới | `--title`, `--owner` |
+| `update` | Cập nhật trạng thái tác vụ | `--id`, `--status` |
+| `report` | Tạo báo cáo tác vụ | `--format` |
+
+## Quy Trình Thường Gặp
+
+### Quy trình: Theo Dõi Tác Vụ Giai Đoạn
+
+1. Chạy `vds-cli tasks list --phase 174` để xem tác vụ đang hoạt động
+2. Cập nhật trạng thái tác vụ: `vds-cli tasks update --id ORCH-001 --status in_progress`
+3. Đánh dấu hoàn thành: `vds-cli tasks update --id ORCH-001 --status completed`
+4. Tạo báo cáo: `vds-cli tasks report --phase 174`
+
+## Liên Quan
+
+- **Điều phối viên:** [spec](spec-orchestrator.md), [progress](progress-orchestrator.md), [audit](audit-triage-playbook.md)
+- **Skill:** [cli-development-skill](../../../../vds-skills/skills/cli-development-skill/SKILL.md)
+- **Confluence:** [WHO Tasks](http://confluence.digital.vn/display/TTCN24/WHO-Project+Ecosystem+Documentation)

package/skills/vds-skill/runtime/docs/vi/agents/reference/validation-and-sync-notes.md

@@ -0,0 +1,26 @@
+<!-- diátaxis: reference -->
+
+<!-- TODO: translate — Vietnamese translation pending -->
+
+# Validation And Sync Notes
+
+This note records the remaining validation steps for the WHO ecosystem alignment work.
+
+## Worktree-safe implementation status
+
+Current edits are isolated in dedicated repo worktrees for:
+- `vds-scripts`
+- `vds-skills`
+
+## Remaining validation steps
+
+1. Review capability coverage against `docs/agents/reference/who-capability-inventory.md`
+2. Review routing consistency against `docs/agents/reference/who-capability-routing-matrix.md`
+3. Re-run skills alignment from the monorepo root when it is safe to touch generated surfaces:
+   - `./WHO-project/vds-skills/scripts/verify-alignment.sh`
+4. Regenerate root `AGENTS.md` from canonical WHO skills source when it is safe to update root generated outputs:
+   - `vds-cli skills sync --agent claude`
+
+## Important constraint
+
+The root generated `AGENTS.md` lives outside these two repo worktrees. It should be synced only in a controlled follow-up step so isolated worktree implementation does not unintentionally mix with the main monorepo working tree.

package/skills/vds-skill/runtime/docs/vi/agents/reference/vds-ai-memory-api.md

@@ -0,0 +1,53 @@
+<!-- diátaxis: reference -->
+
+<!-- TODO: translate — Vietnamese translation pending -->
+
+# VDS AI Memory API
+
+Operational usage currently centers on the skill contract and captured decision records.
+
+## Sources
+
+- `vds-ai-memory-skill` (`WHO-project/vds-skills/skills/vds-ai-memory-skill/SKILL.md`)
+- [Use VDS AI memory](../how-to/02-using-vds-ai-memory.md)
+- [WHO project baseline](../../../AGENTS.md)
+
+## CLI Commands (Primary)
+
+The `vds-cli memory` subcommand wraps the REST API with session management, auth, and error formatting.
+
+```bash
+vds-cli memory search "auth patterns" --limit 5
+vds-cli memory store "decision text" --category code --importance high --tags tag1,tag2
+vds-cli memory get <memory_id>
+vds-cli memory sessions
+vds-cli memory health
+vds-cli memory --json-only stats
+```
+
+Use the routed form for normal execution. Place global flags like `--json-only` before the subcommand. For detailed subcommand help, use `./scripts/worktree_uv.sh run --project memory_orchestrator vds-memory --help`.
+
+## REST API (curl fallback)
+
+Base URL (`/api/v1`) resolves in this order:
+
+1. `VDS_MEMORY_API_URL`
+2. `http://localhost:${API_PORT}` (when `API_PORT` is set)
+3. `http://localhost:8000`
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/sessions` | POST | Create a session |
+| `/memories` | POST | Store a memory |
+| `/memories/search` | POST | Search memories |
+| `/memories/<id>` | GET | Retrieve memory by ID |
+| `/health` | GET | Health check |
+| `/hooks/session-context` | POST | **Phase 6 HX.2** — Hook proxy for SessionStart pre-load (returns `{additionalContext}`) |
+| `/hooks/session-persist` | POST | **Phase 6 HX.2** — Hook proxy for Stop auto-persist (session summary + decisions) |
+
+See the skill file (`WHO-project/vds-skills/skills/vds-ai-memory-skill/SKILL.md`) for curl examples. The two `/hooks/*` endpoints are registered as `"type": "http"` hooks in `.claude/settings.local.json` alongside the corresponding `vds-cli memory-*` command hooks as a dual-path safety net (HTTP non-2xx is non-blocking in Claude Code, so the command path is the fallback).
+
+## Practical Contract
+
+- Read and write memory through the approved skill workflow.
+- Store concise, durable decisions with supporting evidence.

package/skills/vds-skill/runtime/docs/vi/agents/reference/vds-cli-reference.md

@@ -0,0 +1,34 @@
+<!-- diátaxis: reference -->
+
+<!-- TODO: translate — Vietnamese translation pending -->
+
+# VDS CLI Reference
+
+`vds-cli` is the unified router for workspace orchestrators.
+
+## Primary Source
+
+- [vds_cli README](../../../vds_cli/README.md)
+
+## Common Entry Points
+
+- `vds-cli env status`
+- `vds-cli status`
+- `vds-cli doctor`
+- `vds-cli jira ...`
+- `vds-cli confluence ...`
+- `vds-cli bitbucket ...`
+- `vds-cli git ...`
+- `vds-cli openapi ...`
+- `vds-cli spec ...`
+- `vds-cli schema ...`
+- `vds-cli diagrams ...`
+- `vds-cli google-sheets ...`
+
+Direct package executables may use different names than the routed `vds-cli` subcommands. **Direct executables are internal implementation detail — always use `vds-cli`.**
+
+As of the current Phase 2 lane, `vds-schema-convert --help` and `vds-cli diagrams --help` now expose structured Typer-based discovery surfaces rather than ad hoc manual output, which makes them safer entrypoints for AI-agent command discovery.
+
+For command-family routing, start with `vds-scripts-skill`. For deep specialist workflows, route to the corresponding specialist skill.
+For shared env/config/cache path behavior, see `portable-paths-and-config.md`.
+For the verified routed command inventory, see `cli-help-matrix.md`.

package/skills/vds-skill/runtime/docs/vi/agents/reference/who-capability-inventory.md

@@ -0,0 +1,98 @@
+<!-- diátaxis: reference -->
+
+<!-- TODO: translate — Vietnamese translation pending -->
+
+# WHO Capability Inventory
+
+This document records the current WHO ecosystem capability surface for routing, documentation, and validation.
+
+## 1. Routed command surfaces
+
+These are the primary user-facing command families exposed through `vds-cli`.
+
+### Bootstrap and discovery
+- `vds-cli env ...`
+- `vds-cli status`
+- `vds-cli doctor`
+- `vds-cli docs ...`
+
+### Integrations
+- `vds-cli jira ...`
+- `vds-cli confluence ...`
+- `vds-cli bitbucket ...`
+- `vds-cli git ...`
+- `vds-cli elastic ...`
+- `vds-cli grafana ...`
+- `vds-cli sonarqube ...`
+
+### Documentation and validation
+- `vds-cli openapi ...`
+- `vds-cli links ...`
+- `vds-cli structure ...`
+- `vds-cli schema ...`
+- `vds-cli pdf ...`
+- `vds-cli diagrams ...`
+- `vds-cli excel ...`
+- `vds-cli google-sheets ...`
+
+### Development and workflow
+- `vds-cli intellij ...`
+- `vds-cli tasks ...`
+- `vds-cli lsp ...`
+- `vds-cli spec ...`
+- `vds-cli audit ...`
+- `vds-cli circular-dependency ...`
+
+## 2. Standalone workspace capabilities
+
+These WHO packages matter operationally even if they are not all presented as primary routed command families inside one platform skill.
+
+- `markdown_orchestrator`
+- `hexagonal_orchestrator`
+- `mcp_server`
+- `multi_agent_orchestrator`
+
+## 3. Shared and internal support layers
+
+These shape the ecosystem but are not primary user task entrypoints.
+
+- `vds_cli_common`
+
+## 4. Skills ecosystem linkage
+
+The WHO skills catalog provides specialist workflow ownership alongside the scripts workspace.
+
+### Platform-routing skill
+- `vds-scripts-skill`
+
+### Specialist skills
+- `audit-orchestrator-skill`
+- `llm-analysis-skill`
+- `spec-creation-skill`
+- `cli-development-skill`
+- `lsp-skill`
+- `circular-dependency-skill`
+- `research-skill`
+- `code-review-graph-skill`
+- `app-config-discovery-skill`
+- `repomix-skill`
+- `grepai-skill`
+- `hexagonal-compliance-skill`
+- `vds-ai-memory-skill`
+
+## 5. Derived and generated surfaces
+
+These are important for agents and operators but are not canonical authoring roots.
+
+- `WHO-project/vds-skills/registry.yaml`
+- `WHO-project/vds-skills/AGENTS.md`
+- root generated `AGENTS.md`
+- `.agent/skills/`
+
+## 6. Validation use
+
+Use this inventory with:
+- `vds-scripts-skill` references
+- `docs/agents/reference/who-capability-routing-matrix.md`
+- `WHO-project/vds-skills/registry.yaml`
+- alignment/sync checks before closure

package/skills/vds-skill/runtime/docs/vi/agents/reference/who-capability-routing-matrix.md

@@ -0,0 +1,16 @@
+<!-- diátaxis: reference -->
+
+<!-- TODO: translate — Vietnamese translation pending -->
+
+# WHO Capability Routing Matrix
+
+| Intent | Human Doc Surface | Command Family / CLI | Skill Owner |
+|-------|--------------------|----------------------|-------------|
+| Bootstrap workspace | `reference/vds-cli-reference.md` | `vds-cli env/status/doctor` | `vds-scripts-skill` |
+| Use Jira/Confluence/Bitbucket/Git | `reference/cli-commands.md` | `vds-cli jira/confluence/bitbucket/git` | `vds-scripts-skill` |
+| Validate docs or platform artifacts | `reference/cli-commands.md` | `vds-cli openapi/links/structure/schema/pdf/diagrams/excel/google-sheets` | `vds-scripts-skill` |
+| Run audit workflow | `reference/cli-commands.md` + audit docs | `vds-cli audit` | `audit-orchestrator-skill` |
+| Create or validate spec | scripts/spec docs | `vds-cli spec` | `spec-creation-skill` |
+| Configure LSP | specialist docs | `vds-cli lsp` | `lsp-skill` |
+| Analyze dependency cycles | specialist docs | `vds-cli circular-dependency` | `circular-dependency-skill` |
+| Research a problem | skills references | mixed tools | `research-skill` |

package/skills/vds-skill/runtime/docs/vi/agents/tutorials/feature-progression-guide.md

@@ -0,0 +1,124 @@
+---
+diátaxis: tutorial
+audience: human
+complexity: basic
+last_updated: 2026-04-30
+phase_ref: 180
+language: vi
+---
+
+# Hướng dẫn Tiến bộ Tính năng
+
+Tiếp tục hành trình khám phá hệ sinh thái WHO sau khi hoàn thành [Hướng dẫn Zero-to-Productive Developer](zero-to-productive-developer.md).
+
+## Ngày 8 — Đánh giá đa dự án
+
+Chạy kiểm tra trên nhiều repository chỉ với một lệnh.
+
+```bash
+# Đánh giá tất cả dự án trong một phòng ban
+vds-cli audit --department INSURANCE --checklist DEP-001
+
+# Đánh giá các repo cụ thể
+vds-cli audit --repo repo-a,repo-b,repo-c --checklist PAR-001
+```
+
+**Học được:** Cấu hình audit, chọn checklist, diễn giải báo cáo.
+
+## Ngày 9 — Tích hợp Confluence
+
+Tải bằng chứng audit và báo cáo lên Confluence tự động.
+
+```bash
+# Đồng bộ bằng chứng sau audit
+vds-cli docs confluence-sync --repo my-service
+
+# Tạo báo cáo điểm chất lượng
+vds-cli docs quality-score
+```
+
+**Học được:** Đích đồng bộ Confluence, định dạng bằng chứng, cấu trúc trang.
+
+## Ngày 10 — Kiểm tra kiến trúc Hexagonal
+
+Xác minh dịch vụ tuân thủ nguyên tắc kiến trúc sạch.
+
+```bash
+# Kiểm tra tuân thủ hexagonal
+vds-cli hexagonal --repo my-service
+
+# Xem báo cáo ranh giới chi tiết
+vds-cli hexagonal --repo my-service --format json
+```
+
+**Học được:** Ranh giới port/adapter, hướng phụ thuộc, mẫu vi phạm.
+
+## Ngày 11 — Phát hiện phụ thuộc vòng lặp
+
+Xác định chu trình phụ thuộc có rủi ro giữa các microservice.
+
+```bash
+# Phát hiện chu trình trong dự án
+vds-cli circular-dependency --project INSURANCE
+
+# Xuất biểu đồ để trực quan hóa
+vds-cli circular-dependency --project INSURANCE --format mermaid
+```
+
+**Học được:** Danh sách phụ thuộc, phân loại chu trình, chiến lược khắc phục.
+
+## Ngày 12 — Quản lý Git Worktree
+
+Sử dụng worktree để phát triển tính năng song song mà không cần chuyển nhánh.
+
+```bash
+# Tạo worktree cho tính năng
+vds-cli git worktree-create --branch feature/my-change
+
+# Liệt kê tất cả worktree
+vds-cli git worktree-list
+```
+
+**Học được:** Vòng đời worktree, sửa chữa, dọn dẹp, luồng đa repo.
+
+## Ngày 13 — Khám phá orchestrator tùy chỉnh
+
+Khám phá các orchestrator nâng cao cho tác vụ chuyên biệt.
+
+```bash
+# Nghiên cứu chủ đề kết hợp tìm kiếm local và web
+vds-cli research --query "best practices for API pagination"
+
+# Tạo biểu đồ từ code
+vds-cli diagrams --repo my-service --format png
+
+# Chuyển đổi định dạng schema
+vds-cli schema --input openapi.yaml --output jsonschema
+```
+
+**Học được:** Chọn orchestrator, định dạng đầu ra, xâu chuỗi lệnh.
+
+## Ngày 14 — Luồng đa tác nhân
+
+Điều phối các nhóm tác nhân song song cho tác vụ phức tạp.
+
+```bash
+# Chạy luồng đa tác nhân
+vds-cli multi-agent --workflow spec-to-impl --spec my-spec.md
+
+# Theo dõi tiến độ tác nhân
+vds-cli multi-agent --status
+```
+
+**Học được:** Định nghĩa luồng, vai trò tác nhân, tổng hợp kết quả.
+
+## Ngoài Ngày 14
+
+- [Đóng góp orchestrator mới](../how-to/contribute-new-orchestrator.md)
+- Viết skill tùy chỉnh
+- [Khám phá chỉ mục orchestrator đầy đủ](../../reference/orchestrator-index.md)
+
+## Xem thêm
+
+- Tiếng Anh: [feature-progression-guide.md](../../agents/tutorials/feature-progression-guide.md)
+- [Hệ sinh thái WHO](../../explanation/who-ecosystem-introduction.md)

package/skills/vds-skill/runtime/docs/vi/agents/tutorials/index.md

@@ -0,0 +1,13 @@
+<!-- diátaxis: tutorial -->
+
+<!-- TODO: translate — Vietnamese translation pending -->
+
+# Tutorials
+
+Start here for guided VDS workspace setup.
+
+- [WHO project baseline](../../../AGENTS.md)
+- [Monorepo baseline](../../../../AGENTS.md)
+- [Scripts workspace quick start](../../README.md)
+- [Skills catalog quick start](../../../../WHO-project/vds-skills/README.md)
+- [WHO skills and scripts onboarding](who-skills-and-scripts-onboarding.md)

package/skills/vds-skill/runtime/docs/vi/agents/tutorials/quick-start.md

@@ -0,0 +1,30 @@
+---
+diátaxis: tutorials
+audience: human
+complexity: basic
+last_updated: 2026-04-30
+phase_ref: 180
+language: vi
+---
+
+# Bắt đầu nhanh
+
+Cài đặt môi trường VDS và chạy lệnh đầu tiên trong vòng 5 phút.
+
+## Yêu cầu
+
+- Python 3.14+, uv, Git, Docker
+
+## Cài đặt
+
+```bash
+cd vds-scripts
+git pull --ff-only origin HEAD
+uv sync
+vds-cli --help
+```
+
+## Xem thêm
+
+- Tiếng Anh: [quick-start.md](../../agents/tutorials/quick-start.md)
+- [Hệ sinh thái WHO](../../explanation/who-ecosystem-introduction.md)