# Custom Commands for Claude Code

This directory contains custom command documentation that Claude Code can reference when assisting with development tasks.

## Available Commands

### 1. Run E2E Tests (`run-e2e-tests.md`)
Comprehensive instructions for running end-to-end tests using Playwright.

**Trigger phrases:**
- "run e2e tests"
- "run end-to-end tests"
- "execute e2e test suite"

### 2. Fix CI (`fix-ci.md`)
Guidance for troubleshooting and fixing CI/CD pipeline issues.

**Trigger phrases:**
- "fix ci"
- "help with continuous integration"

### 3. Browser Observe (`browser-observe.md`)
Instructions for browser-based testing and observation workflows.

**Trigger phrases:**
- "observe browser"
- "start browser observation"

### 4. Prepare E2E Tests (`prepare-e2e-tests.md`)
Analyzes code changes, determines needed E2E test coverage, writes test specs, and runs them to verify they pass.

**Trigger phrases:**
- "prepare e2e tests"
- "write e2e tests for my changes"
- "add e2e test coverage"

## How It Works

When you ask Claude to perform one of these tasks, it will:
1. Automatically detect the request based on your natural language
2. Reference the appropriate command file
3. Follow the detailed instructions in that file
4. Execute the necessary steps to complete the task

## Adding New Commands

To add a new custom command:

1. Create a new markdown file in this directory with a descriptive name (e.g., `deploy-staging.md`)
2. Write clear, detailed instructions including:
   - Overview of the task
   - Prerequisites
   - Step-by-step instructions
   - Common issues and troubleshooting
   - Examples
3. Update this README to list the new command
5. Commit all files to version control

## Best Practices

- **Be specific**: Include exact commands, file paths, and configuration details
- **Include context**: Explain why certain steps are necessary
- **Add troubleshooting**: Document common errors and solutions
- **Use examples**: Show concrete examples of usage
- **Keep updated**: Review and update commands as the project evolves
