# Contributing

Contributions are welcome and appreciated. Here's how to get involved.

## Getting Started

1. Fork the repository
2. Create a branch: `git checkout -b feat/<feature-name>`
3. Make your changes
4. Test thoroughly against the Docker lab
5. Commit using Conventional Commits (see below)
6. Push your branch and open a Pull Request

## Commit Messages

This project uses [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
Format: `<type>(<scope>): <description>`

```
feat(shell): add PHP fsockopen reverse shell
fix(check): handle non-WordPress targets
docs(readme): document RCE requirements
```

Common types: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`.
See the [specification](https://www.conventionalcommits.org/en/v1.0.0/#specification) for details.

## Guidelines

- Keep changes focused — one feature or fix per PR
- Don't introduce external dependencies unless necessary
- If adding a new feature, update documentation to reflect it
- Follow the existing code style (Python: `black`)

## Reporting Issues

Open an issue and include:
- Your OS and `python3 -V`
- The exact command used and the full output
- A screenshot or log if applicable

## Pull Requests

All PRs are reviewed. Small fixes are just as welcome as large features. If you're planning something significant, open an issue first to discuss the direction.