Add AGENTS.md

[Copilot]

Agents working on this repo have missed key functional details and have a tendency to over-restructure code. AGENTS.md captures the patterns and constraints that matter most.

What's documented

• Templated design constraint — customization is config.yaml-only; code structure should not be restructured beyond what a specific fix requires
• Hugging Face API specifics
  • List vs. detail URL patterns for datasets, models, spaces
  • Model browser-link format: huggingface.co/{owner}/{repo} (no /models/ prefix)
  • cardData is not returned by the bulk models list — each model requires a secondary per-model fetch to get model_name, model_description, tags, etc.
  • cardData key shape differs by resource type (pretty_name / model_name / title)
• Testing scope — tests validate utility logic in src/; they only need to run on code changes, not on site operation
• Quick reference — repo layout, config fields, build/dev commands, CI workflows

[EmersonFras]

Looks good, left one note about the hardcoded Node version and response to the suggested change but everything else I think is well structured.

[egrace479]

Looks good, left one note about the hardcoded Node version and response to the suggested change but everything else I think is well structured.

@EmersonFras, I don't see a response at the suggested change.

[hlapp]

See inline suggestions and comments.

[hlapp]

Suggested change

This is a **template repository** for a web-based catalog of an organization's public code, datasets, models, and spaces. It fetches live data from the GitHub API and the Hugging Face API and renders a searchable, filterable catalog page as a static site via GitHub Pages. The default setup is for the Imageomics Organization's GitHub and Hugging Face products, and this Imageomics Catalog is live.

This is a **template repository** for a web-based catalog of an organization's public code, datasets, models, and spaces. It fetches live data from the code repository platform (such as GitHub) API and the platform API for hosting datasets and models (Hugging Face) and renders a searchable, filterable catalog page as a static site via GitHub Pages. The default setup is for the Imageomics Organization's GitHub and Hugging Face products, and this Imageomics Catalog is live.

[hlapp]

Was the live or this Imageomics Catalog meant to be linked to the live site? Also, note that in a fork this wording won't work well. Maybe more like this: The default setup is for the Imageomics Organization's GitHub and Hugging Face products. (I.e., it's not clear what the reference to the live site would add to the coding agent's ability to work better.)

[egrace479]

I was thinking it should know that it is in fact run off this repository, but perhaps leaving the default setup information is sufficient since the deploy workflow is described later.