@ngocsangairvds/vsaf 4.1.14 → 4.1.16

package/skills/vds-skill/runtime/docs/agents/tutorials/zero-to-productive-developer.md

@@ -37,7 +37,7 @@ Close and reopen your terminal so the new PATH is active. You do not need to ins
 
 ```bash
 ls WHO-project/vds-scripts/vds_cli/
-ls WHO-project/vds-scripts/scripts/worktree_uv.sh
+ls WHO-project/vds-scripts/uv run --directory ~/.claude/vds-scripts
 ```
 
 ### 1.4 Signpost
@@ -55,7 +55,7 @@ All WHO workspace commands are run through `uv`. Inside the `vds-scripts` direct
 
 ```bash
 cd WHO-project/vds-scripts
-./scripts/worktree_uv.sh --help
+uv run --directory ~/.claude/vds-scripts --help
 ```
 
 If the help banner prints, your environment is aligned.
@@ -63,7 +63,7 @@ If the help banner prints, your environment is aligned.
 ### 2.2 Ask for directions
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli --help
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli --help
 ```
 
 Read the top-level command list. Notice that actions are grouped: `audit`, `spec`, `memory`, `progress`, `confluence`, `bitbucket`.
@@ -71,7 +71,7 @@ Read the top-level command list. Notice that actions are grouped: `audit`, `spec
 ### 2.3 Check environment health
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env status
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env status
 ```
 
 This prints:
@@ -137,7 +137,7 @@ Pick a small improvement to a how-to guide, for example:
 ### 4.2 Run the docs validator
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli docs validate
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli docs validate
 ```
 
 This checks:
@@ -168,7 +168,7 @@ git commit -m "docs: clarify first-audit-run prerequisites"
 Do not run on production audit targets yet. Choose a command that only reads:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli audit doctor --help
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli audit doctor --help
 ```
 
 ### 5.2 Run the doctor command against the workspace itself
@@ -176,7 +176,7 @@ Do not run on production audit targets yet. Choose a command that only reads:
 The `doctor` subcommand inspects the current workspace without mutating state:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli audit doctor profiles
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli audit doctor profiles
 ```
 
 This lists the known profiles and their availability. It will print a short table.
@@ -188,8 +188,8 @@ Open `docs/agents/reference/audit-triage-playbook.md`. This is a reference doc.
 ### 5.4 Try a spec command
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli spec --help
-./scripts/worktree_uv.sh run --project vds_cli vds-cli spec validate
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli spec --help
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli spec validate
 ```
 
 If validation passes, your workspace spec is aligned with the canonical triplet.
@@ -221,7 +221,7 @@ Place the new file under `docs/agents/how-to/` and add its link to `llms.txt`.
 ### 6.3 Run the validator
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli docs validate
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli docs validate
 ```
 
 ### 6.4 Open a draft PR or request review from a team member
@@ -268,7 +268,7 @@ In a scratch file or local note, write:
 For example, if the skill says to run `vds-cli audit dispatch --profile default-all --dry-run`, write that step into your test plan and execute it:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli audit dispatch --profile default-all --dry-run
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli audit dispatch --profile default-all --dry-run
 ```
 
 Read the output and reflect: did it match the skill's stated expectations?
@@ -298,13 +298,13 @@ git commit -m "docs(agents): add how-to for X" -m "- Problem: ..." -m "- Solutio
 ### 8.3 Run spec alignment
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli spec validate
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli spec validate
 ```
 
 ### 8.4 Run the docs validator
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli docs validate
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli docs validate
 ```
 
 ### 8.5 Push and open a merge request
@@ -333,7 +333,7 @@ After the merge:
 ## Recurring reminders
 
 - Quote all paths that contain spaces (`cd "..."`).
-- Use `./scripts/worktree_uv.sh` when in a dedicated worktree.
+- Use `uv run --directory ~/.claude/vds-scripts` when in a dedicated worktree.
 - Never put secrets in `.md` files, use `~/.vds/.env` instead.
 - Every new doc must: declare its Diátaxis quadrant, link from `llms.txt`, and pass `vds-cli docs validate`.
 - Prefer small changes over large ones. Each day above is designed to take under sixty minutes.

package/skills/vds-skill/runtime/docs/vi/agents/explanation/runtime-verification-and-gap-reporting.md

@@ -84,28 +84,28 @@ Use only commands already documented and supported in the current repo surface.
 ### Credentials
 
 ```bash
-./scripts/worktree_uv.sh run --project audit_orchestrator \
+uv run --directory ~/.claude/vds-scripts --package audit_orchestrator \
   vds-cli audit --json-only doctor credentials --require-state-dsn
 ```
 
 ### Profile / provider availability
 
 ```bash
