Update contribution templates and user guidance

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,90 @@
+name: Bug report
+description: Report something that is incorrect or broken
+type: "bug"
+labels: ["bug"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for helping improve EAGLE.
+
+        Before opening a bug report, please search the existing issues to check whether the problem has already been reported.
+        Enhancement requests should be opened as an Enhancement Discussion instead of an issue.
+
+  - type: textarea
+    id: current_behavior
+    attributes:
+      label: What is wrong?
+      description: Describe the incorrect or broken behavior.
+      placeholder: Include short log snippets here. For long logs, create a GitHub gist and link it.
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_behavior
+    attributes:
+      label: What should have happened?
+      description: Describe the behavior you expected.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area affected
+      multiple: true
+      options:
+        - Data prep / UFS2ARCO
+        - Training
+        - Inference
+        - Verification / WXVX
+        - Visualization / plotting
+        - Configuration
+        - Documentation
+        - CI/CD or tooling
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: system
+    attributes:
+      label: System or environment
+      multiple: true
+      options:
+        - Ursa
+        - Cloud
+        - Local workstation
+        - Other HPC
+        - Unknown / not applicable
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: EAGLE version, branch, or commit
+      placeholder: main, v1.1.0, or a commit SHA
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction_steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide enough detail for another developer to reproduce the problem.
+      placeholder: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional context
+      description: Add links, logs, screenshots, or related issues.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Enhancement requests
+    url: https://github.com/NOAA-EPIC/EAGLE/discussions/new?category=enhancement-discussion
+    about: Please propose new capabilities in an Enhancement Discussion instead of opening an issue.
+  - name: Questions and answers
+    url: https://github.com/NOAA-EPIC/EAGLE/discussions/categories/q-a
+    about: Please use GitHub Discussions for usage questions and general help.

.github/pull_request_template.md

@@ -21,18 +21,22 @@ Refs NOAA-EPIC/repo#5678
 ## Type of change:
 <!--
 Indicate PR type of change.
-Delete options that are not applicable. 
+Check all that apply.
+Maintainers can use these selections when applying repository labels.
 -->
 - [ ] Bug fix
-- [ ] New feature
+- [ ] Enhancement / new feature
 - [ ] Refactor / cleanup
 - [ ] Documentation
 - [ ] CI/CD or tooling
+- [ ] Subcomponent update
 - [ ] Other:
 
 ## Area(s) affected
-<!-- Check all that apply -->
+<!-- Check all that apply. Maintainers can use these selections when applying repository labels. -->
 - [ ] nested_eagle workflow
+- [ ] Training
+- [ ] Inference
 - [ ] Verification / evaluation (via WXVX)
 - [ ] Data prep / UFS2ARCO
 - [ ] Config (YAML)
@@ -51,6 +55,7 @@ Delete options that are not applicable.
 - [ ] I have performed a self-review of my own code
 - [ ] My changes generate no new warnings
 - [ ] I have made corresponding changes to the system documentation if necessary
+- [ ] I checked whether this PR requires subcomponent PRs and completed the subcomponent checklist below
 
 ## Testing / Verification:
 <!--
@@ -77,9 +82,8 @@ Fill in if you ran on HPC or a specific system. Delete if not applicable.
   - MET version (if applicable):
 
 ## Commit Message:
-<!--
-Provide a concise commit message for any subcomponents; delete unnecessary info.
--->
+<!-- Provide a concise commit message summary for affected components. -->
+* EAGLE -
 * UFS2ARCO -
 * WXVX (verification) -
 
@@ -92,8 +96,8 @@ Example:
 * WXVX: NOAA-EPIC/WXVX#33
 Delete sections that are not needed.
 -->
+- [ ] No subcomponent PRs are required for this change.
+- [ ] Required subcomponent PRs are linked below.
 * EAGLE: NOAA-EPIC/EAGLE#
 * UFS2ARCO: NOAA-PSL/UFS2ARCO#
 * WXVX (verification): NOAA-EPIC/WXVX#
-* None
-

.github/scripts/build

@@ -3,5 +3,7 @@
 # shellcheck disable=1091
 
 set -euo pipefail
+export EAGLE_CLEAN_CONDA_PKGS=1
+export PIP_NO_CACHE_DIR=1
 time make devenv cudascript=dummy
 . conda/etc/profile.d/conda.sh

.github/scripts/fsclean

@@ -2,7 +2,7 @@
 
 # shellcheck disable=2068,2086
 
-GIGSREQD=57
+GIGSREQD=47
 
 gigsfree() { df . -BG --output=avail | tail -n1 | sed 's/[^0-9]//g'; }
 msg() { echo $GIGSREQD GB NEEDED, $1 GB AVAILABLE: $2; }
@@ -38,12 +38,12 @@ else
   )
   dirs=(
     /home/runner/{.cargo,.dotnet,.rustup}
-    /opt/hostedtoolcache/{Ruby,PyPy,node,go,CodeQL}
-    /opt/{az,google,microsoft,pipx}
+    /opt/hostedtoolcache/{Python,Ruby,PyPy,node,go,CodeQL}
+    /opt/{az,ghc,google,microsoft,pipx}
     /usr/lib/{firefox,google-cloud-sdk,jvm,snapd}
     /usr/local/lib/android
-    /usr/local/share/{chromium,powershell}
-    /usr/local/{aws-*,julia*}
+    /usr/local/share/{boost,chromium,powershell,vcpkg}
+    /usr/local/{.ghcup,aws-*,julia*}
     /usr/share/{az_*,dotnet,gradle-*,kotlinc,miniconda,swift}
   )
   (

README.md

@@ -16,9 +16,14 @@ To learn about EAGLE and how to use the provided workflows, please see our [docu
 ## Collaboration
 
 - If you encounter a problem using EAGLE that appears to be a bug, please open an [issue](https://github.com/NOAA-EPIC/EAGLE/issues) with us.
+- For enhancement requests, please start an [Enhancement Discussion](https://github.com/NOAA-EPIC/EAGLE/discussions/new?category=enhancement-discussion).
 - For free-form sharing of ideas, questions, tips and tricks, etc., please start or join a [discussion](https://github.com/NOAA-EPIC/EAGLE/discussions).
 - To contribute to the codebase, please see our [docs](https://epic-eagle.readthedocs.io/en/latest/contributing.html).
 
+## Citation
+
+The Earth Prediction Innovation Center (EPIC) and the NOAA AI for Numerical Weather Prediction (AI4NWP) Working Group. (2026). The nested-EAGLE (Experimental AI Global and Limited-area Ensemble forecast system) (v1.0.0). Zenodo. https://doi.org/10.5281/zenodo.19672026
+
 ## Acknowledgments
 
 ufs2arco: Tim Smith (NOAA Physical Sciences Laboratory)