Skip to content

Commit d8280c1

Browse files
committed
Update agent skills
Signed-off-by: Tomas Pereira de Vasconcelos <tomasvasconcelos1@gmail.com>
1 parent 948e653 commit d8280c1

4 files changed

Lines changed: 35 additions & 36 deletions

File tree

.cursor/rules/dropping-and-or-adding-support-for-python-versions/RULES.md

Lines changed: 0 additions & 32 deletions
This file was deleted.

AGENTS.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -210,11 +210,10 @@ def _coerce_to_densities(...):
210210
- Run targeted tests via: `tox -e pytest -- tests/unit/test_foo.py -k "test_bar" --no-cov`
211211
- The `tests/e2e/artifacts/` directory contains expected Plotly Figure JSON for e2e tests
212212

213-
## .cursor Rules
213+
## Agent Skills
214214

215-
Check `.cursor/rules` before changing platform or version support. The only
216-
current rule is for adding or dropping Python versions at
217-
`.cursor/rules/dropping-and-or-adding-support-for-python-versions/RULES.md`.
215+
Agent skills live under `skills/`. For Python version support changes, follow
216+
`skills/dropping-and-or-adding-support-for-python-versions/SKILL.md`.
218217

219218
## CI/CD Pipeline
220219

MANIFEST.in

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,7 @@ recursive-include .github *.yml *.yaml
3939
recursive-include cicd_utils README.md *.py *.sh
4040
recursive-include misc *.py *.ipynb *.txt *.png
4141
recursive-include requirements *.txt
42+
recursive-include skills *.md
4243
recursive-include tests *.py
4344
recursive-include tests/e2e/artifacts *.json
4445

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
name: dropping-and-or-adding-support-for-python-versions
3+
description: Update supported Python versions across CI, configs, and docs in line with the official Python support policy. Use when adding or dropping Python version support.
4+
---
5+
This project follows the official Python support policy: https://devguide.python.org/versions/
6+
7+
When adding support for a new Python version
8+
1. Update `.github/workflows/ci.yml` at `jobs.software-tests.strategy.matrix.python-version`.
9+
2. Update `pyproject.toml` at `project.classifiers`.
10+
3. Update `docs/reference/changelog.md` at the top of "Unreleased changes" with:
11+
"Add support for Python 3.XX, in accordance with the official Python support policy[^1] ({gh-pr}`XXX`)".
12+
13+
When dropping support for an end-of-life Python version
14+
1. Remove it from the CI pipeline and update the entries listed below.
15+
2. Update `docs/reference/changelog.md` under an "Unreleased changes" -> "Breaking changes" section with:
16+
"Dropped support for Python 3.XX, in accordance with the official Python support policy[^1] ({gh-pr}`XXX`)".
17+
18+
Files to update when dropping support for a Python version
19+
- `.github/workflows/ci.yml`: `jobs.software-tests.strategy.matrix.python-version`,
20+
`jobs.static-checks.steps.with.python-version`.
21+
- `.github/workflows/release.yml`: `jobs.build.steps.with.python-version`,
22+
`jobs.github-release.steps.with.python-version`.
23+
- `.pre-commit-config.yaml`: `default_language_version.python`.
24+
- `.readthedocs.yml`: `build.tools.python`.
25+
- `AGENTS.md`: wherever relevant.
26+
- `docs/development/contributing.md`: wherever relevant.
27+
- `Makefile`: `BASE_PYTHON`.
28+
- `mypy.ini`: `python_version`.
29+
- `pyproject.toml`: `project.classifiers`, `project.requires-python`.
30+
- `pyrightconfig.json`: `pythonVersion`.
31+
- `ruff.toml`: `target-version`.

0 commit comments

Comments
 (0)