-./scripts/worktree_uv.sh run --project audit_orchestrator \
+uv run --directory ~/.claude/vds-scripts --package audit_orchestrator \
   vds-cli audit --json-only doctor profile-availability --mode active
 ```
 
 ### Project or repo readiness
 
 ```bash
-./scripts/worktree_uv.sh run --project audit_orchestrator \
+uv run --directory ~/.claude/vds-scripts --package audit_orchestrator \
   vds-cli audit --json-only state readiness --project <PROJECT_PAGE_ID>
 ```
 
 ### Checklist/source surface verification
 
 ```bash
-./scripts/worktree_uv.sh run --project audit_orchestrator \
+uv run --directory ~/.claude/vds-scripts --package audit_orchestrator \
   vds-cli audit query-checklist --checklist-page 88722450 --summary-only
 ```
 

package/skills/vds-skill/runtime/docs/vi/agents/how-to/02-using-vds-ai-memory.md

@@ -69,7 +69,7 @@ vds-cli memory --json-only stats
 - Use the direct package entrypoint for full command help:
 
 ```bash
-./scripts/worktree_uv.sh run --project memory_orchestrator vds-memory --help
+uv run --directory ~/.claude/vds-scripts --package memory_orchestrator vds-memory --help
 ```
 
 ## Practical Rules

package/skills/vds-skill/runtime/docs/vi/agents/how-to/first-audit-run.md

@@ -8,7 +8,7 @@
 
 ## Prerequisites
 
-- `vds-scripts` cloned and bootstrapped (`./scripts/worktree_uv.sh sync`)
+- `vds-scripts` cloned and bootstrapped (`uv sync --directory ~/.claude/vds-scripts`)
 - `vds-cli doctor` passes
 - Target repo(s) accessible via Bitbucket
 

package/skills/vds-skill/runtime/docs/vi/agents/how-to/install-and-bootstrap-who-scripts-and-skills.md

@@ -33,7 +33,7 @@ git clone http://bitbucket.digital.vn/scm/WHO/vds-skills.git
 
 ```bash
 cd vds-scripts
-./scripts/worktree_uv.sh sync --all-packages
+uv sync --directory ~/.claude/vds-scripts --all-packages
 ```
 
 Nếu `uv sync` báo lỗi:
@@ -84,16 +84,16 @@ Helper được quản lý duy nhất qua `vds-cli env *` subcommands. KHÔNG c
 
 ```bash
 # Cài helper canonical tại $HOME/.vds/bin/git-credential-vds (mode 0o700)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env install-git-helper
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env install-git-helper
 
 # Kiểm tra trạng thái cài đặt
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env verify-git-helper
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env verify-git-helper
 
 # Khi cần reset cooldown (sau khi sửa creds bị lock)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env verify-git-helper --reset-cooldown
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env verify-git-helper --reset-cooldown
 
 # Gỡ cài đặt (idempotent)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env remove-git-helper [--purge]
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env remove-git-helper [--purge]
 ```
 
 Helper bảo vệ chống Bitbucket account-lock thông qua: (a) host allowlist (mặc định `bitbucket.digital.vn`), (b) lockout-prevention (3 failures trong 60s → 300s cooldown), (c) token preference (BITBUCKET_TOKEN ưu tiên hơn VDS_PASSWORD khi cả hai có).
@@ -102,13 +102,13 @@ Helper bảo vệ chống Bitbucket account-lock thông qua: (a) host allowlist
 
 ```bash
 # Kiểm tra vds-cli
-./scripts/worktree_uv.sh run --project vds_cli vds-cli --help
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli --help
 
 # Kiểm tra trạng thái môi trường
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env status
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env status
 
 # Chạy kiểm thử tập trung
