@ngocsangairvds/vsaf 4.1.12 → 4.1.15

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

@@ -20,13 +20,13 @@ once):
 
 ```bash
 # Using uv run (console script)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket --help
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket --help
 
 # Using the unified VDS CLI
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env load
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket projects
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repositories PROJECT_KEY
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pull-requests PROJECT_KEY REPO_SLUG
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env load
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket projects
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repositories PROJECT_KEY
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pull-requests PROJECT_KEY REPO_SLUG
 ```
 
 **Agent-friendly output**
@@ -41,13 +41,13 @@ once):
 - **`projects`** - List all Bitbucket projects
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket projects --limit 50
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket projects --limit 50
   ```
 
 - **`create-project`** - Create a new project
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket create-project PROJECT_KEY "Project Name" \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket create-project PROJECT_KEY "Project Name" \
     --description "Project description"
   ```
 
@@ -56,24 +56,24 @@ once):
 - **`repositories`** - List repositories in a project
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repositories PROJECT_KEY --limit 25
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repositories PROJECT_KEY --limit 25
   ```
 
 - **`repo`** - Repository CRUD operations (create/get/update/delete)
 
   ```bash
   # Get repository
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo get PROJECT_KEY REPO_SLUG
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo get PROJECT_KEY REPO_SLUG
 
   # Create repository (requires --yes)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo create PROJECT_KEY REPO_SLUG --yes
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo create PROJECT_KEY REPO_SLUG --yes
 
   # Update repository description (requires --yes)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo update PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo update PROJECT_KEY REPO_SLUG \
     --description "Updated description" --yes
 
   # Delete repository (requires --yes)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo delete PROJECT_KEY REPO_SLUG --yes
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo delete PROJECT_KEY REPO_SLUG --yes
   ```
 
 - **Repository Management (Python client)** - Full CRUD operations via Python client
@@ -105,15 +105,15 @@ once):
 
   ```bash
   # Fork repository within same project
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket fork create PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket fork create PROJECT_KEY REPO_SLUG \
     --new-repo REPO_FORK --yes
 
   # Fork repository to new project
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket fork create PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket fork create PROJECT_KEY REPO_SLUG \
     --new-project NEW_PROJECT_KEY --new-repo NEW_REPO_SLUG --yes
 
   # List forks of a repository
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket fork list PROJECT_KEY REPO_SLUG
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket fork list PROJECT_KEY REPO_SLUG
   ```
 
   > **Note**: Fork operations require `--yes` flag for confirmation. The `list` action uses heuristic-based filtering
@@ -123,7 +123,7 @@ once):
 
 - **`pull-requests`** - List pull requests
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pull-requests PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pull-requests PROJECT_KEY REPO_SLUG \
     --state OPEN \
     --order newest \
     --limit 100
@@ -139,96 +139,96 @@ Complete PR workflow automation from CLI:
 #### Create and Review
 ```bash
 # Create pull request
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket create-pr EKYC ekyc-business \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket create-pr EKYC ekyc-business \
   "Fix boundary timers" fix/ekyc-psj-fix-001 \
   --target release \
   --description "Fixes ENGINE-09005 errors" \
   --reviewers "user1,user2"
 
 # Create draft PR and include required reviewers (best-effort; falls back if draft unsupported)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket create-pr EKYC ekyc-business \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket create-pr EKYC ekyc-business \
   "Draft: Payment validation" feature/payment-validation \
   --target develop \
   --draft \
   --include-required-reviewers
 
 # Create cross-project PR (optional: override source/destination project/repo)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket create-pr EKYC ekyc-business \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket create-pr EKYC ekyc-business \
   "Cross project PR" feature/branch \
   --source-project PLATFORM --source-repo platform-repo \
   --dest-project INSURANCE --dest-repo insurance-repo \
   --target release
 
 # Get PR details
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket get-pr EKYC ekyc-business 154
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket get-pr EKYC ekyc-business 154
 
 # Get PR details with commit list (best-effort)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket get-pr EKYC ekyc-business 154 \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket get-pr EKYC ekyc-business 154 \
   --include-commits --commit-limit 20
 
 # View PR changes
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pr-diff EKYC ekyc-business 154
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pr-diff EKYC ekyc-business 154
 
 # View PR changes for a specific file + write JSON summary to disk
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pr-diff EKYC ekyc-business 154 \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pr-diff EKYC ekyc-business 154 \
   --file "src/main/resources/application.yml" \
   --output /tmp/pr_154_diff.json \
   --no-color
 
 # Best-effort unified diff (only when API provides hunks)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pr-diff EKYC ekyc-business 154 --unified --no-color --output /tmp/pr_154.patch
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pr-diff EKYC ekyc-business 154 --unified --no-color --output /tmp/pr_154.patch
 
 # List PR activities
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pr-activities EKYC ekyc-business 154 --limit 10
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pr-activities EKYC ekyc-business 154 --limit 10
 
 # List only comment activities
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pr-activities EKYC ekyc-business 154 --type COMMENTED --limit 10
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pr-activities EKYC ekyc-business 154 --type COMMENTED --limit 10
 
 # List PR comments (derived from activities)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pr-comments EKYC ekyc-business 154 --limit 20
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pr-comments EKYC ekyc-business 154 --limit 20
 
 # List PR comments (threaded fields like parent/severity when available)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket list-pr-comments EKYC ekyc-business 154 --limit 20
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket list-pr-comments EKYC ekyc-business 154 --limit 20
 ```
 
 #### Approve and Merge
 ```bash
 # Add review comment
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket comment-pr EKYC ekyc-business 154 \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket comment-pr EKYC ekyc-business 154 \
   --text "LGTM! Ready to merge."
 
 # Inline-style comment or reply (best effort; falls back to general comment if server/SDK lacks support)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket comment-pr EKYC ekyc-business 154 \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket comment-pr EKYC ekyc-business 154 \
   --text "Fix this typo" --file "src/main.java" --line 42
 
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket comment-pr EKYC ekyc-business 154 \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket comment-pr EKYC ekyc-business 154 \
   --text "Good catch!" --reply-to 123
 
 # Approve PR
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket approve-pr EKYC ekyc-business 154 --yes
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket approve-pr EKYC ekyc-business 154 --yes
 
 # Merge PR (requires --yes)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket merge-pr EKYC ekyc-business 154 --yes
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket merge-pr EKYC ekyc-business 154 --yes
 
 # Merge with strategy, custom message, and close source branch
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket merge-pr EKYC ekyc-business 154 \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket merge-pr EKYC ekyc-business 154 \
   --strategy squash \
   --message "Squash merge PR #154" \
   --close-source-branch \
   --yes
 
 # Merge without approval check (not recommended)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket merge-pr EKYC ekyc-business 154 \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket merge-pr EKYC ekyc-business 154 \
   --skip-approval-check --yes
 
 # Or decline PR (requires --yes)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket decline-pr EKYC ekyc-business 154 --reason "Not meeting requirements" --yes
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket decline-pr EKYC ekyc-business 154 --reason "Not meeting requirements" --yes
 ```
 
 #### Remove Approval
 ```bash
 # Unapprove PR
