diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 0000000..e0cc2d2
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,77 @@
+name: Bug report
+description: Report a bug, regression, or broken workflow.
+title: "bug: "
+labels:
+  - bug
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What is broken?
+      placeholder: A short description of the bug.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: report_mode
+    attributes:
+      label: Report source
+      description: How was this bug discovered?
+      options:
+        - Human user
+        - Coding agent / automation
+        - Human + coding agent
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide the smallest reliable reproduction.
+      placeholder: |
+        1. Run ...
+        2. Click ...
+        3. Observe ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      placeholder: What should have happened instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      placeholder: What happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Include CLI version, OS, Python version, model/provider, or any relevant context.
+      placeholder: weco version, OS, shell, provider, model, etc.
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs, screenshots, or extra context
+      description: Paste logs or add any extra details that will help triage.
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Pre-flight
+      options:
+        - label: I searched for an existing issue first.
+          required: true
+        - label: I can still reproduce this issue.
+          required: false
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..3ba13e0
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1 @@
+blank_issues_enabled: false
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
new file mode 100644
index 0000000..ec67789
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,65 @@
+name: Feature request
+description: Propose a feature, UX improvement, or workflow enhancement.
+title: "feat: "
+labels:
+  - enhancement
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What would you like to see added or improved?
+      placeholder: A short description of the requested feature.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: requester_mode
+    attributes:
+      label: Request source
+      description: Who is proposing this request?
+      options:
+        - Human user
+        - Coding agent / automation
+        - Human + coding agent
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem to solve
+      description: What workflow, pain point, or limitation is driving this request?
+      placeholder: Describe the underlying problem.
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe the preferred approach.
+      placeholder: Explain what should change.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Any workarounds, rejected options, or tradeoffs.
+
+  - type: textarea
+    id: success
+    attributes:
+      label: Success criteria
+      description: How would we know this request is done and successful?
+      placeholder: Clear acceptance criteria, user outcome, or measurable result.
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Pre-flight
+      options:
+        - label: I searched for an existing issue first.
+          required: true
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..2b38732
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,43 @@
+## Summary
+
+<!-- What changed and why? -->
+
+## Linked Issues
+
+<!-- Example: Closes #123 -->
+
+## Change Type
+
+- [ ] `feat`
+- [ ] `fix`
+- [ ] `docs`
+- [ ] `refactor`
+- [ ] `test`
+- [ ] `chore`
+- [ ] `ci`
+
+## Authorship
+
+<!-- Check the one that best describes how this PR was produced. -->
+
+- [ ] Fully AI-generated
+- [ ] Human-directed, AI-authored
+- [ ] Human-authored with AI assistance
+- [ ] Fully human-authored
+
+## Validation
+
+- [ ] Tests added or updated
+- [ ] Existing tests pass
+- [ ] Manual verification completed
+- [ ] Not applicable
+
+## Notes for Reviewers
+
+<!-- Any context, caveats, rollout notes, or follow-up work -->
+
+## Checklist
+
+- [ ] I checked for accidental secrets or credentials
+- [ ] I updated docs, examples, or help text if needed
+- [ ] I kept the change scoped and reviewable