From 9a06e95408cb2c467e4160f773c930fc10ef6fcb Mon Sep 17 00:00:00 2001
From: Abdullah <syedabdullah535@gmail.com>
Date: Sun, 20 Sep 2026 15:01:50 +0530
Subject: [PATCH] docs: add GitHub issue and pull request templates

(cherry picked from commit 9ff3e92d101bbc9b58eb9ff72ff4f564ff6b65f9)
---
 .github/ISSUE_TEMPLATE/bug_report.yml      | 55 ++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml          | 11 +++++
 .github/ISSUE_TEMPLATE/feature_request.yml | 54 +++++++++++++++++++++
 .github/PULL_REQUEST_TEMPLATE.md           | 29 ++++++++++++
 4 files changed, 149 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml
 create mode 100644 .github/PULL_REQUEST_TEMPLATE.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 000000000..01438c7f5
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,55 @@
+name: Bug report
+description: Report incorrect behavior, a crash, or a regression.
+title: "[Bug]: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please search existing issues first. Include the smallest reproducible example you can.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Describe the actual behavior and the behavior you expected.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      description: Include commands, input files, and the smallest useful example.
+      render: shell
+    validations:
+      required: true
+
+  - type: textarea
+    id: output
+    attributes:
+      label: Error output or graph output
+      description: Paste the relevant traceback, diagnostic, or incorrect result.
+      render: text
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Graphify version
+      placeholder: "0.9.64"
+
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: Include operating system, Python version, and installation method.
+      placeholder: "macOS 15, Python 3.12, uv tool install"
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional context
+      description: Add related files, screenshots, or links if they help explain the issue.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 000000000..ac603f552
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,11 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Security policy
+    url: https://github.com/Graphify-Labs/graphify/security/policy
+    about: Please report vulnerabilities privately using the security policy.
+  - name: 📖 Documentation
+    url: https://github.com/Graphify-Labs/graphify/blob/v8/README.md
+    about: Check the README and docs before opening an issue.
+  - name: 🤝 Contributing guide
+    url: https://github.com/Graphify-Labs/graphify/blob/v8/README.md#development-setup
+    about: Read the development and contribution guidelines before opening a pull request.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
new file mode 100644
index 000000000..668a84a48
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,54 @@
+name: Feature request
+description: Suggest an improvement or new capability.
+title: "[Feature]: "
+labels:
+  - enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please search existing issues first and describe the user problem before proposing an implementation.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem or use case
+      description: What are you trying to do that Graphify cannot do today?
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe the expected behavior, command, API, or workflow.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: What other approaches or workarounds did you consider?
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Extraction or language support
+        - Graph building or querying
+        - CLI or installation
+        - Skills or assistant integrations
+        - Documentation
+        - Performance
+        - Security
+        - Developer experience or CI
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Add examples, links, or sample input where useful.
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 000000000..57e09327e
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,29 @@
+## What does this PR do?
+
+<!-- Describe the problem and the change. Link the relevant issue when one exists. -->
+
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Documentation
+- [ ] Tests or CI
+- [ ] Refactor
+- [ ] Security fix
+
+## How was this tested?
+
+<!-- Include the commands you ran and any platform-specific checks. -->
+
+```text
+
+```
+
+## Graphify-specific checklist
+
+- [ ] I added or updated tests for behavior changes.
+- [ ] I updated documentation or confirmed that no documentation is needed.
+- [ ] I updated generated skill artifacts when changing their source fragments.
+- [ ] I considered compatibility across supported Python versions.
+- [ ] I confirmed that no API keys, generated graph data, or local-only files are included.