Slash Commands Reference

Complete reference for all available slash commands. These custom Claude Code commands automate common development workflows.

Development Workflow

/pr-create

Create a pull request with comprehensive description and automated quality gates.

Usage:

/pr-create

What It Does:

1. Checks if branch needs rebasing onto master
2. Checks if PHPStan analysis is required (PHP files changed)
3. Fetches issue details from GitHub
4. Creates PR with comprehensive description template
5. Links PR to related GitHub issue

Quality Gates:

• Rebase validation (ensures branch is up-to-date)
• PHPStan analysis (for PHP file changes)

---

/rebase-master

Rebase current branch onto latest master and resolve conflicts.

Usage:

/rebase-master

What It Does:

1. Fetches latest master from origin
2. Rebases current branch onto master
3. Detects conflicts and guides resolution
4. Verifies rebase completed successfully

When to Use:

• Before creating a PR
• After master has advanced significantly
• Before merging your branch

---

/commit

Create a git commit with proper formatting.

Usage:

/commit [optional-message]

# Examples
/commit "Add booking validation"
/commit

Commit Format:

The subject is a Conventional Commit; the ClickUp task is referenced in a Refs: footer (not the subject). When the branch was created by /task-work, the CU-… task ID is taken from the branch name.

type(scope): description

Refs: CU-TASKID

Example:
feat(backend): add booking validation service

Refs: CU-869dtaf1r

---

Code Quality

/fix-phpstan

Run PHPStan analysis and automatically fix all detected errors.

Usage:

# Analyze entire application
/fix-phpstan

# Analyze specific file
/fix-phpstan app/Services/BookingService.php

# Analyze directory
/fix-phpstan app/Services

Phases:

1. Phase 1: Runs PHPStan analysis to identify errors
2. Phase 2: Automatically fixes all errors
3. Phase 3: Verifies all errors are resolved
4. Phase 4: Prompts to commit changes

Common Fixes Applied:

• Missing PHPDoc array type annotations
• Using env() outside config files
• Missing return type declarations
• Untyped properties

---

Task Management

/task-create

Create a ClickUp task from a description or plan, with a clean title and a structured description.

Usage:

/task-create [description or path to plan file]

# Example
/task-create Add email notifications for booking confirmations

What It Does:

1. Detects an optional plan to include
2. Derives a clean, short task name
3. Infers type/area tags and (if signalled) priority
4. Asks which ClickUp list to use, then creates the task via MCP
5. Uploads and attaches any screenshots/files provided as evidence

---

/task-work

Start working on an existing ClickUp task by setting up a feature branch.

Usage:

/task-work TASK_ID

# Example
/task-work CU-869dtaf1r

What It Does:

1. Resolves the task from ClickUp (by ID or name)
2. Assigns it to the current user and moves it to In Progress
3. Syncs origin/master
4. Creates and checks out a feature branch off the latest master

Branch Naming:

<taskId>_<slugified-name>

Example:
CU-869dtaf1r_bogus-multi-stop-domestic-flight-legs

The leading CU-… token lets ClickUp’s GitHub integration auto-link commits and the PR back to the task.

---

Documentation

/update-docs

Update documentation for recently changed backend services.

Usage:

/update-docs

# Or for specific service
/update-docs BookingService

What It Does:

1. Detects recently modified service files
2. Updates corresponding documentation
3. Verifies code examples are accurate
4. Updates API reference if endpoints changed

---

/review-branch

Review code on a local branch before opening a PR — full-branch reviews or targeted commit reviews from provided SHAs or ranges.

Usage:

/review-branch

# Or scope to specific commits/ranges
/review-branch <sha-or-range>

When to Use:

• Before running /pr-create, to catch issues early
• To review a specific set of commits without reviewing the whole branch

---

Infrastructure

/ec2-connect

Open an interactive shell on a Volāre EC2 instance (api, front, or ops-runner) via AWS SSM Session Manager — no SSH keys or VPN.

Usage:

/ec2-connect [environment] [role]

# Example
/ec2-connect production ops-runner

Always confirms environment (staging vs production) and role before connecting. See Server Access for the full procedure.

---

Database

/db-backup

Trigger a fresh PostgreSQL backup to S3 via db-backup.sh.

Usage:

/db-backup

Produces a plain-SQL dump and uploads it to s3://$DB_DUMPS_BUCKET/Volare/latest.sql (overwrites — no history). See Database Backup & Restore.

---

/db-restore

Restore the local PostgreSQL database from the latest production dump on S3.

Usage:

/db-restore

Downloads the latest dump and restores it locally, prompting before replacing local data. See Database Backup & Restore.

---

Quick Reference

Command	Category	Purpose	Required Args
/pr-create	Workflow	Create PR with quality gates	None
/rebase-master	Workflow	Rebase onto latest master	None
/update-master	Workflow	Switch to master, pull, sync deps	None
/commit	Workflow	Create formatted commit	Optional message
/review-branch	Workflow	Review a branch before PR	Optional commit SHAs/range
/fix-phpstan	Quality	Run and fix PHPStan errors	Optional path
/task-create	Tasks	Create ClickUp task	Description or plan
/task-work	Tasks	Start working on task	Task ID
/review-comment	Review	Evaluate PR review comment validity	Comment text
/update-docs	Docs	Update service documentation	Optional service
/work-report	Reporting	Generate work report/changelog	Optional period
/prune-branches	Maintenance	Delete merged local branches	None
/ec2-connect	Infrastructure	Shell into an EC2 instance via SSM	Optional environment + role
/db-backup	Database	Trigger a DB backup to S3	None
/db-restore	Database	Restore local DB from latest prod dump	None

Common Workflows

Starting New Feature

# 1. Create ClickUp task
/task-create Add customer export functionality

# 2. Start working on the task
/task-work CU-869dtaf1r

# 3. Implement the feature
# ... coding ...

# 4. Fix type safety issues
/fix-phpstan app/Services/CustomerService.php

# 5. Commit changes
/commit "Implement customer export service"

# 6. Update documentation
/update-docs CustomerService

# 7. Create pull request
/pr-create

Fixing a Bug

# 1. Create branch for bug fix
/task-work CU-869dtac5r

# 2. Fix the bug
# ... coding ...

# 3. Run static analysis
/fix-phpstan

# 4. Commit the fix
/commit "Fix booking validation null pointer"

# 5. Create PR
/pr-create

Tips and Best Practices

Command Execution Order

Typical sequence:

1. /task-work - Set up branch
2. Code your feature
3. /fix-phpstan - Fix type safety
4. /commit - Commit changes
5. /update-docs - Update docs
6. /pr-create - Create PR

Error Recovery

If /pr-create stops you:

# Rebase if needed
/rebase-master

# Fix PHPStan if needed
/fix-phpstan

# Retry PR creation
/pr-create

Efficiency Tips

1. Run PHPStan early and often - Don’t wait until PR time
2. Commit frequently - Use /commit for small, logical changes
3. Update docs as you code - Don’t save for the end
4. Use /rebase-master regularly - Stay current with master

Troubleshooting

Command Not Found

# List available commands
/help

# Check command exists
ls .claude/skills/

Quality Gate Blocks PR

This is expected behavior:

1. Follow the prompted command (/fix-phpstan)
2. Wait for fixes to complete
3. Review and commit fixes
4. Retry /pr-create