Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
59 commits
Select commit Hold shift + click to select a range
25118f5
Add instructions for the use of AI coding tools
samsrabin Oct 27, 2026
b943765
AGENTS.md: Fix case of a path.
samsrabin Oct 28, 2026
d822d27
AGENTS.md: Clarify: Allowed to draft issues/PRs but not touch them.
samsrabin Oct 28, 2026
edb2bc5
AGENTS.md: Prompt human to keep description updated.
samsrabin Oct 28, 2026
f962503
AI disclosure section now consistent throughout repo.
samsrabin Oct 28, 2026
a21691f
AGENTS.md: Clarify "contribute to" in GitHub section.
samsrabin Oct 28, 2026
45d4fe5
AGENTS.md: Don't fetch EVERYTHING linked in CONTRIBUTING.md.
samsrabin Oct 28, 2026
4dfbe59
AGENTS.md: Give example Co-Authored-By.
samsrabin Oct 28, 2026
3fa8461
AGENTS.md: Clarify "The CTSM repo" means ESCOMP's.
samsrabin Oct 28, 2026
63a3f87
AGENTS.md: Finish a sentence
samsrabin Oct 28, 2026
803ab61
AGENTS.md: More clarifications in GitHub section.
samsrabin Oct 28, 2026
7b6708c
Don't allow blank issues; force use of a template.
samsrabin Oct 28, 2026
1b47c4a
CONTRIBUTING.md: Clarify "assisting with a contribution."
samsrabin Oct 28, 2026
e22579d
AGENTS.md: Fix refs to AI disclosure section name.
samsrabin Oct 28, 2026
41ddc3d
GH templates: Add example AI usages
samsrabin Oct 30, 2026
27f5a89
Bug report template: Confirm it's real
samsrabin Oct 30, 2026
4de9ce9
CONTRIBUTING.md: Rework order of AI section
samsrabin Oct 30, 2026
e8f23bf
CONTRIBUTING.md: Require issues first.
samsrabin Oct 30, 2026
d8a8551
AGENTS.md: reword, not amend
samsrabin Oct 30, 2026
91bba3b
AGENTS.md: Require *them* to remove planning docs
samsrabin Oct 30, 2026
5a6d5a3
AGENTS.md: No exceptions to editing issues/PRs.
samsrabin Oct 30, 2026
dd3c065
Add clm-coding-conventions.md.
samsrabin Oct 30, 2026
d9a138e
clm-coding-conventions.md: No numbers > H3.
samsrabin Oct 30, 2026
2c417c8
clm-coding-conventions.md: Remove outdated emails
samsrabin Oct 30, 2026
e8e0bfa
clm-coding-conventions.md: Now orphan
samsrabin Oct 30, 2026
4d69270
clm-coding-conventions.md: Update Fortran feature support list.
samsrabin Oct 30, 2026
3708e93
clm-coding-conventions.md: Remove references to "CMTs".
samsrabin Oct 30, 2026
302b329
clm-coding-conventions.md: Remove reference to Yellowstone.
samsrabin Oct 30, 2026
0708800
clm-coding-conventions.md: Update refs to XML files
samsrabin Oct 30, 2026
17a9905
clm-coding-conventions.md: Make most code blocks fortran.
samsrabin Oct 30, 2026
9ab2ab3
Refer to new coding guidelines page.
samsrabin Oct 30, 2026
acb2d3f
Add bug report issue form.
samsrabin Oct 30, 2026
9dba65a
Add other issue forms.
samsrabin Oct 30, 2026
096ed27
Docs issue form: Add question about docs version.
samsrabin Oct 30, 2026
3826095
Delete GitHub issue templates; use forms instead.
samsrabin Oct 30, 2026
81c2a82
clm-coding-conventions.md: Remove refs to clmtype.
samsrabin Oct 30, 2026
8e39b2c
PR template: Link to new coding conventions webpage.
samsrabin Oct 30, 2026
38b258a
clm-coding-conventions.md: Add link to CLM4.5 refactoring page.
samsrabin Oct 30, 2026
7e367d4
clm-coding-conventions.md: Remove "previous page" ref.
samsrabin Oct 30, 2026
060b3dd
clm-coding-conventions.md: Fix a contradictory .lt.
samsrabin Oct 30, 2026
b7393e4
clm-coding-conventions.md: Remove `== .true` example
samsrabin Oct 30, 2026
37cafd8
AGENTS.md: Try to soften contradiction about refs to plan docs
samsrabin Oct 30, 2026
60c883c
AGENTS.md: Delete a repetitive sentence.
samsrabin Oct 30, 2026
6b6611b
AGENTS.md: Better signal "example" for co-authored-by.
samsrabin Oct 30, 2026
3a91aa4
AGENTS.md: Use rebasing to remove (refs to) planning docs.
samsrabin Oct 30, 2026
951c086
CONTRIBUTING.md: Add links to new issue, discussion pages.
samsrabin Oct 30, 2026
0b07c9d
clm-coding-conventions.md: Fix a reference
samsrabin Oct 30, 2026
60ece91
AGENTS.md: Typo fix
samsrabin Oct 30, 2026
302dd9a
AGENTS.md: Explain what to do if if human asks AI to do GitHub stuff.
samsrabin Oct 31, 2026
fedddf2
AGENTS.md: Add Co-Authored By example for Gemini.
samsrabin Oct 31, 2026
4469ada
CONTRIBUTING.md: Clarify that AI usage example is PR template.
samsrabin Oct 31, 2026
7e24ef5
AGENTS.md: Add instructions for non-interactive rebase.
samsrabin Oct 31, 2026
354a765
CONTRIBUTING.md: Delete a stray colon
samsrabin Oct 31, 2026
80a77dc
AGENTS.md: PRs: Never check boxes on human's behalf.
samsrabin Oct 31, 2026
2b0bce7
CONTRIBUTING.md: Explain checkboxes
samsrabin Oct 31, 2026
f74c5c9
AGENTS.md: Correct email address for Gemini.
samsrabin Oct 31, 2026
7395179
AGENTS.md: Clarify that link for GEMINI emails.
samsrabin Nov 2, 2026
4c43299
AGENTS.md: Add a missing close quote
samsrabin Nov 2, 2026
abe8f45
AGENTS.md: Add Co-Authored-By for ChatGPT
samsrabin Nov 2, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 0 additions & 29 deletions .github/ISSUE_TEMPLATE/01_bug_report.md

