global-conventions
Follow consistent project structure, version control practices, environment configuration, code review processes, and development conventions across the entire application. Use this skill when organizing project files and directories, when writing commit messages or creating pull requests, when managing environment variables and configuration, when participating in code reviews, when defining testing requirements, when using feature flags, when maintaining changelogs, when documenting setup instructions, or when establishing consistent development practices across the team.
When & Why to Use This Skill
The Global Conventions skill is designed to enforce architectural integrity and standardized development workflows across software projects. It ensures that Claude adheres to specific project structures, version control best practices, and environment configurations, significantly reducing technical debt and improving team collaboration through consistent coding standards and documentation practices.
Use Cases
- Project Restructuring: Automatically organizing or refactoring directory layouts to align with industry-standard architectural patterns.
- Standardized Version Control: Generating consistent commit messages, branch names, and pull request descriptions that follow team-defined naming conventions.
- Environment Management: Managing complex environment variables and configuration files to ensure consistency across local, staging, and production environments.
- Automated Documentation Maintenance: Keeping README files, changelogs, and contribution guidelines up-to-date as the codebase evolves.
- Code Review Alignment: Ensuring all code contributions and reviews strictly adhere to the team's established testing requirements and style guides.
- Feature Flag Implementation: Managing the lifecycle of experimental features using consistent feature flagging patterns to maintain main-branch stability.
| name | Global Conventions |
|---|---|
| description | Follow consistent project structure, version control practices, environment configuration, code review processes, and development conventions across the entire application. Use this skill when organizing project files and directories, when writing commit messages or creating pull requests, when managing environment variables and configuration, when participating in code reviews, when defining testing requirements, when using feature flags, when maintaining changelogs, when documenting setup instructions, or when establishing consistent development practices across the team. |
Global Conventions
This Skill provides Claude Code with specific guidance on how to adhere to coding standards as they relate to how it should handle global conventions.
When to use this skill
- When organizing or restructuring project files and directories
- When writing commit messages, creating branches, or making pull requests
- When managing environment variables and configuration files
- When documenting features in README files or architecture documentation
- When participating in code reviews as reviewer or author
- When defining or following testing requirements before merging
- When implementing feature flags for incomplete or experimental features
- When maintaining changelog or release notes
- When managing project dependencies and documenting why they're used
- When setting up or updating contribution guidelines
- When ensuring consistent practices across the development team
- When making decisions about long-lived branches vs. feature flags
Instructions
For details, refer to the information provided in this file: global conventions