Agent Skills: /configure:makefile

/configure:makefile

Check and configure project Makefile against project standards.

When to Use This Skill

| Use this skill when... | Use another approach when... | |------------------------|------------------------------| | Setting up a new Makefile for a project that requires Make | Project can use Just instead — use /configure:justfile (preferred) | | Auditing existing Makefile for missing standard targets | Writing complex build rules with dependencies — consult GNU Make documentation | | Ensuring Makefile follows team conventions (help target, PHONY, colors) | Project uses a language-native build system (cargo, go build) exclusively | | Running CI/CD compliance checks on Makefile structure | Migrating from Makefile to Justfile — use /configure:justfile which handles migration | | Adding language-specific build/test/lint targets to existing Makefile | Debugging a specific Make target — run make -n <target> directly |

Context

• Project root: !pwd
• Makefile exists: !find . -maxdepth 1 -name 'Makefile'
• Makefile targets: !grep -E '^[a-zA-Z_-]+:' Makefile
• Package files: !find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' -o -name 'go.mod' \)
• Docker files: !find . -maxdepth 1 \( -name 'Dockerfile' -o -name 'docker-compose.yml' -o -name 'compose.yml' \)
• Server files: !find src -maxdepth 1 \( -name 'server.*' -o -name 'main.*' \)

Parameters

Parse from $ARGUMENTS:

• --check-only: Report Makefile compliance status without modifications
• --fix: Apply fixes automatically without prompting

Required Makefile targets: help, test, build, clean, lint

Execution

Execute this Makefile compliance check:

Step 1: Detect project type

Read the context values and determine project type (in order):

1. Python: pyproject.toml or requirements.txt present
2. Node: package.json present
3. Rust: Cargo.toml present
4. Go: go.mod present
5. Generic: None of the above

Check for service indicators (start/stop needed):

• Has docker-compose.yml or compose.yml -> Docker Compose service
• Has Dockerfile + HTTP server code -> Container service
• Has src/server.* or src/main.* -> Application service

Step 2: Analyze existing Makefile targets

If Makefile exists, check against required targets:

Required targets for all projects:

| Target | Purpose | |--------|---------| | help | Display available targets (default goal) | | test | Run test suite | | build | Build project artifacts | | clean | Remove temporary files and build artifacts | | lint | Run linters |

Additional targets (context-dependent):

| Target | When Required | |--------|---------------| | start | If project has runnable service | | stop | If project has background service | | format | If project uses auto-formatters |

Step 3: Run compliance checks

| Check | Standard | Severity | |-------|----------|----------| | File exists | Makefile present | FAIL if missing | | Default goal | .DEFAULT_GOAL := help | WARN if missing | | PHONY declarations | All targets marked .PHONY | WARN if missing | | Colored output | Color variables defined | INFO | | Help target | Auto-generated from comments | WARN if missing | | Language-specific | Commands match project type | FAIL if mismatched |

Step 4: Generate compliance report

Print a report showing:

• Project type (detected)
• Each target with PASS/FAIL status and the command used
• Makefile structural checks (default goal, PHONY, colors, help)
• Missing targets list
• Issue count

If --check-only is set, stop here.

Step 5: Create or update Makefile (if --fix or user confirms)

1. Missing Makefile: Create from standard template using the detected project type
2. Missing targets: Add targets with appropriate language-specific commands
3. Missing defaults: Add .DEFAULT_GOAL, .PHONY, color variables
4. Missing help: Add auto-generated help target using awk comment parsing

Use the language-specific commands below:

Python (uv-based):

• lint: @uv run ruff check .
• format: @uv run ruff format .
• test: @uv run pytest
• build: @docker build -t {{PROJECT_NAME}} .
• clean: @find . -type f -name "*.pyc" -delete + remove cache dirs

Node.js:

• lint: @npm run lint
• format: @npm run format
• test: @npm test
• build: @npm run build
• clean: @rm -rf node_modules/ dist/ .next/ .turbo/

Rust:

• lint: @cargo clippy -- -D warnings
• format: @cargo fmt
• test: @cargo nextest run
• build: @cargo build --release
• clean: @cargo clean

Go:

• lint: @golangci-lint run
• format: @gofmt -s -w .
• test: @go test ./...
• build: @go build -o bin/{{PROJECT_NAME}}
• clean: @rm -rf bin/ dist/ + @go clean

Step 6: Update standards tracking

Update .project-standards.yaml:

components:
  makefile: "2025.1"

Step 7: Print final report

Print a summary of changes applied, targets added, and suggest running make help to verify.

For the universal Makefile template structure, see REFERENCE.md.

Agentic Optimizations

| Context | Command | |---------|---------| | Quick compliance check | /configure:makefile --check-only | | Auto-fix all issues | /configure:makefile --fix | | List existing targets | grep -E '^[a-zA-Z_-]+:' Makefile | | Dry-run a target | make -n <target> | | Show default goal | make -p \| grep '.DEFAULT_GOAL' |

Flags

| Flag | Description | |------|-------------| | --check-only | Report status without offering fixes | | --fix | Apply fixes automatically |

Examples

# Check current Makefile compliance
/configure:makefile --check-only

# Create/update Makefile for Python project
/configure:makefile --fix

# Check compliance and prompt for fixes
/configure:makefile

See Also

• /configure:all - Run all compliance checks
• /configure:workflows - GitHub Actions workflows
• /configure:dockerfile - Docker configuration