-./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket unapprove-pr EKYC ekyc-business 154 --yes
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket unapprove-pr EKYC ekyc-business 154 --yes
 ```
 
 All commands support `--json-only` for clean JSON output and automatic markdown report generation.
@@ -237,7 +237,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 
 - **`pipelines`** - List pipelines
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pipelines WORKSPACE REPOSITORY --limit 10
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pipelines WORKSPACE REPOSITORY --limit 10
   ```
 
 ### User and Group Management
@@ -245,13 +245,13 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`groups`** - List all groups
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket groups --filter "developers" --limit 50
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket groups --filter "developers" --limit 50
   ```
 
 - **`project-users`** - List users with permissions for a project
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket project-users PROJECT_KEY \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket project-users PROJECT_KEY \
     --filter "john" \
     --limit 25
   ```
@@ -259,7 +259,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`project-groups`** - List groups with permissions for a project
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket project-groups PROJECT_KEY \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket project-groups PROJECT_KEY \
     --filter "developers" \
     --limit 25
   ```
@@ -269,38 +269,38 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`grant-group-repo`** - Grant group permissions to a repository
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket grant-group-repo PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket grant-group-repo PROJECT_KEY REPO_SLUG \
     GROUP_NAME write
   ```
 
 - **`branch-permissions`** - Branch permissions management
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket branch-permissions get PROJECT_KEY --permission-id 1
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket branch-permissions set PROJECT_KEY \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket branch-permissions get PROJECT_KEY --permission-id 1
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket branch-permissions set PROJECT_KEY \
     --matcher-type BRANCH --matcher-value "refs/heads/master" \
     --permission-type READ_ONLY --yes
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket branch-permissions delete PROJECT_KEY --permission-id 1 --yes
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket branch-permissions delete PROJECT_KEY --permission-id 1 --yes
   ```
 
 - **`conditions`** - Conditions-Reviewers management
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket conditions list PROJECT_KEY
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket conditions get PROJECT_KEY --condition-id 1
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket conditions create PROJECT_KEY \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket conditions list PROJECT_KEY
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket conditions get PROJECT_KEY --condition-id 1
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket conditions create PROJECT_KEY \
     --condition-file condition.json --yes
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket conditions list PROJECT_KEY --repo REPO_SLUG
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket conditions list PROJECT_KEY --repo REPO_SLUG
   ```
 
 - **`code`** - Code/file content operations
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code file PROJECT_KEY REPO_SLUG --file "path/to/file.py"
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code commits PROJECT_KEY REPO_SLUG --limit 50
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code diff PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code file PROJECT_KEY REPO_SLUG --file "path/to/file.py"
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code commits PROJECT_KEY REPO_SLUG --limit 50
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code diff PROJECT_KEY REPO_SLUG \
     --file "path/to/file.py" --hash-oldest abc123 --hash-newest def456
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code changelog PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code changelog PROJECT_KEY REPO_SLUG \
     --ref-from master --ref-to develop
   ```
 
@@ -309,10 +309,10 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`webhooks`** - Manage repository webhooks
   ```bash
   # List webhooks (optionally filter by event, include statistics)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket webhooks list PROJECT_KEY REPO_SLUG --filter-event "repo:push"
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket webhooks list PROJECT_KEY REPO_SLUG --filter-event "repo:push"
 
   # Create a webhook (requires --yes confirmation)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket webhooks create PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket webhooks create PROJECT_KEY REPO_SLUG \
     --name "CI Hook" \
     --url "https://ci.example.com/bitbucket" \
     --event repo:push \
