45 lines (33 loc) · 1.28 KB

Contributing to EV Core

Thanks for your interest in contributing.

EV Core is built with a strong bias towards reliability and traceability. Contributions that improve determinism, safety, and maintainability are especially welcome.

Ground rules

Keep changes small and reviewable (one improvement per PR where possible).
Preserve the deterministic-first design (tools/routing before LLM fallback).
Do not commit secrets, keys, tokens, or private configuration.
Do not add large binaries or model files to the repo.

Development workflow

Fork the repo (or create a branch if you have access).
Create a feature branch:
- feature/<short-description>
Make changes with clear commits.
Open a PR into dev with:
- what changed
- why it changed
- how to test it manually (brief)

What belongs in this repo

Core runtime logic (scripts/)
Configuration templates (config/)
Documentation

What does NOT belong in this repo

models/ (local model weights)
llama.cpp/ (external dependency)
logs/ (run artefacts)
agents/ (local-only agent system, intentionally isolated)
.env files or credentials

Reporting issues

Please include:

device/OS info
relevant log snippets (redact secrets)
steps to reproduce
expected vs actual behaviour