-./scripts/worktree_uv.sh run --project vds_cli vds-cli doctor
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli doctor
 ```
 
 Bạn sẽ thấy bảng màu với các hàng:
@@ -146,10 +146,10 @@ Kết quả mong đợi: ✅ docs validate passed (với cảnh báo về bản
 
 | Triệu chứng | Nguyên nhân | Khắc phục |
 |-------------|-------------|-----------|
-| `Module not found` | Chưa đồng bộ workspace | Chạy `./scripts/worktree_uv.sh sync --all-packages` |
+| `Module not found` | Chưa đồng bộ workspace | Chạy `uv sync --directory ~/.claude/vds-scripts --all-packages` |
 | `Auth failures` | Thiếu biến môi trường | Kiểm tra `~/.vds/.env` |
 | `Worktree issues` | `core.symlinks=false` | `git config --global core.symlinks true` |
-| `vds-cli not found` | Chưa cài đặt entrypoint | `./scripts/worktree_uv.sh run --project vds_cli ...` |
+| `vds-cli not found` | Chưa cài đặt entrypoint | `uv run --directory ~/.claude/vds-scripts --package vds_cli ...` |
 
 ---
 

package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/analytics-pipeline-workflow.md

@@ -15,7 +15,7 @@
 
 ## Điều kiện tiên quyết
 
-- `vds-scripts` đã được clone và khởi tạo (`./scripts/worktree_uv.sh sync`)
+- `vds-scripts` đã được clone và khởi tạo (`uv sync --directory ~/.claude/vds-scripts`)
 - `vds-cli doctor` đạt trạng thái xanh cho các profile Elastic, Grafana và Metabase
 - `~/.vds/.env` chứa `ELASTIC_HOST`, `GRAFANA_HOST`, `METABASE_HOST`, và các thông tin xác thực tương ứng
 - Các index pattern đã được tạo trong Elasticsearch (ví dụ: `vds-logs-*`)
@@ -35,7 +35,7 @@ Metabase (phân phối dashboard)
 Chạy tìm kiếm log có mục tiêu để trích xuất dữ liệu phân tích thô.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli elastic search --index "vds-logs-*" \
   --query '{"bool":{"filter":[{"range":{"@timestamp":{"gte":"now-7d"}}},{"term":{"level":"ERROR"}}]}}' \
   --size 5000 --output /tmp/elastic-errors.json
@@ -53,7 +53,7 @@ Kết quả mong đợi:
 Tổng hợp lỗi theo dịch vụ để phục vụ bước trực quan hóa tiếp theo:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli elastic aggregate --index "vds-logs-*" \
   --field "service.name" --metric "count" \
   --time-range "now-7d" --output /tmp/error-agg.json
@@ -72,7 +72,7 @@ Kết quả mong đợi:
 Nạp dữ liệu đã tổng hợp vào một datasource Grafana và tạo panel.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli grafana datasource test --name "vds-elastic"
 ```
 
@@ -86,7 +86,7 @@ Kết quả mong đợi:
 Tạo một dashboard với panel time-series từ truy vấn Elastic:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli grafana dashboard create --title "VDS Error Analytics" \
   --datasource "vds-cli elastic" --panel-type timeseries \
   --query '{"index":"vds-logs-*","body":{"aggs":{"services":{"terms":{"field":"service.name"}}}}}' \
@@ -104,7 +104,7 @@ Kết quả mong đợi:
 Sinh link snapshot để chia sẻ:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli grafana snapshot create --dashboard "vds-error-analytics" \
   --name "Error Analytics Snapshot $(date +%Y-%m-%d)"
 ```
@@ -120,7 +120,7 @@ Kết quả mong đợi:
 Đồng bộ tập dữ liệu đã tổng hợp sang Metabase để phục vụ khai thác tự phục vụ.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli metabase card create --database "vds-analytics" \
   --name "Weekly Error Distribution" --query-file /tmp/error-agg.json
 ```
@@ -136,7 +136,7 @@ Kết quả mong đợi:
 Thêm card vào dashboard Metabase:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli metabase dashboard add-card --dashboard "VDS Operational Metrics" \
   --card 2143 --col 0 --row 0
 ```
@@ -151,7 +151,7 @@ Kết quả mong đợi:
 Công khai dashboard để truy cập public hoặc để nhúng:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli metabase dashboard publish --dashboard "VDS Operational Metrics" \
   --enable-public-link
 ```

package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/code-quality-gate-workflow.md

@@ -38,7 +38,7 @@ Báo cáo chất lượng tổng hợp
 Chạy phân tích SonarQube trên repo đích:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli sonarqube analyze --repo vds-scripts --branch main
 ```
 
@@ -62,7 +62,7 @@ vds-cli sonarqube report --repo vds-scripts --format json --output sonar-report.
 Kiểm tra tính tuân thủ kiến trúc hexagonal:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli hexagonal check --path . --strict
 ```
 
@@ -80,7 +80,7 @@ Kết quả mong đợi:
 Kiểm tra cấu trúc và tổ chức mã nguồn:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli structure validate --path . --mode target-state
 ```
 
@@ -98,7 +98,7 @@ Kết quả mong đợi:
 Phát hiện vòng lặp import:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli circular-dependency analyze --path . --language python
 ```
 
