viepilot 2.12.0 → 2.22.0

package/lib/adapters/copilot.cjs

@@ -0,0 +1,44 @@
+'use strict';
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  id: 'copilot',
+  name: 'GitHub Copilot',
+  // Paths (home-relative; resolved at install time)
+  skillsDir:   (home) => path.join(home, '.config', 'gh-copilot', 'skills'),
+  viepilotDir: (home) => path.join(home, '.config', 'gh-copilot', 'viepilot'),
+  // {envToolDir} in SKILL.md files resolves to this value at install time (ENH-035)
+  executionContextBase: '.config/gh-copilot/viepilot',
+  // Copilot Chat uses /skill-name (same as Claude Code / Cursor)
+  postInstallHint: 'Open Copilot Chat in VS Code and type /vp-status to get started',
+  hooks: {
+    configFile: null,  // Copilot uses .agent.md convention, not programmatic hooks
+    schema: 'copilot',
+    supportedEvents: []
+  },
+  installSubdirs: [
+    'workflows',
+    path.join('templates', 'project'),
+    path.join('templates', 'phase'),
+    path.join('templates', 'architect'),
+    'bin',
+    'lib',
+    'ui-components',
+    'agents'
+  ],
+  isAvailable: (home) => {
+    const h = home || os.homedir();
+    // Primary: gh-copilot config dir exists
+    if (fs.existsSync(path.join(h, '.config', 'gh-copilot'))) return true;
+    // Secondary: gh CLI installed at common paths (user likely has Copilot access)
+    const ghPaths = [
+      '/usr/local/bin/gh',
+      '/opt/homebrew/bin/gh',
+      '/usr/bin/gh',
+      path.join(h, '.local', 'bin', 'gh'),
+    ];
+    return ghPaths.some((p) => fs.existsSync(p));
+  },
+};

package/lib/adapters/cursor.cjs

