# Contributing

## Development setup
1. Install Go 1.25+.
2. Clone repository.
3. Run:
   - `go mod tidy`
   - `go test ./...`

## Build locally
- `go build -o bin/pxmon ./cmd/pxmon`
- `go build -o bin/pxmon-agent ./cmd/pxmon-agent`

## Code style
- Keep changes small and focused.
- Prefer explicit error messages with command context.
- Add tests for behavior changes when possible.

## Commit style
Use clear, scoped commit messages, for example:
- `feat(cluster): add alert routing batch window`
- `fix(tui): stabilize panel heights during scroll`
- `docs: expand command reference`

## Pull requests
Include:
- What changed
- Why it changed
- How you tested it
- Any behavior or migration impact