@@ -320,14 +320,14 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --yes
 
   # Update a webhook
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket webhooks update PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket webhooks update PROJECT_KEY REPO_SLUG \
     --webhook-id 42 \
     --name "Updated Hook" \
     --set-inactive \
     --yes
 
   # Delete a webhook
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket webhooks delete PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket webhooks delete PROJECT_KEY REPO_SLUG \
     --webhook-id 42 \
     --yes
   ```
@@ -337,22 +337,22 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`workspace`** - Manage Cloud workspaces
   ```bash
   # List all workspaces
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket workspace list
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket workspace list
 
   # Get workspace details
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket workspace get --workspace-slug workspace1
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket workspace get --workspace-slug workspace1
 
   # Get workspace permissions
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket workspace permissions --workspace-slug workspace1
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket workspace permissions --workspace-slug workspace1
 
   # Get repository permissions in workspace
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket workspace permissions --workspace-slug workspace1 --repo-slug repo1
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket workspace permissions --workspace-slug workspace1 --repo-slug repo1
 
   # List projects in workspace
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket workspace projects --workspace-slug workspace1
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket workspace projects --workspace-slug workspace1
 
   # Get specific project from workspace
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket workspace project --workspace-slug workspace1 --project-key PROJ1
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket workspace project --workspace-slug workspace1 --project-key PROJ1
   ```
 
 ### Repository Variables (Bitbucket Cloud Only)
@@ -360,20 +360,20 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`repo-variables`** – Manage repository-level pipeline variables
   ```bash
   # List repository variables (JSON output with --no-markdown)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-variables list \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-variables list \
     --workspace team-slug \
     --repo-slug repo-slug \
     --no-markdown
 
   # Get a single variable by UUID
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-variables get \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-variables get \
     --workspace team-slug \
     --repo-slug repo-slug \
     --uuid {variable-uuid} \
     --no-markdown
 
   # Create a secured variable (requires --yes)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-variables create \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-variables create \
     --workspace team-slug \
     --repo-slug repo-slug \
     --key API_TOKEN \
@@ -383,7 +383,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --no-markdown
 
   # Update an existing variable (key/value/secured)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-variables update \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-variables update \
     --workspace team-slug \
     --repo-slug repo-slug \
     --uuid {variable-uuid} \
