create-genia-os 2.4.0 → 3.0.0

package/template/.aiox-core/development/tasks/analyze-cross-artifact.md

@@ -0,0 +1,357 @@
+# Cross-Artifact Analysis Task
+
+> **Command:** `*analyze`
+> **Owner Agent:** @qa (can be invoked by any agent)
+> **Mode:** Read-only (no file modifications)
+
+---
+
+## Purpose
+
+Executar análise de consistência cross-artifact para identificar gaps, inconsistências, e ambiguidades entre PRD, Architecture, Stories, e Specs. Produz relatório consolidado com severidades e recomendações.
+
+**Inspirado por:** GitHub Spec-Kit `/speckit.analyze`
+
+---
+
+## autoClaude
+
+```yaml
+autoClaude:
+  version: '3.0'
+
+  elicit: false
+  deterministic: true
+  composable: true
+  readOnly: true  # CRITICAL: This task NEVER modifies files
+
+  inputs:
+    - name: scope
+      type: enum
+      values: [all, prd, architecture, stories, specs]
+      required: false
+      default: all
+      description: Escopo da análise
+
+    - name: storyId
+      type: string
+      required: false
+      description: Analisar story específica (opcional)
+
+  outputs:
+    - name: analysis_report
+      type: stdout
+      format: markdown
+      description: Relatório consolidado (não salva arquivo)
+
+  verification:
+    type: manual
+    description: Revisão humana do relatório
+```
+
+---
+
+## Constitutional Reference
+
+> **Reference:** Constitution Article V - Quality First
+> **Purpose:** Garantir qualidade e consistência antes de implementação
+
+---
+
+## Analysis Passes
+
+### Pass 1: Coverage Gaps
+
+```yaml
+coverage_analysis:
+  description: Identificar requisitos sem implementação e vice-versa
+
+  checks:
+    - name: requirements_without_tasks
+      description: Requisitos em PRD/spec sem tasks correspondentes
+      severity: HIGH
+
+    - name: tasks_without_requirements
+      description: Tasks sem requisito rastreável
+      severity: MEDIUM
+
+    - name: acceptance_criteria_coverage
+      description: Critérios de aceite sem testes
+      severity: HIGH
+
+    - name: stories_without_specs
+      description: Stories sem especificação formal
+      severity: MEDIUM
+```
+
+### Pass 2: Consistency Check
+
+```yaml
+consistency_analysis:
+  description: Detectar inconsistências entre artefatos
+
+  checks:
+    - name: prd_vs_architecture
+      description: PRD menciona features não cobertas na arquitetura
+      severity: HIGH
+      sources: [docs/prd.md, docs/prd/, docs/architecture.md, docs/architecture/]
+
+    - name: architecture_vs_stories
+      description: Decisões arquiteturais não refletidas em stories
+      severity: MEDIUM
+
+    - name: spec_vs_story
+      description: Spec diverge dos acceptance criteria da story
+      severity: HIGH
+
+    - name: terminology_drift
+      description: Mesmo conceito com nomes diferentes
+      severity: LOW
+```
+
+### Pass 3: Ambiguity Detection
+
+```yaml
+ambiguity_analysis:
+  description: Identificar áreas sub-especificadas
+
+  checks:
+    - name: vague_requirements
+      patterns:
+        - "should be fast"
+        - "user-friendly"
+        - "as needed"
+        - "etc."
+        - "TBD"
+        - "TODO"
+      severity: MEDIUM
+
+    - name: missing_acceptance_criteria
+      description: Stories sem critérios mensuráveis
+      severity: HIGH
+
+    - name: unresolved_questions
+      description: Open Questions não resolvidas em specs
+      severity: MEDIUM
+
+    - name: assumption_not_validated
+      description: Assumptions sem validação documentada
+      severity: LOW
+```
+
+### Pass 4: Constitution Compliance
+
+```yaml
+constitution_compliance:
+  description: Verificar aderência aos princípios constitucionais
+
+  checks:
+    - name: cli_first_violation
+      article: I
+      description: UI implementada sem CLI correspondente
+      severity: CRITICAL
+
+    - name: no_invention_violation
+      article: IV
+      description: Spec com conteúdo não rastreável
+      severity: CRITICAL
+
+    - name: story_driven_violation
+      article: III
+      description: Código sem story associada
+      severity: HIGH
+```
+
+---
+
+## Severity Levels
+
+| Severity | Descrição | Ação |
+|----------|-----------|------|
+| **CRITICAL** | Viola Constitution, bloqueia progresso | MUST fix before continue |
+| **HIGH** | Gap significativo, risco alto | SHOULD fix before implementation |
+| **MEDIUM** | Inconsistência moderada | Consider fixing |
+| **LOW** | Melhoria de qualidade | Nice to have |
+
+---
+
+## Execution Flow
+
+```yaml
+execution:
+  steps:
+    - id: 1-gather
+      action: Coletar todos os artefatos no escopo
+      files:
+        - docs/prd.md OR docs/prd/**/*.md
+        - docs/architecture.md OR docs/architecture/**/*.md
+        - docs/stories/**/story.yaml
+        - docs/stories/**/spec/*.md
+        - docs/stories/**/spec/*.json
+
+    - id: 2-parse
+      action: Extrair estrutura de cada artefato
+      extract:
+        - requirements (FR-*, NFR-*, CON-*)
+        - acceptance_criteria
+        - tasks
+        - decisions
+        - open_questions
+        - assumptions
+
+    - id: 3-analyze
+      action: Executar 4 passes de análise
+      passes: [coverage, consistency, ambiguity, constitution]
+
+    - id: 4-aggregate
+      action: Consolidar findings por severidade
+
+    - id: 5-report
+      action: Gerar relatório markdown
+```
+
+---
+
+## Report Format
+
+````markdown
+# Cross-Artifact Analysis Report
+
+> **Generated:** {timestamp}
+> **Scope:** {scope}
+> **Analyzed:** {file_count} files
+
+---
+
+## Executive Summary
+
+| Severity | Count |
+|----------|-------|
+| CRITICAL | {n} |
+| HIGH | {n} |
+| MEDIUM | {n} |
+| LOW | {n} |
+
+**Overall Health:** {HEALTHY | CONCERNS | AT_RISK | BLOCKED}
+
+---
+
+## Critical Findings (MUST FIX)
+
+### Finding C1: {title}
+- **Category:** {constitution_violation | coverage_gap | inconsistency}
+- **Location:** {file:line or artifact reference}
+- **Description:** {details}
+- **Resolution:** {recommended action}
+
+---
+
+## High Priority Findings
+
+### Finding H1: {title}
+...
+
+---
+
+## Coverage Metrics
+
+| Metric | Value | Target |
+|--------|-------|--------|
+| Requirements with tasks | {n}% | 100% |
+| Tasks with requirements | {n}% | 100% |
+| Acceptance criteria with tests | {n}% | 80% |
+| Stories with specs | {n}% | 100% |
+
+---
+
+## Recommendations
+
+1. **Immediate:** {critical fixes}
+2. **Before Implementation:** {high priority fixes}
+3. **Improvement:** {medium/low fixes}
+
+---
+
+## Files Analyzed
+
+- {file1}
+- {file2}
+- ...
+
+---
+
+*Report generated by AIOX Cross-Artifact Analysis*
+*Reference: Constitution Article V - Quality First*
+````
+
+---
+
+## Usage Examples
+
+```bash
+# Análise completa do projeto
+*analyze
+
+# Análise apenas de stories
+*analyze --scope stories
+
+# Análise de story específica
+*analyze --story 2.1
+
+# Análise com foco em PRD vs Architecture
+*analyze --scope prd,architecture
+```
+
+---
+
+## Integration with Existing Checklists
+
+Esta task agrega e referencia os seguintes checklists existentes:
+
+| Checklist | Uso na Análise |
+|-----------|----------------|
+| `architect-checklist.md` | Pass 2: PRD vs Architecture |
+| `story-draft-checklist.md` | Pass 3: Ambiguity in stories |
+| `story-dod-checklist.md` | Pass 1: Coverage gaps |
+| `pm-checklist.md` | Pass 2: PRD consistency |
+| `po-master-checklist.md` | Pass 1: Story coverage |
+
+---
+
+## Error Handling
+
+```yaml
+errors:
+  - condition: No PRD found
+    action: WARN and continue with available artifacts
+
+  - condition: No stories found
+    action: WARN and limit analysis to PRD/Architecture
+
+  - condition: Parse error in artifact
+    action: Report error, skip file, continue analysis
+
+  - condition: Empty analysis (no findings)
+    action: Report "HEALTHY" status
+```
+
+---
+
+## Metadata
+
+```yaml
+metadata:
+  version: 1.0.0
+  created: 2025-01-30
+  inspired_by: GitHub Spec-Kit /speckit.analyze
+  tags:
+    - quality
+    - analysis
+    - cross-artifact
+    - read-only
+```
+
+---
+
+*Cross-Artifact Analysis Task v1.0.0*
+*CLI First | Quality First | Read-Only*