@@ -115,7 +115,7 @@ Kết quả mong đợi:
 Sinh báo cáo chất lượng hợp nhất:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli docs quality-report \
   --sonar sonar-report.json \
   --hexagonal hexagonal-report.json \

package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/confluence-bitbucket-sync-workflow.md

@@ -15,7 +15,7 @@
 
 ## Điều kiện tiên quyết
 
-- `vds-scripts` đã được clone và khởi tạo (`./scripts/worktree_uv.sh sync`)
+- `vds-scripts` đã được clone và khởi tạo (`uv sync --directory ~/.claude/vds-scripts`)
 - `vds-cli doctor` thành công
 - `~/.vds/.env` chứa `VDS_USERNAME`, `VDS_PASSWORD`, `CONFLUENCE_HOST`
 - Đã biết slug dự án Bitbucket và repo mục tiêu
@@ -35,7 +35,7 @@ bitbucket verify (kiểm tra liên kết)
 Chạy công cụ kiểm định tài liệu để kiểm tra header diátaxis, tính toàn vẹn liên kết và cấu trúc.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli docs validate --check-diataxis --check-links
 ```
 
@@ -53,7 +53,7 @@ Kết quả mong đợi:
 Chạy kiểm tra nghiêm ngặt hơn trước CI:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli docs validate --check-diataxis --check-links --fail-on-warning
 ```
 
@@ -62,7 +62,7 @@ Chạy kiểm tra nghiêm ngặt hơn trước CI:
 Đẩy tài liệu đã được kiểm định lên không gian Confluence.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli confluence sync --source docs/agents/how-to/ --space WHO --parent-page 88722450
 ```
 
@@ -81,7 +81,7 @@ Kết quả mong đợi:
 Đồng bộ một hướng dẫn duy nhất với tiêu đề chỉ định rõ:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli confluence sync --source docs/agents/how-to/first-audit-run.md \
   --space WHO --parent-page 88722450 --title "First Audit Run"
 ```
@@ -91,7 +91,7 @@ Kết quả mong đợi:
 Sau khi các trang Confluence đã hoạt động, xác minh rằng các liên kết repo Bitbucket phân giải đúng.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli bitbucket verify-links --project vds-scripts --check-confluence-refs
 ```
 
@@ -116,15 +116,15 @@ Thêm job sau vào `.github/workflows/docs-sync.yml`:
       - uses: actions/checkout@v4
       - name: Validate docs
         run: |
-          ./scripts/worktree_uv.sh run --project vds_cli \
+          uv run --directory ~/.claude/vds-scripts --package vds_cli \
             vds-cli docs validate --check-diataxis --check-links --fail-on-warning
       - name: Sync to Confluence
         run: |
-          ./scripts/worktree_uv.sh run --project vds_cli \
+          uv run --directory ~/.claude/vds-scripts --package vds_cli \
             vds-cli confluence sync --source docs/agents/ --space WHO --parent-page ${{ vars.CONFLUENCE_PARENT_PAGE }}
       - name: Verify Bitbucket links
         run: |
-          ./scripts/worktree_uv.sh run --project vds_cli \
+          uv run --directory ~/.claude/vds-scripts --package vds_cli \
             vds-cli bitbucket verify-links --project vds-scripts --check-confluence-refs
 ```
 

package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/document-delivery-workflow.md

@@ -57,7 +57,7 @@ See [API Reference](../reference/api.md).
 Render sơ đồ mermaid thành hình ảnh:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli diagrams mermaid --input architecture.md --output diagrams/
 ```
 
@@ -80,7 +80,7 @@ vds-cli diagrams c4 --level container --input c4-model.md --output c4-container.
 Sinh PDF từ markdown:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli pdf md2pdf --input architecture.md --output architecture.pdf --template corporate
 ```
 
@@ -103,7 +103,7 @@ vds-cli pdf batch --input-dir docs/ --output-dir pdfs/ --template corporate
 Đồng bộ tài liệu lên Confluence:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli confluence sync --input architecture.md --page-id 12345 --space WHO
 ```
 

package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/memory-progress-workflow.md

@@ -15,7 +15,7 @@
 
 ## Điều kiện tiên quyết
 
-- `vds-scripts` đã được clone và khởi tạo (`./scripts/worktree_uv.sh sync`)
+- `vds-scripts` đã được clone và khởi tạo (`uv sync --directory ~/.claude/vds-scripts`)
 - `vds-cli doctor` đạt trạng thái xanh
 - `~/.vds/.env` chứa thông tin xác thực backend memory (DSN Postgres hoặc đường dẫn file cục bộ)
 
@@ -34,7 +34,7 @@ progress report (theo dõi mức hoàn thành)
 Lưu các quan sát quan trọng sau mỗi phiên làm việc để các agent về sau có thể tiếp cận.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli memory store --tag "phase174,spec,fr-3" \
   --content "FR-3 requires multi-step workflow guides combining 2+ orchestrators"
 ```
