First off, thank you for considering contributing to CC CLAUDE.md Flow! 🎉
This project follows a simple philosophy: Brutal honesty and practical solutions over theoretical perfection.
Found a bug or have a suggestion?
- Check existing issues first to avoid duplicates
- Create a new issue with:
- Clear title describing the problem
- Steps to reproduce (for bugs)
- Expected vs actual behavior
- Your environment details (OS, Claude Code version, etc.)
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes
- Test thoroughly - all profiles should work
- Commit with clear messages (
git commit -m 'Add: New workflow pattern for X') - Push to your fork (
git push origin feature/amazing-feature) - Open a Pull Request
- One feature per PR - keep it focused
- Update documentation if needed
- Test all profiles before submitting
- Be brutally honest in your PR description
- Use consistent formatting
- Keep line length reasonable (80-120 chars)
- Use meaningful headers
- Include practical examples
- Comment your code (in language of the code)
- Use descriptive variable names
- Handle errors gracefully
- Test on both WSL and native Linux
Want to add a new specialized profile?
- Follow the existing pattern - study current profiles
- Define clear purpose - what problem does it solve?
- Include autonomous switching logic
- Add documentation and examples
- Update profile switching scripts
We welcome translations!
- Create a new branch for your language
- Translate documentation (keep code/commands in English)
- Maintain the original tone and philosophy
- Submit PR with
[LANG]prefix (e.g.,[SK] Add Slovak translation)
- Be respectful - we're all here to learn
- Be helpful - share your knowledge
- Be practical - focus on what works
- Be honest - if something doesn't work, say it
- Open an issue with
[Question]prefix - Join our discussions in the Issues section
- Check existing documentation first
Contributors will be added to our Contributors List with:
- GitHub handle
- Contribution type (code, docs, ideas, etc.)
- Number of contributions
Remember: The best contribution is one that helps someone solve a real problem.
Thank you for making CC CLAUDE.md Flow better! 🚀