Code Foundations provides software engineering best practices from Code Complete and A Philosophy of Software Design. It helps developers write maintainable, scalable code. It integrates with Claude Code for automated code reviews, refactoring, and architecture planning.
git clone https://github.com/ryanthedev/code-foundations.gitCode Foundations is a Claude plugin that enforces software engineering best practices from Code Complete and A Philosophy of Software Design. It guides developers through a structured workflow: research to clarify requirements, plan to design implementation, and build with mandatory quality gates. Each phase includes automated checklists, architectural reviews, and verification steps that catch issues before commit. The plugin prevents technical debt by loading domain-specific skills during planning and gated execution, ensuring code meets maintainability and scalability standards. It also provides scientific debugging workflows to systematically track down bugs.
Install via marketplace with `/plugin install code-foundations@rtd`. Use `/code-foundations:research` to clarify requirements, `/code-foundations:plan` to design implementation with skill auditing, and `/code-foundations:build` to execute with quality gates. For bugs, use `/code-foundations:debug` with task tracking.
Planning feature implementations with architectural review before coding
Executing multi-phase builds with automated quality gates and peer review
Debugging intermittent failures using predict-log-run-resolve methodology
Clarifying vague requirements through facilitated conversation
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/ryanthedev/code-foundationsCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Review this [CODE_SNIPPET] for adherence to software engineering best practices. Identify any potential issues related to maintainability, scalability, or readability. Suggest specific improvements following the principles from Code Complete and A Philosophy of Software Design. Also, provide a brief explanation for each recommendation.
After reviewing the provided code snippet, here are my observations and recommendations: 1. **Function Length**: The `process_data` function is 120 lines long, which violates the Single Responsibility Principle. Break it down into smaller functions, each handling a specific task. This will improve readability and maintainability. 2. **Parameter List**: The `generate_report` function has 7 parameters. Consider using a configuration object or a builder pattern to reduce the number of parameters and make the function call more readable. 3. **Error Handling**: The code lacks proper error handling. Implement try-catch blocks to handle potential exceptions and provide meaningful error messages. 4. **Code Duplication**: There are several instances of duplicated code in the `validate_data` function. Extract the common logic into a separate function to adhere to the DRY (Don't Repeat Yourself) principle. 5. **Naming Conventions**: Some variable names are not descriptive enough. For example, `data` could be more specific, like `user_data` or `transaction_data`. Descriptive names improve code readability and understanding.
Shopify for Homebuilders
AI assistant built for thoughtful, nuanced conversation
Get more done every day with Microsoft Teams – powered by AI
Automate your spreadsheet tasks with AI power
Agentic AI Workflow platform
Connected workspace for docs, wikis, and projects
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan