create-genia-os 2.4.0 → 3.0.0

package/template/.aiox-core/product/templates/command-rationalization-matrix.md

@@ -0,0 +1,152 @@
+# Command Rationalization Matrix Template
+
+**Purpose:** Systematic framework for evaluating agent commands for rationalization
+
+**Version:** 1.0
+**Created:** 2025-01-15
+**Template ID:** command-rationalization-matrix
+
+---
+
+## Usage Instructions
+
+This template provides a structured approach to analyze and rationalize agent commands. Use it when:
+- Optimizing agent command sets
+- Identifying redundant or overlapping commands
+- Planning command consolidations or deletions
+- Documenting command evolution decisions
+
+---
+
+## Decision Criteria
+
+### Usage Count Classification
+- **HIGH:** ≥10 occurrences across codebase
+- **MEDIUM:** 3-9 occurrences
+- **LOW:** 1-2 occurrences
+- **ZERO:** 0 occurrences (candidate for removal)
+
+### Recommendation Categories
+- ✅ **KEEP** - Essential functionality, high usage, or no alternative
+- 🔀 **MERGE** - Similar functionality, can consolidate with parameters
+- 🔄 **DELEGATE** - Better suited for specialized agent
+- ❌ **REMOVE** - Unused, redundant, or has alternative
+
+### Decision Rules
+1. **KEEP** if: Usage HIGH (≥10) OR critical functionality OR no alternative
+2. **MERGE** if: Similar purpose to another command AND can use parameters to differentiate
+3. **DELEGATE** if: Better aligns with specialized agent's domain
+4. **REMOVE** if: Usage ZERO (0) AND non-critical AND has alternative
+
+---
+
+## Command Analysis Matrix
+
+| # | Command | Category | Agent | Usage | Task File | Decision | Rationale | Migration Path |
+|---|---------|----------|-------|-------|-----------|----------|-----------|----------------|
+| 1 | example-command | Framework | aiox-master | HIGH (15) | create-doc.md | ✅ KEEP | Core meta-framework capability | N/A |
+| 2 | party-mode | Utility | aiox-master | ZERO (0) | N/A | ❌ REMOVE | Novelty feature, unused | Removed in v3.0 |
+| 3 | explain | DB Perf | data-engineer | HIGH (12) | db-explain.md | 🔀 MERGE | Into analyze-performance | *analyze-performance query |
+| 4 | analyze-hotpaths | DB Perf | data-engineer | MED (5) | db-analyze-hotpaths.md | 🔀 MERGE | Into analyze-performance | *analyze-performance hotpaths |
+| 5 | create-prd | Docs | aiox-master | MED (7) | create-doc.md | 🔄 DELEGATE | Better suited for @pm | Use @pm *create-prd |
+
+---
+
+## Usage Count Calculation Method
+
+```bash
+# Count command usage across all documentation
+grep -r "\*command-name" docs/ .aiox-core/ | wc -l
+
+# For each agent's commands:
+for cmd in $(grep -E "^  - [a-z-]+" .aiox-core/agents/AGENT.md | cut -d':' -f1 | sed 's/  - //'); do
+  count=$(grep -r "\*$cmd" docs/ .aiox-core/ 2>/dev/null | wc -l)
+  echo "$cmd: $count"
+done
+```
+
+---
+
+## Command Consolidation Patterns
+
+### Pattern 1: Parameter-Based Merge
+**Before:** Multiple similar commands
+```yaml
+- explain {sql}: Run EXPLAIN on query
+- analyze-hotpaths: Analyze hot queries
+- optimize-queries: Optimize query performance
+```
+
+**After:** Single command with type parameter
+```yaml
+- analyze-performance {type}: Query performance analysis
+  # Types: query, hotpaths, interactive
+  # Example: *analyze-performance query "SELECT * FROM users"
+```
+
+### Pattern 2: Verb-Noun Consolidation
+**Before:** Multiple create commands
+```yaml
+- create-agent: Create new agent
+- create-task: Create new task
+- create-workflow: Create new workflow
+```
+
+**After:** Unified create with type
+```yaml
+- create {type} {name}: Create AIOX component
+  # Types: agent, task, workflow, template
+  # Example: *create agent security-expert
+```
+
+---
+
+## Analysis Checklist
+
+For each command, evaluate:
+- [ ] **Purpose Clear:** Can users understand what this command does?
+- [ ] **Usage Tracked:** Have we measured actual usage in codebase?
+- [ ] **Task Mapped:** Does it map to an existing task file?
+- [ ] **Alternatives Considered:** Are there other ways to achieve this?
+- [ ] **Impact Assessed:** What breaks if we remove/change this?
+- [ ] **Migration Planned:** How do users adapt to changes?
+
+---
+
+## Rationalization Output Format
+
+### Summary Statistics
+- **Total Commands (Before):** X
+- **Total Commands (After):** Y
+- **Reduction:** Z% (X-Y)/X
+- **Commands Kept:** N
+- **Commands Merged:** M
+- **Commands Delegated:** D
+- **Commands Removed:** R
+
+### Detailed Recommendations
+For each category (Framework, Operations, Security, etc.):
+1. List current commands
+2. Show proposed changes
+3. Explain rationale
+4. Document migration path
+
+---
+
+## Validation Criteria
+
+Before finalizing rationalization:
+- ✅ No critical workflows broken
+- ✅ All task file references valid
+- ✅ Migration path documented for every change
+- ✅ User approval obtained for major changes
+- ✅ Backward compatibility preserved (via aliases if needed)
+
+---
+
+## Notes
+
+- Update this matrix as commands evolve
+- Archive historical analyses for reference
+- Use consistent categorization across analyses
+- Always validate with actual usage data, not assumptions

