# Contributing to copilot-commit-validator

Thank you for considering contributing to copilot-commit-validator! This document provides guidelines and instructions for contributing.

## Getting Started

1. **Fork the repository** on GitHub
2. **Clone your fork** to your local machine
3. **Create a new branch** for your feature or bug fix:
   ```bash
   git checkout -b feature/your-feature-name
   ```

## Development Setup

1. Install dependencies:
   ```bash
   npm install
   ```

2. Set up your environment variables:
   ```bash
   cp .env.example .env
   ```

3. Configure your GitHub token (optional but recommended):
   ```bash
   export GITHUB_TOKEN=your_token_here
   ```

## Making Changes

1. **Write clear, descriptive commit messages**
   - Use imperative mood (e.g., "Add feature" not "Added feature")
   - Keep commits focused and atomic
   - Reference issues when applicable

2. **Follow code style guidelines**
   - Use consistent indentation (2 spaces)
   - Follow existing code patterns
   - Add comments for complex logic

3. **Test your changes**
   - Test locally before submitting a PR
   - Verify the package.json entry point works correctly

## Submitting Changes

1. **Push to your fork**:
   ```bash
   git push origin feature/your-feature-name
   ```

2. **Create a Pull Request** with:
   - Clear description of changes
   - Reference to related issues
   - Testing information
   - Any breaking changes clearly noted

3. **Wait for review**
   - Maintainers will review your PR
   - Address feedback and requested changes
   - Once approved, your PR will be merged

## Reporting Issues

- **Search existing issues** before creating a new one
- **Provide clear descriptions** with steps to reproduce
- **Include environment information**:
  - Node.js version
  - npm version
  - Operating system
  - GitHub token status (if applicable)

## Code Review Process

All submissions require review. We use GitHub pull requests for this purpose. Consult GitHub Help for more information on using pull requests.

## Community

- Be respectful and inclusive
- Help others learn and grow
- Celebrate contributions
- Follow the Code of Conduct

## Questions?

Feel free to open an issue with the label "question" or contact the maintainers.

Thank you for contributing!