This folder is the single source of truth for running Kroot as an enterprise-grade product: how work is branched, versioned, released, secured and observed. It is written for maintainers and operators.
The engineering charter that governs day-to-day contribution lives in
AGENTS.md.
| Document | Purpose |
|---|---|
coding-standards.md |
Go and TypeScript rules, naming, error handling |
testing-strategy.md |
Test pyramid, coverage, race detection, E2E |
branching-strategy.md |
Trunk-based model, branch naming, PR rules |
versioning-policy.md |
What bumps major / minor / patch |
release-process.md |
Release checklist, tags, artifacts, rollback |
security-policy.md |
Threat model, handling, hardening checklist |
observability.md |
Logs, metrics, health checks, SLOs |
api-compatibility.md |
Compatibility guarantees for CLI, HTTP and env vars |
main is the
authoritative one for the current development line.