@@ -51,7 +51,7 @@ Kết quả mong đợi:
 Lưu nhiều quan sát từ một phiên làm việc gộp:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli memory store --tag "phase174,audit" \
   --content "Audit run completed with 3 violations in hexagonal-compliance rules"
 ```
@@ -61,7 +61,7 @@ Lưu nhiều quan sát từ một phiên làm việc gộp:
 Trước khi bắt đầu phiên mới, tìm trong memory các công việc liên quan đã thực hiện trước đây.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli memory search "phase174 workflow guides"
 ```
 
@@ -78,7 +78,7 @@ Kết quả mong đợi:
 Truy hồi với bộ lọc tag để thu hẹp phạm vi:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli memory search "fr-3" --tag spec
 ```
 
@@ -87,7 +87,7 @@ Truy hồi với bộ lọc tag để thu hẹp phạm vi:
 Tạo báo cáo tiến độ từ các quan sát đã lưu và trạng thái audit hiện tại.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli progress report --phase 174 --format markdown
 ```
 
@@ -103,14 +103,14 @@ Kết quả mong đợi:
 Sinh báo cáo tổng hợp qua nhiều phase:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli progress report --phase 174,175,176 --format json
 ```
 
 Theo dõi mức hoàn thành phase với tích hợp checklist:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli progress checklist --phase 174 --update-status
 ```
 
@@ -133,7 +133,7 @@ Thêm vào shell profile hoặc hook của agent để tự lưu sau mỗi lện
 vds_memory_store() {
   local tag="$1"
   local content="$2"
-  ./scripts/worktree_uv.sh run --project vds_cli \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli \
     vds-cli memory store --tag "$tag" --content "$content"
 }
 ```

package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/research-spec-audit-workflow.md

@@ -15,7 +15,7 @@
 
 ## Điều kiện tiên quyết
 
-- `vds-scripts` đã được clone và khởi tạo (`./scripts/worktree_uv.sh sync`)
+- `vds-scripts` đã được clone và khởi tạo (`uv sync --directory ~/.claude/vds-scripts`)
 - `vds-cli doctor` thành công
 - (Các) repo mục tiêu truy cập được qua Bitbucket
 - `~/.vds/.env` chứa `VDS_USERNAME`, `VDS_PASSWORD`, và `OPENAI_API_KEY`
@@ -35,7 +35,7 @@ audit (thực thi kiểm định)
 Chạy truy vấn research có mục tiêu để thu thập bằng chứng cho tính năng hoặc khoảng trống bạn cần xử lý.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli research search "hexagonal architecture compliance patterns"
 ```
 
@@ -51,7 +51,7 @@ Kết quả mong đợi:
 Chấm điểm chất lượng bằng chứng trước khi tiếp tục:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli research score --evidence /tmp/vds-research-evidence-<timestamp>.json
 ```
 
@@ -70,7 +70,7 @@ Kết quả mong đợi:
 Dùng điều phối viên spec để tạo một spec mới từ bằng chứng research.
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli spec create hexagonal-compliance --evidence /tmp/vds-research-evidence-<timestamp>.json
 ```
 
@@ -86,7 +86,7 @@ Kết quả mong đợi:
 Kiểm định bộ ba tệp spec:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli spec validate --spec-dir .gpt-5.4/specs/hexagonal-compliance
 ```
 
@@ -102,7 +102,7 @@ Kết quả mong đợi:
 Chạy kiểm tra căn chỉnh:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli spec check-alignment --spec-dir .gpt-5.4/specs/hexagonal-compliance
 ```
 
@@ -111,7 +111,7 @@ Chạy kiểm tra căn chỉnh:
 Chạy điều phối viên audit đối với repo mục tiêu sử dụng spec đã được kiểm định.
 
 ```bash
-./scripts/worktree_uv.sh run --project audit_orchestrator \
+uv run --directory ~/.claude/vds-scripts --package audit_orchestrator \
   vds-cli audit run --repo vds-scripts --scope full --spec hexagonal-compliance
 ```
 
@@ -129,7 +129,7 @@ Kết quả mong đợi:
 Tạo báo cáo hợp nhất:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli research report --evidence /tmp/vds-research-evidence-<timestamp>.json \
   --audit /tmp/vds-audit-report-<timestamp>.json
 ```