Merge pull request #229 from TimeWarpEngineering/Cramer/2025-06-23/Task_023

Task 023: Create Architectural Decision Records

Author: StevenTCramer

TimeWarp.Architecture/.github/issue_template/ai_agent_task.yml

@@ -0,0 +1,123 @@
+name: AI Agent Task
+description: Request AI agent assistance for development work
+title: "[AI Task]: "
+labels: ["ai-agent", "automation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        🤖 **AI Agent Task Request**
+        
+        Use this template to request AI agent assistance. After creating the issue, mention the AI agent (e.g., @claude) in a comment to trigger automated work.
+
+  - type: textarea
+    id: task-description
+    attributes:
+      label: Task Description
+      description: Clearly describe what you want the AI agent to implement
+      placeholder: |
+        Example: "Add dark mode toggle to the settings page with user preference persistence"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: task-type
+    attributes:
+      label: Task Type
+      description: What type of work is this?
+      options:
+        - Feature Implementation
+        - Bug Fix
+        - Refactoring
+        - Testing
+        - Documentation
+        - Architecture Update
+        - Performance Optimization
+    validations:
+      required: true
+
+  - type: textarea
+    id: requirements
+    attributes:
+      label: Requirements
+      description: Specific requirements and constraints
+      placeholder: |
+        - Must use FluentUI components
+        - Should persist user preference to localStorage
+        - Must include unit tests
+        - Should follow existing patterns in codebase
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance-criteria
+    attributes:
+      label: Acceptance Criteria
+      description: How will we know this task is complete?
+      placeholder: |
+        - [ ] Toggle button appears in settings page
+        - [ ] Dark mode applies to all components
+        - [ ] User preference persists across sessions
+        - [ ] Unit tests cover new functionality
+        - [ ] Documentation is updated
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context and Background
+      description: Provide any relevant context or background information
+      placeholder: |
+        - Related files: src/components/Settings.tsx
+        - Existing patterns to follow: src/theme/ThemeProvider.tsx
+        - Dependencies: FluentUI theme system
+
+  - type: checkboxes
+    id: scope
+    attributes:
+      label: Scope
+      description: Which areas will this task affect?
+      options:
+        - label: Frontend (Client)
+        - label: Backend (API)
+        - label: Database
+        - label: Tests
+        - label: Documentation
+        - label: DevOps/CI-CD
+        - label: Security
+
+  - type: dropdown
+    id: complexity
+    attributes:
+      label: Estimated Complexity
+      description: How complex do you think this task is?
+      options:
+        - Simple - Single file changes, straightforward implementation
+        - Medium - Multiple files, some research needed
+        - Complex - Architecture changes, significant implementation
+        - Research - Unknown complexity, investigation needed
+    validations:
+      required: true
+
+  - type: textarea
+    id: ai-instructions
+    attributes:
+      label: Special Instructions for AI Agent
+      description: Any specific instructions for the AI agent
+      placeholder: |
+        - Please follow the existing code style in the repository
+        - Create feature branch following naming convention: Author/YYYY-MM-DD/Description
+        - Include comprehensive tests
+        - Update relevant documentation
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+        
+        **Next Steps:**
+        1. After creating this issue, comment with `@claude please work on this task`
+        2. The AI agent will create a branch and implement the solution
+        3. Review the resulting pull request and provide feedback
+        4. Merge when satisfied with the implementation

TimeWarp.Architecture/.github/issue_template/bug_report.yml

@@ -0,0 +1,77 @@
+name: Bug Report
+description: Report a bug or issue
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the information below to help us investigate.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Describe what happened...
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Go to '...'
+        2. Click on '...'
+        3. Scroll down to '...'
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: A clear and concise description of what you expected to happen.
+      placeholder: What should have happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: A clear and concise description of what actually happened.
+      placeholder: What actually happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Please provide details about your environment
+      placeholder: |
+        - OS: [e.g. Windows 11, macOS 13, Ubuntu 22.04]
+        - Browser: [e.g. Chrome 120, Firefox 119, Safari 17]
+        - .NET Version: [e.g. .NET 9.0]
+        - Template Version: [e.g. 1.0.0]
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs or Error Messages
+      description: If applicable, add any relevant logs or error messages
+      render: shell
+      placeholder: Paste logs here...
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here
+      placeholder: Any additional information that might be helpful...

TimeWarp.Architecture/.github/issue_template/feature_request.yml

@@ -0,0 +1,91 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! Please provide as much detail as possible.
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Feature Summary
+      description: A brief summary of the feature you'd like to see
+      placeholder: Briefly describe the feature...
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve?
+      placeholder: |
+        As a [user type],
+        I want [functionality],
+        So that [benefit/value].
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like to see
+      placeholder: How should this feature work?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternative Solutions
+      description: Describe any alternative solutions or features you've considered
+      placeholder: What other approaches could solve this problem?
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - Low - Nice to have
+        - Medium - Would be helpful
+        - High - Important for my use case
+        - Critical - Blocking my usage
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: scope
+    attributes:
+      label: Scope
+      description: Which areas does this feature affect?
+      options:
+        - label: Templates
+        - label: Architecture
+        - label: Documentation
+        - label: Developer Experience
+        - label: Testing
+        - label: DevOps/CI-CD
+        - label: Performance
+        - label: Security
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance Criteria
+      description: What criteria must be met for this feature to be considered complete?
+      placeholder: |
+        - [ ] Criterion 1
+        - [ ] Criterion 2
+        - [ ] Criterion 3
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, mockups, or examples
+      placeholder: Any additional information, screenshots, or examples...

TimeWarp.Architecture/.vscode/settings.json

@@ -2,6 +2,7 @@
     "cSpell.words": [
         "Fixie",
         "nameof",
+        "reprioritized",
         "Shouldly",
         "Yarp"
     ]