---
name: "scaffold-vue3-vite"
description: "Scaffold a new Vue 3 + Vite project with vue-router, atomic component directories, and SCSS styling foundations."
agent: "agent"
tools: [read, search, execute]
argument-hint: "project-root=<path> app-name=<name> mode=<dry-run|apply> port=<dev-server-port>"
---

Scaffold a new Vue 3 + Vite project using the shared scaffold script.

Requirements:

- Prefer `resources/scripts/scaffold-vue3-vite.sh` over manually creating files.
- Default to `--mode dry-run` unless the user explicitly asks for apply mode.
- Resolve `--project-root` and `--app-name` before running; ask if missing.
- After `--mode apply` completes, instruct the user to run `npm install` then
  `npm run dev` to verify the dev server starts cleanly.
- Summarize the files created and the next steps.