@ngocsangairvds/vsaf 4.1.14 → 4.1.16

package/skills/vds-skill/runtime/docker/ROLLBACK.md

@@ -460,7 +460,7 @@ cd WHO-project/vds-skills
 git revert 92fcc7b  # infrastructure-evolution-skill v1.7.1 commit
 
 # Re-sync skill catalog
-./scripts/worktree_uv.sh run --project vds_cli vds-cli skills sync --agent claude
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli skills sync --agent claude
 ```
 
 3. **Verify rollback**

package/skills/vds-skill/runtime/docs/README.md

@@ -20,9 +20,9 @@ Use the steps below as the scripts-workspace quick start after that canonical bo
    ```
 3. **Verify credentials + health**
    ```bash
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli env status
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli status
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli doctor
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env status
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli status
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli doctor
    ```
    If `vds-cli` fails with `ModuleNotFoundError: vds_cli`, run:
    ```bash
@@ -30,10 +30,10 @@ Use the steps below as the scripts-workspace quick start after that canonical bo
    ```
 4. **Sample operations**
    ```bash
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli git status --project insurance
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli jira search "project = NTTC" --limit 5
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence content search "space = TDOV" --limit 5
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket projects
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git status --project insurance
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli jira search "project = NTTC" --limit 5
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence content search "space = TDOV" --limit 5
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket projects
    ```
 
 **Environment:** Store shared credentials in `VDS_ENV_FILE` or `<config-root>/.env`.
@@ -41,7 +41,7 @@ Use the steps below as the scripts-workspace quick start after that canonical bo
 otherwise from the friendly user-home VDS default (`~/.vds` on Unix-like systems).
 All `vds-scripts` CLIs auto-load the shared env file via `vds_cli_common`.
 If a variable is already set in the shell, it takes precedence over values loaded from `.env`.
-Use `./scripts/worktree_uv.sh run --project vds_cli vds-cli env status` to confirm.
+Use `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env status` to confirm.
 See `docs/agents/reference/portable-paths-and-config.md` for the full precedence and path model.
 If you update shared packages (e.g., `vds_cli_common`), re-sync the affected project:
 `uv sync --project <orchestrator> --reinstall`.
@@ -82,18 +82,18 @@ For **AI agents**, use this file as the primary operational reference and `AGENT
 
 | Task | Command |
 | --- | --- |
-| Check env / status | `./scripts/worktree_uv.sh run --project vds_cli vds-cli env status` • `./scripts/worktree_uv.sh run --project vds_cli vds-cli status` |
-| Regenerate manifest | `./scripts/worktree_uv.sh run --project vds_cli vds-cli regenerate-manifest` (add `--dry-run` to preview) |
-| Git pull/status (manifest-aware) | `./scripts/worktree_uv.sh run --project vds_cli vds-cli git pull --project lep` • `... git status --match "*notification*"` |
-| Branch lifecycle | `./scripts/worktree_uv.sh run --project vds_cli vds-cli git branch list --project insurance` |
-| Jira operations | `./scripts/worktree_uv.sh run --project vds_cli vds-cli jira search "<JQL>" --limit 20` • `... jira session create` |
-| Confluence | `./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence content page <ID> --server external --expand body.storage` |
-| Bitbucket | `./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repositories INSURANCE` |
-| Elastic | `./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic ping` |
-| Grafana | `./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana health` |
-| Hooks / Markdown lint | `./scripts/worktree_uv.sh run --project markdown_orchestrator python -m vds_markdown_orchestrator.cli lint` |
-
-> **Tip:** `./scripts/worktree_uv.sh run --project vds_cli vds-cli --help` and `... <service> --help` expose all flags. Use `--json-only` for machine-readable output or `--no-reports` to skip report files.
+| Check env / status | `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env status` • `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli status` |
+| Regenerate manifest | `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli regenerate-manifest` (add `--dry-run` to preview) |
+| Git pull/status (manifest-aware) | `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git pull --project lep` • `... git status --match "*notification*"` |
+| Branch lifecycle | `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git branch list --project insurance` |
+| Jira operations | `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli jira search "<JQL>" --limit 20` • `... jira session create` |
+| Confluence | `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence content page <ID> --server external --expand body.storage` |
+| Bitbucket | `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repositories INSURANCE` |
+| Elastic | `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic ping` |
+| Grafana | `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana health` |
+| Hooks / Markdown lint | `uv run --directory ~/.claude/vds-scripts --package markdown_orchestrator python -m vds_markdown_orchestrator.cli lint` |
+
+> **Tip:** `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli --help` and `... <service> --help` expose all flags. Use `--json-only` for machine-readable output or `--no-reports` to skip report files.
 
 Git commands automatically attempt to regenerate `vds-scripts/repo-manifest.yaml` from Bitbucket (LEP/INSURANCE/SAVING/EKYC)
 before running the underlying git orchestrator. To disable this behavior (for example, when offline), set
@@ -105,17 +105,17 @@ Run from `WHO-project/vds-scripts`:
 
 ```bash
 # Unified CLI + live credentialed checks
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env status
-./scripts/worktree_uv.sh run --project vds_cli vds-cli jira search "assignee = currentUser() ORDER BY updated DESC" --limit 1
-./scripts/worktree_uv.sh run --project jira_orchestrator vds-cli jira search "assignee = currentUser() ORDER BY updated DESC" --limit 1 --json-only
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence search --cql "type=page" --limit 1
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket projects
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env status
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli jira search "assignee = currentUser() ORDER BY updated DESC" --limit 1
+uv run --directory ~/.claude/vds-scripts --package jira_orchestrator vds-cli jira search "assignee = currentUser() ORDER BY updated DESC" --limit 1 --json-only
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence search --cql "type=page" --limit 1
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket projects
 
 # Service-specific live checks
