Contributing to jevkit

September 18, 2026 ยท View on GitHub

Thanks for your interest in contributing!

Getting Started

git clone https://github.com/ariel-frischer/jevkit.git
cd jevkit
make install   # Download dependencies
make build     # Build binary
make test      # Run tests

Development

make build     # Build to bin/jevkit
make test      # Run all tests
make lint      # Run linters
make format    # Format code

Pull Requests

  1. Fork the repo and create your branch from main
  2. Add tests for any new functionality
  3. Ensure make test and make lint pass
  4. Update CHANGELOG.yaml with your changes

Reporting Issues

Use GitHub Issues. Include:

  • What you expected vs what happened
  • Steps to reproduce
  • jevkit version output
  • OS and architecture

Code Style

  • Functions under 40 lines
  • Errors wrapped with context: fmt.Errorf("doing X: %w", err)
  • Table-driven tests with map[string]struct{}

License

By contributing, you agree that your contributions will be licensed under the MIT License.

Agent skill development

To keep the repo skill live in your agent while developing:

ln -s "$PWD/.skills/jevkit" ~/.agents/skills/jevkit
ln -s ../../.agents/skills/jevkit ~/.claude/skills/jevkit   # if you use Claude Code