AGENTS

This repository powers the Open Modeling Foundation science gateway, implemented with Hugo and Docsy, and published on GitHub Pages.

This document is the canonical source of truth for agent behavior in this repository.

For a contributor-facing overview, see the Agent Harness section in README.md.

Scope and precedence

This file defines the shared operating contract for all AI agents.
If guidance in .github/copilot-instructions.md or CLAUDE.md differs, follow this file.
README.md provides contributor-facing context; this file remains authoritative for agent behavior.
Agent-specific files should provide adapter notes only and link back here.

Agent-generated artifacts must be written under .agent/.

Run project commands in containers only; do not assume local go, hugo, node, or npm are installed on the host.
Use Docker Compose with the hugo service for build/test/update tasks (for example: docker compose run --rm --no-deps --entrypoint sh hugo -c '<command>').
Prefer the shared Hugo production build entrypoint .github/scripts/build-site.sh for render operations used by CI and local production-style checks.
Use make render for the local production-style render path and make serve for local hot-reload preview.
If a command cannot run in the current container setup, document the limitation and propose a container-based alternative.