Show HN: Brooks-Lint – AI code reviews grounded in 12 classic engineering books

Show HN (score: 5)
Found: June 11, 2026
ID: 5107

Description

Show HN: Brooks-Lint – AI code reviews grounded in 12 classic engineering books I once managed a small team and hired an intern to develop the backend services for a software system. He used AI tools to write the entire project; while it ran correctly and produced the right results, the directory structure was atrocious upon review. Typically, a FastAPI service is organized into components like routers and services, but he had created an unnecessarily deep, multi-layered structure within the service layer—logic that should have simply been split across two or three files. The code lacked elegance. Recalling concepts from books on software project management, code structure, and architecture—such as The Mythical Man-Month—I decided to codify these architectural principles into a reusable "skill" to optimize my project's structure. I used Claude Code to create a skill called `brooks-lint` and employed it to refactor the project, resulting in a much clearer and more logical architecture. I encourage everyone to use this skill, identify issues, submit pull requests, and collaborate on improvements, thereby benefiting the projects you are currently developing.

More from Show

Show HN: iMessage is the best interface, so I built TypeScript SDK for it

Show HN: iMessage is the best interface, so I built TypeScript SDK for it I was building my personal agent, but I had to use Telegram, as it was the easiest platform to integrate. I wanted to build the harness and agent, not the infrastructure around these two, yet my UX was struggling. I stick to iMessage, and then I had to use another app to interact with my agent...<p>So I spent a weekend on building a TypeScript SDK, that unifies how to interact with different iMessage providers (as there is no official way to use iMessage), so you can play around with them, without having to commit to one, nor with a need to rewrite half of the codebase to change the integration.<p>It&#x27;s open-source, you can check the repo here: <a href="https:&#x2F;&#x2F;imessage-sdk.dev&#x2F;" rel="nofollow">https:&#x2F;&#x2F;imessage-sdk.dev&#x2F;</a>

No other tools from this source yet.