@@ -23,7 +23,8 @@ module.exports = {
     path.join('templates', 'architect'),
     'bin',
     'lib',
-    'ui-components'
+    'ui-components',
+    'agents'
   ],
   isAvailable: (home) => {
     const h = home || os.homedir();

package/lib/adapters/index.cjs

@@ -6,6 +6,7 @@ const adapters = {
   'cursor-ide':   require('./cursor.cjs'),      // alias
   'antigravity':  require('./antigravity.cjs'),
   'codex':        require('./codex.cjs'),
+  'copilot':      require('./copilot.cjs'),
 };
 
 /**

package/lib/viepilot-install.cjs

@@ -191,6 +191,15 @@ 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 });
       }
     }
+    // ENH-057: copy agents/ directory (agents layer added in v2.20.0)
+    const agentsRoot = path.join(root, 'agents');
+    if (fs.existsSync(agentsRoot)) {
+      for (const ent of listDirEntries(root, 'agents')) {
+        const src = path.join(root, 'agents', ent.name);
+        const dest = path.join(vpDir, 'agents', 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.12.0",
+  "version": "2.22.0",
   "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

@@ -4,6 +4,18 @@ description: "Audit state, docs drift, and stack best-practice compliance — wo
 version: 0.3.2
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-AUDIT  v0.3.2 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-audit`, `/vp-audit`, "audit", "kiểm tra", "check docs"
@@ -74,6 +86,9 @@ When auditing a project bootstrapped via `vp-crystallize --brownfield`:
 - `ARCHITECTURE.md` counts vs actual `skills/`, `workflows/`, CLI
 - `README.md` viepilot-specific badges (version, skills-N, workflows-N)
 - `docs/skills-reference.md` sections vs `skills/` directory
+- **Silent by default (ENH-049):** Tier 4 output is suppressed when all checks pass (✅)
+  or when the check is skipped (non-framework repo). Output only appears when issues (⚠️)
+  are found. Non-framework repos: Tier 4 skipped silently with no message.
 
 **Output:**
 - Report by 4 tiers, each tier with its own status

package/skills/vp-auto/SKILL.md

@@ -4,6 +4,18 @@ description: "Autonomous execution loop with control points and recovery"
 version: 0.2.2
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-AUTO  v0.2.2 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-auto`, `/vp-auto`, "auto", "vibe", "chạy tự động"

package/skills/vp-brainstorm/SKILL.md

@@ -4,6 +4,18 @@ description: "Brainstorm session to collect ideas and decisions for the project"
 version: 1.1.0
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-BRAINSTORM  v1.1.0 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-brainstorm`, `/vp-brainstorm`, hoặc yêu cầu "brainstorm"
@@ -107,3 +119,25 @@ Key steps:
 - [ ] **FEAT-009**: intake completed, binding already present, **or** waiver with reason before Completed; session records **`## Project meta intake (FEAT-009)`**
 - [ ] Next steps suggested
 </success_criteria>
+
+## Adapter Compatibility
+
+### AskUserQuestion Tool (ENH-048)
+This skill uses adapter-aware interactive prompts. Behavior depends on your adapter:
+
+| Adapter | Interactive Prompts | Notes |
+|---------|---------------------|-------|
+| Claude Code (terminal) | ✅ `AskUserQuestion` tool — **REQUIRED** | Must call AUQ; plain-text only if tool errors or is unavailable |
+| Claude Code (VS Code ext) | ⚠️ Partial | Terminal yes; VS Code UI pending [anthropics/claude-code#12609](https://github.com/anthropics/claude-code/issues/12609) |
+| Cursor (Plan Mode) | ⚠️ Partial | `AskQuestion` in Plan Mode only — not in Agent/Skills Mode |
+| Cursor (Agent/Skills) | ❌ Text fallback | AskQuestion not available in Agent Mode |
+| Codex CLI | ❌ Text fallback | Native tool N/A; community MCP available |
+| Antigravity (native agent) | ❌ Text fallback | Artifact model, no raw tool calls |
+| GitHub Copilot | ✅ `/skill-name` in Chat | Via `.agent.md` custom agent; AUQ not available — text fallback |
+
+When `AskUserQuestion` is not available, the skill automatically falls back to
+plain-text numbered list prompts — no configuration required.
+
+**Prompts using AskUserQuestion in this skill:**
+- Session intent (continue / review / new — Step 2)
+- Landing page layout selection (Step 4 — Layout A/B/C/D)

package/skills/vp-crystallize/SKILL.md

@@ -4,6 +4,18 @@ description: "Convert brainstorm sessions into executable artifacts"
 version: 0.8.0
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-CRYSTALLIZE  v0.8.0 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-crystallize`, `/vp-crystallize`, hoặc "crystallize", "setup project"
@@ -100,8 +112,21 @@ Scanner runs 12 signal categories across the existing codebase:
 11. **Git history** — commit convention, version pattern, contributors, repo URL
 12. **Language survey** — file extension glob → language distribution
 
+**Multi-repo / monorepo support (ENH-047):**
+
+- **Git submodule detection** — reads `.gitmodules`; scans each initialized submodule path (Signal Cat 1+2+4); records uninitialized paths as `primary_language: MISSING`. Never runs `git submodule update` — read-only.
+- **Polyrepo hints** — detects docker-compose `../` build contexts, `file:../` deps, CI cross-repo clones, README external links, Makefile `cd ../` targets; outputs `polyrepo_hints[]`; prompts user to supply `related_repos[]` (optional).
+- **Per-module gap detection** — every `modules[]` entry carries `gap_tier` (DETECTED/ASSUMED/MISSING), `must_detect_status{}` (evidence per field: value + source + tier), and `open_questions[]`. A module with `gap_tier: MISSING` blocks artifact generation with a targeted per-field prompt.
+
+**Scan Report contains:**
+- Root `gap_tier` (= worst tier across all modules: MISSING > ASSUMED > DETECTED)
+- `modules[]` — one entry per workspace/submodule/root with `gap_tier`, `must_detect_status{}`, `open_questions[]`
+- `polyrepo_hints[]` — polyrepo signals (omitted when empty, no empty arrays)
+- `related_repos[]` — user-supplied sibling repos (omitted when empty)
+- Root `open_questions[]` — includes rollup from all modules
+
 Produces **Scan Report** (YAML) with DETECTED / ASSUMED / MISSING classification.
-MUST-DETECT gaps (project_name, primary_language, ≥1 framework, current_version) block artifact generation until user fills interactively.
+MUST-DETECT gaps (root: project_name, primary_language, ≥1 framework, current_version; per-module: primary_language, framework, module_purpose, entry_point) block artifact generation until user fills interactively.
 Generates `docs/brainstorm/session-brownfield-import.md` stub for `vp-audit` compatibility.
 Safety: never reads `.env`; skips `node_modules/`, `.git/`, `target/`, `build/`, `dist/`.
 </objective>
@@ -250,3 +275,28 @@ Ask user for (confirm proposals from profile if present):
 - [ ] **ENH-022:** Every generated Mermaid diagram has a `.viepilot/architecture/<canonical-name>.mermaid` file in sync with `ARCHITECTURE.md` (no extra files created for N/A)
 - [ ] **FEAT-009:** When profile is bound — ARCHITECTURE + PROJECT-CONTEXT record the profile source; if not — state none / not configured explicitly
 </success_criteria>
+
+## Adapter Compatibility
+
+### AskUserQuestion Tool (ENH-048)
+This skill uses adapter-aware interactive prompts. Behavior depends on your adapter:
+
+| Adapter | Interactive Prompts | Notes |
+|---------|---------------------|-------|
+| Claude Code (terminal) | ✅ `AskUserQuestion` tool — **REQUIRED** | Must call AUQ; plain-text only if tool errors or is unavailable |
+| Claude Code (VS Code ext) | ⚠️ Partial | Terminal yes; VS Code UI pending [anthropics/claude-code#12609](https://github.com/anthropics/claude-code/issues/12609) |
+| Cursor (Plan Mode) | ⚠️ Partial | `AskQuestion` in Plan Mode only — not in Agent/Skills Mode |
+| Cursor (Agent/Skills) | ❌ Text fallback | AskQuestion not available in Agent Mode |
+| Codex CLI | ❌ Text fallback | Native tool N/A; community MCP available |
+| Antigravity (native agent) | ❌ Text fallback | Artifact model, no raw tool calls |
+| GitHub Copilot | ✅ `/skill-name` in Chat | Via `.agent.md` custom agent; AUQ not available — text fallback |
+
+When `AskUserQuestion` is not available, the skill automatically falls back to
+plain-text numbered list prompts — no configuration required.
+
+**Prompts using AskUserQuestion in this skill:**
+- License selection (Step 0 metadata)
+- Brownfield overwrite confirmation (Step 0-B)
+- Polyrepo related-repos prompt (Step 0-B)
+- UI direction gate choice (Step 1A)
+- Architect mode suggestion (Step 1D)

package/skills/vp-debug/SKILL.md

@@ -4,6 +4,18 @@ description: "Systematic debugging with persistent state tracking across session
 version: 0.2.0
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-DEBUG  v0.2.0 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-debug`, `/vp-debug`, "debug", "gỡ lỗi"

package/skills/vp-docs/SKILL.md

@@ -4,6 +4,18 @@ description: "Generate comprehensive documentation for the project"
 version: 0.2.1
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-DOCS  v0.2.1 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-docs`, `/vp-docs`, "docs", "documentation", "tài liệu"
@@ -80,19 +92,29 @@ Optional flags:
 
 ### Step 0: Resolve Project Context (ALWAYS first)
 ```bash
-# Read actual GitHub URL — never use hardcoded placeholder
+# Forge-agnostic remote URL parser — supports GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, self-hosted
 REMOTE_URL=$(git remote get-url origin 2>/dev/null || echo "")
-GITHUB_SLUG=$(echo "$REMOTE_URL" | sed 's|.*github\.com[:/]||; s|\.git$||')
-GITHUB_OWNER=$(echo "$GITHUB_SLUG" | cut -d'/' -f1)
-GITHUB_REPO=$(echo "$GITHUB_SLUG" | cut -d'/' -f2)
+if echo "$REMOTE_URL" | grep -q 'dev\.azure\.com'; then
+  GIT_HOST="dev.azure.com"
+  GIT_OWNER=$(echo "$REMOTE_URL" | sed 's|.*dev\.azure\.com/||; s|/.*||')
+  GIT_REPO=$(echo "$REMOTE_URL" | sed 's|.*/_git/||; s|\.git$||; s|/$||')
+elif echo "$REMOTE_URL" | grep -q '^git@'; then
+  GIT_HOST=$(echo "$REMOTE_URL" | sed 's|^git@||; s|:.*||')
+  GIT_OWNER=$(echo "$REMOTE_URL" | sed 's|^git@[^:]*:||; s|/.*||')
+  GIT_REPO=$(echo "$REMOTE_URL" | sed 's|^git@[^:]*:[^/]*/||; s|\.git$||')
+else
+  GIT_HOST=$(echo "$REMOTE_URL" | sed 's|^https\?://||; s|/.*||')
+  GIT_OWNER=$(echo "$REMOTE_URL" | sed 's|^https\?://[^/]*/||; s|/.*||')
+  GIT_REPO=$(echo "$REMOTE_URL" | sed 's|^https\?://[^/]*/[^/]*/||; s|\.git$||; s|/$||')
+fi
 # Fallback: use searchable placeholder, not 'your-org'
-[ -z "$GITHUB_OWNER" ] && GITHUB_OWNER="{GITHUB_OWNER}" && GITHUB_REPO="{GITHUB_REPO}"
+[ -z "$GIT_OWNER" ] && GIT_HOST="{GIT_HOST}" && GIT_OWNER="{GIT_OWNER}" && GIT_REPO="{GIT_REPO}"
 
 ACTUAL_SKILLS=$(ls skills/*/SKILL.md 2>/dev/null | wc -l | tr -d ' ')
 ACTUAL_WORKFLOWS=$(ls workflows/*.md 2>/dev/null | wc -l | tr -d ' ')
 ```
 
-> Use `$GITHUB_OWNER/$GITHUB_REPO` in all generated files.
+> Use `$GIT_HOST`, `$GIT_OWNER`, `$GIT_REPO` in all generated files.
 > Use `$ACTUAL_SKILLS` and `$ACTUAL_WORKFLOWS` for counts.
 > **Never write** `your-org`, `YOUR_USERNAME`, `YOUR_ORG` into generated files.
 

package/skills/vp-evolve/SKILL.md

@@ -4,6 +4,18 @@ description: "Upgrade, add features, or start a new milestone"
 version: 0.3.0
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-EVOLVE  v0.3.0 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-evolve`, `/vp-evolve`, "evolve", "thêm feature", "milestone mới", "upgrade"
@@ -180,6 +192,26 @@ Next action: /vp-auto --from {new_phase}
 ```
 </process>
 
+## Adapter Compatibility
+
+### AskUserQuestion Tool (ENH-048 + ENH-055)
+
+| Adapter | Interactive Prompts | Notes |
+|---------|---------------------|-------|
+| Claude Code (terminal) | ✅ `AskUserQuestion` tool — **REQUIRED** | Must call AUQ; plain-text only if tool errors or is unavailable |
+| Cursor (Agent/Skills) | ❌ Text fallback | AskQuestion not available in Agent Mode |
+| Codex CLI | ❌ Text fallback | Native tool N/A |
+| Antigravity (native agent) | ❌ Text fallback | Artifact model, no raw tool calls |
+| GitHub Copilot | ✅ `/skill-name` in Chat | Via `.agent.md` custom agent; AUQ not available — text fallback |
+
+**Claude Code (terminal):** Always call `AskUserQuestion` first. Only fall back to the plain-text menu if the tool returns an error or is unavailable.
+
+**Prompts using AskUserQuestion in this skill:**
+- Evolve mode selection (Step 2 — Add Feature / New Milestone / Refactor)
+- Complexity selection (Step 3A — S/M/L/XL)
+- Brainstorm routing decision (Step 3A — Yes / No)
+- Workflow continuation (Step 5 — Execute /vp-auto / Create request / Done)
+
 <success_criteria>
 - [ ] User intent correctly identified
 - [ ] Architecture compatibility checked

package/skills/vp-info/SKILL.md

@@ -4,6 +4,18 @@ description: "Display ViePilot version, npm latest, skills/workflows list via vp
 version: 0.1.1
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-INFO  v0.1.1 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-info`, `/vp-info`, "viepilot version", "phiên bản viepilot", "skills list bundle"

package/skills/vp-pause/SKILL.md

@@ -4,6 +4,18 @@ description: "Pause work with context preservation to resume later"
 version: 0.1.1
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-PAUSE  v0.1.1 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-pause`, `/vp-pause`, "pause", "dừng", "tạm nghỉ"

package/skills/vp-proposal/SKILL.md

@@ -4,6 +4,18 @@ description: "Generate professional proposal packages (.pptx + .docx + .md) from
 version: 0.1.0
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-PROPOSAL  v0.1.0 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-proposal`, `/vp-proposal`, "proposal", "pitch deck", "presentation", "tài liệu đề xuất"

package/skills/vp-request/SKILL.md

@@ -4,6 +4,18 @@ description: "Create new request: feature, bug fix, enhancement, or brainstorm c
 version: 0.2.0
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-REQUEST  v0.2.0 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-request`, `/vp-request`, "request", "yêu cầu", "bug", "lỗi", "feature mới", "nâng cấp"
@@ -265,3 +277,27 @@ Update `.viepilot/TRACKER.md`:
 - [ ] TRACKER.md updated
 - [ ] Appropriate routing suggested
 </success_criteria>
+
+## Adapter Compatibility
+
+### AskUserQuestion Tool (ENH-048)
+This skill uses adapter-aware interactive prompts. Behavior depends on your adapter:
+
+| Adapter | Interactive Prompts | Notes |
+|---------|---------------------|-------|
+| Claude Code (terminal) | ✅ `AskUserQuestion` tool — **REQUIRED** | Must call AUQ; plain-text only if tool errors or is unavailable |
+| Claude Code (VS Code ext) | ⚠️ Partial | Terminal yes; VS Code UI pending [anthropics/claude-code#12609](https://github.com/anthropics/claude-code/issues/12609) |
+| Cursor (Plan Mode) | ⚠️ Partial | `AskQuestion` in Plan Mode only — not in Agent/Skills Mode |
+| Cursor (Agent/Skills) | ❌ Text fallback | AskQuestion not available in Agent Mode |
+| Codex CLI | ❌ Text fallback | Native tool N/A; community MCP available |
+| Antigravity (native agent) | ❌ Text fallback | Artifact model, no raw tool calls |
+| GitHub Copilot | ✅ `/skill-name` in Chat | Via `.agent.md` custom agent; AUQ not available — text fallback |
+
+When `AskUserQuestion` is not available, the skill automatically falls back to
+plain-text numbered list prompts — no configuration required.
+
+**Prompts using AskUserQuestion in this skill:**
+- Request type detection (Bug / Feature / Enhancement / Tech Debt — Step 2)
+- Bug severity selection (Critical / High / Medium / Low — Step 4A)
+- Feature priority selection (Must-have / Should-have / Nice-to-have — Step 4B)
+- Workflow continuation (Step 6 — Plan /vp-evolve / Create another / Done)

package/skills/vp-resume/SKILL.md

@@ -4,6 +4,18 @@ description: "Resume work from previous session with full context restoration"
 version: 0.1.1
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-RESUME  v0.1.1 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-resume`, `/vp-resume`, "resume", "tiếp tục", "where was i"

package/skills/vp-rollback/SKILL.md

@@ -4,6 +4,18 @@ description: "Rollback to any checkpoint safely with state preservation"
 version: 0.1.1
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-ROLLBACK  v0.1.1 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-rollback`, `/vp-rollback`, "rollback", "quay lại"

package/skills/vp-status/SKILL.md

@@ -4,6 +4,18 @@ description: "Display progress dashboard and actionable insights"
 version: 0.1.1
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-STATUS  v0.1.1 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-status`, `/vp-status`, "status", "tiến độ", "đang ở đâu"

package/skills/vp-task/SKILL.md

@@ -4,6 +4,18 @@ description: "Manual control over individual tasks"
 version: 0.2.0
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-TASK  v0.2.0 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-task`, `/vp-task`

package/skills/vp-ui-components/SKILL.md

@@ -4,6 +4,18 @@ description: "Manage workflow for collecting and reusing UI components"
 version: 0.1.1
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-UI-COMPONENTS  v0.1.1 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-ui-components`, `/vp-ui-components`, "ui components", "component library", "21st.dev component"

package/skills/vp-update/SKILL.md

@@ -4,6 +4,18 @@ description: "Upgrade viepilot package via npm (dry-run, --yes, --global) via vp
 version: 0.1.1
 ---
 
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-UPDATE  v0.1.1 (fw 2.19.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+
 <cursor_skill_adapter>
 ## A. Skill Invocation
 - Skill được gọi khi user mention `vp-update`, `/vp-update`, "upgrade viepilot", "cập nhật viepilot npm"