Python: Add AI-assisted contribution policy and issue-first workflow

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,11 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
 contact_links:
   - name: Documentation
     url: https://aka.ms/agent-framework
     about: Check out the official documentation for guides and API reference.
   - name: Discussions
     url: https://github.com/microsoft/agent-framework/discussions
     about: Ask questions about Agent Framework.
+  - name: Security Vulnerability
+    url: https://github.com/microsoft/agent-framework/security/policy
+    about: Report security vulnerabilities privately.

.github/ISSUE_TEMPLATE/dotnet-issue.yml

@@ -1,53 +1,72 @@
 name: .NET Bug Report
-description: Report a bug in the Agent Framework .NET SDK
+description: Report a reproducible bug in the Agent Framework .NET SDK
 title: ".NET: [Bug]: "
 labels: [".NET"]
 type: bug
 body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this form for reproducible defects. Ask usage questions in
+        [Discussions](https://github.com/microsoft/agent-framework/discussions).
+
+  - type: textarea
+    id: observed-behavior
+    attributes:
+      label: Observed Behavior
+      description: What happened?
+      placeholder: Describe the incorrect behavior and its impact.
+    validations:
+      required: true
+
   - type: textarea
-    id: description
+    id: expected-behavior
     attributes:
-      label: Description
-      description: Please provide a clear and detailed description of the bug.
+      label: Expected Behavior
+      description: What did you expect to happen?
+      placeholder: Describe the expected result.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction-steps
+    attributes:
+      label: Steps to Reproduce
+      description: Provide the smallest reliable sequence that reproduces the problem.
       placeholder: |
-        - What happened?
-        - What did you expect to happen?
-        - Steps to reproduce the issue
+        1. Configure ...
+        2. Run ...
+        3. Observe ...
     validations:
       required: true
 
   - type: textarea
-    id: code-sample
+    id: minimal-reproduction
     attributes:
-      label: Code Sample
-      description: If applicable, provide a minimal code sample that demonstrates the issue.
+      label: Minimal Reproduction
+      description: Provide minimal code or a repository link. If unavailable, explain why.
       placeholder: |
         ```csharp
-        // Your code here
+        // Minimal code that reproduces the problem
         ```
-      render: markdown
     validations:
-      required: false
+      required: true
 
   - type: textarea
     id: error-messages
     attributes:
-      label: Error Messages / Stack Traces
-      description: Include any error messages or stack traces you received.
-      placeholder: |
-        ```
-        Paste error messages or stack traces here
-        ```
-      render: markdown
+      label: Error Messages and Stack Traces
+      description: Include the complete relevant error output after removing credentials, authorization headers, signed URLs, personal data, internal endpoints, and other sensitive values.
+      render: text
     validations:
       required: false
 
   - type: input
     id: dotnet-packages
     attributes:
       label: Package Versions
-      description: List the Microsoft.Agents.* packages and versions you are using
-      placeholder: "e.g., Microsoft.Agents.AI.Abstractions: 1.0.0, Microsoft.Agents.AI.OpenAI: 1.0.0"
+      description: List the Microsoft.Agents.* packages and exact versions you are using.
+      placeholder: "Microsoft.Agents.AI: 1.0.0"
     validations:
       required: true
 
@@ -56,15 +75,50 @@ body:
     attributes:
       label: .NET Version
       description: What version of .NET are you using?
-      placeholder: "e.g., .NET 8.0"
+      placeholder: ".NET 10.0"
     validations:
-      required: false
+      required: true
+
+  - type: dropdown
+    id: operating-system
+    attributes:
+      label: Operating System
+      options:
+        - Windows
+        - macOS
+        - Linux
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: regression
+    attributes:
+      label: Regression
+      description: Did this work in an earlier Agent Framework version?
+      options:
+        - "Yes"
+        - "No"
+        - Unknown
+    validations:
+      required: true
 
   - type: textarea
     id: additional-context
     attributes:
       label: Additional Context
-      description: Add any other context or screenshots that might be helpful.
-      placeholder: "Any additional information..."
+      description: Add any other relevant context, logs, or screenshots.
     validations:
       required: false
+
+  - type: checkboxes
+    id: acknowledgements
+    attributes:
+      label: Acknowledgements
+      options:
+        - label: I searched existing issues and did not find a duplicate.
+          required: true
+        - label: I personally verified this behavior and the reproduction details are authentic.
+          required: true
+        - label: I will wait for explicit maintainer agreement before starting implementation of a non-trivial change.
+          required: true

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -1,51 +1,100 @@
 name: Feature Request
-description: Request a new feature for Microsoft Agent Framework
+description: Propose a new capability for Microsoft Agent Framework
 title: "[Feature]: "
 type: feature
 body:
+  - type: markdown
+    attributes:
+      value: |
+        Describe the problem before proposing implementation. Filing an issue does
+        not reserve the work or approve a pull request.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What concrete problem or limitation are you experiencing?
+      placeholder: Describe the current limitation and who it affects.
+    validations:
+      required: true
 
   - type: textarea
-    id: description
+    id: use-case
     attributes:
-      label: Description
-      description: Please describe the feature you'd like and why it would be useful.
-      placeholder: |
-        Describe the feature you're requesting:
-        - What problem does it solve?
-        - What would the expected behavior be?
-        - Are there any alternatives you've considered?
+      label: Use Case and Evidence
+      description: Provide a real scenario, example, or other evidence that demonstrates the need.
+      placeholder: Explain what you are trying to accomplish and why the current APIs or guidance are insufficient.
     validations:
       required: true
 
   - type: textarea
-    id: code-sample
+    id: desired-outcome
     attributes:
-      label: Code Sample
-      description: If applicable, provide a code sample showing how you'd like to use this feature.
-      placeholder: |
-        ```python
-        # Your code here
-        ```
+      label: Desired Outcome
+      description: Describe the behavior or capability you need without prescribing implementation details.
+      placeholder: What should a successful outcome allow users to do?
+    validations:
+      required: true
 
-        or
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: What existing features, workarounds, or alternative approaches have you considered?
+      placeholder: Describe what you tried and why it did not meet the need.
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed-direction
+    attributes:
+      label: Proposed Direction
+      description: If you have a proposed API or design direction, describe it here.
+      placeholder: Optional implementation or API ideas.
+    validations:
+      required: false
 
-        ```csharp
-        // Your code here
-        ```
-      render: markdown
+  - type: textarea
+    id: scope
+    attributes:
+      label: Scope and Non-Goals
+      description: Identify important boundaries or related work that should not be included.
+      placeholder: Optional scope constraints and non-goals.
     validations:
       required: false
 
   - type: dropdown
     id: language
     attributes:
-      label: Language/SDK
-      description: Which language/SDK does this feature apply to?
+      label: Language
+      description: Which implementation does this request apply to?
       options:
         - Both
         - .NET
         - Python
         - Other / Not Applicable
       default: 0
     validations:
-      required: false
+      required: true
+
+  - type: dropdown
+    id: contribution-intent
+    attributes:
+      label: Contribution Intent
+      description: Would you be interested in implementing this after maintainer agreement?
+      options:
+        - I am willing to implement this
+        - I can help with implementation or testing
+        - I am only requesting the feature
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: acknowledgements
+    attributes:
+      label: Acknowledgements
+      options:
+        - label: I searched existing issues and did not find a duplicate.
+          required: true
+        - label: I will wait for explicit maintainer agreement before starting implementation of a non-trivial change.
+          required: true

.github/ISSUE_TEMPLATE/general-issue.yml

@@ -0,0 +1,77 @@
+name: Other Issue
+description: Report a documentation, process, or repository problem
+title: "[Issue]: "
+type: task
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this form for problems that are not SDK bugs or feature requests.
+        Ask usage questions in
+        [Discussions](https://github.com/microsoft/agent-framework/discussions).
+        Report security vulnerabilities according to
+        [SECURITY.md](https://github.com/microsoft/agent-framework/security/policy).
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      options:
+        - Documentation
+        - Build or CI
+        - Repository maintenance
+        - Contribution process
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What is incorrect, missing, or difficult?
+      placeholder: Describe the problem and its impact.
+    validations:
+      required: true
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence
+      description: Provide links, examples, screenshots, or reproduction steps that demonstrate the problem.
+      placeholder: Include enough information for a maintainer to verify the issue.
+    validations:
+      required: true
+
+  - type: textarea
+    id: desired-outcome
+    attributes:
+      label: Desired Outcome
+      description: What should change?
+      placeholder: Describe the expected result without assuming a particular implementation.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: language
+    attributes:
+      label: Language
+      description: Which implementation does this issue affect?
+      options:
+        - Both
+        - .NET
+        - Python
+        - Not Applicable
+      default: 3
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: acknowledgements
+    attributes:
+      label: Acknowledgements
+      options:
+        - label: I searched existing issues and did not find a duplicate.
+          required: true
+        - label: I will wait for explicit maintainer agreement before starting implementation of a non-trivial change.
+          required: true