@@ -392,7 +392,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --no-markdown
 
   # Delete a variable
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-variables delete \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-variables delete \
     --workspace team-slug \
     --repo-slug repo-slug \
     --uuid {variable-uuid} \
@@ -405,7 +405,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`issue`** – Manage repository issues when Bitbucket Issues tracker is enabled
   ```bash
   # List issues (with optional query/sort)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket issue list \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket issue list \
     --workspace team-slug \
     --repo-slug repo-slug \
     --query 'state = "open"' \
@@ -413,7 +413,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --no-markdown
 
   # Create an issue
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket issue create \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket issue create \
     --workspace team-slug \
     --repo-slug repo-slug \
     --title "Production bug" \
@@ -423,7 +423,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --no-markdown
 
   # Update an issue (title/state/kind/priority/description)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket issue update \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket issue update \
     --workspace team-slug \
     --repo-slug repo-slug \
     --issue-id 123 \
@@ -431,7 +431,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --no-markdown
 
   # Delete an issue (requires --yes)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket issue delete \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket issue delete \
     --workspace team-slug \
     --repo-slug repo-slug \
     --issue-id 123 \
@@ -444,21 +444,21 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`pipeline-advanced`** – Inspect pipelines, steps, logs, and stop executions
   ```bash
   # Get pipeline details
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pipeline-advanced get \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pipeline-advanced get \
     --workspace team-slug \
     --repo-slug repo-slug \
     --pipeline-uuid {pipeline-uuid} \
     --no-markdown
 
   # List steps for a pipeline
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pipeline-advanced steps \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pipeline-advanced steps \
     --workspace team-slug \
     --repo-slug repo-slug \
     --pipeline-uuid {pipeline-uuid} \
     --no-markdown
 
   # Get a specific step
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pipeline-advanced step \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pipeline-advanced step \
     --workspace team-slug \
     --repo-slug repo-slug \
     --pipeline-uuid {pipeline-uuid} \
@@ -466,7 +466,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --no-markdown
 
   # Fetch pipeline step log (optionally provide byte range)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pipeline-advanced log \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pipeline-advanced log \
     --workspace team-slug \
     --repo-slug repo-slug \
     --pipeline-uuid {pipeline-uuid} \
@@ -476,7 +476,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --output ./logs/{pipeline-uuid}-{step-uuid}.log
 
   # Stop a running pipeline (requires --yes)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pipeline-advanced stop \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pipeline-advanced stop \
     --workspace team-slug \
     --repo-slug repo-slug \
     --pipeline-uuid {pipeline-uuid} \
@@ -489,14 +489,14 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`pr-blocker`** – Manage blocker comments on pull requests
   ```bash
   # List blockers on a pull request
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pr-blocker list \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pr-blocker list \
     --workspace team-slug \
     --repo-slug repo-slug \
     --pull-request-id 123 \
     --no-markdown
 
   # Add a blocker (optional reason/severity)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pr-blocker add \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pr-blocker add \
     --workspace team-slug \
     --repo-slug repo-slug \
     --pull-request-id 123 \
@@ -506,7 +506,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --no-markdown
 
   # Delete a blocker (requires --yes)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket pr-blocker delete \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket pr-blocker delete \
     --workspace team-slug \
     --repo-slug repo-slug \
     --pull-request-id 123 \
@@ -519,7 +519,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 
 - **`commit-status`** - Bitbucket Server/Data Center build statuses for a commit. Usage: `vds-cli bitbucket commit-status get <PROJECT> <REPO> <COMMIT> [--limit N] [--key KEY]`
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket commit-status get PROJECT_KEY REPO_SLUG COMMIT_ID \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket commit-status get PROJECT_KEY REPO_SLUG COMMIT_ID \
     --limit 20 \
     --key "ci"
   ```
