Skip to content

Add the AGENTS.md - #2092

Open
eap wants to merge 6 commits into
JCSDA:developfrom
eap:feature/agentsmd
Open

eap wants to merge 6 commits into
JCSDA:developfrom
eap:feature/agentsmd

Conversation

@eap

@eap eap commented Aug 18, 2026 •

Copy link
Copy Markdown
Collaborator

Add an AGENTS.md file. This file sets ground rules for how agents interact with spack-stack and gives documentation pointers and agent-specific instructions.

This file was primarily generated by claude using notes from a long-running install and debug session.

Motivations

  • Constrain unwanted agent behaviors; no autonomous pull requests, tool attributions, destructive behavior.
  • Give agents advice on common tasks; install, debug, site updates.
  • Agent-specific advice on managing spack commands; executing and following commands with overwhelming output or long runtimes like concretize and install

Comment thread AGENTS.md Resolved
@mathomp4

mathomp4 commented Aug 18, 2026 •

Copy link
Copy Markdown
Collaborator

Might be interesting to look at mom-ocean/MOM6#1699

In that @adcroft made a sort of symlink or reference nest of various markdown files to support a few different agents (CLAUDE.md, AGENTS.md, .github/copilot-instructions.md, etc.).

This might not be needed anymore?

@climbfuji climbfuji left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

A few minor comments and corrections, other than that I am fine with merging this and making incremental changes as we go.

Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Resolved
- Put the temporary AI policy (JCSDA#2196) from develop at the top, verbatim
- Already-loaded modules no longer raise ModuleLoadError (spack 4d949958df);
  rewrite sharp edge 5.1 and its symptom-table row, drop module purge advice
- Externals need prefix: or modules:, not prefix: only
- Use spack build-env <spec> -- bash --norc --noprofile
- Fix drift: --compiler naming, cache paths, removed check_libirc.sh,
  stale frontera HPC example -> derecho
@eap
eap marked this pull request as ready for review November 10, 2026 23:07
@eap
eap requested review from climbfuji and mathomp4 November 10, 2026 23:12
Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Outdated

**1. External `modules:` fail late** — any site whose externals use `modules:`
(all HPC, plus admin sites with vendor toolchains). Spack judges a module load
by whether `$LOADEDMODULES` *changed*, not by exit status. Already-loaded

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I think this is no longer true (bug fix by @mathomp4 upstream that we pulled down)? The language confuses me.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Yes. This sounds like the fix we pulled in to 2.2

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

reworded.

Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Outdated
## 7. New releases (drift reconciliation)

Wiki: the per-release `Release-x.y.z` page (e.g.
[Release 2.1.1](https://github.com/JCSDA/spack-stack/wiki/Release-2.1.1)) and its `post-release-updates` companion.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

update to 2.2.0

@eap eap left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

PTAL

Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Outdated

**1. External `modules:` fail late** — any site whose externals use `modules:`
(all HPC, plus admin sites with vendor toolchains). Spack judges a module load
by whether `$LOADEDMODULES` *changed*, not by exit status. Already-loaded

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

reworded.

Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Resolved
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.

4 participants