| name | repo-setup |
| description | Performs initial repository setup including git hooks, demo site creation, and dependency installation. Use when cloning the repository for the first time, onboarding a new developer, or resetting the development environment. |
Setup Repository
You are helping set up the Umbraco.AI repository for local development.
Task
Perform initial repository setup by running the appropriate setup scripts based on the user's platform and preferences.
Available Setup Tasks
-
Git Hooks - Install git hooks for branch naming enforcement
- Windows:
.\scripts\setup-git-hooks.ps1
- Linux/Mac:
./scripts/setup-git-hooks.sh
-
Demo Site - Create unified solution with demo Umbraco instance
- Windows:
.\scripts\install-demo-site.ps1
- Linux/Mac:
./scripts/install-demo-site.sh
- Options:
-SkipTemplateInstall / -Force (PowerShell) or --skip-template-install / --force (Bash)
-
Dependencies - Install npm workspace dependencies
-
Initial Build - Build the unified solution
- Command:
dotnet build Umbraco.AI.local.slnx
Workflow
- Detect platform - Check if Windows (PowerShell) or Linux/Mac (Bash)
- Ask user what to set up - Use AskUserQuestion with options:
- "Git hooks only"
- "Git hooks + demo site"
- "Full setup (hooks + demo + dependencies + build)"
- Allow custom selections
- Execute selected tasks in order
- Report results - Show what was completed and any errors
Important Notes
- Always run scripts from the repository root
- Check if demo site already exists before running install script
- Use platform-specific script extensions (.ps1 vs .sh)
- Provide clear feedback after each step
- If any step fails, report it but continue with remaining tasks if possible
Example Flow
User invokes: /repo-setup
You ask: "What would you like to set up?"
- Git hooks only
- Git hooks + demo site
- Full setup (hooks + demo + dependencies + build)
User selects: "Full setup"
You execute:
1. Run setup-git-hooks script
2. Run install-demo-site script
3. Run npm install
4. Run dotnet build
Report: "Setup complete!"
