auroq-os 2.2.3 → 2.3.1

package/agents/squad-forge/tasks/generate-prd.md

@@ -1,265 +0,0 @@
----
-task: "Generate PRD"
-responsavel: "@forge-smith"
-responsavel_type: "agent"
-atomic_layer: "task"
-Entrada: "02-process-map/process-map.yaml, 01-extraction/process-units.yaml"
-Saida: "docs/prd/squad-{slug}.md"
-Checklist:
-  - "Visao do squad clara (1 paragrafo)"
-  - "Escopo definido (in-scope + out-of-scope)"
-  - "Personas extraidas do processo"
-  - "FRs derivadas de PU-STEPs (rastreaveis)"
-  - "NFRs derivadas de PU-QUALITY_GATEs"
-  - "Constraints derivadas de PU-DEPENDENCYs externas"
-  - "Success criteria mensuraveis"
-  - "Cada secao referencia PU-IDs de origem"
-execution_type: "semantic"
----
-
-# Task: Generate PRD — Product Requirements Document do Squad
-
-**Task ID:** squad-forge/generate-prd
-**Version:** 1.0.0
-**Status:** Production Ready
-**Created:** 2026-05-05
-**Category:** Documentation
-**Execution Type:** Semantic
-
----
-
-## Executive Summary
-
-Apos Playback validado (Fase 2), antes de Arquitetura (Fase 3), gerar PRD do squad em `docs/prd/squad-{slug}.md`. Cumpre Article III da Constitution (Story-Driven Development) — squad e desenvolvido a partir de PRD, nao de improviso.
-
-**Posicao no Workflow:** Sub-task da Fase 3 (Step 0 do architect-squad)
-**Definicao de Sucesso:** PRD com FRs/NFRs/Constraints rastreaveis aos PUs
-**Gate:** Parte de QG-SF-003
-
----
-
-## Purpose
-
-Story-driven development e Article III da Constitution Auroq — NON-NEGOTIABLE. Hoje o squad-forge gera squad sem PRD, sem stories, sem rastreabilidade. Esta task corrige.
-
-PRD e ponte entre processo extraido (PUs) e arquitetura do squad. Sem PRD, decisoes arquiteturais ficam implicitas. Com PRD, sao defendidas.
-
----
-
-## Pipeline Visual
-
-```
-generate-prd
-  |
-  v
-STEP 1: LOAD PROCESS MAP + PUs
-  |
-  v
-STEP 2: EXTRACT VISION
-  Visao + escopo (in/out)
-  |
-  v
-STEP 3: EXTRACT PERSONAS
-  Quem usa o squad
-  |
-  v
-STEP 4: DERIVE FRs (Functional Requirements)
-  Cada PU-STEP → FR rastreavel
-  |
-  v
-STEP 5: DERIVE NFRs (Non-Functional Requirements)
-  Cada PU-QUALITY_GATE → NFR
-  |
-  v
-STEP 6: DERIVE CONSTRAINTS
-  PU-DEPENDENCYs externas → CONs
-  |
-  v
-STEP 7: DEFINE SUCCESS CRITERIA
-  Mensuraveis, derivados de PUs
-  |
-  v
-STEP 8: WRITE PRD
-  docs/prd/squad-{slug}.md
-```
-
----
-
-## Step-by-Step Execution
-
-### Step 1: Load Process Map + PUs
-
-Ler:
-- `02-process-map/process-map.yaml`
-- `01-extraction/process-units.yaml`
-
-### Step 2: Extract Vision
-
-Da descricao do processo no process-map + PU-STEPs iniciais:
-
-**Visao (1 paragrafo):** O que esse squad existe pra fazer. Quem se beneficia. Como difere de fazer manualmente.
-
-**Escopo:**
-- **In-scope:** o que o squad cobre (lista de capacidades derivadas dos PU-STEPs)
-- **Out-of-scope:** o que NAO cobre (derivado de external_dependencies do state.json + PUs marcadas como "humano so")
-
-### Step 3: Extract Personas
-
-Da metadata do process-map + PUs:
-
-**Persona Primaria:**
-- Nome do papel (ex: "Estrategista de lancamento", "Tecnico de trafego")
-- Contexto (vem de scope do state.json)
-- Objetivo principal ao usar o squad
-- Frequencia de uso
-
-**Personas Secundarias** (se aplicavel): outras pessoas que interagem com output do squad.
-
-### Step 4: Derive Functional Requirements (FRs)
-
-Para cada PU-STEP, gerar FR:
-
-```markdown
-**FR-001:** {Descricao funcional baseada no PU-STEP}
-- Origem: PU-STEP-xxx (trace)
-- Agente responsavel: {agent-id} (do blueprint)
-- Acceptance criteria:
-  - [ ] {Criterio derivado de PU-QUALITY_GATE associada}
-  - [ ] {Criterio derivado de PU-OUTPUT associado}
-```
-
-Cada FR DEVE ter `Origem:` rastreavel. Sem rastreabilidade, FR e ficcao.
-
-### Step 5: Derive Non-Functional Requirements (NFRs)
-
-PU-QUALITY_GATEs viram NFRs sobre como o squad opera (qualidade, performance, usabilidade):
-
-```markdown
-**NFR-001:** {Criterio de qualidade}
-- Origem: PU-QUALITY_GATE-xxx
-- Tipo: {Quality|Performance|Usability|Security}
-- Threshold: {valor mensuravel}
-```
-
-PU-TACITs sobre velocidade ou padrao tambem viram NFRs.
-
-### Step 6: Derive Constraints (CONs)
-
-PU-DEPENDENCYs externas + restricoes mencionadas pelo dono viram constraints:
-
-```markdown
-**CON-001:** {Restricao que limita design do squad}
-- Origem: PU-DEPENDENCY-xxx ou external_dependencies do state
-- Tipo: {Technical|Business|Resource|Time}
-- Impacto: {O que essa constraint impede ou exige}
-```
-
-### Step 7: Define Success Criteria
-
-Criterios mensuraveis pra dizer "esse squad funciona":
-
-- Derivados dos PU-QUALITY_GATEs principais
-- Devem ser binarios ou quantificaveis
-- Cada criterio liga a 1+ FRs
-
-```markdown
-**SC-001:** {Criterio de sucesso}
-- Mensuravel via: {como medir}
-- FRs cobertos: [FR-001, FR-003]
-```
-
-### Step 8: Write PRD
-
-Salvar em `docs/prd/squad-{slug}.md` com formato:
-
-```markdown
-# PRD: Squad {Title}
-
-**Slug:** {slug}
-**Version:** 1.0.0
-**Created:** {ISO date}
-**Source process:** {process_name} ({total_pus} PUs extraidos)
-**Status:** Draft → Approved (via QG-SF-003)
-
----
-
-## Visao
-
-{Paragrafo gerado no Step 2}
-
-## Escopo
-
-### In-scope
-{Lista derivada dos PU-STEPs}
-
-### Out-of-scope
-{Lista derivada de external_dependencies + PUs humano-only}
-
-## Personas
-
-### Persona Primaria
-{Conteudo do Step 3}
-
-### Personas Secundarias
-{Se aplicavel}
-
-## Functional Requirements
-
-{Lista de FR-001 ate FR-N do Step 4}
-
-## Non-Functional Requirements
-
-{Lista de NFR-001 ate NFR-N do Step 5}
-
-## Constraints
-
-{Lista de CON-001 ate CON-N do Step 6}
-
-## Success Criteria
-
-{Lista de SC-001 ate SC-N do Step 7}
-
-## Trace Matrix
-
-| PU-ID | Tipo | Vira em |
-|-------|------|---------|
-| PU-{slug}-001 | STEP | FR-001 |
-| PU-{slug}-002 | DECISION | FR-001 (decision point) |
-| PU-{slug}-003 | QUALITY_GATE | NFR-001 |
-| ... | ... | ... |
-
-> Trace matrix prova rastreabilidade — cada elemento do PRD veio de PU especifico.
-
----
-
-## Quality Check (antes de fechar)
-
-- [ ] Todos os PU-STEPs viraram pelo menos 1 FR
-- [ ] Todos os PU-QUALITY_GATEs viraram NFR
-- [ ] Todos os PU-DEPENDENCYs externos viraram CON
-- [ ] Cada FR/NFR/CON tem Origem rastreavel
-- [ ] Trace matrix completa
-- [ ] Vocabulario do usuario (nao termos inventados)
-```
-
----
-
-## Outputs
-
-| Arquivo | Conteudo |
-|---------|----------|
-| `docs/prd/squad-{slug}.md` | PRD completo |
-
----
-
-## Error Handling
-
-| Cenario | Acao |
-|---------|------|
-| PU-STEP sem PU-OUTPUT associado | Inferir output do contexto, marcar `[INFERRED]` no FR |
-| PU-DECISION orfao (sem branches) | Marcar como FR com TODO de extracao adicional |
-| Processo sem PU-QUALITY_GATEs | NFRs ficam genericas ("sem criterios explicitos") + warning ao Chief |
-
----
-
-**Task Status:** Ready for Production

