Skip to content

docs: add AGENTS.md for coding agents - #46

Merged
AzulGarza merged 2 commits into
mainfrom
docs/agents-md
Oct 8, 2026
Merged

AzulGarza merged 2 commits into
mainfrom
docs/agents-md

Conversation

@AzulGarza

Copy link
Copy Markdown
Member

Summary

  • Add root AGENTS.md with conventional commits, release steps (chore(release): vX.Y.Z + gh release create), and CI overview.
  • Document the cross-model testing contract: new features extend tests/models/test_models.py for all conftest.py models; new models join that list.

Test plan

  • Documentation-only change (no code paths affected)

Made with Cursor

Document release flow, CI expectations, and cross-model test_models contract.

Co-authored-by: Cursor <cursoragent@cursor.com>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

AGENTS.md contains inaccurate or inconsistent workflow and testing documentation that should be corrected.

Review effort: Lite
Findings: 1 Low severity

Open (1)
What changed in this PR

Adds a root AGENTS.md documenting repository conventions, releases, CI, and cross-model testing.

Changes:

  • Documents Conventional Commits and release workflow.
  • Summarizes CI and local testing.
  • Defines cross-model testing expectations.
File Review findings
AGENTS.md Four nit findings: clarify pre-commit scope (1 vote), correct make verify-ci commands (3 votes), fix the exog-test path (1 vote), and reconcile model test-marking guidance (1 vote).

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread AGENTS.md
| **test-docs** | Executable markdown in `docs/` (except changelog files), `README.md`, and Python docstrings via `mktestdocs`. |
| **build-docs** | `mkdocs build` |
| **lint** | Full `pre-commit` (ruff, mypy on `foundationforecast/` only—`experiments/` excluded) |
| **test-gift-eval** | Modal GPU run for [`configs/ci_subset.yaml`](experiments/gift-eval/configs/ci_subset.yaml), then `make verify-ci` (S3 sync + strict per-job MASE/CRPS vs Hugging Face references). |

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dependes on #45.

@codspeed

codspeed Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

Merging this PR will not alter performance

✅ 17 untouched benchmarks


Comparing docs/agents-md (15f1d80) with main (356d2ba)

Open in CodSpeed

Co-authored-by: Cursor <cursoragent@cursor.com>
@codecov

codecov Bot commented Oct 6, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@AzulGarza
AzulGarza merged commit 117d223 into main Oct 8, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants