Add contributor feedback entrypoints

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,68 @@
+name: Bug report
+description: Report a reproducible contract, CLI, or example-run problem.
+title: "bug: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for testing CineThread. Please report only an actual run and
+        remove private media, credentials, cookies, and local absolute paths.
+  - type: input
+    id: version
+    attributes:
+      label: Version or commit
+      description: Release tag, package version, or commit SHA.
+      placeholder: v0.2.0
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, Python version, and installation method.
+      placeholder: Windows 11, Python 3.12, editable install
+    validations:
+      required: true
+  - type: textarea
+    id: command
+    attributes:
+      label: Exact command and sanitized input
+      description: Include a minimal command and a sanitized JSON fixture when relevant.
+      render: shell
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected result
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual result
+      description: Include the full error or validation output.
+    validations:
+      required: true
+  - type: dropdown
+    id: relationship
+    attributes:
+      label: Relationship to the maintainer
+      options:
+        - Independent user
+        - Maintainer
+        - Maintainer alternate account
+        - Collaborator
+    validations:
+      required: true
+  - type: checkboxes
+    id: safeguards
+    attributes:
+      label: Safeguards
+      options:
+        - label: I removed credentials, private assets, and local absolute paths.
+          required: true
+        - label: I ran the command above myself.
+          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Verified run-feedback template
+    url: https://github.com/cyou1314/cinethread/blob/main/docs/feedback-template.md
+    about: Use this format only after a real run. State whether you are independent from the maintainer.

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,49 @@
+name: Feature request
+description: Propose a bounded, public improvement grounded in a real workflow need.
+title: "feature: "
+labels:
+  - enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        CineThread keeps its core deterministic and standard-library-only.
+        Describe a real workflow need; do not include private media, credentials,
+        or unlicensed assets.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem to solve
+      description: What failed or stayed ambiguous in a real workflow?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed behavior
+      description: Include the contract, CLI, adapter, or documentation boundary that should change.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Explain why a documentation change, external adapter, or existing contract is insufficient.
+  - type: dropdown
+    id: evidence
+    attributes:
+      label: Evidence status
+      options:
+        - Real run or user workflow observed
+        - Designed proposal only
+    validations:
+      required: true
+  - type: checkboxes
+    id: safeguards
+    attributes:
+      label: Safeguards
+      options:
+        - label: This request does not depend on private assets, credentials, or paid generation.
+          required: true
+        - label: I am not presenting a maintainer alternate account as independent adoption.
+          required: true

.github/pull_request_template.md

@@ -0,0 +1,23 @@
+## Summary
+
+Describe the user-visible change and the real workflow problem it addresses.
+
+## Validation
+
+- [ ] `python -m unittest discover -s tests -v`
+- [ ] Relevant example or CLI command was run.
+- [ ] `git diff --check` passes.
+
+## Contract and evidence boundary
+
+- [ ] If a contract changed, the code, schema, public example, and regression
+  test changed together.
+- [ ] This PR does not turn a designed contract, dry run, or technical previs
+  result into a claim of rendered or QC-accepted media.
+- [ ] No credentials, private assets, local absolute paths, or unlicensed
+  source data are included.
+
+## Notes for reviewers
+
+State any compatibility impact, external dependency, or asset-license question.
+

CODE_OF_CONDUCT.md

@@ -0,0 +1,29 @@
+# CineThread Code of Conduct
+
+## Our standard
+
+We want CineThread to be a practical, respectful place to improve creative
+workflow tooling. Participate in good faith, focus on the work, and treat
+other contributors with respect.
+
+## Expected behavior
+
+- Give reproducible, evidence-based feedback.
+- Separate designed contracts, dry runs, rendered output, and observed QC.
+- Explain the provenance and redistribution rights of any external asset or
+  motion data proposed for the project.
+- Keep review discussion focused on the code, documentation, and user impact.
+
+## Unacceptable behavior
+
+- Harassment, discrimination, personal attacks, or bad-faith disruption.
+- Uploading credentials, cookies, private media, private reference assets, or
+  local absolute paths.
+- Presenting generated media, a maintainer's alternate account, or unverified
+  results as independent community evidence.
+
+## Reporting
+
+For a conduct concern, open a private contact through the repository owner's
+GitHub profile rather than posting sensitive details in a public issue.
+

README.md

@@ -54,6 +54,14 @@ Prompt validation does not generate an image or video. QC validation does not
 open or interpret media; a `pass` or `fail` result requires explicitly marked
 observed evidence from an available artifact.
 
+## Contribute and report a real run
+
+Use the [contribution guide](CONTRIBUTING.md), [Code of Conduct](CODE_OF_CONDUCT.md),
+and [verified feedback template](docs/feedback-template.md). Bug reports and
+feature requests use structured GitHub forms so that environment, commands,
+and evidence boundaries are clear. A maintainer's alternate account may report
+a real bug, but it is not independent adoption evidence.
+
 [![CI](https://github.com/cyou1314/cinethread/actions/workflows/ci.yml/badge.svg)](https://github.com/cyou1314/cinethread/actions/workflows/ci.yml)
 
 面向 AI 动画、AI 漫剧和分镜预演的轻量合同工具包：把镜头任务、相机路径、入/出镜状态和动作选择写成可验证、可复现的 JSON。