create-genia-os 2.4.0 → 3.0.0

package/template/.aiox-core/development/workflows/story-development-cycle.yaml

@@ -0,0 +1,284 @@
+workflow:
+  id: story-development-cycle
+  name: Story Development Cycle
+  version: "1.0"
+  description: >-
+    Ciclo completo de desenvolvimento de stories. Automatiza o fluxo desde a criação
+    até a entrega com quality gate: create → validate → implement → QA review.
+    Aplicável a projetos greenfield e brownfield.
+  type: generic
+  project_types:
+    - greenfield
+    - brownfield
+    - feature-development
+    - bug-fix
+    - enhancement
+
+  metadata:
+    elicit: true
+    confirmation_required: true
+
+  execution_modes:
+    - mode: yolo
+      description: Execução autônoma com mínima interação
+      prompts: 0-1
+    - mode: interactive
+      description: Checkpoints de decisão e feedback educacional
+      prompts: 5-10
+      default: true
+    - mode: preflight
+      description: Planejamento completo antes da execução - análise upfront de requisitos e dependências
+      prompts: "10-15"
+
+  phases:
+    - phase_1: Story Creation
+    - phase_2: Story Validation
+    - phase_3: Implementation
+    - phase_4: QA Review
+
+  sequence:
+    - step: create_story
+      id: create
+      phase: 1
+      agent: sm
+      action: Criar próxima story
+      notes: |
+        Scrum Master cria a próxima story do backlog:
+        - Usa task create-next-story para stories de PRD shardado
+        - Usa task brownfield-create-story para projetos brownfield
+        - Define acceptance criteria claros
+        - Estabelece escopo e dependências
+        - Story inicia com status "Draft"
+
+        Entrada requerida:
+        - PRD shardado OU documentação do projeto
+        - Contexto do epic/feature
+
+        Critérios de sucesso:
+        - [ ] Story criada com título descritivo
+        - [ ] Acceptance criteria definidos
+        - [ ] Escopo claro e delimitado
+        - [ ] Dependências identificadas
+      outputs:
+        - story_file
+        - story_id
+      next: validate
+
+    - step: validate_story
+      id: validate
+      phase: 2
+      agent: po
+      action: Validar story (10 checks)
+      requires: create
+      notes: |
+        Product Owner valida a story com checklist de 10 pontos:
+
+        Checklist de validação:
+        - [ ] 1. Título claro e objetivo
+        - [ ] 2. Descrição completa do problema/necessidade
+        - [ ] 3. Acceptance criteria testáveis (Given/When/Then)
+        - [ ] 4. Escopo bem definido (o que está IN e OUT)
+        - [ ] 5. Dependências mapeadas
+        - [ ] 6. Estimativa de complexidade adequada
+        - [ ] 7. Valor de negócio identificado
+        - [ ] 8. Riscos documentados
+        - [ ] 9. Critérios de Done claros
+        - [ ] 10. Alinhamento com PRD/Epic
+
+        Resultado:
+        - Aprovada → Status muda para "Ready"
+        - Rejeitada → Retorna para SM com feedback
+
+        Critérios de sucesso:
+        - [ ] Todos os 10 checks passaram
+        - [ ] Story marcada como "Ready"
+      outputs:
+        - validation_report
+        - story_status
+      next: implement
+      on_failure: create
+
+    - step: implement_story
+      id: implement
+      phase: 3
+      agent: dev
+      action: Implementar story
+      requires: validate
+      notes: |
+        Dev Agent implementa a story validada:
+        - Analisa acceptance criteria
+        - Planeja implementação técnica
+        - Escreve código seguindo padrões do projeto
+        - Cria/atualiza testes unitários
+        - Atualiza File List na story
+        - Marca story como "In Review" ao finalizar
+
+        Boas práticas:
+        - Commits atômicos e bem descritos
+        - Código limpo e documentado
+        - Testes cobrindo acceptance criteria
+        - Sem débito técnico novo
+
+        Critérios de sucesso:
+        - [ ] Todos os acceptance criteria implementados
+        - [ ] Testes passando
+        - [ ] File List atualizada
+        - [ ] Código commitado
+        - [ ] Story status = "In Review"
+      outputs:
+        - implementation_files
+        - test_results
+        - commit_hash
+      next: review
+
+    - step: qa_review
+      id: review
+      phase: 4
+      agent: qa
+      action: Review final + quality gate
+      requires: implement
+      notes: |
+        QA Agent executa review final com quality gate:
+
+        Quality Gate Checks:
+        - [ ] Code review (padrões, legibilidade, manutenibilidade)
+        - [ ] Testes unitários adequados e passando
+        - [ ] Acceptance criteria atendidos
+        - [ ] Sem regressões introduzidas
+        - [ ] Performance aceitável
+        - [ ] Segurança verificada (OWASP basics)
+        - [ ] Documentação atualizada se necessário
+
+        Ações do QA:
+        - Corrige issues menores diretamente
+        - Documenta issues maiores para Dev resolver
+        - Aprova ou rejeita com feedback
+
+        Resultado:
+        - Aprovada → Status muda para "Done"
+        - Rejeitada → Retorna para Dev com checklist de fixes
+
+        Critérios de sucesso:
+        - [ ] Quality gate passou
+        - [ ] Story marcada como "Done"
+      outputs:
+        - qa_report
+        - quality_gate_status
+        - story_final_status
+      next: complete
+      on_failure: implement
+
+    - workflow_end:
+      id: complete
+      action: story_complete
+      notes: |
+        Story concluída com sucesso!
+
+        Ciclo completado:
+        ✅ Story criada (SM)
+        ✅ Story validada (PO)
+        ✅ Story implementada (Dev)
+        ✅ Quality gate aprovado (QA)
+
+        Próximos passos:
+        - Executar novamente para próxima story
+        - Ou iniciar novo ciclo: *workflow story-development-cycle
+
+  flow_diagram: |
+    ```mermaid
+    graph TD
+        A[Start: Story Development Cycle] --> B[sm: Criar próxima story]
+        B --> C[po: Validar story - 10 checks]
+
+        C --> D{Validação OK?}
+        D -->|Não| E[Feedback para SM]
+        E --> B
+        D -->|Sim| F[dev: Implementar story]
+
+        F --> G[qa: Review + Quality Gate]
+
+        G --> H{Quality Gate OK?}
+        H -->|Não| I[Feedback para Dev]
+        I --> F
+        H -->|Sim| J[Story Done!]
+
+        J --> K{Mais stories?}
+        K -->|Sim| B
+        K -->|Não| L[Ciclo Completo]
+
+        style L fill:#90EE90
+        style J fill:#90EE90
+        style B fill:#87CEEB
+        style C fill:#FFE4B5
+        style F fill:#98FB98
+        style G fill:#DDA0DD
+        style E fill:#FFB6C1
+        style I fill:#FFB6C1
+    ```
+
+  decision_guidance:
+    when_to_use:
+      - Desenvolvimento de qualquer story (greenfield ou brownfield)
+      - Ciclo completo com validação e quality gate
+      - Quando precisa de rastreabilidade do processo
+      - Equipes que seguem processo ágil estruturado
+
+    when_not_to_use:
+      - Hotfixes urgentes (use fluxo simplificado)
+      - Spikes/POCs exploratórios
+      - Tasks puramente técnicas sem story
+
+  handoff_prompts:
+    story_created: |
+      Story criada com sucesso!
+      ID: {{story_id}}
+      Título: {{story_title}}
+      Status: Draft
+
+      Prosseguindo para validação com PO...
+
+    story_validated: |
+      Story validada pelo PO!
+      Checks aprovados: {{passed_checks}}/10
+      Status: Ready
+
+      Story pronta para implementação...
+
+    story_implemented: |
+      Story implementada pelo Dev!
+      Arquivos modificados: {{file_count}}
+      Testes: {{test_status}}
+      Commits: {{commit_count}}
+      Status: In Review
+
+      Iniciando QA review...
+
+    story_approved: |
+      Story aprovada no Quality Gate!
+      Status: Done
+
+      Ciclo completo para story {{story_id}}.
+      Execute novamente para próxima story.
+
+    story_rejected_validation: |
+      Story rejeitada na validação.
+      Issues encontradas: {{issue_list}}
+
+      Retornando para SM ajustar...
+
+    story_rejected_qa: |
+      Story rejeitada no Quality Gate.
+      Issues para resolver: {{issue_list}}
+
+      Retornando para Dev corrigir...
+
+metadata:
+  author: Orion (AIOX Master)
+  created_date: 2025-01-30
+  version: 1.0.0
+  tags:
+    - story
+    - development-cycle
+    - quality-gate
+    - agile
+    - generic

