aios-core 2.2.1 → 2.3.1

package/.aios-core/core/data/workflow-patterns.yaml

@@ -1,267 +0,0 @@
-# Workflow Patterns Definition
-# Defines common AIOS workflow sequences for context detection
-#
-# Version: 1.0
-# Created: 2025-01-15
-# Story: 6.1.2.5 - Contextual Agent Load System
-#
-# Format:
-# - workflow_name: Unique identifier
-# - description: Human-readable workflow description
-# - agent_sequence: Expected sequence of agents used
-# - key_commands: Commands that signal this workflow
-# - trigger_threshold: Minimum matching commands to detect pattern (default: 2)
-
-workflows:
-  # Story Development Workflow (Most Common)
-  story_development:
-    description: "Complete story lifecycle from validation to deployment"
-    agent_sequence:
-      - po         # Story validation
-      - dev        # Implementation
-      - qa         # Quality assurance
-      - devops     # Deployment
-    key_commands:
-      - validate-story-draft
-      - validate-next-story
-      - develop
-      - develop-yolo
-      - develop-interactive
-      - develop-preflight
-      - review-qa
-      - apply-qa-fixes
-      - pre-push-quality-gate
-      - github-pr-automation
-    trigger_threshold: 2
-    typical_duration: "1-5 days"
-    success_indicators:
-      - "Story status: Ready for Review"
-      - "All tests passing"
-      - "PR created and merged"
-    # Workflow transitions (Story 6.1.2.5 - Workflow Navigation)
-    transitions:
-      validated:
-        trigger: "validate-story-draft completed successfully"
-        greeting_message: "Story validated! Ready to implement."
-        next_steps:
-          - command: develop-yolo
-            args_template: "${story_path}"
-            description: "Autonomous YOLO mode (no interruptions)"
-          - command: develop-interactive
-            args_template: "${story_path}"
-            description: "Interactive mode with checkpoints (default)"
-          - command: develop-preflight
-            args_template: "${story_path}"
-            description: "Plan everything upfront, then execute"
-      in_development:
-        trigger: "develop completed successfully"
-        greeting_message: "Development complete! Ready for QA review."
-        next_steps:
-          - command: review-qa
-            args_template: "${story_path}"
-            description: "Run QA review and tests"
-          - command: run-tests
-            args_template: ""
-            description: "Execute test suite manually"
-      qa_reviewed:
-        trigger: "review-qa completed successfully"
-        greeting_message: "QA review complete!"
-        next_steps:
-          - command: apply-qa-fixes
-            args_template: ""
-            description: "Apply QA feedback and fixes"
-          - command: pre-push-quality-gate
-            args_template: ""
-            description: "Run final quality checks before push"
-
-  # Epic Creation Workflow
-  epic_creation:
-    description: "Create and organize epics with initial stories"
-    agent_sequence:
-      - po         # Epic planning
-      - sm         # Story creation
-      - architect  # Technical review
-    key_commands:
-      - create-epic
-      - brownfield-create-epic
-      - create-story
-      - brownfield-create-story
-      - create-next-story
-      - validate-story-draft
-      - analyze-impact
-    trigger_threshold: 2
-    typical_duration: "0.5-2 days"
-    success_indicators:
-      - "Epic documented"
-      - "Initial stories created"
-      - "Stories validated"
-
-  # Backlog Management Workflow
-  backlog_management:
-    description: "Review, prioritize, and schedule backlog items"
-    agent_sequence:
-      - qa         # Backlog review
-      - po         # Prioritization
-      - pm         # Scheduling
-    key_commands:
-      - backlog-add
-      - backlog-update
-      - backlog-review
-      - backlog-debt
-      - backlog-summary
-      - backlog-prioritize
-      - backlog-schedule
-    trigger_threshold: 2
-    typical_duration: "0.5-1 day"
-    success_indicators:
-      - "Backlog items prioritized"
-      - "Sprint planned"
-
-  # Architecture Review Workflow
-  architecture_review:
-    description: "Design review and documentation of architectural decisions"
-    agent_sequence:
-      - architect  # Design and review
-      - qa         # Review validation
-      - dev        # Implementation planning
-    key_commands:
-      - analyze-impact
-      - analyze-framework
-      - create-doc
-      - shard-doc
-      - review-proposal
-      - review-story
-      - architect-analyze-impact
-    trigger_threshold: 2
-    typical_duration: "1-3 days"
-    success_indicators:
-      - "Architecture documented"
-      - "Decision reviewed"
-      - "Implementation plan approved"
-
-  # Git Workflow (DevOps)
-  git_workflow:
-    description: "Version control and deployment workflow"
-    agent_sequence:
-      - dev        # Code changes
-      - devops     # Git operations
-    key_commands:
-      - pre-push-quality-gate
-      - github-pr-automation
-      - repository-cleanup
-      - version-management
-    trigger_threshold: 2
-    typical_duration: "0.5-1 day"
-    success_indicators:
-      - "Changes committed"
-      - "PR created"
-      - "Code merged"
-
-  # Database Development Workflow
-  database_workflow:
-    description: "Database schema design and migration workflow"
-    agent_sequence:
-      - data-engineer  # Schema design
-      - dev            # Migration implementation
-      - qa             # Testing
-    key_commands:
-      - db-domain-modeling
-      - db-schema-audit
-      - db-dry-run
-      - db-apply-migration
-      - db-rollback
-      - db-smoke-test
-      - db-rls-audit
-      - db-verify-order
-    trigger_threshold: 2
-    typical_duration: "1-3 days"
-    success_indicators:
-      - "Schema designed"
-      - "Migrations tested"
-      - "RLS policies validated"
-
-  # Code Quality Improvement Workflow
-  code_quality_workflow:
-    description: "Refactoring and code quality improvements"
-    agent_sequence:
-      - qa         # Quality assessment
-      - dev        # Refactoring
-    key_commands:
-      - improve-code-quality
-      - suggest-refactoring
-      - optimize-performance
-      - security-scan
-      - generate-tests
-      - nfr-assess
-    trigger_threshold: 2
-    typical_duration: "0.5-2 days"
-    success_indicators:
-      - "Code refactored"
-      - "Tests added"
-      - "Quality metrics improved"
-
-  # Documentation Workflow
-  documentation_workflow:
-    description: "Create and synchronize project documentation"
-    agent_sequence:
-      - analyst    # Research and analysis
-      - architect  # Documentation creation
-      - po         # Review
-    key_commands:
-      - document-project
-      - sync-documentation
-      - create-doc
-      - shard-doc
-      - index-docs
-      - generate-documentation
-    trigger_threshold: 2
-    typical_duration: "0.5-2 days"
-    success_indicators:
-      - "Documentation created"
-      - "Documentation synchronized"
-      - "Documentation indexed"
-
-  # UX Design Workflow
-  ux_workflow:
-    description: "User experience design and validation"
-    agent_sequence:
-      - ux-design-expert  # Design
-      - dev               # Implementation
-      - qa                # Validation
-    key_commands:
-      - ux-create-wireframe
-      - ux-user-research
-      - ux-ds-scan-artifact
-      - build-component
-      - audit-codebase
-    trigger_threshold: 2
-    typical_duration: "1-3 days"
-    success_indicators:
-      - "Wireframes created"
-      - "Components implemented"
-      - "UX validated"
-
-  # Brainstorming and Research Workflow
-  research_workflow:
-    description: "Facilitated brainstorming and research sessions"
-    agent_sequence:
-      - analyst    # Research
-      - architect  # Analysis
-      - po         # Documentation
-    key_commands:
-      - analyst-facilitate-brainstorming
-      - advanced-elicitation
-      - create-deep-research-prompt
-      - kb-mode-interaction
-    trigger_threshold: 2
-    typical_duration: "0.5-1 day"
-    success_indicators:
-      - "Research completed"
-      - "Ideas documented"
-      - "Action items created"
-
-# Validation Notes:
-# - Patterns cross-referenced with Epic 6.1 workflow analysis
-# - Commands verified against actual project usage in .aios-core/agents/*.md
-# - Agent sequences match actual workflow patterns from recent stories
-# - Threshold of 2 ensures workflow detection is accurate but not overly sensitive

