cmd-makefile-improve
Makefile Foundation Review
Review the current repository's Makefile foundation, then recommend a small, high-quality next iteration. This is a review-and-proposal skill: do not modify files, commit, install dependencies, or publish anything until the user explicitly approves the proposed changes.
When invoked in /Users/olshansky/workspace/agent-skills, the primary implementation target is skills/cmd-makefile/ and its templates/modules. In any other repository, target that repository's Makefile, helper directory, templates, tests, and documentation instead.
Operating contract
- Inspect first; infer nothing from filenames alone.
- Ask one concise batch of questions after discovery when choices materially affect the recommendation.
- Report evidence, proposed changes, and tradeoffs before editing.
- Wait for explicit approval. “Looks good” or “go ahead” approves the presented scope; new or materially broader work needs a new proposal.
- After approval, make only the approved changes and verify them. If approval is not given, leave the worktree unchanged.
Do not treat a clean worktree as permission to edit. Do not automatically update generated dashboards, symlinks, installed skills, remote repositories, or unrelated files.
Discovery pass
Use the repository's documented workflow first. Read AGENTS.md, README.md, CONTRIBUTING.md, and any tool-specific instruction files that apply. Check make help before suggesting raw commands when a Makefile exists.