A Claude Code skill checks AI-written code structure
The Hacker News poster says an intern used AI tools to build backend services that worked, but had a very messy folder structure. The poster says they made a Claude Code skill called `brooks-lint` based on ideas from classic engineering books such as The Mythical Man-Month. They used it to refactor the project into a clearer structure. The poster asks others to try the skill, find issues, and send pull requests.
Key points
- The post focuses on code that works but has a poor structure after being written with AI tools.
- `brooks-lint` is presented as a Claude Code skill.
- Its rules are based on ideas from classic engineering books such as The Mythical Man-Month.
- The poster says it helped refactor a backend project into a clearer layout.
- The project is open for issues and pull requests from other users.
Quick term guide
- AI tools
- Software that can help create text, code, images, or other work.
- Claude Code skill
- A set of custom instructions added to Claude Code that teaches it to follow a specific workflow or set of rules for a project.
- refactor
- Improving the structure or readability of code without changing what it actually does.
- pull requests
- Requests to review and merge code changes into a project.
- pull request
- A formal way to propose code changes and ask others (or an AI) to review them before they're merged into the main codebase
- Solo makers
- People who build and launch their own products or services entirely on their own.
- AI coding tools
- Programs like Claude, Cursor, or ChatGPT that write code for you when you describe what you want in plain language.
- AI coding tool
- Software that uses AI to help write, edit, or explain code.