-./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic ping
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana health
-./scripts/worktree_uv.sh run --project vds_cli vds-cli sonarqube ping
-./scripts/worktree_uv.sh run --project vds_cli vds-cli pdf -- version
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic ping
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana health
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli sonarqube ping
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli pdf -- version
 ```
 
 Notes:
@@ -156,7 +156,7 @@ docker compose down
 - Phase 2 Ubuntu portability verification: `./scripts/verification/phase2_portable_paths_ubuntu_docker.sh` (supported entrypoint; uses `docker/compose.phase2-verification.yml` underneath)
 - Run smoke tests inside container:
   ```bash
-  docker compose exec mcp-server ./scripts/worktree_uv.sh run --project vds_cli vds-cli status
+  docker compose exec mcp-server uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli status
   docker compose exec mcp-server uv run --project mcp_server pytest tests/unit -q
   ```
 

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

@@ -82,28 +82,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/agents/how-to/02-using-vds-ai-memory.md

@@ -67,7 +67,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/agents/how-to/apply-phase3-migration.md

@@ -51,7 +51,7 @@ the next manual `vds-cli scheduler schedules trigger-now ecosystem-daily-report`
 
 ```bash
 cd WHO-project/vds-scripts
-./scripts/worktree_uv.sh run --project scheduler_orchestrator alembic upgrade head
+uv run --directory ~/.claude/vds-scripts --package scheduler_orchestrator alembic upgrade head
 ```
 
 Expected output:
@@ -130,7 +130,7 @@ vds-cli scheduler schedules pause ecosystem-daily-report
 
 # 2. Downgrade.
 cd WHO-project/vds-scripts
-./scripts/worktree_uv.sh run --project scheduler_orchestrator alembic downgrade -1
+uv run --directory ~/.claude/vds-scripts --package scheduler_orchestrator alembic downgrade -1
 ```
 
 `alembic downgrade -1` reverts to `a1b2c3d4e5f8` (Phase 2 head), drops

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

@@ -6,7 +6,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/agents/how-to/install-and-bootstrap-who-scripts-and-skills.md

@@ -7,7 +7,7 @@ It is written for both human contributors and AI agents.
 
 ## 1. Choose the right working mode
 
-- **Dedicated `vds-scripts` worktree**: prefer `./scripts/worktree_uv.sh ...` for all `uv` commands.
+- **Dedicated `vds-scripts` worktree**: prefer `uv run --directory ~/.claude/vds-scripts ...` for all `uv` commands.
 - **Main `vds-scripts` checkout**: `uv sync` and `uv run --project ...` are acceptable.
 - **External clone**: set explicit `VDS_SCRIPTS_PATH` / `VDS_SKILLS_PATH` values and do not assume monorepo-relative defaults.
 
