viepilot 2.50.1 → 3.7.2

package/lib/request/url-enricher.cjs

@@ -0,0 +1,69 @@
+'use strict';
+
+const URL_ROUTES = {
+  github:  /github\.com\/[^/]+\/[^/]+\/issues\/\d+/,
+  linear:  /linear\.app\/[^/]+\/issue\/[A-Z]+-\d+/,
+  jira:    /atlassian\.net\/browse\/[A-Z]+-\d+/,
+  trello:  /trello\.com\/c\/[a-zA-Z0-9]+/,
+  notion:  /notion\.so\/[a-f0-9-]{8,}/,
+};
+
+/**
+ * Detect whether input string contains a known issue-tracker URL.
+ * @param {string} input - raw user input (may contain URL anywhere)
+ * @returns {{ matched: boolean, source?: string, url?: string }}
+ */
+function detectIssueUrl(input) {
+  if (!input || typeof input !== 'string') return { matched: false };
+  // Extract first https?:// URL from input
+  const urlMatch = input.match(/https?:\/\/[^\s]+/);
+  if (!urlMatch) return { matched: false };
+  const url = urlMatch[0].replace(/[.,!?)]+$/, ''); // strip trailing punctuation
+  for (const [source, pattern] of Object.entries(URL_ROUTES)) {
+    if (pattern.test(url)) return { matched: true, source, url };
+  }
+  return { matched: false };
+}
+
+/**
+ * Enrich a request with details extracted from an issue URL via browser-intake-agent.
+ * Returns null (never throws) when extraction fails or agent is unavailable.
+ * CC adapter only — dispatched by vp-request SKILL.md / workflows/request.md.
+ * @param {string} url
+ * @param {string} source - detected source type
+ * @param {string} projectRoot
+ * @returns {Promise<{title,type,description,priority,labels}|null>}
+ */
+async function enrichFromUrl(url, source, projectRoot) {
+  try {
+    // CC adapter: Agent dispatch is handled by request.md (orchestrator layer).
+    // Direct callers (non-CC) receive null — enrichment silently skipped.
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Format pre-fill display for user confirmation.
+ * @param {object} enriched - { title, type, description, priority, labels }
+ * @param {string} url
+ * @returns {string} formatted display string
+ */
+function formatPreFillDisplay(enriched, url) {
+  if (!enriched) return '';
+  const lines = [
+    `Context extracted from: ${url}`,
+    ``,
+    `  Title:       ${enriched.title || '(not detected)'}`,
+    `  Type:        ${enriched.type || '(not detected)'}`,
+    `  Description: ${String(enriched.description || '').slice(0, 120)}${(enriched.description || '').length > 120 ? '...' : ''}`,
+    `  Priority:    ${enriched.priority || '(not detected)'}`,
+  ];
+  if (enriched.labels && enriched.labels.length > 0) {
+    lines.push(`  Labels:      ${enriched.labels.join(', ')}`);
+  }
+  return lines.join('\n');
+}
+
+module.exports = { detectIssueUrl, enrichFromUrl, formatPreFillDisplay, URL_ROUTES };

package/lib/viepilot-install.cjs

@@ -203,6 +203,21 @@ function buildInstallPlan(packageRoot, envSource = process.env, opts = {}) {
         steps.push(ent.isDirectory() ? { kind: 'copy_dir', from: src, to: dest } : { kind: 'copy_file', from: src, to: dest });
       }
     }
+    // BUG-027: copy adapter-native agent definitions to adapter's native agents dir
+    // e.g. agents/claude-code/ → ~/.claude/agents/ (not ~/.claude/viepilot/agents/claude-code/)
+    if (adapter.claudeAgentsSrc && adapter.claudeAgentsDir) {
+      const agentsSrcDir = path.join(root, adapter.claudeAgentsSrc);
+      const agentsDestDir = adapter.claudeAgentsDir(home);
+      if (fs.existsSync(agentsSrcDir)) {
+        steps.push({ kind: 'mkdir', path: agentsDestDir });
+        for (const ent of fs.readdirSync(agentsSrcDir, { withFileTypes: true })) {
+          const src = path.join(agentsSrcDir, ent.name);
+          const dest = path.join(agentsDestDir, ent.name);
+          steps.push(ent.isDirectory() ? { kind: 'copy_dir', from: src, to: dest } : { kind: 'copy_file', from: src, to: dest });
+        }
+      }
+    }
+
     // BUG-007: copy package.json so resolveViepilotPackageRoot() finds the root
     steps.push({ kind: 'copy_file', from: path.join(root, 'package.json'), to: path.join(vpDir, 'package.json') });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viepilot",
-  "version": "2.50.1",
+  "version": "3.7.2",
   "description": "**Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**",
   "main": "index.js",
   "bin": {

package/skills/vp-audit/SKILL.md

@@ -53,7 +53,7 @@ Silent if command unavailable or errors.
 </persona_context>
 
 
-<cursor_skill_adapter>
+<adapter id="claude-code">
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-audit`, `/vp-audit`, "audit", "kiểm tra", "check docs"
 - Treat all user text after the skill mention as `{{VP_ARGS}}`
@@ -62,8 +62,57 @@ Silent if command unavailable or errors.
 Display audit results clearly with actionable suggestions grouped by tier.
 
 ## C. Tool Usage
-Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
-</cursor_skill_adapter>
+Use Claude Code tools: `Bash` (shell), `Read` (file), `Edit` + `Write` (file write/patch),
+`Grep` (search), `Glob` (file patterns), `LS`, `WebSearch`, `WebFetch`,
+`Agent` (spawn subagent — multi-level nesting supported)
+Interactive: `AskUserQuestion` (deferred — preload via ToolSearch before first call)
+</adapter>
+
+<adapter id="cursor-agent">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Cursor tools: `run_terminal_cmd` (shell), `read_file` (read), `edit_file` (write/edit),
+`grep_search` (search), `web_search`, `codebase_search`, `list_dir`, `file_search`
+Interactive: text list fallback (AskQuestion available in Plan Mode only; Agent Mode = text)
+Subagent: `/multitask` (user command, single-level only — not a callable tool)
+MCP limit: 40 tools
+</adapter>
+
+<adapter id="antigravity">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Skill discovery: LLM-driven (automatic, no slash command needed).
+
+## C. Tool Usage
+Use Antigravity tools: `shell` (cmd), `file_read`, `file_write`, MCP plugins
+Interactive: text fallback (TUI-based; no formal AskUserQuestion)
+Skill path: `.agents/skills/<skill>/SKILL.md` (project) or `~/.gemini/antigravity/skills/` (global)
+Note: Gemini CLI deprecated June 18, 2026 — use Antigravity CLI.
+</adapter>
+
+<adapter id="codex">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Codex tools: `container.exec` (sandboxed shell), `apply_patch` (file write), `web_search`
+Interactive: text fallback (TUI Tab/Enter injection)
+Config: `~/.codex/config.toml`
+</adapter>
+
+<adapter id="copilot">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Discovery: User-driven (`@agent-name` in GitHub Copilot Chat).
+
+## C. Tool Usage
+Use Copilot tools: `runCommands` (shell), `read`/`readfile` (read), `edit`/`editFiles` (write),
+`code_search`, `find_references`
+Interactive: `askQuestions` (main agent only — NOT available in subagents; VS Code issue #293745)
+Skill path: `.github/agents/<name>.agent.md`
+</adapter>
 <scope_policy>
 ## ViePilot Namespace Guard (BUG-004)
 - Default mode: only use and reference `vp-*` skills in ViePilot workflows.
@@ -150,6 +199,8 @@ Optional flags:
 - `--tier3`      : Run Tier 3 (stack best-practice) only
 - `--tier4`      : Run Tier 4 (framework integrity) only
 - `--no-autolog` : Skip auto-logging of gaps to `.viepilot/requests/`; report-only mode
+- `--visual`     : Run browser-based visual + functional audit of running dev server (ENH-091; requires agent-browser)
+- `--browser <url>` : Specify base URL for browser audit (default: `http://localhost:3000`)
 
 ### Auto-Log Behavior (ENH-070)
 
@@ -180,6 +231,17 @@ Execute workflow from `@$HOME/{envToolDir}/workflows/audit.md`
 **Step 0**: Detect project type (viepilot framework vs user project)
 
 **Step 1 — Tier 1**: ViePilot State Consistency
+
+**Claude Code — invoke file-scanner-agent for state file discovery:**
+```
+Agent({ subagent_type: "file-scanner-agent",
+  description: "file-scanner-agent: scan state files for stale phase refs",
+  prompt: "patterns: [\".viepilot/phases/*/PHASE-STATE.md\"]. keywords: [\"in_progress\", \"planned\"]. context: Find phases with stale in_progress or planned status."
+})
+```
+Non-Claude Code: run Glob/Grep inline.
+
+Then cross-check results against:
 ```bash
 # TRACKER.md vs PHASE-STATE.md
 # ROADMAP.md vs PHASE-STATE.md
@@ -188,6 +250,17 @@ Execute workflow from `@$HOME/{envToolDir}/workflows/audit.md`
 ```
 
 **Step 2 — Tier 2**: Project Documentation Drift
+
+**Claude Code — invoke file-scanner-agent for docs drift scan:**
+```
+Agent({ subagent_type: "file-scanner-agent",
+  description: "file-scanner-agent: scan docs for stale refs and placeholder URLs",
+  prompt: "patterns: [\"docs/**/*.md\", \"README.md\", \"CHANGELOG.md\"]. keywords: [\"your-org\", \"YOUR_USERNAME\", \"TODO\", \"placeholder\"]. context: Find stale placeholder refs and docs drift."
+})
+```
+Non-Claude Code: run Glob/Grep inline.
+
+Then check:
 ```bash
 # Detect version: package.json / pom.xml / pyproject.toml
 # README.md version mention
@@ -207,6 +280,29 @@ Execute workflow from `@$HOME/{envToolDir}/workflows/audit.md`
 
 **Step 5**: Generate full report
 
+**Step 5B**: Browser Audit (when `--visual` flag present, Claude Code adapter only)
+
+```
+When --visual is passed:
+1. Resolve base URL: --browser <url> → config.json audit.baseUrl → http://localhost:3000
+2. Dispatch browser-audit-agent:
+   Agent({ subagent_type: "browser-audit-agent",
+     description: "browser-audit-agent: audit running dev server",
+     prompt: `op: audit_routes. baseUrl: ${baseUrl}. projectRoot: ${projectRoot}` })
+3. On success: call writeAuditReport(result, projectRoot) → lib/audit/browser-runner.cjs
+4. Report path shown to user: .viepilot/audit/visual-report-{timestamp}.md
+5. On agent-browser not installed: show prerequisite message, skip browser audit (non-blocking)
+
+After audit_routes: optionally run accessibility_check on same routes:
+   Agent({ subagent_type: "browser-audit-agent",
+     prompt: `op: accessibility_check. baseUrl: ${baseUrl}. routes: ${JSON.stringify(routes)}. projectRoot: ${projectRoot}` })
+
+Baseline management:
+- --visual first run: saves screenshots to .viepilot/audit/baselines/{slug}.png
+- Subsequent runs: compares current vs baseline (visual_check op)
+- --update-baseline: forces baseline refresh (passes updateBaseline: true to agent)
+```
+
 **Step 6**: Auto-fix (if requested)
 </process>
 

package/skills/vp-auto/SKILL.md

@@ -53,7 +53,7 @@ Silent if command unavailable or errors.
 </persona_context>
 
 
-<cursor_skill_adapter>
+<adapter id="claude-code">
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-auto`, `/vp-auto`, "auto", "vibe", "chạy tự động"
 - Treat all user text after the skill mention as `{{VP_ARGS}}`
@@ -62,11 +62,61 @@ Silent if command unavailable or errors.
 Prompt user conversationally with numbered list options at control points.
 
 ## C. Tool Usage
-Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
+Use Claude Code tools: `Bash` (shell), `Read` (file), `Edit` + `Write` (file write/patch),
+`Grep` (search), `Glob` (file patterns), `LS`, `WebSearch`, `WebFetch`,
+`Agent` (spawn subagent — multi-level nesting supported)
+Interactive: `AskUserQuestion` (deferred — preload via ToolSearch before first call)
 
 ## D. Subagent Spawning
-Use `Task(subagent_type="generalPurpose", ...)` for parallel execution.
-</cursor_skill_adapter>
+Use `Agent` tool for subagent dispatch. For parallel task execution: fan-out with multiple
+`Agent` calls per cluster (see ADAPTER_CONTEXT.orchestration — claude-code supports parallel: true).
+</adapter>
+
+<adapter id="cursor-agent">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Cursor tools: `run_terminal_cmd` (shell), `read_file` (read), `edit_file` (write/edit),
+`grep_search` (search), `web_search`, `codebase_search`, `list_dir`, `file_search`
+Interactive: text list fallback (AskQuestion available in Plan Mode only; Agent Mode = text)
+Subagent: `/multitask` (user command, single-level only — not a callable tool)
+MCP limit: 40 tools
+</adapter>
+
+<adapter id="antigravity">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Skill discovery: LLM-driven (automatic, no slash command needed).
+
+## C. Tool Usage
+Use Antigravity tools: `shell` (cmd), `file_read`, `file_write`, MCP plugins
+Interactive: text fallback (TUI-based; no formal AskUserQuestion)
+Skill path: `.agents/skills/<skill>/SKILL.md` (project) or `~/.gemini/antigravity/skills/` (global)
+Note: Gemini CLI deprecated June 18, 2026 — use Antigravity CLI.
+</adapter>
+
+<adapter id="codex">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Codex tools: `container.exec` (sandboxed shell), `apply_patch` (file write), `web_search`
+Interactive: text fallback (TUI Tab/Enter injection)
+Config: `~/.codex/config.toml`
+</adapter>
+
+<adapter id="copilot">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Discovery: User-driven (`@agent-name` in GitHub Copilot Chat).
+
+## C. Tool Usage
+Use Copilot tools: `runCommands` (shell), `read`/`readfile` (read), `edit`/`editFiles` (write),
+`code_search`, `find_references`
+Interactive: `askQuestions` (main agent only — NOT available in subagents; VS Code issue #293745)
+Skill path: `.github/agents/<name>.agent.md`
+</adapter>
 <scope_policy>
 ## ViePilot Namespace Guard (BUG-004)
 - Default mode: only use and reference `vp-*` skills in ViePilot workflows.

package/skills/vp-brainstorm/SKILL.md

@@ -53,7 +53,7 @@ Silent if command unavailable or errors.
 </persona_context>
 
 
-<cursor_skill_adapter>
+<adapter id="claude-code">
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-brainstorm`, `/vp-brainstorm`, hoặc yêu cầu "brainstorm"
 - Treat all user text after the skill mention as `{{VP_ARGS}}`
@@ -62,7 +62,10 @@ Silent if command unavailable or errors.
 Prompt user conversationally with numbered list options.
 
 ## C. Tool Usage
-Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
+Use Claude Code tools: `Bash` (shell), `Read` (file), `Edit` + `Write` (file write/patch),
+`Grep` (search), `Glob` (file patterns), `LS`, `WebSearch`, `WebFetch`,
+`Agent` (spawn subagent — multi-level nesting supported)
+Interactive: `AskUserQuestion` (deferred — preload via ToolSearch before first call)
 
 ## D. Session Actions — Proactive AUQ Triggers (BUG-026)
 **No slash sub-commands.** All session actions are triggered proactively by the AI via
@@ -76,7 +79,53 @@ Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`,
 | **Sync UI → Arch** | After arch update when UI workspace also active | "Sync architecture changes to UI Direction workspace?" |
 
 **Why:** In Claude Code terminal, any `/command` is intercepted by the shell as a skill invocation. Using proactive AUQ triggers works identically on ALL adapters — no adapter-specific typing rules needed.
-</cursor_skill_adapter>
+</adapter>
+
+<adapter id="cursor-agent">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Cursor tools: `run_terminal_cmd` (shell), `read_file` (read), `edit_file` (write/edit),
+`grep_search` (search), `web_search`, `codebase_search`, `list_dir`, `file_search`
+Interactive: text list fallback (AskQuestion available in Plan Mode only; Agent Mode = text)
+Subagent: `/multitask` (user command, single-level only — not a callable tool)
+MCP limit: 40 tools
+</adapter>
+
+<adapter id="antigravity">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Skill discovery: LLM-driven (automatic, no slash command needed).
+
+## C. Tool Usage
+Use Antigravity tools: `shell` (cmd), `file_read`, `file_write`, MCP plugins
+Interactive: text fallback (TUI-based; no formal AskUserQuestion)
+Skill path: `.agents/skills/<skill>/SKILL.md` (project) or `~/.gemini/antigravity/skills/` (global)
+Note: Gemini CLI deprecated June 18, 2026 — use Antigravity CLI.
+</adapter>
+
+<adapter id="codex">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Codex tools: `container.exec` (sandboxed shell), `apply_patch` (file write), `web_search`
+Interactive: text fallback (TUI Tab/Enter injection)
+Config: `~/.codex/config.toml`
+</adapter>
+
+<adapter id="copilot">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Discovery: User-driven (`@agent-name` in GitHub Copilot Chat).
+
+## C. Tool Usage
+Use Copilot tools: `runCommands` (shell), `read`/`readfile` (read), `edit`/`editFiles` (write),
+`code_search`, `find_references`
+Interactive: `askQuestions` (main agent only — NOT available in subagents; VS Code issue #293745)
+Skill path: `.github/agents/<name>.agent.md`
+</adapter>
 <scope_policy>
 ## ViePilot Namespace Guard (BUG-004)
 - Default mode: only use and reference `vp-*` skills in ViePilot workflows.
@@ -152,6 +201,23 @@ Optional flags:
 - `--research` : Enable proactive research suggestions during the session
 - `--ui` : Enable UI Direction mode (live HTML/CSS direction artifacts + auto-generates `design.md` when design keywords present — ENH-076)
 - `--domain embedded` : Force-activate Embedded Domain Mode (hardware topology, RTOS, pin map, memory layout, protocol matrix, power budget pages + topic probes)
+
+### Reference URL Input (ENH-092)
+
+When user provides a URL during brainstorm (competitor app, documentation, reference product):
+- research-agent is dispatched with `op: browse_url` using `vercel-labs/agent-browser`
+- Extracted insights added as `## Reference Research` section in session output
+- Covers: features, UX patterns, pricing model, tech stack clues
+- Available as context for crystallize step
+- Falls back to WebFetch if agent-browser not installed (static HTML only — warns if page is JS-rendered)
+
+**Examples:**
+```
+/vp-brainstorm I want to build a task manager. Reference: https://linear.app
+/vp-brainstorm --new Compare these two tools: https://notion.so https://coda.io
+```
+
+**Multiple URLs**: dispatches `compare_products` op → side-by-side comparison table.
 </context>
 
 ### Embedded Domain Mode (ENH-071)

package/skills/vp-crystallize/SKILL.md

@@ -53,7 +53,7 @@ Silent if command unavailable or errors.
 </persona_context>
 
 
-<cursor_skill_adapter>
+<adapter id="claude-code">
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-crystallize`, `/vp-crystallize`, hoặc "crystallize", "setup project"
 - Treat all user text after the skill mention as `{{VP_ARGS}}`
@@ -62,8 +62,57 @@ Silent if command unavailable or errors.
 Prompt user conversationally with numbered list options.
 
 ## C. Tool Usage
-Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
-</cursor_skill_adapter>
+Use Claude Code tools: `Bash` (shell), `Read` (file), `Edit` + `Write` (file write/patch),
+`Grep` (search), `Glob` (file patterns), `LS`, `WebSearch`, `WebFetch`,
+`Agent` (spawn subagent — multi-level nesting supported)
+Interactive: `AskUserQuestion` (deferred — preload via ToolSearch before first call)
+</adapter>
+
+<adapter id="cursor-agent">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Cursor tools: `run_terminal_cmd` (shell), `read_file` (read), `edit_file` (write/edit),
+`grep_search` (search), `web_search`, `codebase_search`, `list_dir`, `file_search`
+Interactive: text list fallback (AskQuestion available in Plan Mode only; Agent Mode = text)
+Subagent: `/multitask` (user command, single-level only — not a callable tool)
+MCP limit: 40 tools
+</adapter>
+
+<adapter id="antigravity">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Skill discovery: LLM-driven (automatic, no slash command needed).
+
+## C. Tool Usage
+Use Antigravity tools: `shell` (cmd), `file_read`, `file_write`, MCP plugins
+Interactive: text fallback (TUI-based; no formal AskUserQuestion)
+Skill path: `.agents/skills/<skill>/SKILL.md` (project) or `~/.gemini/antigravity/skills/` (global)
+Note: Gemini CLI deprecated June 18, 2026 — use Antigravity CLI.
+</adapter>
+
+<adapter id="codex">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Codex tools: `container.exec` (sandboxed shell), `apply_patch` (file write), `web_search`
+Interactive: text fallback (TUI Tab/Enter injection)
+Config: `~/.codex/config.toml`
+</adapter>
+
+<adapter id="copilot">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Discovery: User-driven (`@agent-name` in GitHub Copilot Chat).
+
+## C. Tool Usage
+Use Copilot tools: `runCommands` (shell), `read`/`readfile` (read), `edit`/`editFiles` (write),
+`code_search`, `find_references`
+Interactive: `askQuestions` (main agent only — NOT available in subagents; VS Code issue #293745)
+Skill path: `.github/agents/<name>.agent.md`
+</adapter>
 <scope_policy>
 ## ViePilot Namespace Guard (BUG-004)
 - Default mode: only use and reference `vp-*` skills in ViePilot workflows.

package/skills/vp-debug/SKILL.md

@@ -53,7 +53,7 @@ Silent if command unavailable or errors.
 </persona_context>
 
 
-<cursor_skill_adapter>
+<adapter id="claude-code">
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-debug`, `/vp-debug`, "debug", "gỡ lỗi"
 - Treat all user text after the skill mention as `{{VP_ARGS}}`
@@ -62,8 +62,57 @@ Silent if command unavailable or errors.
 Prompt user conversationally. Guide through systematic debugging steps.
 
 ## C. Tool Usage
-Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
-</cursor_skill_adapter>
+Use Claude Code tools: `Bash` (shell), `Read` (file), `Edit` + `Write` (file write/patch),
+`Grep` (search), `Glob` (file patterns), `LS`, `WebSearch`, `WebFetch`,
+`Agent` (spawn subagent — multi-level nesting supported)
+Interactive: `AskUserQuestion` (deferred — preload via ToolSearch before first call)
+</adapter>
+
+<adapter id="cursor-agent">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Cursor tools: `run_terminal_cmd` (shell), `read_file` (read), `edit_file` (write/edit),
+`grep_search` (search), `web_search`, `codebase_search`, `list_dir`, `file_search`
+Interactive: text list fallback (AskQuestion available in Plan Mode only; Agent Mode = text)
+Subagent: `/multitask` (user command, single-level only — not a callable tool)
+MCP limit: 40 tools
+</adapter>
+
+<adapter id="antigravity">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Skill discovery: LLM-driven (automatic, no slash command needed).
+
+## C. Tool Usage
+Use Antigravity tools: `shell` (cmd), `file_read`, `file_write`, MCP plugins
+Interactive: text fallback (TUI-based; no formal AskUserQuestion)
+Skill path: `.agents/skills/<skill>/SKILL.md` (project) or `~/.gemini/antigravity/skills/` (global)
+Note: Gemini CLI deprecated June 18, 2026 — use Antigravity CLI.
+</adapter>
+
+<adapter id="codex">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Codex tools: `container.exec` (sandboxed shell), `apply_patch` (file write), `web_search`
+Interactive: text fallback (TUI Tab/Enter injection)
+Config: `~/.codex/config.toml`
+</adapter>
+
+<adapter id="copilot">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Discovery: User-driven (`@agent-name` in GitHub Copilot Chat).
+
+## C. Tool Usage
+Use Copilot tools: `runCommands` (shell), `read`/`readfile` (read), `edit`/`editFiles` (write),
+`code_search`, `find_references`
+Interactive: `askQuestions` (main agent only — NOT available in subagents; VS Code issue #293745)
+Skill path: `.github/agents/<name>.agent.md`
+</adapter>
 <scope_policy>
 ## ViePilot Namespace Guard (BUG-004)
 - Default mode: only use and reference `vp-*` skills in ViePilot workflows.

package/skills/vp-design/SKILL.md

@@ -46,7 +46,7 @@ Inject the output as `## User Persona` context before any task execution.
 Silent if command unavailable or errors.
 </persona_context>
 
-<cursor_skill_adapter>
+<adapter id="claude-code">
 ## A. Skill Invocation
 - Skill is triggered when user mentions `vp-design`, `/vp-design`, "design system", "design.md", "sync tokens", "audit design"
 - Treat all user text after the skill mention as `{{VP_ARGS}}`
@@ -55,8 +55,57 @@ Silent if command unavailable or errors.
 Prompt user conversationally with numbered list options at control points.
 
 ## C. Tool Usage
-Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
-</cursor_skill_adapter>
+Use Claude Code tools: `Bash` (shell), `Read` (file), `Edit` + `Write` (file write/patch),
+`Grep` (search), `Glob` (file patterns), `LS`, `WebSearch`, `WebFetch`,
+`Agent` (spawn subagent — multi-level nesting supported)
+Interactive: `AskUserQuestion` (deferred — preload via ToolSearch before first call)
+</adapter>
+
+<adapter id="cursor-agent">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Cursor tools: `run_terminal_cmd` (shell), `read_file` (read), `edit_file` (write/edit),
+`grep_search` (search), `web_search`, `codebase_search`, `list_dir`, `file_search`
+Interactive: text list fallback (AskQuestion available in Plan Mode only; Agent Mode = text)
+Subagent: `/multitask` (user command, single-level only — not a callable tool)
+MCP limit: 40 tools
+</adapter>
+
+<adapter id="antigravity">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Skill discovery: LLM-driven (automatic, no slash command needed).
+
+## C. Tool Usage
+Use Antigravity tools: `shell` (cmd), `file_read`, `file_write`, MCP plugins
+Interactive: text fallback (TUI-based; no formal AskUserQuestion)
+Skill path: `.agents/skills/<skill>/SKILL.md` (project) or `~/.gemini/antigravity/skills/` (global)
+Note: Gemini CLI deprecated June 18, 2026 — use Antigravity CLI.
+</adapter>
+
+<adapter id="codex">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+
+## C. Tool Usage
+Use Codex tools: `container.exec` (sandboxed shell), `apply_patch` (file write), `web_search`
+Interactive: text fallback (TUI Tab/Enter injection)
+Config: `~/.codex/config.toml`
+</adapter>
+
+<adapter id="copilot">
+## A. Skill Invocation
+Same trigger keywords as claude-code adapter.
+Discovery: User-driven (`@agent-name` in GitHub Copilot Chat).
+
+## C. Tool Usage
+Use Copilot tools: `runCommands` (shell), `read`/`readfile` (read), `edit`/`editFiles` (write),
+`code_search`, `find_references`
+Interactive: `askQuestions` (main agent only — NOT available in subagents; VS Code issue #293745)
+Skill path: `.github/agents/<name>.agent.md`
+</adapter>
 
 <scope_policy>
 ## ViePilot Namespace Guard (BUG-004)