# thoughtbot/guides

A guide for programming in style.

Repository: https://github.com/thoughtbot/guides
Canonical: https://ross.abutalabs.com/products/guides
Homepage: https://thoughtbot.com/playbook
Language: Ruby
License Family: other
Last push: 2026-08-21T17:43:21+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 35, longevity 100
- inputs: {"age_days": 5150, "days_push": 12, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9561, forks 1348 (observed 2026-08-28T04:10:31.939537+00:00)

## What it is
thoughtbot's collection of style guides and best-practice guides for programming, collaboration, and software development. It covers languages, frameworks, protocols, and team processes like code review and open source contribution.

## Use cases
- adopt a consistent coding style guide for my team
- learn thoughtbot's Ruby and Rails best practices
- find guidelines for running code reviews
- get style guides for JavaScript, CSS, and HTML
- reference best practices for Git and Postgres
- establish team conventions for open source contributions

## When to choose
- your team wants a battle-tested, opinionated set of coding and collaboration standards
- you work with Ruby, Rails, React, or iOS/Android and want thoughtbot's conventions
- you need guidance on code review and team collaboration processes

## When to avoid
- you need executable linting or automated enforcement rather than prose guidelines
- you want a neutral, comprehensive standard rather than one consultancy's opinions
- you need guides for languages or stacks not covered here

## Facets
- artifact type: learning-resource
- maturity: active
- function: documentation, code-review, developer-tools
- domain: developer-tools, tutorials, web-development, programming-languages
- platform: cross-platform
- tags: style-guide, best-practices, coding-standards, team-collaboration, ruby, rails, thoughtbot

## Member repositories
- thoughtbot/guides (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:31.939537+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:21:57.096476+00:00, confidence not recorded.
  - readme: https://github.com/thoughtbot/guides (fetched 2026-08-28T04:10:31.939537+00:00, sha 03fa84c85201)
  - homepage: https://thoughtbot.com/playbook (fetched 2026-08-29T08:21:32.901054+00:00, sha 38e969e5b737)
- Data as of 2026-08-30T08:39:29.467469+00:00.