Skip to main content

Development Guide

Local Dev Loop​

make dev-up
./scripts/dev/wait-for-services.sh
make test-fast

Core Engineering Gates​

  • formatting: make fmt
  • linting: make lint
  • tests: make test, make test-integration, make test-compatibility
  • architecture guardrails: make test-architecture, make check-guardrails

E2E and MQL Validation​

  • make e2e-single
  • make e2e-local-cluster
  • make mql-exhaustive
  • make mql-coverage-audit

Where to Read Before Changes​

  • README.md
  • docs/ARCHITECTURE.md
  • docs/COMPATIBILITY.md

Source of Truth​

  • Makefile
  • scripts/dev/wait-for-services.sh
  • docs/ARCHITECTURE.md