makefile-generation

Table of Contents

• When To Use
• Standard Targets
• Python Makefile
• Rust Makefile
• TypeScript Makefile
• Workflow
• 1. Detect Language
• 2. Load Template
• 3. Collect Project Info
• 4. Render Template
• 5. Verify
• Customization
• Related Skills

Makefile Generation Skill

Generate a Makefile with standard development targets for Python, Rust, or TypeScript projects.

When To Use

• Need a Makefile for a project without one
• Want to update Makefile with new targets
• Standardizing build automation across projects
• Setting up development workflow commands
• Creating language-specific build targets

When NOT To Use

• Makefile already exists and is current
• Project uses alternative build system exclusively (e.g., npm scripts only)
• Complex custom build process that doesn't fit standard patterns
• Use /attune:upgrade-project instead for updating existing Makefiles

Standard Targets

Python Makefile

Common targets:

• help - Show available targets
• install - Install dependencies with uv
• lint - Run ruff linting
• format - Format code with ruff
• typecheck - Run mypy type checking
• test - Run pytest
• test-coverage - Run tests with coverage report
• check-all - Run all quality checks
• clean - Remove generated files and caches
• build - Build distribution packages
• publish - Publish to PyPI

Rust Makefile

Common targets:

• help - Show available targets
• fmt - Format with rustfmt
• lint - Run clippy
• check - Cargo check
• test - Run tests
• build - Build release binary
• clean - Clean build artifacts

TypeScript Makefile

Common targets:

• help - Show available targets
• install - Install npm dependencies
• lint - Run ESLint
• format - Format with Prettier
• typecheck - Run tsc type checking
• test - Run Jest tests
• build - Build for production
• dev - Start development server

Workflow

1. Detect Language

# Check for language indicators
if [ -f "pyproject.toml" ]; then
    LANGUAGE="python"
elif [ -f "Cargo.toml" ]; then
    LANGUAGE="rust"
elif [ -f "package.json" ]; then
    LANGUAGE="typescript"
fi

Verification: Run the command with --help flag to verify availability.

2. Load Template

from pathlib import Path

template_path = Path("plugins/attune/templates") / language / "Makefile.template"

Verification: Run the command with --help flag to verify availability.

3. Collect Project Info

metadata = {
    "PROJECT_NAME": "my-project",
    "PROJECT_MODULE": "my_project",
    "PYTHON_VERSION": "3.10",
}

Verification: Run the command with --help flag to verify availability.

4. Render Template

from template_engine import TemplateEngine

engine = TemplateEngine(metadata)
engine.render_file(template_path, Path("Makefile"))

Verification: Run the command with --help flag to verify availability.

5. Verify

make help

Verification: Run make --dry-run to verify build configuration.

Customization

Users can add custom targets after the generated ones:

# ============================================================================
# CUSTOM TARGETS
# ============================================================================

deploy: build ## Deploy to production
	./scripts/deploy.sh

Verification: Run the command with --help flag to verify availability.

Related Skills

• Skill(attune:project-init) - Full project initialization
• Skill(abstract:makefile-dogfooder) - Makefile testing and validation

Troubleshooting

Common Issues

Command not found Ensure all dependencies are installed and in PATH

Permission errors Check file permissions and run with appropriate privileges

Unexpected behavior Enable verbose logging with --verbose flag