thoughtbot / guides
A guide for programming in style.
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing thoughtbot/guides in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Embed this Badge
Showcase RepoMind's analysis directly in your repository's README.
Repository Summary (README)
PreviewGuides
Guides for working together, getting things done, programming well, and programming in style.
High level guidelines
- Be consistent.
- Don't rewrite existing code to follow this guide.
- Don't violate a guideline without a good reason.
- A reason is good when you can convince a teammate.
A note on the language
- "Avoid" means don't do it unless you have good reason.
- "Don't" means there's never a good reason.
- "Prefer" indicates a better option and its alternative to watch out for.
- "Use" is a positive instruction.
Guides by category
Collaboration
Protocols
Languages
Frameworks and platforms
Tools
Contributing
Please read the contribution guidelines before submitting a pull request.
In particular: if you have commit access, please don't merge changes without waiting a week for everybody to leave feedback.
Credits
Thank you, contributors!
License
Guides is © 2020-2025 thoughtbot, inc. It is distributed under the Creative Commons Attribution License.
<!-- START /templates/footer.md -->About thoughtbot
This repo is maintained and funded by thoughtbot, inc. The names and logos for thoughtbot are trademarks of thoughtbot, inc.
We love open source software! See our other projects. We are available for hire.
<!-- END /templates/footer.md -->