@@ -48,7 +48,7 @@ export VDS_SKILLS_PATH="${VDS_SKILLS_PATH:-./WHO-project/vds-skills/skills}"
 
 ```bash
 cd "$VDS_SCRIPTS_PATH"
-./scripts/worktree_uv.sh sync --all-packages
+uv sync --directory ~/.claude/vds-scripts --all-packages
 ```
 
 ### Non-worktree checkout
@@ -64,10 +64,10 @@ Run the minimum verification set before deeper work:
 
 ```bash
 cd "$VDS_SCRIPTS_PATH"
-./scripts/worktree_uv.sh run --project vds_cli vds-cli --help
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env status
-./scripts/worktree_uv.sh run --project vds_cli vds-cli audit --help
-./scripts/worktree_uv.sh run --project vds_cli vds-cli spec --help
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli --help
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env status
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli audit --help
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli spec --help
 ```
 
 If you are not in a dedicated worktree, use `uv run --project ...` equivalents.
@@ -259,19 +259,19 @@ Per FR-23 (helper lifecycle via vds-cli) + FR-24 (single canonical artifact), th
 # Install the canonical helper at $HOME/.vds/bin/git-credential-vds (mode 0o700)
 # and configure git credential.helper to use it. Removes any pre-FR-24 artifacts
 # (signature-checked per AC-24.6 — user-authored files are preserved with a warning).
-./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
 
 # Verify install state (exit 0 ⇔ all checks pass)
-./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
 
 # If a Bitbucket account-lock cooldown is active, reset after fixing creds:
-./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
 
 # Uninstall (idempotent — safe to call when nothing is installed)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env remove-git-helper
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env remove-git-helper
 
 # Uninstall + delete cooldown state file
-./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
 ```
 
 The helper enforces three contracts:
@@ -285,9 +285,9 @@ The helper enforces three contracts:
 Confirm the full credential + helper stack:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env status
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env verify-git-helper
-./scripts/worktree_uv.sh run --project vds_cli vds-cli doctor
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env status
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env verify-git-helper
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli doctor
 ```
 
 `vds-cli doctor` includes a "Git credential helper" status row (`installed` / `missing` / `broken`) per FR-23 AC-23.5, with a remediation hint pointing to `vds-cli env install-git-helper`.

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

@@ -6,7 +6,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 with Elastic, Grafana, and Metabase profiles green
 - `~/.vds/.env` contains `ELASTIC_HOST`, `GRAFANA_HOST`, `METABASE_HOST`, and corresponding credentials
 - Index patterns created in Elasticsearch (e.g., `vds-logs-*`)
@@ -26,7 +26,7 @@ Metabase (deliver dashboards)
 Run a targeted log search to extract raw analytics data.
 
 ```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
@@ -44,7 +44,7 @@ Expected output:
 Aggregate errors by service for downstream visualization:
 
 ```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
@@ -63,7 +63,7 @@ Expected output:
 Import the aggregated data into a Grafana datasource and create a 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"
 ```
 
@@ -77,7 +77,7 @@ Expected output:
 Create a dashboard with a time-series panel from the Elastic query:
 
 ```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"}}}}}' \
@@ -95,7 +95,7 @@ Expected output:
 Generate a snapshot link for sharing:
 
 ```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)"
 ```
@@ -111,7 +111,7 @@ Expected output:
 Sync the aggregated dataset to Metabase for self-service exploration.
 
 ```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
 ```
@@ -127,7 +127,7 @@ Expected output:
 Add the card to a Metabase dashboard:
 
 ```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
 ```
@@ -142,7 +142,7 @@ Expected output:
 Publish the dashboard for public or embedding access:
 
 ```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/agents/how-to/orchestrator-workflows/code-quality-gate-workflow.md

@@ -29,7 +29,7 @@ Consolidated Quality Report
 Run SonarQube analysis on the target repo:
 
 ```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
 ```
 
@@ -53,7 +53,7 @@ vds-cli sonarqube report --repo vds-scripts --format json --output sonar-report.
 Validate hexagonal architecture compliance:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli \
+uv run --directory ~/.claude/vds-scripts --package vds_cli \
   vds-cli hexagonal check --path . --strict
 ```
 
@@ -71,7 +71,7 @@ Expected output:
 Validate code structure and organization:
 
 ```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
 ```
 