@@ -529,11 +529,11 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`code-insights`** - Manage Code Insights reports
   ```bash
   # Get a report
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code-insights get PROJECT_KEY REPO_SLUG COMMIT_ID \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code-insights get PROJECT_KEY REPO_SLUG COMMIT_ID \
     --report-key "test-report"
 
   # Create a report
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code-insights create PROJECT_KEY REPO_SLUG COMMIT_ID \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code-insights create PROJECT_KEY REPO_SLUG COMMIT_ID \
     --report-key "coverage-report" \
     --title "Coverage Report" \
     --reporter "coverage-tool" \
@@ -543,13 +543,13 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --yes
 
   # Add annotations to a report
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code-insights annotate PROJECT_KEY REPO_SLUG COMMIT_ID \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code-insights annotate PROJECT_KEY REPO_SLUG COMMIT_ID \
     --report-key "test-report" \
     --annotations-file annotations.json \
     --yes
 
   # Delete a report
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code-insights delete PROJECT_KEY REPO_SLUG COMMIT_ID \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code-insights delete PROJECT_KEY REPO_SLUG COMMIT_ID \
     --report-key "test-report" \
     --yes
   ```
@@ -559,30 +559,30 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`repo-settings`** - Manage repository settings
   ```bash
   # Branching model
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings branching-model get PROJECT_KEY REPO_SLUG
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings branching-model set PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings branching-model get PROJECT_KEY REPO_SLUG
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings branching-model set PROJECT_KEY REPO_SLUG \
     --model-file branching-model.json --yes
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings branching-model enable PROJECT_KEY REPO_SLUG --yes
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings branching-model disable PROJECT_KEY REPO_SLUG --yes
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings branching-model enable PROJECT_KEY REPO_SLUG --yes
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings branching-model disable PROJECT_KEY REPO_SLUG --yes
 
   # Default branch
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings default-branch get PROJECT_KEY REPO_SLUG
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings default-branch set PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings default-branch get PROJECT_KEY REPO_SLUG
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings default-branch set PROJECT_KEY REPO_SLUG \
     --branch "main" --yes
 
   # Repository hooks
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings hooks get PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings hooks get PROJECT_KEY REPO_SLUG \
     --start 0 --limit 50
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings hooks enable PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings hooks enable PROJECT_KEY REPO_SLUG \
     --hook-key "com.atlassian.bitbucket.server.bitbucket-bundle:force-push-hook" --yes
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings hooks disable PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings hooks disable PROJECT_KEY REPO_SLUG \
     --hook-key "com.atlassian.bitbucket.server.bitbucket-bundle:force-push-hook" --yes
 
   # Git LFS
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings lfs get PROJECT_KEY REPO_SLUG
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings lfs set PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings lfs get PROJECT_KEY REPO_SLUG
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings lfs set PROJECT_KEY REPO_SLUG \
     --enabled --yes
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket repo-settings lfs set PROJECT_KEY REPO_SLUG \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket repo-settings lfs set PROJECT_KEY REPO_SLUG \
     --disabled --yes
   ```
 
@@ -591,7 +591,7 @@ All commands support `--json-only` for clean JSON output and automatic markdown
 - **`code-advanced`** - Advanced code operations
   ```bash
   # List files in repository
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code-advanced file-list \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code-advanced file-list \
     --project-key PROJECT_KEY \
     --repository-slug REPO_SLUG \
     --sub-folder "src" \
@@ -600,28 +600,28 @@ All commands support `--json-only` for clean JSON output and automatic markdown
     --limit 100
 
   # Get commit information
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code-advanced commit-info \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code-advanced commit-info \
     --project-key PROJECT_KEY \
     --repository-slug REPO_SLUG \
     --commit "abc123" \
     --path "file.py"
 
   # Get commit changes
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code-advanced commit-changes \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code-advanced commit-changes \
     --project-key PROJECT_KEY \
     --repository-slug REPO_SLUG \
     --commit-id "abc123" \
     --merges "exclude"
 
   # Search code (Cloud-only)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code-advanced search \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code-advanced search \
     --team "workspace" \
     --search-query "def test_function" \
     --page 1 \
     --limit 20
 
   # Advanced code search with repository filter (Cloud-only)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli bitbucket code-advanced search-advanced \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli bitbucket code-advanced search-advanced \
     --team "workspace" \
     --search-query "class MyClass" \
     --repository "repo-slug" \

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

@@ -6,10 +6,10 @@ Validates Business Requirements Document (BRD) coverage across VDS Insurance doc
 
 ```bash
 # Default validation (writes report to scripts/brd_coverage_report.json)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli brd -- validate
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli brd -- validate
 
 # Custom docs root + report path
-./scripts/worktree_uv.sh run --project vds_cli vds-cli brd -- validate \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli brd -- validate \
   --root WHO-project/insurance-document \
   --report /tmp/brd_coverage_report.json \
   --min-coverage 100