package/template/.aiox-core/elicitation/agent-elicitation.js

@@ -0,0 +1,272 @@
+/**
+ * Agent Creation Elicitation Workflow
+ * Progressive disclosure for creating new agents
+ */
+
+const agentElicitationSteps = [
+  {
+    title: 'Basic Agent Information',
+    description: 'Let\'s start with the fundamental details about your agent',
+    help: 'An agent is a specialized AI assistant with a specific role and set of capabilities. Think of it as a team member with expertise in a particular area.',
+    questions: [
+      {
+        type: 'input',
+        name: 'agentName',
+        message: 'What is the agent\'s name?',
+        examples: ['data-analyst', 'code-reviewer', 'project-manager'],
+        validate: (input) => {
+          if (!input) return 'Agent name is required';
+          if (!/^[a-z][a-z0-9-]*$/.test(input)) {
+            return 'Name must be lowercase with hyphens only (e.g., data-analyst)';
+          }
+          return true;
+        },
+      },
+      {
+        type: 'input',
+        name: 'agentTitle',
+        message: 'What is the agent\'s professional title?',
+        examples: ['Senior Data Analyst', 'Code Review Specialist', 'Project Manager'],
+        smartDefault: {
+          type: 'fromAnswer',
+          source: 'agentName',
+          transform: (name) => name.split('-').map(w => 
+            w.charAt(0).toUpperCase() + w.slice(1),
+          ).join(' '),
+        },
+      },
+      {
+        type: 'input',
+        name: 'agentIcon',
+        message: 'Choose an emoji icon for this agent',
+        examples: ['📊', '🔍', '📋', '🚀', '🛡️'],
+        default: '🤖',
+      },
+      {
+        type: 'input',
+        name: 'whenToUse',
+        message: 'When should users activate this agent? (one line)',
+        examples: [
+          'Use for data analysis and visualization tasks',
+          'Use for code review and quality assurance',
+          'Use for project planning and tracking',
+        ],
+      },
+    ],
+    required: ['agentName', 'agentTitle', 'whenToUse'],
+  },
+  
+  {
+    title: 'Agent Persona & Style',
+    description: 'Define how your agent communicates and behaves',
+    help: 'The persona defines the agent\'s personality, communication style, and approach to tasks.',
+    questions: [
+      {
+        type: 'input',
+        name: 'personaRole',
+        message: 'What is the agent\'s professional role?',
+        examples: [
+          'Expert Data Scientist & Analytics Specialist',
+          'Senior Software Engineer & Code Quality Expert',
+          'Agile Project Manager & Scrum Master',
+        ],
+      },
+      {
+        type: 'input',
+        name: 'personaStyle',
+        message: 'Describe their communication style',
+        examples: [
+          'analytical, precise, data-driven',
+          'thorough, constructive, detail-oriented',
+          'organized, proactive, collaborative',
+        ],
+        default: 'professional, helpful, focused',
+      },
+      {
+        type: 'input',
+        name: 'personaIdentity',
+        message: 'What is their core identity? (one sentence)',
+        examples: [
+          'A data expert who transforms raw data into actionable insights',
+          'A code quality guardian who ensures best practices',
+          'A project orchestrator who keeps teams aligned and productive',
+        ],
+      },
+      {
+        type: 'list',
+        name: 'personaFocus',
+        message: 'What is their primary focus area?',
+        choices: [
+          'Technical implementation',
+          'Analysis and insights',
+          'Process and workflow',
+          'Quality and standards',
+          'Communication and documentation',
+          'Other (specify)',
+        ],
+      },
+      {
+        type: 'input',
+        name: 'personaFocusCustom',
+        message: 'Specify the focus area:',
+        when: (answers) => answers.personaFocus === 'Other (specify)',
+      },
+    ],
+    required: ['personaRole', 'personaStyle', 'personaIdentity'],
+  },
+  
+  {
+    title: 'Agent Commands',
+    description: 'Define what commands this agent will respond to',
+    help: 'Commands are actions users can request from the agent. Each command should have a clear purpose.',
+    questions: [
+      {
+        type: 'checkbox',
+        name: 'standardCommands',
+        message: 'Select standard commands to include:',
+        choices: [
+          { name: 'analyze - Perform analysis on data/code', value: 'analyze' },
+          { name: 'create - Generate new content/files', value: 'create' },
+          { name: 'review - Review existing work', value: 'review' },
+          { name: 'suggest - Provide recommendations', value: 'suggest' },
+          { name: 'explain - Explain concepts or code', value: 'explain' },
+          { name: 'validate - Check for errors/issues', value: 'validate' },
+          { name: 'report - Generate reports', value: 'report' },
+        ],
+        default: ['analyze', 'create', 'suggest'],
+      },
+      {
+        type: 'confirm',
+        name: 'addCustomCommands',
+        message: 'Would you like to add custom commands?',
+        default: false,
+      },
+      {
+        type: 'input',
+        name: 'customCommands',
+        message: 'Enter custom commands (comma-separated, format: "name:description"):',
+        when: (answers) => answers.addCustomCommands,
+        examples: ['optimize:Optimize performance', 'debug:Debug issues'],
+        filter: (input) => input.split(',').map(cmd => cmd.trim()),
+      },
+    ],
+  },
+  
+  {
+    title: 'Dependencies & Resources',
+    description: 'Specify what resources this agent needs',
+    help: 'Dependencies are tasks, templates, or data files the agent needs to function properly.',
+    questions: [
+      {
+        type: 'checkbox',
+        name: 'dependencyTypes',
+        message: 'What types of dependencies does this agent need?',
+        choices: [
+          { name: 'Tasks - Reusable task workflows', value: 'tasks' },
+          { name: 'Templates - Document/code templates', value: 'templates' },
+          { name: 'Checklists - Quality checklists', value: 'checklists' },
+          { name: 'Data - Reference data files', value: 'data' },
+        ],
+      },
+      {
+        type: 'input',
+        name: 'taskDependencies',
+        message: 'Enter task dependencies (comma-separated):',
+        when: (answers) => answers.dependencyTypes.includes('tasks'),
+        examples: ['analyze-data.md', 'generate-report.md'],
+        filter: (input) => input ? input.split(',').map(t => t.trim()) : [],
+      },
+      {
+        type: 'input',
+        name: 'templateDependencies',
+        message: 'Enter template dependencies (comma-separated):',
+        when: (answers) => answers.dependencyTypes.includes('templates'),
+        examples: ['report-template.md', 'analysis-template.yaml'],
+        filter: (input) => input ? input.split(',').map(t => t.trim()) : [],
+      },
+    ],
+  },
+  
+  {
+    title: 'Security & Access Control',
+    description: 'Configure security settings for this agent',
+    help: 'Security settings control what the agent can access and who can use it.',
+    condition: { field: 'agentName', operator: 'exists' },
+    questions: [
+      {
+        type: 'list',
+        name: 'securityLevel',
+        message: 'What security level should this agent have?',
+        choices: [
+          { name: 'Standard - Default permissions', value: 'standard' },
+          { name: 'Elevated - Additional capabilities', value: 'elevated' },
+          { name: 'Restricted - Limited access', value: 'restricted' },
+          { name: 'Custom - Define specific permissions', value: 'custom' },
+        ],
+        default: 'standard',
+      },
+      {
+        type: 'confirm',
+        name: 'requireAuthorization',
+        message: 'Should this agent require special authorization to activate?',
+        default: false,
+        when: (answers) => answers.securityLevel !== 'standard',
+      },
+      {
+        type: 'confirm',
+        name: 'enableAuditLogging',
+        message: 'Enable audit logging for this agent\'s operations?',
+        default: true,
+        when: (answers) => answers.securityLevel !== 'standard',
+      },
+      {
+        type: 'checkbox',
+        name: 'allowedOperations',
+        message: 'Select allowed operations:',
+        when: (answers) => answers.securityLevel === 'custom',
+        choices: [
+          'file_read',
+          'file_write',
+          'file_delete',
+          'execute_commands',
+          'network_access',
+          'memory_access',
+          'manifest_update',
+        ],
+      },
+    ],
+  },
+  
+  {
+    title: 'Advanced Options',
+    description: 'Configure advanced agent features',
+    condition: { field: 'securityLevel', operator: 'notEquals', value: 'standard' },
+    questions: [
+      {
+        type: 'confirm',
+        name: 'enableMemoryLayer',
+        message: 'Enable memory layer integration?',
+        default: true,
+      },
+      {
+        type: 'input',
+        name: 'corePrinciples',
+        message: 'Enter core principles for this agent (comma-separated):',
+        examples: [
+          'Always validate data before processing',
+          'Follow security best practices',
+          'Provide clear explanations',
+        ],
+        filter: (input) => input ? input.split(',').map(p => p.trim()) : [],
+      },
+      {
+        type: 'input',
+        name: 'customActivationInstructions',
+        message: 'Any special activation instructions? (optional)',
+        examples: ['Load specific context on activation', 'Initialize connections'],
+      },
+    ],
+  },
+];
+
+module.exports = agentElicitationSteps;