spec-first-copilot 0.7.0-beta.1 → 0.7.0

package/templates/sfw.config.yml.example

@@ -1,147 +1,147 @@
-# ============================================================================
-# sfw.config.yml — Manifesto do projeto SFW
-# ============================================================================
-# Este arquivo define COMO o pipeline SFW fala com o mundo externo:
-# - De onde vêm os insumos do PM/PO (input)
-# - Pra onde vão os artefatos gerados (output.targets[])
-# - Como os nomes dos itens são formados (naming)
-#
-# É commitável (zero segredos). Credenciais ficam em .mcp.json gitignored
-# ou variáveis de ambiente exportadas ANTES de abrir o Claude Code.
-#
-# Gerado pelo CLI: `spec-first-claude init --name=X`
-#
-# Referências:
-# - Interface do adapter: .github/adapters/interface.md
-# - Adapters disponíveis: .github/adapters/registry.md
-# - Templating de nomes:  .github/adapters/naming.md
-# - Erros:                .github/adapters/errors.md
-# ============================================================================
-
-# ----------------------------------------------------------------------------
-# project — identidade do projeto
-# ----------------------------------------------------------------------------
-project:
-  name: "Meu Projeto"
-  # Page ID raiz do projeto no Confluence (o framework conhece o projeto inteiro)
-  # root_page_id: "65708"
-
-# ----------------------------------------------------------------------------
-# naming — templates de nome (aplicados pela engine em .github/adapters/naming.md)
-# ----------------------------------------------------------------------------
-# Placeholders suportados: {scope}, {type}
-#   {scope} = nome do item no Input (ex: "app_barbearia", "feat_login")
-#   {type}  = tipo do artefato (ex: "PRD", "SDD", "Progresso")
-# Qualquer outro placeholder → ValidationError no load do manifest.
-#
-# O usuário nomeia livremente os items no Input — o agent NÃO impõe naming.
-# Estes templates controlam apenas o que o agent GERA no Output.
-naming:
-  # Subpasta (ou page-mãe) criada no Output por scope
-  # Ex: "out_app_barbearia", "out_feat_login"
-  output_container: "out_{scope}"
-
-  # Nome do artefato DENTRO do container
-  # No Confluence: {scope} no nome evita colisão de títulos no space
-  # No filesystem: pode simplificar pra "{type}" (sem redundância de scope)
-  output_artifact: "{scope} - {type}"
-
-# ----------------------------------------------------------------------------
-# input — de onde vêm os insumos do PM/PO (single source no MVP)
-# ----------------------------------------------------------------------------
-# /load {scope} usa esta seção pra puxar o conteúdo pro filesystem local.
-# Dev nunca edita o backend de input — só lê. PM owns este espaço.
-#
-# O agent faz listChildren(parent_page_id) e busca o scope pelo nome.
-# Se o scope não existir no backend, /load falha com erro explícito.
-input:
-  # Chave do adapter no registry. MVP: "confluence" | "filesystem"
-  adapter: confluence
-
-  # Config passada pro adapter.validateConfig(). Campos obrigatórios/opcionais
-  # são documentados no arquivo do adapter (ex: .github/adapters/confluence.md).
-  config:
-    space_key: ST
-    parent_page_id: "360668"      # page-mãe que contém os scopes no Input
-    recursive: true               # desce na árvore de scopes
-    include_attachments: true     # baixa PNGs, PDFs, planilhas
-
-  # Cache local onde /load materializa os insumos
-  cache:
-    local_dir: "workspace/Input/"
-    log: ".ai/load-log.md"        # append-only: id, version, sha256, timestamp
-    incremental: true             # hash-based re-load (NOVO/MODIFICADO/INALTERADO)
-
-# ----------------------------------------------------------------------------
-# output — pra onde os artefatos vão (MVP: 1 target, multi-target em P2)
-# ----------------------------------------------------------------------------
-# Cada target recebe um subset de artefatos via `publishes`.
-# Auto-publish é disparado pelas skills (/extract, /design, /plan).
-# Agent owns este espaço. PM só aplica label `sfw-approved` pra aprovar.
-#
-# Premissa: 1 space = 1 projeto (no Confluence). Multi-projeto no mesmo
-# space causa colisão de títulos — constraint do Confluence, não do SFW.
-# Se necessário, o user diferencia no Input (nomes únicos) e o Output
-# herda a unicidade via {scope} no naming.
-output:
-  targets:
-
-    # --- Target 1: Confluence (espelho de aprovação pro time) ---------------
-    - name: confluence-mirror
-
-      adapter: confluence
-
-      config:
-        space_key: ST
-        parent_page_id: "294931"  # page-mãe do Output no Confluence
-
-      # Whitelist de tipos que este target recebe.
-      # Tipos válidos: PRD, SDD, Progresso
-      # (tasks.md, docs/, projetos.yaml, specs/ ficam LOCAL ONLY —
-      #  ver §9.9 "Boundary publish vs local")
-      publishes: [PRD, SDD, Progresso]
-
-      # auto   — skill dispara publish automaticamente no fim
-      # manual — skill gera artefato local e pergunta se quer publicar
-      # off    — target ignorado (offline-first natural)
-      mode: auto
-
-      # Estratégia de conflict detection:
-      # version — compara version do backend com publish-log antes de update
-      # hash    — compara sha256 do conteúdo remoto com snapshot local
-      # none    — sobrescreve cego (NÃO recomendado; perde drift humano)
-      conflict_detection: version
-
-      # Mecanismo de aprovação do artefato publicado:
-      # label — PM aplica label na página Confluence pra marcar aprovado
-      # none  — sem aprovação formal (pipeline segue sem checar)
-      approval_mechanism: label
-      approval_label: "sfw-approved"
-
-    # --- Target 2: Filesystem mirror (opcional — time offline/backup) -------
-    # Descomente pra ativar. Útil pra testes E2E com FilesystemAdapter como
-    # mock natural — zero lib de mock, zero stub.
-    #
-    # - name: local-mirror
-    #   adapter: filesystem
-    #   config:
-    #     root_path: "./mirror"
-    #     glob: "**/*.md"
-    #   publishes: [PRD, SDD, Progresso]
-    #   mode: auto
-    #   conflict_detection: hash
-    #   approval_mechanism: none
-
-# ----------------------------------------------------------------------------
-# context_pages — páginas extras que o framework pode consultar (opcional)
-# ----------------------------------------------------------------------------
-# O /mcp descobre a árvore do projeto e sugere pages que podem ser úteis
-# como contexto durante /extract e /design (referências, decisões, etc.)
-#
-# context_pages:
-#   - id: "557057"
-#     title: "Referências"
-#     use_in: [extract, design]
-#   - id: "425998"
-#     title: "Decisões"
-#     use_in: [design]
+# ============================================================================
+# sfw.config.yml — Manifesto do projeto SFW
+# ============================================================================
+# Este arquivo define COMO o pipeline SFW fala com o mundo externo:
+# - De onde vêm os insumos do PM/PO (input)
+# - Pra onde vão os artefatos gerados (output.targets[])
+# - Como os nomes dos itens são formados (naming)
+#
+# É commitável (zero segredos). Credenciais ficam em .mcp.json gitignored
+# ou variáveis de ambiente exportadas ANTES de abrir o Claude Code.
+#
+# Gerado pelo CLI: `spec-first-claude init --name=X`
+#
+# Referências:
+# - Interface do adapter: .github/adapters/interface.md
+# - Adapters disponíveis: .github/adapters/registry.md
+# - Templating de nomes:  .github/adapters/naming.md
+# - Erros:                .github/adapters/errors.md
+# ============================================================================
+
+# ----------------------------------------------------------------------------
+# project — identidade do projeto
+# ----------------------------------------------------------------------------
+project:
+  name: "Meu Projeto"
+  # Page ID raiz do projeto no Confluence (o framework conhece o projeto inteiro)
+  # root_page_id: "65708"
+
+# ----------------------------------------------------------------------------
+# naming — templates de nome (aplicados pela engine em .github/adapters/naming.md)
+# ----------------------------------------------------------------------------
+# Placeholders suportados: {scope}, {type}
+#   {scope} = nome do item no Input (ex: "app_barbearia", "feat_login")
+#   {type}  = tipo do artefato (ex: "PRD", "TRD", "Progresso")
+# Qualquer outro placeholder → ValidationError no load do manifest.
+#
+# O usuário nomeia livremente os items no Input — o agent NÃO impõe naming.
+# Estes templates controlam apenas o que o agent GERA no Output.
+naming:
+  # Subpasta (ou page-mãe) criada no Output por scope
+  # Ex: "out_app_barbearia", "out_feat_login"
+  output_container: "out_{scope}"
+
+  # Nome do artefato DENTRO do container
+  # No Confluence: {scope} no nome evita colisão de títulos no space
+  # No filesystem: pode simplificar pra "{type}" (sem redundância de scope)
+  output_artifact: "{scope} - {type}"
+
+# ----------------------------------------------------------------------------
+# input — de onde vêm os insumos do PM/PO (single source no MVP)
+# ----------------------------------------------------------------------------
+# /load {scope} usa esta seção pra puxar o conteúdo pro filesystem local.
+# Dev nunca edita o backend de input — só lê. PM owns este espaço.
+#
+# O agent faz listChildren(parent_page_id) e busca o scope pelo nome.
+# Se o scope não existir no backend, /load falha com erro explícito.
+input:
+  # Chave do adapter no registry. MVP: "confluence" | "filesystem"
+  adapter: confluence
+
+  # Config passada pro adapter.validateConfig(). Campos obrigatórios/opcionais
+  # são documentados no arquivo do adapter (ex: .github/adapters/confluence.md).
+  config:
+    space_key: ST
+    parent_page_id: "360668"      # page-mãe que contém os scopes no Input
+    recursive: true               # desce na árvore de scopes
+    include_attachments: true     # baixa PNGs, PDFs, planilhas
+
+  # Cache local onde /load materializa os insumos
+  cache:
+    local_dir: "workspace/Input/"
+    log: ".ai/load-log.md"        # append-only: id, version, sha256, timestamp
+    incremental: true             # hash-based re-load (NOVO/MODIFICADO/INALTERADO)
+
+# ----------------------------------------------------------------------------
+# output — pra onde os artefatos vão (MVP: 1 target, multi-target em P2)
+# ----------------------------------------------------------------------------
+# Cada target recebe um subset de artefatos via `publishes`.
+# Auto-publish é disparado pelas skills (/extract, /design, /plan).
+# Agent owns este espaço. PM só aplica label `sfw-approved` pra aprovar.
+#
+# Premissa: 1 space = 1 projeto (no Confluence). Multi-projeto no mesmo
+# space causa colisão de títulos — constraint do Confluence, não do SFW.
+# Se necessário, o user diferencia no Input (nomes únicos) e o Output
+# herda a unicidade via {scope} no naming.
+output:
+  targets:
+
+    # --- Target 1: Confluence (espelho de aprovação pro time) ---------------
+    - name: confluence-mirror
+
+      adapter: confluence
+
+      config:
+        space_key: ST
+        parent_page_id: "294931"  # page-mãe do Output no Confluence
+
+      # Whitelist de tipos que este target recebe.
+      # Tipos válidos: PRD, TRD, Progresso
+      # (tasks.md, docs/, projetos.yaml, specs/ ficam LOCAL ONLY —
+      #  ver §9.9 "Boundary publish vs local")
+      publishes: [PRD, TRD, Progresso]
+
+      # auto   — skill dispara publish automaticamente no fim
+      # manual — skill gera artefato local e pergunta se quer publicar
+      # off    — target ignorado (offline-first natural)
+      mode: auto
+
+      # Estratégia de conflict detection:
+      # version — compara version do backend com publish-log antes de update
+      # hash    — compara sha256 do conteúdo remoto com snapshot local
+      # none    — sobrescreve cego (NÃO recomendado; perde drift humano)
+      conflict_detection: version
+
+      # Mecanismo de aprovação do artefato publicado:
+      # label — PM aplica label na página Confluence pra marcar aprovado
+      # none  — sem aprovação formal (pipeline segue sem checar)
+      approval_mechanism: label
+      approval_label: "sfw-approved"
+
+    # --- Target 2: Filesystem mirror (opcional — time offline/backup) -------
+    # Descomente pra ativar. Útil pra testes E2E com FilesystemAdapter como
+    # mock natural — zero lib de mock, zero stub.
+    #
+    # - name: local-mirror
+    #   adapter: filesystem
+    #   config:
+    #     root_path: "./mirror"
+    #     glob: "**/*.md"
+    #   publishes: [PRD, TRD, Progresso]
+    #   mode: auto
+    #   conflict_detection: hash
+    #   approval_mechanism: none
+
+# ----------------------------------------------------------------------------
+# context_pages — páginas extras que o framework pode consultar (opcional)
+# ----------------------------------------------------------------------------
+# O /mcp descobre a árvore do projeto e sugere pages que podem ser úteis
+# como contexto durante /extract e /design (referências, decisões, etc.)
+#
+# context_pages:
+#   - id: "557057"
+#     title: "Referências"
+#     use_in: [extract, design]
+#   - id: "425998"
+#     title: "Decisões"
+#     use_in: [design]