Brooks-Lint encodes 12 classic engineering books into an AI code-review skill
hyhmrright built `brooks-lint`, a Claude Code skill that applies architectural principles from 12 classic software engineering books — including *The Mythical Man-Month* — to review and refactor code structure.
Score breakdown
`brooks-lint` directly addresses a gap where AI-generated code passes functional tests but violates established architectural principles — by encoding those principles from classic texts into a reusable review skill, it applies structured software-engineering judgment to AI-written codebases.
- 01Built by hyhmrright and published on GitHub as an open-source project
- 02Implemented as a Claude Code skill named `brooks-lint`
- 03Grounds AI code reviews in principles from 12 classic software engineering books
hyhmrright published `brooks-lint` on GitHub after a hands-on experience managing an intern whose AI-written FastAPI backend was functionally correct but architecturally messy — specifically, the service layer had been broken into an unnecessarily deep, multi-layered directory structure rather than a simple split across two or three files. Recalling principles from books on software project management, code structure, and architecture, the author decided to encode those ideas into a reusable tool rather than apply them ad hoc.
The project is open-source and the author invites the community to use the skill, identify issues, and submit pull requests to expand or improve the encoded principles.
The result is a Claude Code skill called `brooks-lint` that grounds AI code reviews in principles drawn from 12 classic software engineering books, with *The Mythical Man-Month* cited explicitly as one source. The author used the skill to refactor the intern's project and describes the outcome as a much clearer and more logical architecture. The project is open-source and the author invites the community to use the skill, identify issues, and submit pull requests to expand or improve the encoded principles.
Key facts
- 01Built by hyhmrright and published on GitHub as an open-source project
- 02Implemented as a Claude Code skill named `brooks-lint`
- 03Grounds AI code reviews in principles from 12 classic software engineering books
- 04*The Mythical Man-Month* is explicitly cited as one of the source books
- 05Motivated by an intern's AI-generated FastAPI backend that was correct but had an overly deep, poorly structured directory layout
- 06Used to refactor the offending project, producing a cleaner architecture
- 07Author invites community contributions via pull requests
Topics
Summary and scoring are generated automatically from the original article. We always link back to the publisher and never republish images or paywalled content. Last processed Jun 12, 2026 · 10:05 UTC. How this works →