BluetOpen source

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)

  • 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/cli.md
  • shouldIf completions still don't work, try removing ~/.cache/prezto/zcompcache and starting a new shell.
    docs/_index.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.

    docs/basic-usage.md

Decisions its pull requests settled (5)

  • #10621consider dependency-groups in lockfile hash
  • #10696env activate: fallback to POSIX compatible builtin
  • #10824Add support for deferred updates / minimum release age
  • #10845support periods in repository names
  • #11003pick the env-compatible version for duplicated lock entries
Your agents can be told this before they touch the code. Get it for your repository: npx bluet-mcp init. What Bluet is.
python-poetry/poetry: what agents should know before contributing · Bluet