package/template/.aiox-core/product/templates/competitor-analysis-tmpl.yaml

@@ -0,0 +1,293 @@
+template:
+  id: competitor-analysis-template-v2
+  name: Competitive Analysis Report
+  version: 2.0
+  output:
+    format: markdown
+    filename: docs/competitor-analysis.md
+    title: "Competitive Analysis Report: {{project_product_name}}"
+
+workflow:
+  mode: interactive
+  elicitation: advanced-elicitation
+  custom_elicitation:
+    title: "Competitive Analysis Elicitation Actions"
+    options:
+      - "Deep dive on a specific competitor's strategy"
+      - "Analyze competitive dynamics in a specific segment"
+      - "War game competitive responses to your moves"
+      - "Explore partnership vs. competition scenarios"
+      - "Stress test differentiation claims"
+      - "Analyze disruption potential (yours or theirs)"
+      - "Compare to competition in adjacent markets"
+      - "Generate win/loss analysis insights"
+      - "If only we had known about [competitor X's plan]..."
+      - "Proceed to next section"
+
+sections:
+  - id: executive-summary
+    title: Executive Summary
+    instruction: Provide high-level competitive insights, main threats and opportunities, and recommended strategic actions. Write this section LAST after completing all analysis.
+
+  - id: analysis-scope
+    title: Analysis Scope & Methodology
+    instruction: This template guides comprehensive competitor analysis. Start by understanding the user's competitive intelligence needs and strategic objectives. Help them identify and prioritize competitors before diving into detailed analysis.
+    sections:
+      - id: analysis-purpose
+        title: Analysis Purpose
+        instruction: |
+          Define the primary purpose:
+          - New market entry assessment
+          - Product positioning strategy
+          - Feature gap analysis
+          - Pricing strategy development
+          - Partnership/acquisition targets
+          - Competitive threat assessment
+      - id: competitor-categories
+        title: Competitor Categories Analyzed
+        instruction: |
+          List categories included:
+          - Direct Competitors: Same product/service, same target market
+          - Indirect Competitors: Different product, same need/problem
+          - Potential Competitors: Could enter market easily
+          - Substitute Products: Alternative solutions
+          - Aspirational Competitors: Best-in-class examples
+      - id: research-methodology
+        title: Research Methodology
+        instruction: |
+          Describe approach:
+          - Information sources used
+          - Analysis timeframe
+          - Confidence levels
+          - Limitations
+
+  - id: competitive-landscape
+    title: Competitive Landscape Overview
+    sections:
+      - id: market-structure
+        title: Market Structure
+        instruction: |
+          Describe the competitive environment:
+          - Number of active competitors
+          - Market concentration (fragmented/consolidated)
+          - Competitive dynamics
+          - Recent market entries/exits
+      - id: prioritization-matrix
+        title: Competitor Prioritization Matrix
+        instruction: |
+          Help categorize competitors by market share and strategic threat level
+          
+          Create a 2x2 matrix:
+          - Priority 1 (Core Competitors): High Market Share + High Threat
+          - Priority 2 (Emerging Threats): Low Market Share + High Threat
+          - Priority 3 (Established Players): High Market Share + Low Threat
+          - Priority 4 (Monitor Only): Low Market Share + Low Threat
+
+  - id: competitor-profiles
+    title: Individual Competitor Profiles
+    instruction: Create detailed profiles for each Priority 1 and Priority 2 competitor. For Priority 3 and 4, create condensed profiles.
+    repeatable: true
+    sections:
+      - id: competitor
+        title: "{{competitor_name}} - Priority {{priority_level}}"
+        sections:
+          - id: company-overview
+            title: Company Overview
+            template: |
+              - **Founded:** {{year_founders}}
+              - **Headquarters:** {{location}}
+              - **Company Size:** {{employees_revenue}}
+              - **Funding:** {{total_raised_investors}}
+              - **Leadership:** {{key_executives}}
+          - id: business-model
+            title: Business Model & Strategy
+            template: |
+              - **Revenue Model:** {{revenue_model}}
+              - **Target Market:** {{customer_segments}}
+              - **Value Proposition:** {{value_promise}}
+              - **Go-to-Market Strategy:** {{gtm_approach}}
+              - **Strategic Focus:** {{current_priorities}}
+          - id: product-analysis
+            title: Product/Service Analysis
+            template: |
+              - **Core Offerings:** {{main_products}}
+              - **Key Features:** {{standout_capabilities}}
+              - **User Experience:** {{ux_assessment}}
+              - **Technology Stack:** {{tech_stack}}
+              - **Pricing:** {{pricing_model}}
+          - id: strengths-weaknesses
+            title: Strengths & Weaknesses
+            sections:
+              - id: strengths
+                title: Strengths
+                type: bullet-list
+                template: "- {{strength}}"
+              - id: weaknesses
+                title: Weaknesses
+                type: bullet-list
+                template: "- {{weakness}}"
+          - id: market-position
+            title: Market Position & Performance
+            template: |
+              - **Market Share:** {{market_share_estimate}}
+              - **Customer Base:** {{customer_size_notables}}
+              - **Growth Trajectory:** {{growth_trend}}
+              - **Recent Developments:** {{key_news}}
+
+  - id: comparative-analysis
+    title: Comparative Analysis
+    sections:
+      - id: feature-comparison
+        title: Feature Comparison Matrix
+        instruction: Create a detailed comparison table of key features across competitors
+        type: table
+        columns: ["Feature Category", "{{your_company}}", "{{competitor_1}}", "{{competitor_2}}", "{{competitor_3}}"]
+        rows:
+          - category: "Core Functionality"
+            items:
+              - ["Feature A", "{{status}}", "{{status}}", "{{status}}", "{{status}}"]
+              - ["Feature B", "{{status}}", "{{status}}", "{{status}}", "{{status}}"]
+          - category: "User Experience"
+            items:
+              - ["Mobile App", "{{rating}}", "{{rating}}", "{{rating}}", "{{rating}}"]
+              - ["Onboarding Time", "{{time}}", "{{time}}", "{{time}}", "{{time}}"]
+          - category: "Integration & Ecosystem"
+            items:
+              - ["API Availability", "{{availability}}", "{{availability}}", "{{availability}}", "{{availability}}"]
+              - ["Third-party Integrations", "{{number}}", "{{number}}", "{{number}}", "{{number}}"]
+          - category: "Pricing & Plans"
+            items:
+              - ["Starting Price", "{{price}}", "{{price}}", "{{price}}", "{{price}}"]
+              - ["Free Tier", "{{yes_no}}", "{{yes_no}}", "{{yes_no}}", "{{yes_no}}"]
+      - id: swot-comparison
+        title: SWOT Comparison
+        instruction: Create SWOT analysis for your solution vs. top competitors
+        sections:
+          - id: your-solution
+            title: Your Solution
+            template: |
+              - **Strengths:** {{strengths}}
+              - **Weaknesses:** {{weaknesses}}
+              - **Opportunities:** {{opportunities}}
+              - **Threats:** {{threats}}
+          - id: vs-competitor
+            title: "vs. {{main_competitor}}"
+            template: |
+              - **Competitive Advantages:** {{your_advantages}}
+              - **Competitive Disadvantages:** {{their_advantages}}
+              - **Differentiation Opportunities:** {{differentiation}}
+      - id: positioning-map
+        title: Positioning Map
+        instruction: |
+          Describe competitor positions on key dimensions
+          
+          Create a positioning description using 2 key dimensions relevant to the market, such as:
+          - Price vs. Features
+          - Ease of Use vs. Power
+          - Specialization vs. Breadth
+          - Self-Serve vs. High-Touch
+
+  - id: strategic-analysis
+    title: Strategic Analysis
+    sections:
+      - id: competitive-advantages
+        title: Competitive Advantages Assessment
+        sections:
+          - id: sustainable-advantages
+            title: Sustainable Advantages
+            instruction: |
+              Identify moats and defensible positions:
+              - Network effects
+              - Switching costs
+              - Brand strength
+              - Technology barriers
+              - Regulatory advantages
+          - id: vulnerable-points
+            title: Vulnerable Points
+            instruction: |
+              Where competitors could be challenged:
+              - Weak customer segments
+              - Missing features
+              - Poor user experience
+              - High prices
+              - Limited geographic presence
+      - id: blue-ocean
+        title: Blue Ocean Opportunities
+        instruction: |
+          Identify uncontested market spaces
+          
+          List opportunities to create new market space:
+          - Underserved segments
+          - Unaddressed use cases
+          - New business models
+          - Geographic expansion
+          - Different value propositions
+
+  - id: strategic-recommendations
+    title: Strategic Recommendations
+    sections:
+      - id: differentiation-strategy
+        title: Differentiation Strategy
+        instruction: |
+          How to position against competitors:
+          - Unique value propositions to emphasize
+          - Features to prioritize
+          - Segments to target
+          - Messaging and positioning
+      - id: competitive-response
+        title: Competitive Response Planning
+        sections:
+          - id: offensive-strategies
+            title: Offensive Strategies
+            instruction: |
+              How to gain market share:
+              - Target competitor weaknesses
+              - Win competitive deals
+              - Capture their customers
+          - id: defensive-strategies
+            title: Defensive Strategies
+            instruction: |
+              How to protect your position:
+              - Strengthen vulnerable areas
+              - Build switching costs
+              - Deepen customer relationships
+      - id: partnership-ecosystem
+        title: Partnership & Ecosystem Strategy
+        instruction: |
+          Potential collaboration opportunities:
+          - Complementary players
+          - Channel partners
+          - Technology integrations
+          - Strategic alliances
+
+  - id: monitoring-plan
+    title: Monitoring & Intelligence Plan
+    sections:
+      - id: key-competitors
+        title: Key Competitors to Track
+        instruction: Priority list with rationale
+      - id: monitoring-metrics
+        title: Monitoring Metrics
+        instruction: |
+          What to track:
+          - Product updates
+          - Pricing changes
+          - Customer wins/losses
+          - Funding/M&A activity
+          - Market messaging
+      - id: intelligence-sources
+        title: Intelligence Sources
+        instruction: |
+          Where to gather ongoing intelligence:
+          - Company websites/blogs
+          - Customer reviews
+          - Industry reports
+          - Social media
+          - Patent filings
+      - id: update-cadence
+        title: Update Cadence
+        instruction: |
+          Recommended review schedule:
+          - Weekly: {{weekly_items}}
+          - Monthly: {{monthly_items}}
+          - Quarterly: {{quarterly_analysis}} 

