docs: update CONTRIBUTING.md to match JS SDK structure

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: FrancescoSaverioZuppichini

CONTRIBUTING.md

@@ -1,31 +1,55 @@
-# Contributing
+# Contributing to scrapegraph-py
 
 ## Setup
 
 ```bash
 uv sync
 ```
 
+## Development
+
+```bash
+uv build             # build to dist/
+uv run ruff check .  # lint
+```
+
 ## Before committing
 
+Run all checks:
+
 ```bash
-uv run ruff check src/ tests/   # lint
-uv run ruff format src/ tests/  # format
-uv run pytest tests/test_client.py -v  # tests
+uv run ruff format src/ tests/  # auto-fix formatting
+uv run ruff check src/ tests/   # check for errors
+uv run pytest tests/test_client.py -v  # unit tests
 ```
 
-Or all at once:
+## Testing
 
 ```bash
-uv run ruff check src/ tests/ && uv run ruff format src/ tests/ && uv run pytest tests/test_client.py -v
+uv run pytest tests/test_client.py -v       # unit tests only
+uv run pytest tests/test_integration.py -v  # live API tests (requires SGAI_API_KEY)
 ```
 
-CI will reject PRs that fail lint or format checks.
+For integration tests, set `SGAI_API_KEY` in your environment or `.env` file.
 
-## Running integration tests
+## Commit messages
 
-Requires `SGAI_API_KEY` env var:
+Use conventional commits:
 
-```bash
-uv run pytest tests/test_integration.py -v
-```
+- `feat:` new feature
+- `fix:` bug fix
+- `refactor:` code change (no new feature, no bug fix)
+- `chore:` maintenance (deps, config)
+- `test:` add/update tests
+- `docs:` documentation
+
+## Pull requests
+
+1. Fork and create a branch from `main`
+2. Make changes
+3. Run all checks (see above)
+4. Submit PR to `main`
+
+## License
+
+MIT - contributions are licensed under the same license.