create-genia-os 2.4.0 → 3.0.0

package/template/.aiox-core/product/templates/project-brief-tmpl.yaml

@@ -0,0 +1,221 @@
+template:
+  id: project-brief-template-v2
+  name: Project Brief
+  version: 2.0
+  output:
+    format: markdown
+    filename: docs/brief.md
+    title: "Project Brief: {{project_name}}"
+
+workflow:
+  mode: interactive
+  elicitation: advanced-elicitation
+  custom_elicitation:
+    title: "Project Brief Elicitation Actions"
+    options:
+      - "Expand section with more specific details"
+      - "Validate against similar successful products"
+      - "Stress test assumptions with edge cases"
+      - "Explore alternative solution approaches"
+      - "Analyze resource/constraint trade-offs"
+      - "Generate risk mitigation strategies"
+      - "Challenge scope from MVP minimalist view"
+      - "Brainstorm creative feature possibilities"
+      - "If only we had [resource/capability/time]..."
+      - "Proceed to next section"
+
+sections:
+  - id: introduction
+    instruction: |
+      This template guides creation of a comprehensive Project Brief that serves as the foundational input for product development.
+      
+      Start by asking the user which mode they prefer:
+      
+      1. **Interactive Mode** - Work through each section collaboratively
+      2. **YOLO Mode** - Generate complete draft for review and refinement
+      
+      Before beginning, understand what inputs are available (brainstorming results, market research, competitive analysis, initial ideas) and gather project context.
+
+  - id: executive-summary
+    title: Executive Summary
+    instruction: |
+      Create a concise overview that captures the essence of the project. Include:
+      - Product concept in 1-2 sentences
+      - Primary problem being solved
+      - Target market identification
+      - Key value proposition
+    template: "{{executive_summary_content}}"
+
+  - id: problem-statement
+    title: Problem Statement
+    instruction: |
+      Articulate the problem with clarity and evidence. Address:
+      - Current state and pain points
+      - Impact of the problem (quantify if possible)
+      - Why existing solutions fall short
+      - Urgency and importance of solving this now
+    template: "{{detailed_problem_description}}"
+
+  - id: proposed-solution
+    title: Proposed Solution
+    instruction: |
+      Describe the solution approach at a high level. Include:
+      - Core concept and approach
+      - Key differentiators from existing solutions
+      - Why this solution will succeed where others haven't
+      - High-level vision for the product
+    template: "{{solution_description}}"
+
+  - id: target-users
+    title: Target Users
+    instruction: |
+      Define and characterize the intended users with specificity. For each user segment include:
+      - Demographic/firmographic profile
+      - Current behaviors and workflows
+      - Specific needs and pain points
+      - Goals they're trying to achieve
+    sections:
+      - id: primary-segment
+        title: "Primary User Segment: {{segment_name}}"
+        template: "{{primary_user_description}}"
+      - id: secondary-segment
+        title: "Secondary User Segment: {{segment_name}}"
+        condition: Has secondary user segment
+        template: "{{secondary_user_description}}"
+
+  - id: goals-metrics
+    title: Goals & Success Metrics
+    instruction: Establish clear objectives and how to measure success. Make goals SMART (Specific, Measurable, Achievable, Relevant, Time-bound)
+    sections:
+      - id: business-objectives
+        title: Business Objectives
+        type: bullet-list
+        template: "- {{objective_with_metric}}"
+      - id: user-success-metrics
+        title: User Success Metrics
+        type: bullet-list
+        template: "- {{user_metric}}"
+      - id: kpis
+        title: Key Performance Indicators (KPIs)
+        type: bullet-list
+        template: "- {{kpi}}: {{definition_and_target}}"
+
+  - id: mvp-scope
+    title: MVP Scope
+    instruction: Define the minimum viable product clearly. Be specific about what's in and what's out. Help user distinguish must-haves from nice-to-haves.
+    sections:
+      - id: core-features
+        title: Core Features (Must Have)
+        type: bullet-list
+        template: "- **{{feature}}:** {{description_and_rationale}}"
+      - id: out-of-scope
+        title: Out of Scope for MVP
+        type: bullet-list
+        template: "- {{feature_or_capability}}"
+      - id: mvp-success-criteria
+        title: MVP Success Criteria
+        template: "{{mvp_success_definition}}"
+
+  - id: post-mvp-vision
+    title: Post-MVP Vision
+    instruction: Outline the longer-term product direction without overcommitting to specifics
+    sections:
+      - id: phase-2-features
+        title: Phase 2 Features
+        template: "{{next_priority_features}}"
+      - id: long-term-vision
+        title: Long-term Vision
+        template: "{{one_two_year_vision}}"
+      - id: expansion-opportunities
+        title: Expansion Opportunities
+        template: "{{potential_expansions}}"
+
+  - id: technical-considerations
+    title: Technical Considerations
+    instruction: Document known technical constraints and preferences. Note these are initial thoughts, not final decisions.
+    sections:
+      - id: platform-requirements
+        title: Platform Requirements
+        template: |
+          - **Target Platforms:** {{platforms}}
+          - **Browser/OS Support:** {{specific_requirements}}
+          - **Performance Requirements:** {{performance_specs}}
+      - id: technology-preferences
+        title: Technology Preferences
+        template: |
+          - **Frontend:** {{frontend_preferences}}
+          - **Backend:** {{backend_preferences}}
+          - **Database:** {{database_preferences}}
+          - **Hosting/Infrastructure:** {{infrastructure_preferences}}
+      - id: architecture-considerations
+        title: Architecture Considerations
+        template: |
+          - **Repository Structure:** {{repo_thoughts}}
+          - **Service Architecture:** {{service_thoughts}}
+          - **Integration Requirements:** {{integration_needs}}
+          - **Security/Compliance:** {{security_requirements}}
+
+  - id: constraints-assumptions
+    title: Constraints & Assumptions
+    instruction: Clearly state limitations and assumptions to set realistic expectations
+    sections:
+      - id: constraints
+        title: Constraints
+        template: |
+          - **Budget:** {{budget_info}}
+          - **Timeline:** {{timeline_info}}
+          - **Resources:** {{resource_info}}
+          - **Technical:** {{technical_constraints}}
+      - id: key-assumptions
+        title: Key Assumptions
+        type: bullet-list
+        template: "- {{assumption}}"
+
+  - id: risks-questions
+    title: Risks & Open Questions
+    instruction: Identify unknowns and potential challenges proactively
+    sections:
+      - id: key-risks
+        title: Key Risks
+        type: bullet-list
+        template: "- **{{risk}}:** {{description_and_impact}}"
+      - id: open-questions
+        title: Open Questions
+        type: bullet-list
+        template: "- {{question}}"
+      - id: research-areas
+        title: Areas Needing Further Research
+        type: bullet-list
+        template: "- {{research_topic}}"
+
+  - id: appendices
+    title: Appendices
+    sections:
+      - id: research-summary
+        title: A. Research Summary
+        condition: Has research findings
+        instruction: |
+          If applicable, summarize key findings from:
+          - Market research
+          - Competitive analysis
+          - User interviews
+          - Technical feasibility studies
+      - id: stakeholder-input
+        title: B. Stakeholder Input
+        condition: Has stakeholder feedback
+        template: "{{stakeholder_feedback}}"
+      - id: references
+        title: C. References
+        template: "{{relevant_links_and_docs}}"
+
+  - id: next-steps
+    title: Next Steps
+    sections:
+      - id: immediate-actions
+        title: Immediate Actions
+        type: numbered-list
+        template: "{{action_item}}"
+      - id: pm-handoff
+        title: PM Handoff
+        content: |
+          This Project Brief provides the full context for {{project_name}}. Please start in 'PRD Generation Mode', review the brief thoroughly to work with the user to create the PRD section by section as the template indicates, asking for any necessary clarification or suggesting improvements. 