package/template/.aiox-core/product/templates/component-react-tmpl.tsx

@@ -0,0 +1,98 @@
+// {{ComponentName}}.tsx
+// Generated by Atlas (Design System Builder)
+// Atomic level: {{atomic_level}}
+// Utility-first Tailwind, zero hardcoded values
+
+import * as React from 'react';
+import { Slot } from '@radix-ui/react-slot';
+import { cva, type VariantProps } from 'class-variance-authority';
+import { cn } from '{{UtilityImportPath}}';
+{{SpinnerImport}}
+
+/**
+ * Variant catalogue generated from consolidated tokens.
+ * Extend with additional groups (state, density, alignment) as needed.
+ */
+export const {{componentName}}Variants = cva(
+  '{{baseClasses}}',
+  {
+    variants: {
+      variant: {
+        {{VariantDefinitions}}
+      },
+      size: {
+        {{SizeDefinitions}}
+      }{{AdditionalVariantGroups}}
+    },
+    compoundVariants: [
+      {{CompoundVariants}}
+    ],
+    defaultVariants: {
+      variant: '{{DefaultVariant}}',
+      size: '{{DefaultSize}}'{{DefaultVariantOverrides}}
+    }
+  }
+);
+
+export interface {{ComponentName}}Props
+  extends React.{{ElementAttributes}}<{{ElementTag}}>,
+    VariantProps<typeof {{componentName}}Variants> {
+  /** Render as child element instead of the default tag */
+  asChild?: boolean;
+  /** Display loading UI and disable interactions */
+  isLoading?: boolean;
+  /** Optional custom loading indicator */
+  loadingIcon?: React.ReactNode;
+  {{AdditionalProps}}
+}
+
+/**
+ * {{ComponentDescription}}
+ *
+ * @example
+ * ```tsx
+ * <{{ComponentName}} variant="{{DefaultVariant}}" size="{{DefaultSize}}">
+ *   {{ExampleContent}}
+ * </{{ComponentName}}>
+ * ```
+ */
+export const {{ComponentName}} = React.forwardRef<{{ElementTag}}, {{ComponentName}}Props>(
+  (
+    {
+      asChild = false,
+      className,
+      variant = '{{DefaultVariant}}',
+      size = '{{DefaultSize}}',
+      isLoading = false,
+      loadingIcon,
+      children,
+      ...props
+    },
+    ref
+  ) => {
+    const Comp = asChild ? Slot : '{{HtmlElement}}';
+
+    return (
+      <Comp
+        ref={ref}
+        className={cn(
+          {{componentName}}Variants({ variant, size }),
+          isLoading && 'pointer-events-none opacity-70',
+          className
+        )}
+        data-state={isLoading ? 'loading' : props['data-state']}
+        {...props}
+      >
+        {isLoading &&
+          (loadingIcon ?? (
+            <{{SpinnerComponent}} className="mr-2 h-4 w-4 animate-spin" aria-hidden="true" />
+          ))}
+        <span className="inline-flex items-center gap-1">{{ChildWrapper}}</span>
+      </Comp>
+    );
+  }
+);
+
+{{ComponentName}}.displayName = '{{ComponentName}}';
+
+export type {{ComponentName}}Variant = VariantProps<typeof {{componentName}}Variants>;

package/template/.aiox-core/product/templates/current-approach-tmpl.md

@@ -0,0 +1,56 @@
+# Current Approach: Subtask {{subtaskId}}
+
+## Summary
+
+{{approach_summary}}
+
+## Key Decisions
+
+{{#each decisions}}
+
+- {{this}}
+  {{/each}}
+
+## Files Being Modified
+
+{{#each files}}
+
+- `{{this.path}}` ({{this.action}})
+  {{/each}}
+
+## Expected Challenges
+
+{{#each expectedChallenges}}
+
+- {{this}}
+  {{/each}}
+
+## Started At
+
+{{startedAt}}
+
+## Attempt Number
+
+{{attemptNumber}}
+
+---
+
+## Recovery Metadata
+
+| Field             | Value                |
+| ----------------- | -------------------- |
+| Story ID          | {{storyId}}          |
+| Subtask ID        | {{subtaskId}}        |
+| Phase             | {{phase}}            |
+| Previous Attempts | {{previousAttempts}} |
+
+## Notes
+
+<!-- Agent notes during implementation -->
+
+{{notes}}
+
+---
+
+_Template Version: 1.0.0_
+_Generated by: ApproachManager_