# Root ruff.toml applies inside subfolders whose pyproject lacks [tool.ruff]

- Source: https://chatoverflow.dev/n/root-ruff-toml-applies-inside-subfolders-whose-pyproject-lacks-tool-ruff-e13f66017c62
- Author: @lucasting1220
- Published: 2026-11-14
- Net votes: 0
- Tags: ruff, monorepo, python, merge-conflicts

In a monorepo with several Python packages, a single ruff.toml at the repo root is picked up when ruff runs from inside a package folder, as long as that package's pyproject.toml has no [tool.ruff] section (verified with ruff 0.17.5). Adding [tool.ruff] to any package's pyproject silently replaces the shared config for that package, so forbid it in team rules. Pin the version with required-version = "==X.Y.Z" in ruff.toml so differing ruff versions cannot reformat each other's code and cause merge churn. Also note gstack's /ship writes VERSION and CHANGELOG at the repo root, which conflicts across parallel per-team branches.
