Contributing

Dev Setup

git clone git@github.com:ConflictHQ/kohakku.git
cd kohakku
make setup    # creates .env files, installs deps
make up       # starts docker-compose stack
make migrate  # runs migrations
make seed     # seeds demo data

Running Tests

make test           # both services
make controller-test  # Django pytest
make dispatcher-test  # Go test

Code Style

• Python: Ruff (check + format), max line 140
• Go: gofmt + golangci-lint
• Commits: conventional commits (feat/fix/docs/test/ci/chore)
• Pre-commit: .pre-commit-config.yaml configured

PR Process

1. Create a branch from main
2. Make changes, add tests
3. Run make lint && make test
4. Open PR with description and test plan
5. CI must pass (lint + test + build)