brooks-lint
Review code, architecture, technical debt, and tests through checks grounded in twelve classic software-engineering books, with cited findings and severity labels.
Project overview
Review code, architecture, technical debt, and tests through checks grounded in twelve classic software-engineering books, with cited findings and severity labels.
Core capabilities
Review code-decay risks
Review code-decay risks. This capability is documented in the repository README and still requires verification against the target DSH version and profile.
Analyze architecture and technical debt
Analyze architecture and technical debt. This capability is documented in the repository README and still requires verification against the target DSH version and profile.
Inspect tests and maintainability
Inspect tests and maintainability. This capability is documented in the repository README and still requires verification against the target DSH version and profile.
Produce findings with book citations and severity levels
Produce findings with book citations and severity levels. This capability is documented in the repository README and still requires verification against the target DSH version and profile.
Installation and usage
Install the DSH Skill pack, reload the target environment as documented, and verify it with a low-risk scenario.
Let an AI Agent install it
Send this prompt to Codex, Claude Code, or another AI agent that can work with your local environment.
Help me install brooks-lint from https://github.com/hyhmrright/brooks-lint. Read the README, license, and installation files first. Confirm the current DeepSeek Harness version, target profile, and required dependencies. Use the repository's current command `curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- dsh`. Explain the profile, paths, and permissions that will change before running it. Follow the repository verification steps and report commands, changed locations, and visible results. Ask before requesting credentials, enabling extra network access or build scripts, overwriting files, or expanding permissions.- DeepSeek Harness has Agent Skills discovery enabled
- Bash and curl are available
- A test repository that can be reviewed read-only
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- dsh- 1Check the environment and target profile
DeepSeek Harness has Agent Skills discovery enabled; Bash and curl are available; A test repository that can be reviewed read-only. Record the current configuration and installed plugins before changing anything.
- 2Run the current repository command
Run the following command. `curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- dsh` Stop and ask before enabling build scripts, providing credentials, or overwriting files.
- 3Reload and verify
Start a read-only code review in DSH, confirm that the brooks-lint Skills are discovered, and inspect the report for risk identifiers, sources, and recommendations.
Start a read-only code review in DSH, confirm that the brooks-lint Skills are discovered, and inspect the report for risk identifiers, sources, and recommendations.
- It is a Skill pack rather than a Cordis Bundle
- Model quality still affects finding quality
- Auto-fix requires human review for false positives and design trade-offs
Use cases
Run read-only reviews before merge
Start with a minimal brooks-lint scope in this scenario, then expand only after checking output, permissions, and compatibility.
Map technical debt in legacy systems
Start with a minimal brooks-lint scope in this scenario, then expand only after checking output, permissions, and compatibility.
Turn findings into a team review checklist
Start with a minimal brooks-lint scope in this scenario, then expand only after checking output, permissions, and compatibility.
Assessment
This assessment is based on the repository README, installation instructions, license, and maintenance metadata. Uses an explicitly sourced review framework; Covers code, architecture, tests, and technical debt; Can start in a read-only review mode. It is a Skill pack rather than a Cordis Bundle; Model quality still affects finding quality; Auto-fix requires human review for false positives and design trade-offs. No local installation or long-term use is claimed.
Why it may be useful
- Uses an explicitly sourced review framework
- Covers code, architecture, tests, and technical debt
- Can start in a read-only review mode
What to know first
- It is a Skill pack rather than a Cordis Bundle
- Model quality still affects finding quality
- Auto-fix requires human review for false positives and design trade-offs
README
brooks-lint
Overview
Review code, architecture, technical debt, and tests through checks grounded in twelve classic software-engineering books, with cited findings and severity labels. Review code, architecture, technical debt, and tests through checks grounded in twelve classic software-engineering books, with cited findings and severity labels.
Getting started
- Install the DSH Skill pack, reload the target environment as documented, and verify it with a low-risk scenario.
- Review code, architecture, technical debt, and tests through checks grounded in twelve classic software-engineering books, with cited findings and severity labels.
- The repository documents these main capabilities: Review code-decay risks, Analyze architecture and technical debt, Inspect tests and maintainability, Produce findings with book citations and severity levels.
- Start a read-only code review in DSH, confirm that the brooks-lint Skills are discovered, and inspect the report for risk identifiers, sources, and recommendations.
Configuration
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- dsh