package/.aios-core/product/templates/1mcp-config.yaml

@@ -1,225 +0,0 @@
-# 1MCP Configuration Template for AIOS
-# Purpose: Define MCP servers and presets for AIOS agents
-# Location: ~/.1mcp/config.json (generated from this template)
-
-# ==============================================================================
-# MCP SERVERS
-# ==============================================================================
-mcps:
-  # Documentation & Research MCP
-  context7:
-    command: "npx"
-    args: ["-y", "@upstash/context7-mcp"]
-    enabled: true
-    description: "Library/framework documentation lookup"
-    use_cases:
-      - "Architecture research"
-      - "API reference lookup"
-      - "Learning new frameworks"
-    agents: ["architect", "analyst", "dev"]
-
-  # GitHub Operations MCP
-  github:
-    command: "npx"
-    args: ["-y", "@modelcontextprotocol/server-github"]
-    enabled: true
-    environment:
-      GITHUB_TOKEN: "${GITHUB_TOKEN}"  # Set in environment
-    description: "GitHub API operations (repos, issues, PRs)"
-    use_cases:
-      - "Story implementation"
-      - "Pull request creation"
-      - "Issue tracking"
-      - "Code review"
-    agents: ["dev", "qa", "sm", "po"]
-
-  # Browser Automation MCP
-  browser:
-    command: "npx"
-    args: ["-y", "@modelcontextprotocol/server-puppeteer"]
-    enabled: true
-    description: "Browser automation and web scraping"
-    use_cases:
-      - "UI testing"
-      - "Web scraping"
-      - "Screenshot generation"
-      - "Integration testing"
-    agents: ["qa", "dev", "analyst"]
-
-  # Docker & Containers MCP (disabled by default)
-  docker:
-    command: "npx"
-    args: ["-y", "@docker/mcp-server-docker-desktop"]
-    enabled: false  # Enable only when needed
-    description: "Docker container management"
-    use_cases:
-      - "Container operations"
-      - "Docker Compose management"
-      - "Image building"
-      - "Deployment automation"
-    agents: ["devops", "sm"]
-
-# ==============================================================================
-# PRESETS (Agent-Specific Configurations)
-# ==============================================================================
-presets:
-  # Development Preset (Default)
-  aios-dev:
-    filter: ["github", "browser"]
-    description: "Story implementation, PRs, development tasks"
-    token_budget: "25-40K"
-    agents: ["dev", "qa", "sm"]
-    use_cases:
-      - "Story implementation (docs/stories/*.md)"
-      - "Pull request creation"
-      - "Code review and validation"
-      - "Issue tracking and management"
-      - "Sprint planning"
-    recommended: true
-
-  # Research Preset
-  aios-research:
-    filter: ["context7", "browser"]
-    description: "Documentation-heavy research and learning"
-    token_budget: "40-60K"
-    agents: ["architect", "analyst"]
-    use_cases:
-      - "Architecture design and research"
-      - "Framework evaluation"
-      - "API reference lookup"
-      - "Best practices research"
-      - "Documentation writing"
-    recommended: false
-
-  # Docker Preset (On-Demand)
-  aios-docker:
-    filter: ["docker", "browser"]
-    description: "Container management and deployment"
-    token_budget: "15-20K"
-    agents: ["devops"]
-    use_cases:
-      - "Docker container operations"
-      - "Deployment automation"
-      - "Integration testing with containers"
-      - "Service orchestration"
-    recommended: false
-    enable_only_when_needed: true
-
-  # Full Preset (Rare Use)
-  aios-full:
-    filter: ["context7", "github", "browser"]
-    description: "Complex multi-domain tasks requiring all tools"
-    token_budget: "60-80K"
-    agents: ["all"]
-    use_cases:
-      - "Complex exploratory work"
-      - "Emergency debugging (need all tools)"
-      - "Multi-domain integration tasks"
-    recommended: false
-    warning: "Use sparingly - higher token cost"
-
-# ==============================================================================
-# SERVER CONFIGURATION
-# ==============================================================================
-server:
-  port: 3050
-  host: "127.0.0.1"  # Localhost only (security)
-  timeout: 30000     # 30 seconds
-  max_retries: 3
-
-# ==============================================================================
-# MONITORING & LOGGING
-# ==============================================================================
-monitoring:
-  enabled: true
-  metrics:
-    track_token_usage: true
-    track_preset_usage: true
-    track_mcp_errors: true
-  logging:
-    level: "info"  # "debug" | "info" | "warn" | "error"
-    file: "~/.1mcp/logs/server.log"
-
-# ==============================================================================
-# AIOS INTEGRATION
-# ==============================================================================
-aios_integration:
-  # Automatic preset selection based on agent
-  auto_preset_selection:
-    enabled: true
-    mappings:
-      dev: "aios-dev"
-      qa: "aios-dev"
-      sm: "aios-dev"
-      po: "aios-dev"
-      architect: "aios-research"
-      analyst: "aios-research"
-      devops: "aios-docker"
-
-  # Token budget alerts
-  token_budget_alerts:
-    enabled: true
-    warn_threshold: 50000   # Warn if > 50K tokens
-    error_threshold: 80000  # Error if > 80K tokens
-
-  # Automatic fallback
-  fallback:
-    enabled: true
-    if_preset_fails: "aios-dev"  # Fallback to dev preset
-    if_server_down: "direct_mcp"  # Fallback to direct MCPs
-
-# ==============================================================================
-# USAGE EXAMPLES
-# ==============================================================================
-examples:
-  # Example 1: Story Implementation (@dev agent)
-  story_implementation:
-    agent: "dev"
-    preset: "aios-dev"
-    mcps_used: ["github", "browser"]
-    token_budget: "~35K"
-    workflow:
-      - "Read story file (filesystem)"
-      - "Search related code (github.search_code)"
-      - "Implement changes (filesystem.write)"
-      - "Create PR (github.create_pr)"
-      - "Update story progress (filesystem.write)"
-
-  # Example 2: Architecture Research (@architect agent)
-  architecture_research:
-    agent: "architect"
-    preset: "aios-research"
-    mcps_used: ["context7", "browser"]
-    token_budget: "~50K"
-    workflow:
-      - "Look up framework docs (context7)"
-      - "Browse examples (browser.navigate)"
-      - "Research best practices (context7 + browser)"
-      - "Document findings (filesystem.write)"
-
-  # Example 3: Docker Deployment (@devops)
-  docker_deployment:
-    agent: "devops"
-    preset: "aios-docker"
-    mcps_used: ["docker", "browser"]
-    token_budget: "~18K"
-    workflow:
-      - "Build Docker image (docker.build)"
-      - "Run container (docker.run)"
-      - "Test deployment (browser.navigate)"
-      - "Verify health (browser.screenshot)"
-
-# ==============================================================================
-# NOTES
-# ==============================================================================
-notes:
-  token_reduction: "85% (280K → 40K with aios-dev)"
-  production_ready: true
-  validated_by: "AIOS Roundtable 2025-01-14"
-  experts:
-    - "Pedro Valério (Systems Architecture)"
-    - "Mitchell Hashimoto (Infrastructure)"
-    - "Andrej Karpathy (AI Systems)"
-    - "Guillermo Rauch (Developer Experience)"
-  decision: "Use 1MCP (Phase 1), defer TOON to Phase 2 pending benchmark"
-  documentation: "docs/guides/1mcp-implementation.md"