Add contribution and issue templates

Author: LLAA178

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,49 @@
+name: Bug report
+description: Report a reproducible bug in training, inference, data handling, or evaluation.
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please include a minimal reproduction and the exact command you ran.
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened?
+      placeholder: A concise description of the bug.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Reproduction
+      description: Paste the command, inputs, and steps needed to reproduce.
+      placeholder: |
+        1. Create environment...
+        2. Run command...
+        3. Observe failure...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What did you expect instead?
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs or traceback
+      description: Paste the relevant output.
+      render: shell
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: Python version, torch version, and device type.
+      placeholder: "Python 3.11, torch 2.3+, cpu/cuda/mps"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security issue
+    about: Report security problems privately instead of opening a public issue.
+    url: https://github.com/LLAA178/qlib-gpu-model/security

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,33 @@
+name: Feature request
+description: Suggest an improvement that fits the repo's scope.
+title: "[Feature] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This repository is intentionally small. Please explain why the change fits a GPU quant modeling demo.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What limitation or pain point are you trying to solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed change
+      description: Describe the smallest useful version of the feature.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: What other approaches did you consider?
+  - type: textarea
+    id: validation
+    attributes:
+      label: Validation plan
+      description: How would this be tested or measured?

.github/pull_request_template.md

@@ -0,0 +1,17 @@
+## Summary
+
+- what changed
+- why it changed
+
+## Validation
+
+- commands run:
+- datasets or checkpoints used:
+- metric or behavior impact:
+
+## Checklist
+
+- [ ] change is scoped and relevant to this repo
+- [ ] local smoke path was run when applicable
+- [ ] README or comments were updated if behavior changed
+- [ ] no claim of production trading readiness was introduced

CONTRIBUTING.md

@@ -0,0 +1,85 @@
+# Contributing
+
+Thanks for contributing.
+
+This repository is maintained as a compact learning and engineering demo, so the contribution bar is simple:
+- keep changes focused
+- prefer reproducible examples over broad claims
+- avoid adding heavy dependencies without a clear need
+- preserve the repo's positioning as a GPU quant modeling demo, not a production trading system
+
+## Development Setup
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python3 -m pip install -U pip
+python3 -m pip install -e '.[viz]'
+```
+
+Optional extras:
+
+```bash
+python3 -m pip install -e '.[profiling]'
+python3 -m pip install -e '.[qlib]'
+python3 -m pip install -e '.[triton]'
+```
+
+## Before Opening a PR
+
+Please run the smallest relevant checks locally.
+
+Minimum smoke path:
+
+```bash
+python3 -m qlib_gpu_model.train \
+  --data-source synthetic \
+  --device cpu \
+  --seq-len 16 \
+  --num-features 8 \
+  --model-dim 32 \
+  --num-heads 4 \
+  --num-layers 1 \
+  --ff-dim 64 \
+  --batch-size 32 \
+  --epochs 1 \
+  --num-workers 0 \
+  --amp-dtype fp32 \
+  --use-compile false \
+  --out-dir outputs/contrib_smoke
+
+python3 -m qlib_gpu_model.infer \
+  --checkpoint outputs/contrib_smoke/best.pt \
+  --device cpu \
+  --batch-size 16 \
+  --iters 10 \
+  --warmup 2
+```
+
+If you touch parquet evaluation logic, also run:
+
+```bash
+python3 -m compileall src
+```
+
+## Scope Guidelines
+
+Good fits:
+- training or inference performance improvements
+- data pipeline fixes
+- backtest and walk-forward correctness fixes
+- reproducibility improvements
+- documentation and figure generation improvements
+
+Needs stronger justification:
+- new modeling stacks unrelated to the current pipeline
+- large framework migrations
+- features that imply live trading readiness
+
+## Pull Request Notes
+
+In your PR description, include:
+- what changed
+- why it changed
+- how you validated it
+- any metric impact if performance behavior changed

SECURITY.md

@@ -0,0 +1,12 @@
+# Security Policy
+
+This repository is a learning-oriented quant modeling demo and is not intended for production trading deployment.
+
+If you find a security issue, do not open a public issue with exploit details.
+Please report it privately through GitHub security reporting if available, or contact the repository owner directly.
+
+When reporting, include:
+- affected file or component
+- impact
+- reproduction steps
+- any suggested mitigation