Makefile Dogfooding Command

Use the makefile-dogfooder skill to analyze, test, and enhance Makefiles across the claude-night-market project.

Parameters

--scope: Target scope (default: all)
- root: Analyze only the root Makefile
- plugins: Analyze plugin Makefiles only
- all: Analyze both root and plugin Makefiles
--mode: Operation mode (default: full)
- analyze: Only analyze and report gaps
- test: Only test existing targets safely
- full: Complete analysis + testing + generation
--plugin: Restrict to specific plugin (e.g., --plugin abstract)
--interactive: Prompt before applying changes (default: true for generation)

Workflow

1. Discovery Phase

Scan all Makefiles and build an inventory of existing targets:

Find all Makefile and .mk files
Extract target definitions and metadata
Build dependency graphs
Identify plugin type (leaf vs aggregator)

2. Analysis Phase

Evaluate Makefiles against best practices:

Check for essential targets (help, clean, test, lint)
Identify missing convenience targets (demo, quick-run)
Detect anti-patterns and inconsistencies
Score each Makefile on completeness (0-100)

3. Testing Phase

Safely validate existing targets:

Run make -n for dry-run validation
Test help targets and documentation coverage
Verify target dependencies exist
Check for common runtime issues

4. Generation Phase

Create missing targets based on analysis:

Generate demo targets to showcase functionality
Add dogfood targets for self-testing
Create quick-run targets for common workflows
Maintain consistency with existing patterns

Examples

# Analyze all Makefiles
/make-dogfood --mode analyze

# Test targets only
/make-dogfood --mode test --scope plugins

# Full workflow for single plugin
/make-dogfood --plugin abstract --mode full

# Quick check with auto-apply
/make-dogfood --scope root --mode full --interactive=false

What This Command Does

Creates detailed inventory of all Makefile targets across the project
Identifies gaps in user-facing functionality using pattern matching
Tests safely without modifying files or running risky operations
Generates missing targets with contextually appropriate templates
Maintains consistency with existing project patterns and conventions

Output Format

The command provides:

Summary report with scores and recommendations
Detailed findings by Makefile
Generated targets ready for review
Integration instructions for applying changes

Integration with Skills

This command uses the makefile-dogfooder skill which provides:

Modular discovery and analysis components
Safe testing patterns for validation
Template-based target generation
Context-aware recommendations

/make-dogfood