spec-first-copilot 0.7.0 → 0.8.0-beta.2

package/templates/.github/templates/feature/context.template.md

@@ -1,89 +1,118 @@
----
-nome: "{{NOME}}"
-first_run: {{true|false}}
-prd_existe: {{true|false}}
-trd_existe: {{true|false}}
-prd_aprovado: {{true|false}}
-trd_aprovado: {{true|false}}
-areas_tocadas: []
-input_path: "workspace/Input/{{NOME}}/"
-status: "not_started"
-ultima_skill: ""
-atualizado_em: ""
----
-
-<!--
-=============================================================================
-INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
-=============================================================================
-
-SCHEMA v4 (mudou de v3):
-- prd_empty REMOVIDO (conceito obsoleto)
-- prd_existe/trd_existe: bool reais (SEM aspas) indicando se /sf-extract gerou cada doc
-- prd_aprovado/trd_aprovado: bool reais (SEM aspas) controlando gate do /sf-design
-
-CAMPOS:
-- nome: identificador livre do scope (ex: app_barbearia, feat_login, infra_k8s)
-- first_run: bool — true se docs/ não existia quando /sf-start foi chamado.
-  IMUTÁVEL após criação.
-- prd_existe: bool — true se /sf-extract gerou PRD.md (insumos tinham produto).
-  false em scopes puro-técnicos.
-- trd_existe: bool — true se /sf-extract gerou TRD.md (insumos tinham técnica).
-  false em scopes puro-produto (raro).
-- prd_aprovado: bool — true após PM aprovar o PRD. Se prd_existe=false, este
-  campo também fica false (não há nada a aprovar).
-- trd_aprovado: bool — true após dev aprovar o TRD. Se trd_existe=false, fica false.
-- areas_tocadas: lista de áreas do TRD que têm GATE=SIM. Preenchido pelo /sf-design.
-  Possíveis: BACK, FRONT, DB, INFRA. Derivado dos GATEs do TRD §2-§5.
-- input_path: caminho relativo da pasta de insumos
-- status: estado atual da pipeline (ver fluxo abaixo)
-- ultima_skill: qual skill alterou este arquivo por último
-- atualizado_em: data/hora ISO da última atualização
-
-FLUXO DE STATUS (v4):
-  not_started
-    ↓ /sf-start cria .context.md
-  discovery_done
-    ↓ /sf-discovery roda (obrigatório no sfw-start)
-  extract_done
-    ↓ /sf-extract gera PRD e/ou TRD
-  prd_approved  ← apenas se prd_existe=true
-    ↓ PM revisa e aprova PRD (skill atualiza prd_aprovado=true)
-  trd_approved  ← apenas se trd_existe=true
-    ↓ dev revisa e aprova TRD (skill atualiza trd_aprovado=true)
-  design_done
-    ↓ /sf-design gera docs/ (first_run) + specs/ (sempre)
-  plan_done
-    ↓ /sf-plan gera tasks
-  dev_in_progress
-    ↓ /sf-dev executa tasks
-  dev_done
-    ↓ /sf-dev finaliza (chama /sf-merge-docs automaticamente)
-  done
-
-Se prd_existe=false: status pula direto de extract_done → trd_approved (sem passar
-por prd_approved). Mesmo vice-versa. Ordem das aprovações dentro do par é irrelevante.
-
-QUEM ATUALIZA:
-- /sf-start: cria arquivo com status=not_started, first_run derivado de docs/
-- /sf-discovery: not_started → discovery_done
-- /sf-extract: discovery_done → extract_done, preenche prd_existe + trd_existe
-- PM aprova: extract_done → prd_approved (atualiza prd_aprovado=true)
-- dev aprova: extract_done|prd_approved → trd_approved (atualiza trd_aprovado=true)
-  (skill futura /approve <doc> ou edição direta do campo + re-rodar /sf-design)
-- /sf-design: (prd_approved + trd_approved) → design_done, preenche areas_tocadas
-  Nota: se só um dos docs existe, o outro aprovado não é exigido.
-- /sf-plan: design_done → plan_done
-- /sf-dev: plan_done → dev_in_progress → dev_done
-- /sf-merge-docs: dev_done → done (aplica PRD+TRD em docs/)
-
-REGRAS:
-- Nunca pular etapas no fluxo de status
-- Nunca editar manualmente — apenas skills atualizam este arquivo
-- Se status não corresponde ao esperado, a skill deve parar e avisar
-- first_run é IMUTÁVEL após criação (representa o estado no bootstrap do scope)
-- prd_existe/trd_existe são IMUTÁVEIS após o /sf-extract (só mudam via re-extração
-  que detecta NOVO conteúdo na outra categoria)
-
-=============================================================================
--->
+---
+nome: "{{NOME}}"
+tipo: "{{scope|onboard}}"
+first_run: {{true|false}}
+prd_existe: {{true|false}}
+trd_existe: {{true|false}}
+prd_aprovado: {{true|false}}
+trd_aprovado: {{true|false}}
+areas_tocadas: []
+input_path: "workspace/Input/{{NOME}}/"
+repo_url: ""
+repo_branch: ""
+repo_path: ""
+status: "not_started"
+ultima_skill: ""
+atualizado_em: ""
+---
+
+<!--
+=============================================================================
+INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
+=============================================================================
+
+SCHEMA v4 (mudou de v3):
+- prd_empty REMOVIDO (conceito obsoleto)
+- prd_existe/trd_existe: bool reais (SEM aspas) indicando se /sf-extract gerou cada doc
+- prd_aprovado/trd_aprovado: bool reais (SEM aspas) controlando gate do /sf-design
+- tipo: discrimina scopes do pipeline normal vs onboarding (brownfield)
+- repo_*: preenchidos só em scopes tipo "onboard"
+
+CAMPOS:
+- nome: identificador livre do scope (ex: app_barbearia, feat_login, infra_k8s,
+  onboard_app_legado)
+- tipo: "scope" (default — pipeline normal /sf-start) ou "onboard" (brownfield
+  via /sfw-onboard — código já existe, ler e documentar sem PRD)
+- first_run: bool — true se docs/ não existia quando /sf-start foi chamado.
+  IMUTÁVEL após criação. Em onboard, sempre true.
+- prd_existe: bool — true se /sf-extract gerou PRD.md (insumos tinham produto).
+  false em scopes puro-técnicos.
+- trd_existe: bool — true se /sf-extract gerou TRD.md (insumos tinham técnica).
+  false em scopes puro-produto (raro).
+- prd_aprovado: bool — true após PM aprovar o PRD. Se prd_existe=false, este
+  campo também fica false (não há nada a aprovar).
+- trd_aprovado: bool — true após dev aprovar o TRD. Se trd_existe=false, fica false.
+- areas_tocadas: lista de áreas do TRD que têm GATE=SIM. Preenchido pelo /sf-design.
+  Possíveis: BACK, FRONT, DB, INFRA. Derivado dos GATEs do TRD §2-§5.
+- input_path: caminho relativo da pasta de insumos
+- repo_url: (só onboard) URL git do repositório onboardeado
+- repo_branch: (só onboard) branch/tag clonada
+- repo_path: (só onboard) caminho relativo do clone em projetos/
+- status: estado atual da pipeline (ver fluxo abaixo)
+- ultima_skill: qual skill alterou este arquivo por último
+- atualizado_em: data/hora ISO da última atualização
+
+FLUXO DE STATUS (v4):
+  not_started
+    ↓ /sf-start cria .context.md
+  discovery_done
+    ↓ /sf-discovery roda (obrigatório no sfw-start)
+  extract_done
+    ↓ /sf-extract gera PRD e/ou TRD
+  prd_approved  ← apenas se prd_existe=true
+    ↓ PM revisa e aprova PRD (skill atualiza prd_aprovado=true)
+  trd_approved  ← apenas se trd_existe=true
+    ↓ dev revisa e aprova TRD (skill atualiza trd_aprovado=true)
+  design_done
+    ↓ /sf-design gera docs/ (first_run) + specs/ (sempre)
+  plan_done
+    ↓ /sf-plan gera tasks
+  dev_in_progress
+    ↓ /sf-dev executa tasks
+  dev_done
+    ↓ /sf-dev finaliza (chama /sf-merge-docs automaticamente)
+  done
+
+Se prd_existe=false: status pula direto de extract_done → trd_approved (sem passar
+por prd_approved). Mesmo vice-versa. Ordem das aprovações dentro do par é irrelevante.
+
+FLUXO ALTERNATIVO — tipo=onboard (brownfield):
+  not_started
+    ↓ /sfw-onboard cria .context.md, clona repo em projetos/<repo_path>/
+  cloned
+    ↓ snapshot gerado em workspace/Input/onboard_<repo>/
+  analyzing
+    ↓ readers paralelos + analyzer consolidam TRD + docs/ + projetos.yaml
+  done
+
+Em onboard:
+- prd_existe = false (sempre — código é técnico, sem PRD)
+- trd_existe = true (sempre)
+- trd_aprovado = true (sempre — código é a verdade, sem ambiguidades, dev valida lendo)
+- areas_tocadas preenchidas a partir dos GATEs do TRD
+- Re-onboard reentra em "analyzing" e refaz merge aditivo
+
+QUEM ATUALIZA:
+- /sfw-onboard: cria arquivo com tipo=onboard, status=not_started → cloned → analyzing → done
+- /sf-start: cria arquivo com tipo=scope, status=not_started, first_run derivado de docs/
+- /sf-discovery: not_started → discovery_done
+- /sf-extract: discovery_done → extract_done, preenche prd_existe + trd_existe
+- PM aprova: extract_done → prd_approved (atualiza prd_aprovado=true)
+- dev aprova: extract_done|prd_approved → trd_approved (atualiza trd_aprovado=true)
+  (skill futura /approve <doc> ou edição direta do campo + re-rodar /sf-design)
+- /sf-design: (prd_approved + trd_approved) → design_done, preenche areas_tocadas
+  Nota: se só um dos docs existe, o outro aprovado não é exigido.
+- /sf-plan: design_done → plan_done
+- /sf-dev: plan_done → dev_in_progress → dev_done
+- /sf-merge-docs: dev_done → done (aplica PRD+TRD em docs/)
+
+REGRAS:
+- Nunca pular etapas no fluxo de status
+- Nunca editar manualmente — apenas skills atualizam este arquivo
+- Se status não corresponde ao esperado, a skill deve parar e avisar
+- first_run é IMUTÁVEL após criação (representa o estado no bootstrap do scope)
+- prd_existe/trd_existe são IMUTÁVEIS após o /sf-extract (só mudam via re-extração
+  que detecta NOVO conteúdo na outra categoria)
+
+=============================================================================
+-->