package/template/.aiox-core/product/templates/qa-gate-tmpl.yaml

@@ -0,0 +1,240 @@
+template:
+  id: qa-gate-template-v1
+  name: QA Gate Definition
+  version: 1.0
+  output:
+    format: yaml
+    filename: "{{task_id}}-gate.yaml"
+    title: "QA Gate: {{gate_name}}"
+
+workflow:
+  mode: interactive
+  elicitation: detailed-elicitation
+
+sections:
+  - id: initial-setup
+    instruction: |
+      Initial Setup for QA Gate Definition
+
+      A QA GATE is a validation checkpoint before task handoff.
+
+      Gate Types:
+      - blocking: Must pass to proceed (hard stop)
+      - warning: Issues noted but can proceed (soft stop)
+      - informational: Just for visibility (no stop)
+
+      Output file location: `qa-gates/{{task_id}}-gate.yaml`
+
+  - id: gate-metadata
+    title: Gate Metadata
+    instruction: |
+      Elicit basic gate information.
+    elicit: true
+    template: |
+      qa_gate:
+        id: {{gate_id}}
+        name: {{gate_name}}
+        task_id: {{task_id}}
+        type: {{gate_type}}
+        validator: {{validator}}
+        version: {{version}}
+
+  - id: validation-criteria
+    title: Validation Criteria
+    instruction: |
+      Define the criteria used to validate task output.
+      Organize into categories: completeness, correctness, quality, compliance.
+    elicit: true
+    template: |
+        criteria:
+          completeness:
+            {{#each completeness_checks}}
+            - check: {{check}}
+              required: {{required}}
+              validation_method: {{method}}
+            {{/each}}
+
+          correctness:
+            {{#each correctness_checks}}
+            - check: {{check}}
+              required: {{required}}
+              validation_method: {{method}}
+            {{/each}}
+
+          quality:
+            {{#each quality_checks}}
+            - check: {{check}}
+              required: {{required}}
+              threshold: {{threshold}}
+              validation_method: {{method}}
+            {{/each}}
+
+          compliance:
+            {{#each compliance_checks}}
+            - check: {{check}}
+              required: {{required}}
+              standard: {{standard}}
+              validation_method: {{method}}
+            {{/each}}
+
+  - id: severity-levels
+    title: Severity Levels
+    instruction: |
+      Define what constitutes different severity levels for issues found.
+    elicit: true
+    template: |
+        severity:
+          critical:
+            description: {{critical_description}}
+            examples:
+              {{#each critical_examples}}
+              - {{this}}
+              {{/each}}
+
+          major:
+            description: {{major_description}}
+            examples:
+              {{#each major_examples}}
+              - {{this}}
+              {{/each}}
+
+          minor:
+            description: {{minor_description}}
+            examples:
+              {{#each minor_examples}}
+              - {{this}}
+              {{/each}}
+
+  - id: validation-process
+    title: Validation Process
+    instruction: |
+      Define the step-by-step process for running this QA gate.
+    elicit: true
+    template: |
+        validation_process:
+          steps:
+            {{#each validation_steps}}
+            - step: {{step_number}}
+              action: {{action}}
+              {{#if automated}}
+              automation:
+                tool: {{automation_tool}}
+                script: {{automation_script}}
+              {{/if}}
+              {{#if manual}}
+              manual_check:
+                instruction: {{manual_instruction}}
+                reviewer: {{reviewer}}
+              {{/if}}
+            {{/each}}
+
+  - id: decision-matrix
+    title: Decision Matrix
+    instruction: |
+      Define the decision logic based on validation results.
+    elicit: true
+    template: |
+        decision_matrix:
+          pass:
+            condition: {{pass_condition}}
+            action: {{pass_action}}
+            next_step: {{next_step_on_pass}}
+
+          concerns:
+            condition: {{concerns_condition}}
+            action: {{concerns_action}}
+            requires_review: {{requires_review}}
+            reviewer: {{reviewer}}
+
+          fail:
+            condition: {{fail_condition}}
+            action: {{fail_action}}
+            {{#if gate_type == "blocking"}}
+            blocks_handoff: true
+            {{/if}}
+            remediation_required: true
+
+          waived:
+            condition: {{waived_condition}}
+            waiver_authority: {{waiver_authority}}
+            waiver_reason_required: true
+            documentation_required: true
+
+  - id: issue-template
+    title: Issue Template
+    instruction: |
+      Define the template for documenting issues found during QA.
+    elicit: true
+    template: |
+        issue_template:
+          fields:
+            - issue_id: Auto-generated
+            - severity: [critical | major | minor]
+            - category: [completeness | correctness | quality | compliance]
+            - description: {{issue_description_format}}
+            - location: {{location_format}}
+            - remediation: {{remediation_format}}
+            - assignee: {{default_assignee}}
+            - due_date: {{default_due_date}}
+
+  - id: escalation-rules
+    title: Escalation Rules
+    instruction: |
+      Define when and how to escalate QA gate failures.
+    elicit: true
+    template: |
+        escalation:
+          triggers:
+            {{#each escalation_triggers}}
+            - condition: {{condition}}
+              escalate_to: {{escalate_to}}
+              timeframe: {{timeframe}}
+              notification_method: {{method}}
+            {{/each}}
+
+          sla:
+            response_time: {{response_time}}
+            resolution_time: {{resolution_time}}
+
+  - id: reporting
+    title: Reporting & Metrics
+    instruction: |
+      Define what gets reported and tracked from this QA gate.
+    elicit: true
+    template: |
+        reporting:
+          metrics:
+            - pass_rate: Percentage of tasks passing QA gate
+            - avg_issues_per_task: Average number of issues found
+            - avg_remediation_time: Time to fix and re-validate
+            - waiver_rate: Percentage of waivers granted
+
+          dashboards:
+            {{#each dashboards}}
+            - name: {{name}}
+              metrics:
+                {{#each metrics}}
+                - {{this}}
+                {{/each}}
+              audience: {{audience}}
+            {{/each}}
+
+          notifications:
+            {{#each notifications}}
+            - event: {{event}}
+              recipients:
+                {{#each recipients}}
+                - {{this}}
+                {{/each}}
+              method: {{method}}
+            {{/each}}
+
+  - id: validation
+    instruction: |
+      Validate the QA gate definition:
+      - At least one criterion per category
+      - Decision matrix covers all outcomes
+      - Escalation rules are clear
+      - Issue template is complete
+
+      If validation fails, prompt corrections.

package/template/.aiox-core/product/templates/qa-report-tmpl.md

@@ -0,0 +1,234 @@
+# QA Report: {{storyId}}
+
+**Version:** 1.0
+**Generated:** {{generatedAt}}
+**Agent:** {{agentName}}
+
+---
+
+## Summary
+
+| Metric            | Value                         |
+| ----------------- | ----------------------------- |
+| **Verdict**       | {{verdict}}                   |
+| **Total Issues**  | {{totalIssues}}               |
+| **Critical**      | {{issuesBySeverity.critical}} |
+| **Major**         | {{issuesBySeverity.major}}    |
+| **Minor**         | {{issuesBySeverity.minor}}    |
+| **Test Coverage** | {{coverage}}%                 |
+| **Build Status**  | {{buildStatus}}               |
+
+---
+
+## Test Results
+
+### Unit Tests
+
+| Metric | Count                |
+| ------ | -------------------- |
+| Total  | {{tests.unit.total}} |
+| Pass   | {{tests.unit.pass}}  |
+| Fail   | {{tests.unit.fail}}  |
+| Skip   | {{tests.unit.skip}}  |
+
+### Integration Tests
+
+| Metric | Count                       |
+| ------ | --------------------------- |
+| Total  | {{tests.integration.total}} |
+| Pass   | {{tests.integration.pass}}  |
+| Fail   | {{tests.integration.fail}}  |
+| Skip   | {{tests.integration.skip}}  |
+
+### E2E Tests
+
+| Metric | Count               |
+| ------ | ------------------- |
+| Total  | {{tests.e2e.total}} |
+| Pass   | {{tests.e2e.pass}}  |
+| Fail   | {{tests.e2e.fail}}  |
+| Skip   | {{tests.e2e.skip}}  |
+
+---
+
+## Issues Found
+
+{{#if issues.critical.length}}
+
+### Critical (Blocks Release)
+
+{{#each issues.critical}}
+
+#### {{id}}: {{title}}
+
+| Field        | Value          |
+| ------------ | -------------- |
+| **Severity** | CRITICAL       |
+| **Location** | `{{location}}` |
+| **Category** | {{category}}   |
+
+**Description:**
+{{description}}
+
+**Expected Behavior:**
+{{expected}}
+
+**Actual Behavior:**
+{{actual}}
+
+**Verification Steps:**
+{{#each verification}}
+{{@index}}. {{this}}
+{{/each}}
+
+---
+
+{{/each}}
+{{else}}
+
+### Critical (Blocks Release)
+
+No critical issues found.
+
+---
+
+{{/if}}
+
+{{#if issues.major.length}}
+
+### Major (Important to Fix)
+
+{{#each issues.major}}
+
+#### {{id}}: {{title}}
+
+| Field        | Value          |
+| ------------ | -------------- |
+| **Severity** | MAJOR          |
+| **Location** | `{{location}}` |
+| **Category** | {{category}}   |
+
+**Description:**
+{{description}}
+
+**Expected Behavior:**
+{{expected}}
+
+**Actual Behavior:**
+{{actual}}
+
+---
+
+{{/each}}
+{{else}}
+
+### Major (Important to Fix)
+
+No major issues found.
+
+---
+
+{{/if}}
+
+{{#if issues.minor.length}}
+
+### Minor (Nice to Fix)
+
+{{#each issues.minor}}
+
+#### {{id}}: {{title}}
+
+| Field        | Value          |
+| ------------ | -------------- |
+| **Severity** | MINOR          |
+| **Location** | `{{location}}` |
+| **Category** | {{category}}   |
+
+**Description:**
+{{description}}
+
+---
+
+{{/each}}
+{{else}}
+
+### Minor (Nice to Fix)
+
+No minor issues found.
+
+---
+
+{{/if}}
+
+## Regression Analysis
+
+{{#if regression.detected}}
+
+### Regression Detected
+
+{{#each regression.items}}
+
+- **{{file}}**: {{description}} (introduced in {{commit}})
+  {{/each}}
+  {{else}}
+  No regressions detected.
+  {{/if}}
+
+---
+
+## Security Analysis
+
+{{#if security.vulnerabilities.length}}
+
+### Vulnerabilities Found
+
+{{#each security.vulnerabilities}}
+| Severity | Type | Location | Description |
+|----------|------|----------|-------------|
+| {{severity}} | {{type}} | `{{location}}` | {{description}} |
+{{/each}}
+{{else}}
+No security vulnerabilities found.
+{{/if}}
+
+**Security Score:** {{security.score}}/100
+
+---
+
+## Recommendation
+
+### Verdict: {{verdict}}
+
+**Justification:**
+{{verdictReason}}
+
+{{#if verdict === 'REJECT'}}
+
+### Required Actions Before Approval
+
+{{#each requiredActions}}
+{{@index}}. {{this}}
+{{/each}}
+{{/if}}
+
+{{#if suggestions.length}}
+
+### Suggestions for Improvement
+
+{{#each suggestions}}
+
+- {{this}}
+  {{/each}}
+  {{/if}}
+
+---
+
+## Metadata
+
+```json
+{{jsonSchema}}
+```
+
+---
+
+_Generated by AIOX QA Report Generator v1.0_