@@ -89,7 +89,7 @@ Expected output:
 Detect import cycles:
 
 ```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
 ```
 
@@ -106,7 +106,7 @@ Expected output:
 Generate a unified quality report:
 
 ```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/agents/how-to/orchestrator-workflows/confluence-bitbucket-sync-workflow.md

@@ -6,7 +6,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
 - `~/.vds/.env` contains `VDS_USERNAME`, `VDS_PASSWORD`, `CONFLUENCE_HOST`
 - Bitbucket project slug and target repo known
@@ -26,7 +26,7 @@ bitbucket verify (check links)
 Run the docs validator to check diátaxis headers, link integrity, and structure.
 
 ```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
 ```
 
@@ -44,7 +44,7 @@ Expected output:
 Run a stricter check before 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
 ```
 
@@ -53,7 +53,7 @@ Run a stricter check before CI:
 Push validated documentation to the Confluence space.
 
 ```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
 ```
 
@@ -72,7 +72,7 @@ Expected output:
 Sync a single guide with explicit title:
 
 ```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"
 ```
@@ -82,7 +82,7 @@ Sync a single guide with explicit title:
 After Confluence pages are live, verify that Bitbucket repo links resolve correctly.
 
 ```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
 ```
 
@@ -107,15 +107,15 @@ Add the following job to `.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/agents/how-to/orchestrator-workflows/document-delivery-workflow.md

@@ -48,7 +48,7 @@ See [API Reference](../reference/api.md).
 Render mermaid diagrams to images:
 
 ```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/
 ```
 
@@ -71,7 +71,7 @@ vds-cli diagrams c4 --level container --input c4-model.md --output c4-container.
 Generate PDF from 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
 ```
 
@@ -94,7 +94,7 @@ vds-cli pdf batch --input-dir docs/ --output-dir pdfs/ --template corporate
 Sync documentation to 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/agents/how-to/orchestrator-workflows/memory-progress-workflow.md

@@ -6,7 +6,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
 - `~/.vds/.env` contains memory backend credentials (Postgres DSN or local file path)
 
@@ -25,7 +25,7 @@ progress report (track completion)
 Save key observations after each work session so they are available to future agents.
 
 ```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"
 ```
@@ -42,7 +42,7 @@ Expected output:
 Store multiple observations from a batch session:
 
 ```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"
 ```
@@ -52,7 +52,7 @@ Store multiple observations from a batch session:
 Before starting a new session, search memory for relevant prior work.
 
 ```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"
 ```
 
@@ -69,7 +69,7 @@ Expected output:
 Recall with tag filter for narrower scope:
 
 ```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
 ```
 
@@ -78,7 +78,7 @@ Recall with tag filter for narrower scope:
 Create a progress report from stored observations and current audit state.
 
 ```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
 ```
 
@@ -94,14 +94,14 @@ Expected output:
 Generate a consolidated report across multiple phases:
 
 ```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
 ```
 
 Track phase completion with checklist integration:
 
 ```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
 ```
 
@@ -124,7 +124,7 @@ Add to your shell profile or agent hook to auto-store after each command:
 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/agents/how-to/orchestrator-workflows/research-spec-audit-workflow.md

@@ -6,7 +6,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
 - `~/.vds/.env` contains `VDS_USERNAME`, `VDS_PASSWORD`, and `OPENAI_API_KEY`
@@ -26,7 +26,7 @@ audit (execute validation)
 Run a targeted research query to collect evidence for the feature or gap you need to address.
 
 ```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"
 ```
 
@@ -42,7 +42,7 @@ Expected output:
 Score the evidence quality before proceeding:
 
 ```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
 ```
 
@@ -61,7 +61,7 @@ Expected output:
 Use the spec orchestrator to create a new spec from the research evidence.
 
 ```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
 ```
 
@@ -77,7 +77,7 @@ Expected output:
 Validate the spec triplet:
 
 ```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
 ```
 
@@ -93,7 +93,7 @@ Expected output:
 Run alignment checks:
 
 ```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
 ```
 
@@ -102,7 +102,7 @@ Run alignment checks:
 Run the audit orchestrator against the target repo using the validated spec.
 
 ```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
 ```
 
@@ -120,7 +120,7 @@ Expected output:
 Generate a consolidated report:
 
 ```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
 ```