diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000..649b4ca
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Report a problem with rfaR
+title: ''
+labels: bug
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior. A minimal reproducible example (reprex) is strongly preferred — see https://reprex.tidyverse.org/.
+
+**Expected behavior**
+What you expected to happen.
+
+**Actual behavior**
+What actually happened, including any error messages or warnings (copy the full text).
+
+**Input data and configuration**
+If applicable, describe the input data (hydrograph, reservoir table, frequency curve parameters, etc.) and the rfaR function call that triggered the issue.
+
+**Session info**
+Please paste the output of `sessionInfo()` and `packageVersion("rfaR")`:
+
+```
+# paste here
+```
+
+**Operating system**
+e.g., Windows 10, Windows 11, macOS 14, Ubuntu 22.04
+
+**Additional context**
+Screenshots, plots, or any other information that might help.
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 0000000..4f32043
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,20 @@
+## Description
+Brief summary of the change and the motivation for it.
+
+## Related Issue
+Closes #<issue number>, or "Discussed in #<issue number>"
+
+## Type of change
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Documentation update
+- [ ] Refactor / internal cleanup
+- [ ] Other (describe):
+
+## Checklist
+- [ ] I opened an issue to discuss this change before submitting
+- [ ] `devtools::document()` has been run
+- [ ] `devtools::check()` passes with zero errors, warnings, and notes
+- [ ] Unit tests have been added or updated (`testthat`)
+- [ ] `NEWS.md` has been updated (if user-facing)
+- [ ] I agree to the Developer Certificate of Origin (see CONTRIBUTING.md)