Makefile Workflow

Workflow for Makefile changes.

Prerequisites

Use git-workflow Skill for branch, commit, and PR workflow.

Applicable Files

Structure

Makefile              # Main entry point, includes make/*.mk
make/
├── go.mk            # Go-related targets
├── docker.mk        # Docker targets
├── atlas.mk         # Database migration targets
├── sqlc.mk          # SQLC generation targets
└── ...

Verification Commands

make mk-lint    # Lint makefiles

Manual Checks

# List all targets
make help

# Dry run (if supported)
make -n {target}

Guidelines

Style

• •Use tabs for indentation (required by Make)
• •Use .PHONY for non-file targets
• •Add help text for targets
• •Group related targets

Best Practices

• • Targets are .PHONY if not creating files
• • Dependencies are correct
• • Variables use ?= for defaults
• • Help text exists for main targets

Example Target

.PHONY: my-target
my-target: ## Description of target
 @echo "Running my-target..."
 command1
 command2

Verification Checklist

• • make mk-lint passes
• • Target runs correctly
• • Dependencies work
• • Help text is accurate

Commit Format

chore(make): {brief description}

- {change 1}
- {change 2}

Closes #{issue_number}

Related Skills

• •git-workflow - Branch, commit, PR workflow