add agents files

[ggmarshall]

Done by claude code

[Copilot]

Pull request overview

Adds an AGENTS.md agent/developer reference document that summarizes the repository layout, key pipeline concepts (tiers, file keys/patterns, parameter catalogs), and common dev workflows (deps, style, pre-commit, tests, docs).

Changes:

• Introduces AGENTS.md with a high-level overview of the dataflow pipeline and repo structure.
• Documents tier naming/targets, parameter catalog concepts, and common development commands (ruff, pre-commit, pytest, Sphinx).
• Provides guidance for extending the pipeline (new processors, scripts, tiers, execution environments).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 62.23%. Comparing base (ea2097a) to head (830d8b8).
⚠️ Report is 7 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #151   +/-   ##
=======================================
  Coverage   62.23%   62.23%           
=======================================
  Files           7        7           
  Lines         662      662           
=======================================
  Hits          412      412           
  Misses        250      250           

☔ View full report in Codecov by Harness.
📢 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.

[gipert]

this seems quite useless to me, unfortunately this is what you get when asking claude

we need to fill it in with some truly useful context for the ai

[ggmarshall]

Reading about this more, I think we want several files in the repo, one in docs, one in workflow, one in tests and one top level one

[gipert]

yes definitely, let's start filling in and then we can see how to organise

i think we also need somehow to add some context about what is the legend data and what to expect from the input data to the various processors. this is something that is not easily deducible from the code