What agents should know before contributing
python-poetry/poetry
Python packaging and dependency management made easy
Read by Bluet from 6 files written for agents and 300 merged pull requests on 2026-09-25. Not reviewed by the maintainers.
Rules its files tell agents (4)
- docs/cli.md
shouldThey do not limit resolution of the lock file: poetry.lock keeps one consistent solution for all declared grou…
{{% note %}} The group options determine which dependency groups are installed or synchronized in the environment. They do not limit resolution of the lock file: poetry.lock keeps one consistent solution for all declared groups, so packages that belong to an excluded group can still change. To restrict which packages Poetry updates, pass their names to the command. {{% /note %}}
- docs/_index.md
shouldIf completions still don't work, try removing ~/.cache/prezto/zcompcache and starting a new shell.
- docs/basic-usage.md
shouldIf your library's poetry.lock falls behind some new dependency version that breaks things for your users, you'…
The application ignores your library's lock file. It can use whatever dependency version meets the constraints in your pyproject.toml. The application will probably use the latest compatible dependency version. If your library's poetry.lock falls behind some new dependency version that breaks things for your users, you're likely to be the last to find out about it.
- docs/basic-usage.md
shouldIf you do not want to give up the reproducibility and performance benefits, consider a regular refresh of poet…
If you do not want to give up the reproducibility and performance benefits, consider a regular refresh of poetry.lock to stay up-to-date and reduce the risk of sudden breakage for users.