This file was deleted.

126 changes: 126 additions & 0 deletions .github/ISSUE_TEMPLATE/01_bug_report.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,126 @@
name: Bug report
description: Report a problem with the code
labels: ["bug"]
type: Bug
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to fill out this bug report!

- type: textarea
id: brief-summary
attributes:
label: Brief summary of bug
description: Give a one or two sentence summary. This could be the same as the issue title if you feel that is a sufficient summary. There will be room to give additional details below.
validations:
required: true

- type: markdown
attributes:
value: |
### General bug information

- type: input
id: version
attributes:
label: CTSM version you are using
description: Output of `git describe`
placeholder: "ctsmX.Y.ZZZ..."
validations:
required: true

- type: dropdown
id: significant-incorrect-science
attributes:
label: Does this bug cause significantly incorrect results in the model's science?
options:
- "Yes"
- "No"
validations:
required: true

- type: textarea
id: configs-affected
attributes:
label: Configurations affected
placeholder: Fill this in if known
validations:
required: false

- type: markdown
attributes:
value: |
### AI disclosure

- type: dropdown
id: was-ai-used
attributes:
label: Was AI used in this contribution?
options:
- "Yes"
- "No"
validations:
required: true

- type: input
id: ai-usage-details
attributes:
label: If you used AI, what did you use it for? (If not, put n/a.)
description: "For example: identifying bug; searching for related issues/PRs; providing minimal working example; drafting issue text"
validations:
required: true

- type: textarea
id: how-confirmed-ai-bug
attributes:
label: If AI discovered this bug, how have you confirmed that it's real? (If not, put n/a.)
description: "Make sure that you as a human being understand the bug! If you don't, we may deprioritize responding to your submission, as we have had numerous instances where an LLM thought something was a bug and it turned out not to be."
validations:
required: true

- type: input
id: ai-provider
attributes:
label: AI provider
placeholder: "E.g., Anthropic"
description: Optional
validations:
required: false

- type: input
id: ai-model
attributes:
label: AI model
placeholder: "E.g., Opus 5.5 high effort"
description: Optional
validations:
required: false

- type: markdown
attributes:
value: |
### Details of bug

- type: textarea
id: additional-detail
attributes:
label: Additional details
validations:
required: false

- type: textarea
id: setup-details
attributes:
label: Important details of your setup / configuration so we can reproduce the bug
description: "Specify anything relevant: the compset, resolution, machine, compiler, any xml or namelist changes, etc. You don't have to repeat anything that you have already noted above."
validations:
required: false

