🤖 AGENTS.md

[tpvasconcelos]

References

• https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals
• https://github.blog/ai-and-ml/github-copilot/how-to-write-a-great-agents-md-lessons-from-over-2500-repositories/
• https://agentskills.io/home
• https://vercel.com/blog/agent-skills-explained-an-faq
• https://vercel.com/blog/agent-skills-explained-an-faq
• https://cursor.com/docs/context/skills
• https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
• https://github.com/openai/skills/blob/main/skills/.system/skill-creator/SKILL.md

---

This pull request introduces new documentation and configuration files to support AI-assisted development and clarify project workflows, along with small improvements to the Makefile and project environment setup. The most significant changes are the addition of an AI agent development guide, rules for Python version support, and enhancements to developer tooling and documentation.

AI Agent and Developer Documentation:

• Added a comprehensive AGENTS.md file that serves as a development guide for AI agents, outlining project structure, stack constraints, workflow expectations, and key commands for setup, testing, and linting.
• Added a CLAUDE.md file referencing AGENTS.md, likely to assist specific AI agents or workflows.

AI/Automation Tooling and Rules:

• Introduced .codex/environments/environment.toml for automated environment setup, including scripts for initializing the repository and running tests.
• Added .cursor/rules/dropping-and-or-adding-support-for-python-versions/RULES.md, documenting the process for updating supported Python versions in line with official policies.
• Updated .cursor/worktrees.json to activate the virtual environment after initialization, improving the developer onboarding experience.

Build and Packaging Improvements:

• Made small improvements to the Makefile, including dependency installation tweaks and improved virtual environment creation. [1] [2] [3]

Documentation and Packaging Configuration:

• Updated MANIFEST.in to include .codex and .cursor files in package distributions, ensuring new configuration and rule files are available in packaged releases.
• Updated the changelog to reflect the addition of AI helper files and Makefile improvements.

---

📚 Documentation preview 📚: https://ridgeplot--367.org.readthedocs.build/en/367/

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (2eaff20) to head (aaf87aa).
⚠️ Report is 12 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #367   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           18        18           
  Lines          657       657           
  Branches        85        85           
=========================================
  Hits           657       657           

Flag	Coverage Δ
combined-src	100.00% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[tpvasconcelos]

@codex review

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. Chef's kiss.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".