go-makefile-writer

# Go Makefile Writer Design a practical root `Makefile` that is readable, reproducible, and aligned with repository layout. ## Quick Reference | If you need to… | Go to | |---|---| | Create a Makefile from scratch for a new Go project | §Execution Modes → Create + §Workflow | | Refactor or update an existing Makefile (minimal-diff) | §Execution Modes → Refactor | | Decide which targets to include (`build`, `test`, `lint`, `ci`…) | §Workflow (Plan targets) | | Get a complete working Makefile example to start from | Load `references/golden/simple-project.mk` or `complex-project.mk` | | Check quality rules, variable conventions, `.PHONY` requirements | Load `references/makefile-quality-guide.md` | | Review a Makefile PR quickly | Load `references/pr-checklist.md` | | Handle a monorepo or multi-module Go repo | §Monorepo Support | ## Execution Modes Select a mode before starting and state it in the output report. ### Create (new Makefile from scratch) - Full target set generated from project inspection. - Use golden templates ([simple-project.mk](references/golden/simple-project.mk) / [complex-project.mk](references/golden/complex-project.mk)) as starting points. - No backward-compatibility concerns. ### Refactor (modify existing Makefile) - **Minimal-diff edits** — change only what is needed; do not rewrite the entire file. - **Backward compatibility**: if target names change, keep aliases for at least one transition period and document them in the output report. - **Pr...