Skip to content

Make System Overview

The repository make system is the shared command language for maintenance work.

It starts at Makefile, which delegates immediately to makes/root.mk. From there the repository pulls in a layered set of make fragments: environment setup, repository-wide orchestration, package dispatch, shared bijux-py contracts, CI-oriented targets, and per-package definitions.

Core Shape

  • Makefile is the top-level entrypoint
  • makes/root.mk assembles repository-wide includes
  • makes/bijux-py/ carries reusable make contracts and target groups
  • makes/packages/ maps shared target patterns onto repository packages

Why It Matters

This structure keeps the command layer explicit. A target can be traced to the file that owns it, and a reviewer can tell whether a new target is repository scope, package scope, CI scope, or release scope.

Purpose

This page gives the shortest honest explanation of how the make system is organized.

Stability

Keep it aligned with the actual include structure rooted at Makefile.