- type: textarea
id: output-or-errors
attributes:
label: Important output or errors that show the problem
description: Fill this in with anything relevant that you haven't already noted.
validations:
required: false
7 changes: 0 additions & 7 deletions .github/ISSUE_TEMPLATE/02_science_discussion.md

This file was deleted.

61 changes: 61 additions & 0 deletions .github/ISSUE_TEMPLATE/02_science_discussion.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
name: Science discussion
description: We encourage the use of issues to discuss CTSM science developments
labels: ["science", "enhancement"]
type: Feature
body:

- type: textarea
id: brief-summary
attributes:
label: Brief summary
description: Give a one or two sentence summary. This could be the same as the issue title if you feel that is a sufficient summary.
validations:
required: true

- type: textarea
id: further-details
attributes:
label: Further details
validations:
required: false

- type: markdown
attributes:
value: |
### AI disclosure

- type: dropdown
id: was-ai-used
attributes:
label: Was AI used in this contribution?
options:
- "Yes"
- "No"
validations:
required: true

- type: input
id: ai-usage-details
attributes:
label: If you used AI, what did you use it for? (If not, put n/a.)
description: "For example: understanding relevant parts of the codebase; outlining possible implementation; drafting issue text"
validations:
required: true

- type: input
id: ai-provider
attributes:
label: AI provider
placeholder: "E.g., Anthropic"
description: Optional
validations:
required: false

- type: input
id: ai-model
attributes:
label: AI model
placeholder: "E.g., Opus 5.5 high effort"
description: Optional
validations:
required: false
24 changes: 0 additions & 24 deletions .github/ISSUE_TEMPLATE/03_documentation.md

This file was deleted.

103 changes: 103 additions & 0 deletions .github/ISSUE_TEMPLATE/03_documentation.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
name: Documentation
description: Something should be added to or fixed in the documentation
labels: ["documentation"]
type: Documentation
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to fill out this issue! If you're planning to eventually contribute a change, please see our [contribution guidelines for documentation](https://escomp.github.io/CTSM/users_guide/working-with-documentation/docs-intro.html#contribution-guidelines).

- type: checkboxes
id: docs-issue-type
attributes:
label: What sort(s) of documentation issue is this?
description: You may select more than one.
options:
- label: Something is missing.
- label: Something is (or might be) incorrect or outdated.
- label: Something is confusing.
- label: Something is broken.

- type: checkboxes
id: docs-location
attributes:
label: What part(s) of the documentation does this concern?
description: You may select more than one.
options:
- label: '[Technical Note](https://escomp.github.io/CTSM/tech_note/index.html) (science and design of the model)'
- label: "[User's Guide](https://escomp.github.io/CTSM/users_guide/index.html) (using the model and related tools)"
- label: "Somewhere else (e.g., README file, tool help text, or code comment)"
- label: "I don't know"

- type: input
id: somewhere-else
attributes:
label: If "somewhere else," where?
validations:
required: false

- type: input
id: docs-version
attributes:
label: If in Technical Note and/or User's Guide, what version(s)?
description: See "Version:" menu in bottom left of documentation webpage
validations:
required: false

- type: textarea
id: describe-the-issue
attributes:
label: Describe the issue
description: A clear and concise description of what is missing or wrong.
validations:
required: true

- type: textarea
id: additional-context
attributes:
label: Additional context
description: Add any other context or screenshots about the issue here.
validations:
required: false

- type: markdown
attributes:
value: |
### AI disclosure

- type: dropdown
id: was-ai-used
attributes:
label: Was AI used in this contribution?
options:
- "Yes"
- "No"
validations:
required: true

- type: input
id: ai-usage-details
attributes:
label: If you used AI, what did you use it for? (If not, put n/a.)
description: "For example: understanding relevant parts of the codebase and/or documentation; drafting suggested documentation changes; drafting issue text"
validations:
required: true

- type: input
id: ai-provider
attributes:
label: AI provider
placeholder: "E.g., Anthropic"
description: Optional
validations:
required: false

- type: input
id: ai-model
attributes:
label: AI model
placeholder: "E.g., Opus 5.5 high effort"
description: Optional
validations:
required: false
7 changes: 0 additions & 7 deletions .github/ISSUE_TEMPLATE/04_other.md

This file was deleted.

Loading
Loading