Recursive Make for Multi-Directory Projects

What problem does it solve?

Coordinating builds across multiple subdirectories in a Make-based project can be brittle when using shell loops, leading to serialized builds, hard-to-trace errors, and poor parallelism. This skill provides a structured approach to organizing per-subdirectory builds with phony targets and proper recursion.

Core Features & Use Cases

• Phony targets for subdirectories: enables parallel builds with make -j and clear scheduling.
• Proper recursion with $(MAKE): ensures flags like -t, -n, -q apply in sub-makes.
• Dependency order & export options: allows declaring per-subdirectory dependencies and shared variables for consistent builds.
• Guidance for common anti-patterns: explains why shell loops are problematic and provides the phony-target alternatives.
• Use cases include multi-directory projects with frontend/backend/database, or scenarios with subdirectory-like subprojects.

Quick Start

Use phony targets for subdirectories and invoke $(MAKE) -C $@ in each target to enable parallel builds.