Release readiness: production infrastructure, multi-language demos, and comprehensive documentation

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,118 @@
+name: Bug Report
+description: Report a bug in ADP
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug! Please provide details to help us fix it.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear description of the bug
+      placeholder: "When I run X, Y happens instead of Z"
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce this bug?
+      placeholder: |
+        1. Run command '...'
+        2. With config file '...'
+        3. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What should happen?
+      placeholder: "The analysis should..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happens?
+      placeholder: "Instead, it..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error Logs
+      description: Paste any relevant error messages or logs
+      render: shell
+      placeholder: "Error: ..."
+    validations:
+      required: false
+
+  - type: dropdown
+    id: language
+    attributes:
+      label: Language
+      description: Which language were you analyzing?
+      options:
+        - TypeScript
+        - JavaScript
+        - PowerShell
+        - C#
+        - Rust
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: ADP Version
+      description: "Run: npm list @architectural-discipline/cli"
+      placeholder: "1.0.0"
+    validations:
+      required: true
+
+  - type: input
+    id: node-version
+    attributes:
+      label: Node.js Version
+      description: "Run: node --version"
+      placeholder: "v20.10.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - Windows
+        - macOS
+        - Linux
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: config
+    attributes:
+      label: Configuration
+      description: Your .adp-config.json (if relevant)
+      render: json
+      placeholder: |
+        {
+          "architectural-discipline": {
+            ...
+          }
+        }
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,73 @@
+name: Feature Request
+description: Suggest a new feature for ADP
+title: "[Feature] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! Please provide details below.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve?
+      placeholder: "I'm always frustrated when..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How would you like this to work?
+      placeholder: "I'd like ADP to..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: What other solutions have you considered?
+      placeholder: "I considered using X, but..."
+    validations:
+      required: false
+
+  - type: dropdown
+    id: languages
+    attributes:
+      label: Affected Languages
+      description: Which languages would this feature support?
+      multiple: true
+      options:
+        - All Languages
+        - TypeScript/JavaScript
+        - PowerShell
+        - C#
+        - Rust
+        - Python (future)
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: examples
+    attributes:
+      label: Usage Examples
+      description: Show how the feature would be used
+      render: shell
+      placeholder: |
+        # Example command
+        architectural-discipline analyze --new-feature
+
+  - type: checkboxes
+    id: contribution
+    attributes:
+      label: Contribution
+      description: Are you willing to help implement this?
+      options:
+        - label: "I'm willing to implement this feature"
+        - label: "I can help with documentation"
+        - label: "I can help with testing"

.github/ISSUE_TEMPLATE/good-first-issue.yml

@@ -0,0 +1,102 @@
+name: Good First Issue
+description: Beginner-friendly issue for new contributors
+title: "[Good First Issue] "
+labels: ["good first issue", "help wanted"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for your interest in contributing to ADP! This template is for creating beginner-friendly issues.
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      description: What type of contribution is this?
+      options:
+        - Documentation
+        - Code Example
+        - Bug Fix
+        - Test Coverage
+        - Language Analyzer
+        - Rule Catalog
+        - Tooling
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe what needs to be done
+      placeholder: |
+        Example: Add documentation for PowerShell analyzer configuration options
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context & Motivation
+      description: Why is this important?
+      placeholder: |
+        Example: Users are confused about how to configure PowerShell analysis thresholds. Clear documentation will help adoption.
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance Criteria
+      description: What defines "done" for this issue?
+      placeholder: |
+        - [ ] Documentation added to docs/languages/powershell.md
+        - [ ] Examples included
+        - [ ] Tested with real config file
+    validations:
+      required: true
+
+  - type: textarea
+    id: resources
+    attributes:
+      label: Resources & References
+      description: Helpful links, files, or context
+      placeholder: |
+        - Existing TypeScript docs: docs/languages/typescript.md
+        - PowerShell analyzer: packages/core/src/analyzers/powershell.ts
+        - Example config: examples/powershell-example/.adp-config.json
+    validations:
+      required: false
+
+  - type: dropdown
+    id: difficulty
+    attributes:
+      label: Estimated Difficulty
+      description: How complex is this task?
+      options:
+        - Beginner (< 2 hours)
+        - Intermediate (2-4 hours)
+        - Advanced (> 4 hours)
+    validations:
+      required: true
+
+  - type: textarea
+    id: skills
+    attributes:
+      label: Required Skills
+      description: What skills would help with this issue?
+      placeholder: |
+        - Basic Markdown
+        - Understanding of PowerShell
+        - Reading TypeScript code
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: mentor
+    attributes:
+      label: Mentorship Available
+      description: Are you willing to mentor someone working on this?
+      options:
+        - label: "Yes, I can provide guidance and code review"
+        - label: "I'll be available for questions"