Analyze Codebase for Improvements

Input Parameters

Parameter	Required	Description	Example
`project_path`	Yes	Path to the root directory of the project or codebase to analyze	~/Code/GitHub/phpbot
`focus_areas`	No	Comma-separated list of specific areas to prioritize	performance, error-handling, documentation
`project_type`	No	Type of project for context-aware recommendations	PHP application

Procedure

Confirm the project path, scope, and priority areas with the user if not provided

Examine directory layout, file counts, and key components:

ls -la {{PROJECT_PATH}}
find {{PROJECT_PATH}}/src -name "*.{{EXTENSION}}" | wc -l
grep -r "TODO\|FIXME\|HACK" {{PROJECT_PATH}}/src 2>/dev/null | head -20

Review README, configuration files, and recent changes to identify architectural pain points
Generate 8–12 actionable improvements organized by impact and effort — each with a problem statement, proposed solution, and expected benefit
Rank by value-to-effort ratio; surface quick wins first, then strategic long-term enhancements
Deliver as structured markdown with code examples and implementation steps where relevant

Notes

Each improvement must have a clear problem statement to justify the recommendation
Consider the project's current maturity level and team capacity when scoping changes

Example

what are 10 things I could do to improve this codebase
audit this project and suggest architectural improvements
identify technical debt and quick wins in this repo
review code quality and suggest optimizations
what are the biggest bottlenecks in this codebase

analyze-codebase-for-improvements

Analyze Codebase for Improvements

Input Parameters

Procedure

Notes

Example