viepilot 2.41.0 → 2.45.3

package/skills/vp-design/SKILL.md

@@ -0,0 +1,219 @@
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-DESIGN  v1.0.0 (fw 2.45.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+<version_check>
+## Version Update Check (ENH-072)
+
+After displaying the greeting banner, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" check-update --silent
+```
+
+**If exit code = 1** (update available — new version printed to stdout):
+Display notice banner before any other output:
+```
+┌──────────────────────────────────────────────────────────────────┐
+│ ✨ ViePilot {latest_version} available  (installed: {current})   │
+│    npm i -g viepilot && vp-tools install --target {adapter_id}   │
+└──────────────────────────────────────────────────────────────────┘
+```
+Replace `{latest_version}` with stdout from the command, `{current}` with the installed
+version, `{adapter_id}` with the active adapter (claude-code / cursor / antigravity / codex / copilot).
+
+**If exit code = 0 or command unavailable**: silent, continue.
+
+**Suppression rules:**
+- `--no-update-check` flag on skill invocation → skip this step entirely
+- `config.json` → `update.check: false` → skip this step entirely
+- Show at most once per session (`update_check_done` session guard)
+</version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
+
+<cursor_skill_adapter>
+## 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}}`
+
+## B. User Prompting
+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>
+
+<scope_policy>
+## ViePilot Namespace Guard (BUG-004)
+- Default mode: only use and reference `vp-*` skills in ViePilot workflows.
+- External skills (`non vp-*`) are out of framework scope unless user explicitly opts in.
+- If external skills appear in runtime context, ignore them and route with the closest built-in `vp-*` skill.
+</scope_policy>
+
+<implementation_routing_guard>
+## Implementation routing guard (ENH-021)
+
+- This skill manages **design system files** (`design.md`, stylesheet token sync, compliance audit).
+- Does **not** implement application features or replace **`/vp-auto`** for shipping code.
+- After creating/updating `design.md`, run **`/vp-design --sync`** to apply tokens, then continue with **`/vp-auto`** for feature work.
+</implementation_routing_guard>
+
+<objective>
+Manage Design.MD design system files for the project (ENH-076).
+
+Implements the [Design.MD v1 spec](https://github.com/google-labs-code/design.md) —
+a Google Labs open standard (Apache 2.0) for describing visual design systems to AI coding agents.
+
+**Commands:**
+- `--init` : Create `design.md` from scratch via Q&A, or import from awesome-design-md community library (55+ brand examples)
+- `--sync` : Sync design.md tokens → Tailwind config / CSS custom properties / SCSS variables
+- `--audit` : Scan project HTML/CSS files for compliance; report deviations (❌ / ⚠️ / ✅)
+- `--import [brand]` : Fetch community template from awesome-design-md (Linear, Notion, Stripe, Vercel, Figma...)
+
+**Creates/Updates:**
+- `design.md` (project root)
+- `tailwind.config.js` / `style.css` / `_variables.scss` (via `--sync`)
+
+**Reads:**
+- `design.md` (project root or session directory)
+- HTML/CSS/SCSS files (via `--audit`)
+
+**After:** `design.md` is ready for `/vp-crystallize` (Step 1D.14 export) and
+`/vp-auto` (Preflight 5.5 token injection into UI tasks)
+</objective>
+
+<execution_context>
+@$HOME/.claude/viepilot/workflows/design.md
+</execution_context>
+
+<context>
+**Commands:**
+- `--init` : Create new design.md (Q&A or awesome-design-md import)
+- `--sync` : Sync tokens to project stylesheets (auto-detects Tailwind / CSS vars / SCSS)
+- `--audit` : Compliance report — scan all HTML/CSS vs design.md spec
+- `--import [brand]` : Import community template (omit brand for interactive catalog picker)
+
+**Examples:**
+```bash
+/vp-design --init                    # Q&A flow to create design.md
+/vp-design --init --import           # Import from awesome-design-md catalog
+/vp-design --sync                    # Sync tokens → detected stylesheet target
+/vp-design --audit                   # Full compliance report
+/vp-design --import linear           # Import Linear design system directly
+/vp-design --import notion           # Import Notion design system
+```
+</context>
+
+<process>
+Execute workflow from `@$HOME/.claude/viepilot/workflows/design.md`
+
+### --init flow (Q&A from scratch)
+
+1. **Brand identity:**
+   - Brand name?
+   - Core personality (3 words — AI suggests: minimal/bold/playful/enterprise/warm/technical)
+   - Primary color (hex or describe, AI suggests 4 palette options)
+
+2. **Typography:**
+   - Font family (AI suggests: Inter / Geist / Plus Jakarta Sans / Custom)
+   - Heading scale (tight compact / balanced standard / spacious editorial)
+
+3. **Spacing & Shape:**
+   - Spacing base (4px atomic / 8px standard — Recommended / custom)
+   - Corner radius (sharp 0px / subtle 4px / rounded 8px / pill 16px+)
+
+4. **Auto-generate semantic colors** from primary (surface, error, success, warning)
+5. **Write** `design.md` at project root
+
+### --init flow (awesome-design-md import mode)
+
+When user says "import" or triggers `--import`:
+1. AUQ catalog picker by category (Productivity / Developer / Commerce / Enterprise / Creative)
+2. Preview selected brand tokens (text table)
+3. AUQ: Apply as-is / Customize tokens / Use as reference only
+
+### --sync flow
+
+1. Parse `design.md` YAML front matter → TOKEN_MAP
+2. Detect stack:
+   - `tailwind.config.js` exists → Tailwind mode
+   - `style.css` only → CSS custom properties mode
+   - `*.scss` files → SCSS mode
+   - Multiple targets found → AUQ: which target?
+3. Generate/update target with tokens:
+   - **Tailwind:** `theme.extend.colors`, `theme.fontFamily`, `theme.spacing`, `theme.borderRadius`
+   - **CSS vars:** `:root { --color-primary: {hex}; --font-sans: {font}; --spacing-base: {n}px; }`
+   - **SCSS:** `$color-primary: {hex}; $font-sans: '{font}'; $spacing-base: {n}px;`
+4. Conflict resolution: AUQ per conflicting token (Override / Merge / Skip)
+5. Report: "Synced N tokens to {target file}"
+
+### --audit flow
+
+1. Discover all `.html` + `.css` + `.scss` files (exclude `node_modules`, `.git`)
+2. For each file: extract color/font references → compare vs TOKEN_MAP
+3. Categorize deviations:
+   - **❌ Critical:** wrong font-family, wrong primary/surface color hex
+   - **⚠️ Minor:** hardcoded value instead of CSS var (e.g. `#6366f1` instead of `var(--color-primary)`)
+   - **✅ Compliant:** uses correct var or correct hex
+4. Generate report table:
+   ```
+   | File | Colors | Typography | Spacing | Status |
+   | index.html | ✅ | ⚠️ 1 | ✅ | Partial |
+   ```
+5. Summary + suggestion: "Run /vp-design --sync to auto-fix"
+
+### --import [brand] flow
+
+1. Resolve brand:
+   - If arg provided → search awesome-design-md catalog for match
+   - If no arg → AUQ catalog picker
+2. Fetch template (runtime from awesome-design-md GitHub raw content)
+3. Preview: show token table (colors/typography/spacing)
+4. AUQ: Apply as-is / Customize before applying / Use as reference only
+</process>
+
+<success_criteria>
+- [ ] `design.md` created/updated at project root
+- [ ] `--init` produces valid Design.MD v1 spec YAML front matter
+- [ ] `--sync` updates correct target file based on stack detection
+- [ ] `--audit` produces severity-categorized compliance report
+- [ ] `--import` fetches community template and applies per user choice
+- [ ] AUQ used for catalog picker, conflict resolution, apply mode
+</success_criteria>
+
+## Adapter Compatibility
+
+### AskUserQuestion Tool (ENH-059)
+
+| Adapter | Interactive Prompts | Notes |
+|---------|---------------------|-------|
+| Claude Code (terminal) | ✅ `AskUserQuestion` — **REQUIRED** | Preload via ToolSearch before first prompt |
+| Cursor / Codex / Antigravity / Copilot | ❌ Text fallback | Plain numbered list |
+
+**Claude Code (terminal) — AUQ preload required (ENH-059):**
+Call `ToolSearch` with `query: "select:AskUserQuestion"` before first interactive prompt.
+
+**Prompts using AskUserQuestion in this skill:**
+- `--init`: primary color palette selection, font family selection
+- `--init --import`: awesome-design-md catalog picker, apply mode (as-is/customize/reference)
+- `--sync`: conflict resolution per token (Override/Merge/Skip), multi-target selection
+- `--audit`: (report only — no AUQ)
+- `--import`: catalog picker, apply mode
+- Workflow continuation after command completes
+</content>
+</invoke>

package/skills/vp-docs/SKILL.md

@@ -41,6 +41,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>

package/skills/vp-evolve/SKILL.md

@@ -41,6 +41,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>

package/skills/vp-info/SKILL.md

@@ -41,6 +41,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>

package/skills/vp-pause/SKILL.md

@@ -41,6 +41,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>

package/skills/vp-persona/SKILL.md

@@ -0,0 +1,207 @@
+<greeting>
+## Invocation Banner
+
+Output this banner as the **first** thing on every invocation — before questions, work, or any other output:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► VP-PERSONA  v1.0.0 (fw 2.42.0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</greeting>
+<cursor_skill_adapter>
+## A. Skill Invocation
+- Skill được gọi khi user mention `vp-persona`, `/vp-persona`, "persona", "profile", "customize workflow"
+- Treat all user text after the skill mention as `{{VP_ARGS}}`
+
+## B. User Prompting
+Prompt user conversationally with numbered list options.
+
+## C. Tool Usage
+Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
+</cursor_skill_adapter>
+<scope_policy>
+## ViePilot Namespace Guard (BUG-004)
+- Default mode: only use and reference `vp-*` skills in ViePilot workflows.
+- External skills (`non vp-*`) are out of framework scope unless user explicitly opts in.
+- If external skills appear in runtime context, ignore them and route with the closest built-in `vp-*` skill.
+</scope_policy>
+
+<implementation_routing_guard>
+## Implementation routing guard (ENH-021)
+
+- This skill is **persona management only**: read/write `~/.viepilot/persona.json`, `personas/`, `context-map.json` — does **not** implement shipping code (`lib/`, `tests/`, `bin/`, `workflows/`, `skills/`).
+- For implementing features: use **`/vp-auto`**. For planning: use **`/vp-evolve`**.
+- **Exception:** User **explicit** bypass — state clearly in chat.
+</implementation_routing_guard>
+
+<version_check>
+## Version Update Check (ENH-072)
+
+After displaying the greeting banner, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" check-update --silent
+```
+
+**If exit code = 1** (update available — new version printed to stdout):
+Display notice banner before any other output:
+```
+┌──────────────────────────────────────────────────────────────────┐
+│ ✨ ViePilot {latest_version} available  (installed: {current})   │
+│    npm i -g viepilot && vp-tools install --target {adapter_id}   │
+└──────────────────────────────────────────────────────────────────┘
+```
+Replace `{latest_version}` with stdout from the command, `{current}` with the installed version,
+`{adapter_id}` with the active adapter (claude-code / cursor / antigravity / codex / copilot).
+
+**If exit code = 0 or command unavailable**: silent, continue.
+
+**Suppression rules:**
+- `--no-update-check` flag on skill invocation → skip this step entirely
+- `config.json` → `update.check: false` → skip this step entirely
+- Show at most once per session (`update_check_done` session guard)
+</version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
+
+<pending_review_check>
+## Pending Review Notice (ENH-073)
+
+At skill start, check if `~/.viepilot/pending-review.md` is non-empty:
+```bash
+test -s "$HOME/.viepilot/pending-review.md" && cat "$HOME/.viepilot/pending-review.md" | wc -l
+```
+If the file has entries, show a **one-line notice** (not a blocking prompt):
+```
+ℹ  {N} persona updates auto-applied — review ~/.viepilot/pending-review.md to revert any
+```
+Show this notice **only on /vp-persona invocation**, not on other skills.
+</pending_review_check>
+
+<objective>
+Manage cross-project user personas for ViePilot.
+
+Persona is **inferred automatically** from project files + git history — no setup wizard required.
+This skill is for **inspection and optional correction** of the auto-detected persona.
+
+**Commands:**
+- `/vp-persona` — Show active persona (inferred fields, confidence, domain, stacks)
+- `/vp-persona --refine` — Field-by-field correction via AUQ (opt-in, not onboarding)
+- `/vp-persona --list` — List all saved personas
+- `/vp-persona --bind . <name>` — Override auto-detection for current dir (correction)
+- `/vp-persona --merge <a> <b>` — Manually create hybrid persona from two named personas
+- `/vp-persona --export` — Print active persona JSON for backup/sharing
+- `/vp-persona --import <file>` — Import persona from JSON file
+- `/vp-persona --reset` — Clear all personas and context-map
+
+**Auto-detection (no command needed):**
+On any `vp-*` skill invocation, persona is auto-detected from:
+- Project file signals (package.json, CMakeLists.txt, requirements.txt, etc.)
+- Git history (team size from shortlog, role from file extensions)
+- Context map (previously detected bindings)
+</objective>
+
+<process>
+
+### Step 1: Check for pending-review entries
+Run the pending-review check per `<pending_review_check>` above.
+
+### Step 2: Load and display active persona
+
+Run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona get
+```
+
+Display active persona in a clean format:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ Active Persona: {name}  [{source}]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Domain:        {domain}
+ Role:          {role}
+ Stacks:        {stacks}
+ Team size:     {team_size}
+ Output style:  {output_style}
+ Phase template:{phase_template}
+ Confidence:    {confidence} {confidence_note}
+ Inferred at:   {inferred_at}
+
+ Topic priority: {topic_priority}
+ Topic skip:     {topic_skip || "(none)"}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+Where `{confidence_note}` = "(low — run --refine to correct)" if confidence < 0.6, else "".
+
+### Step 3: Handle --refine
+
+Use AUQ for field-by-field correction (only fields the user wants to change):
+
+**AUQ sequence (each question is optional — user can skip):**
+1. Domain: current value shown, ask if correct
+2. Stacks: current value shown, ask to add/remove
+3. Output style: lean / balanced / enterprise
+4. Phase template: from domain pack list or custom
+
+After correction: write updated persona to `~/.viepilot/personas/{name}.json`, update active.
+
+### Step 4: Handle --list
+
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona list
+```
+Display as table.
+
+### Step 5: Handle --bind . <name>
+
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona set <name>
+```
+Update context-map for current directory.
+
+### Step 6: Handle --merge <a> <b>
+
+Load both named personas, call `mergePersonas()`, save as `merge-{a}-{b}`, set active.
+
+### Step 7: Handle --export / --import / --reset
+
+- `--export`: print `~/.viepilot/personas/{active}.json` content
+- `--import <file>`: read JSON file, write to personas dir, set active
+- `--reset`: delete `~/.viepilot/personas/`, `context-map.json`, `persona.json`
+
+</process>
+
+<success_criteria>
+- [ ] Active persona shown with all inferred fields
+- [ ] Confidence < 0.6 flagged with note
+- [ ] --refine corrects fields without full re-setup
+- [ ] --list shows all personas with active marker
+- [ ] --bind overrides auto-detection for current dir
+- [ ] --merge creates hybrid persona
+- [ ] pending-review notice shown when entries exist
+</success_criteria>
+
+## Adapter Compatibility
+
+### AskUserQuestion Tool (ENH-073)
+
+| Adapter | Interactive Prompts | Notes |
+|---------|---------------------|-------|
+| Claude Code (terminal) | ✅ `AskUserQuestion` — REQUIRED for --refine | Preload via ToolSearch first |
+| Cursor / Codex / Copilot / Antigravity | ❌ Text fallback | Plain numbered list |
+
+**Claude Code (terminal) — AUQ preload required (ENH-059):**
+Before the first interactive prompt, call `ToolSearch` with `query: "select:AskUserQuestion"`.
+
+**Prompts using AskUserQuestion in this skill:**
+- --refine field correction (domain, stacks, output_style, phase_template)

package/skills/vp-proposal/SKILL.md

@@ -41,6 +41,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>

package/skills/vp-request/SKILL.md

@@ -41,6 +41,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>

package/skills/vp-resume/SKILL.md

@@ -41,6 +41,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>

package/skills/vp-rollback/SKILL.md

@@ -41,6 +41,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>
@@ -88,11 +98,12 @@ Rollback to any checkpoint safely, with backup and state preservation.
 
 <context>
 Optional flags:
-- `--list` : List available checkpoints
+- `--list` : List available checkpoints (plain-text table, no interactive prompt)
 - `--to <tag>` : Rollback to specific tag
 - `--latest` : Rollback to latest checkpoint
 - `--force` : Skip confirmation
 - `--dry-run` : Show what would happen
+- `--limit N` : Checkpoints per page in interactive selection (default: 10). E.g. `--limit 30` shows 30 per page.
 </context>
 
 <process>
@@ -159,8 +170,30 @@ Update TRACKER.md if needed.
 ```
 </process>
 
+## Adapter Compatibility
+
+### AskUserQuestion Tool (ENH-075)
+Checkpoint selection uses `AskUserQuestion` on Claude Code (terminal).
+
+| Adapter | Interactive Prompts | Notes |
+|---------|---------------------|-------|
+| Claude Code (terminal) | ✅ `AskUserQuestion` — REQUIRED at checkpoint selection | Preload schema via ToolSearch first |
+| Cursor / Codex / Copilot / Antigravity | ❌ Text fallback | Plain numbered list; re-run with `--limit N` for more entries |
+
+**Claude Code (terminal) — AUQ preload required (ENH-059):**
+Before the checkpoint selection prompt, call `ToolSearch` with
+`query: "select:AskUserQuestion"` to load the deferred tool schema.
+If ToolSearch fails, fall back to plain-text numbered list.
+
+**Prompts using AskUserQuestion in this skill:**
+- Checkpoint selection (Step 1 — tag list + "Show N more →" pagination + "Enter manually")
+
 <success_criteria>
 - [ ] Checkpoints listed with dates
+- [ ] AUQ checkpoint picker shown on Claude Code terminal (text fallback on other adapters)
+- [ ] "Show N more →" pagination works; disappears when no more checkpoints
+- [ ] `--limit N` controls page size (default: 10)
+- [ ] `--list` flag outputs plain-text table and exits (no AUQ)
 - [ ] Target validated before rollback
 - [ ] Backup created before changes
 - [ ] State files updated after rollback

package/skills/vp-skills/SKILL.md

@@ -37,6 +37,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>

package/skills/vp-status/SKILL.md

@@ -41,6 +41,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>

package/skills/vp-task/SKILL.md

@@ -41,6 +41,16 @@ version, `{adapter_id}` with the active adapter (claude-code / cursor / antigrav
 - `config.json` → `update.check: false` → skip this step entirely
 - Show at most once per session (`update_check_done` session guard)
 </version_check>
+<persona_context>
+## Persona Context Injection (ENH-073)
+At skill start, run:
+```bash
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona auto-switch
+node "$HOME/.claude/viepilot/bin/vp-tools.cjs" persona context
+```
+Inject the output as `## User Persona` context before any task execution.
+Silent if command unavailable or errors.
+</persona_context>
 
 
 <cursor_skill_adapter>