package/agents/squad-forge/tasks/generate-stories.md

@@ -1,223 +0,0 @@
----
-task: "Generate Stories"
-responsavel: "@forge-smith"
-responsavel_type: "agent"
-atomic_layer: "task"
-Entrada: "docs/prd/squad-{slug}.md, 03-blueprint/squad-blueprint.yaml"
-Saida: "docs/stories/squad-forge/{slug}/*.story.md"
-Checklist:
-  - "1 story por fase do workflow do squad gerado"
-  - "Cada story tem AC com [ ] checkboxes"
-  - "Cada story referencia PRD (FR-xxx, NFR-xxx)"
-  - "Story principal tem AC = 5 QGs do squad-forge (QG-SF-001..005)"
-  - "File List inicializada (vazia, sera preenchida no assemble)"
-  - "Dev Notes com referencia aos PUs"
-execution_type: "semantic"
----
-
-# Task: Generate Stories — Stories de Desenvolvimento do Squad
-
-**Task ID:** squad-forge/generate-stories
-**Version:** 1.0.0
-**Status:** Production Ready
-**Created:** 2026-05-05
-**Category:** Documentation
-**Execution Type:** Semantic
-
----
-
-## Executive Summary
-
-Apos PRD gerado, antes de Assembly (Fase 4), criar stories de implementacao em `docs/stories/squad-forge/{slug}/`. Cada story corresponde a uma fase do workflow do squad gerado, com Acceptance Criteria rastreaveis ao PRD e PUs.
-
-**Posicao no Workflow:** Sub-task da Fase 3 (apos generate-prd)
-**Definicao de Sucesso:** Stories prontas pro assemble-squad usar como tracker
-**Gate:** Parte de QG-SF-003
-
----
-
-## Purpose
-
-Article III da Constitution: "All development starts with a story". Hoje o squad-forge ignora. Esta task corrige.
-
-Stories funcionam como tracker de progresso durante a Fase 4 (Assembly). Cada artefato gerado marca AC como `[x]`. File List e atualizada conforme arquivos sao criados.
-
----
-
-## Pipeline Visual
-
-```
-generate-stories
-  |
-  v
-STEP 1: LOAD PRD + BLUEPRINT
-  |
-  v
-STEP 2: CREATE EPIC STORY
-  Story principal: criacao do squad
-  AC = 5 QGs do squad-forge
-  |
-  v
-STEP 3: CREATE PHASE STORIES
-  1 story por fase do workflow
-  AC = quality gates do squad gerado
-  |
-  v
-STEP 4: WRITE STORIES
-  docs/stories/squad-forge/{slug}/*.story.md
-```
-
----
-
-## Step-by-Step Execution
-
-### Step 1: Load PRD + Blueprint
-
-Ler:
-- `docs/prd/squad-{slug}.md`
-- `03-blueprint/squad-blueprint.yaml`
-
-### Step 2: Create Epic Story (story principal)
-
-`docs/stories/squad-forge/{slug}/0.0.epic.story.md`:
-
-```markdown
-# Story 0.0: Squad {Title} — Epic
-
-**Status:** Draft
-**Epic:** Criacao do Squad {title}
-**PRD:** docs/prd/squad-{slug}.md
-
-## User Story
-
-As {persona primaria},
-I want {squad capability principal extraido do PRD vision},
-So that {beneficio principal}.
-
-## Acceptance Criteria (mapeadas aos QGs do squad-forge)
-
-- [ ] **AC-1 (QG-SF-001):** Extracao completa — >=15 PUs, 6/8 lentes cobertas, confianca media >=0.7
-- [ ] **AC-2 (QG-SF-002):** Playback validado — usuario confirmou "esse e meu processo"
-- [ ] **AC-3 (QG-SF-003):** Arquitetura coerente — 1-7 agentes, cada PU mapeado, sem dep circular, PRD + stories gerados
-- [ ] **AC-4 (QG-SF-004):** Estrutura nuclear + profundidade — squad-validator PASS + self-audit PASS (agentes >=250 linhas, 3+ Output Examples, 3+ Immune triggers, KB rica)
-- [ ] **AC-5 (QG-SF-005):** Operacional — 2/3 smoke tests PASS, usuario aprova, instalacao automatica em squads/
-
-## Tasks (alta granularidade — 1 task = 1 fase do pipeline squad-forge)
-
-- [ ] Setup (Fase 0)
-- [ ] Extracao de Processo (Fase 1)
-- [ ] Playback Validation (Fase 2)
-- [ ] Arquitetura + PRD + Stories (Fase 3)
-- [ ] Montagem (Fase 4) — ver stories N.N de cada fase do squad gerado
-- [ ] Validacao Final (Fase 5)
-
-## File List
-
-(Sera preenchida durante Fase 4 com cada arquivo gerado)
-
-## Dev Notes
-
-- **Source process:** {process_name} ({total_pus} PUs extraidos)
-- **Process map:** minds/{slug}/02-process-map/process-map.yaml
-- **Blueprint:** minds/{slug}/03-blueprint/squad-blueprint.yaml
-- **Agentes do squad:** {N agentes}, {N tasks}, {N workflows}
-
-## QA Notes
-
-(Preenchida pelo @forge-chief na Fase 5 com resultado de smoke tests)
-```
-
-### Step 3: Create Phase Stories
-
-Para cada fase do workflow do squad gerado, criar 1 story em `docs/stories/squad-forge/{slug}/{N}.story.md`:
-
-```markdown
-# Story {N}.0: {Nome da fase do workflow do squad gerado}
-
-**Status:** Draft
-**Epic:** Squad {title}
-**Parent:** docs/stories/squad-forge/{slug}/0.0.epic.story.md
-**Phase:** Phase {N} do workflow `wf-{squad-name}`
-
-## Context
-
-{Descricao da fase do blueprint — o que essa fase do squad gerado faz}
-
-## Acceptance Criteria
-
-- [ ] **AC-1:** {Quality gate dessa fase do squad gerado, do blueprint}
-- [ ] **AC-2:** Tasks implementadas: {lista das tasks dessa fase}
-- [ ] **AC-3:** Agente responsavel definido: @{agent-id}
-
-## FRs cobertos
-
-- FR-001 (PU-STEP-xxx)
-- FR-002 (PU-STEP-yyy)
-
-## NFRs aplicaveis
-
-- NFR-001 (criterio de qualidade)
-
-## Tasks (granularidade = 1 task = 1 artefato gerado)
-
-- [ ] Gerar agente {agent-id}.md (>=250 linhas, 3+ Output Examples, 3+ Immune triggers)
-- [ ] Gerar task {task-name}.md (8 campos TASK-FORMAT-SPEC-V1)
-- [ ] {outras tasks especificas dessa fase}
-
-## File List
-
-- (preenchida durante geracao)
-
-## Dev Notes
-
-- PUs cobertas: PU-{slug}-001, PU-{slug}-002
-- Bottleneck identificado: {se aplicavel}
-- Human touchpoint: {se aplicavel}
-```
-
-### Step 4: Write Stories
-
-Salvar todas em `docs/stories/squad-forge/{slug}/`. Estrutura final:
-
-```
-docs/stories/squad-forge/{slug}/
-  0.0.epic.story.md         # Story principal (5 ACs = 5 QGs)
-  1.story.md                # Phase 1 do squad gerado
-  2.story.md                # Phase 2 do squad gerado
-  ...
-  N.story.md                # Phase N
-```
-
----
-
-## Outputs
-
-| Arquivo | Conteudo |
-|---------|----------|
-| `docs/stories/squad-forge/{slug}/0.0.epic.story.md` | Story principal |
-| `docs/stories/squad-forge/{slug}/{N}.story.md` | 1 story por fase do squad gerado |
-
----
-
-## Integration with Assembly Phase
-
-Durante Fase 4 (`assemble-squad.md`), cada step que gera artefato:
-1. Marca AC correspondente na story como `[x]`
-2. Adiciona arquivo gerado a File List
-3. Atualiza Status (Draft → InProgress → Done)
-
-Stories sao tracker de progresso. Sem stories, Fase 4 voa as cegas.
-
----
-
-## Error Handling
-
-| Cenario | Acao |
-|---------|------|
-| Blueprint sem fases definidas | Fall back: 1 story unica = epic |
-| PRD sem FRs (processo simples) | Stories so com ACs estruturais |
-| Multiple agents na mesma fase | 1 story por agente, parent = story da fase |
-
----
-
-**Task Status:** Ready for Production