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

package/templates/.github/skills/sf-load/SKILL.md

@@ -1,296 +1,296 @@
-
-# /sf-load <nome> | --all
-
-Puxa conteúdo do backend configurado (Confluence, filesystem, etc.) e materializa localmente.
-
-## Modos
-
-| Modo | O que traz | Destino local |
-|------|-----------|---------------|
-| `/sf-load <nome>` | Input **e** Output do scope `{nome}` | `workspace/Input/{nome}/` + `workspace/Output/{nome}/` |
-| `/sf-load --all` | **Tudo** — todos os scopes de Input e Output | `workspace/Input/*/` + `workspace/Output/*/` |
-
-## Por que trazer Output também?
-
-O Output pode já ter artefatos publicados (PRD, TRD, Progresso) por outra sessão
-ou outro dev. Se você não traz, o pipeline pensa que não existe e tenta recriar.
-Trazer Output garante continuidade.
-
-## Quando usar
-
-- **Antes de `/sf-start`** — traz insumos frescos + artefatos existentes
-- **Após o PM adicionar novos insumos** — re-sincroniza incrementalmente
-- **Início de sessão num projeto existente** — `/sf-load --all` pra ter tudo atualizado
-- **Não obrigatório** se o projeto é 100% local (sem `sfw.config.yml`)
-
-## Pré-condições
-
-| # | Validação | Se falhar |
-|---|-----------|-----------|
-| 1 | `sfw.config.yml` existe na raiz do projeto | Parar → "Rode /sf-mcp confluence ou configure manualmente. Veja .github/adapters/SETUP.md" |
-| 2 | `sfw.config.yml` tem seção `input` e `output` | Parar → "Seções input/output não encontradas no sfw.config.yml" |
-| 3 | Adapter acessível (MCP rodando pra Confluence) | Parar → orientar setup conforme `.github/adapters/SETUP.md` |
-
-## Execução
-
-### 1. Carregar configuração
-
-Ler `sfw.config.yml` e extrair:
-- `input.adapter` + `input.config` — pra puxar Input
-- `input.config.parent_page_id` — page-mãe do Input no backend
-- `output.targets[0].adapter` + `output.targets[0].config` — pra puxar Output
-- `output.targets[0].config.parent_page_id` — page-mãe do Output no backend
-- `input.cache.local_dir` — default `workspace/Input/`
-- `input.cache.log` — default `.ai/load-log.md`
-- `naming.output_container` — template pra nome da pasta de Output (ex: `out_{scope}`)
-
-### 2. Determinar o que trazer
-
-**Se `/sf-load <nome>`:**
-- **Input**: buscar scope `{nome}` nos filhos de `input.parent_page_id`
-  - Match exato por título — se não encontrou, ERRO
-- **Output**: buscar container `out_{nome}` (ou conforme `naming.output_container`) nos filhos de `output.parent_page_id`
-  - Se não encontrou → OK, ainda não foi publicado. Pular silenciosamente.
-
-**Se `/sf-load --all`:**
-- **Input**: listar TODOS os filhos de `input.parent_page_id`
-- **Output**: listar TODOS os filhos de `output.parent_page_id`
-- Processar cada um como se fosse `/sf-load <nome>` individual
-
-### 3. Trazer conteúdo — RECURSIVO ATÉ O ÚLTIMO NÍVEL, FLAT LOCAL
-
-> **3 REGRAS INVIOLÁVEIS:**
-> 1. **Descer até o último nível** — `get_page_children` retorna só 1 nível. O agent DEVE fazer loop recursivo.
-> 2. **Local é flat** — todos os arquivos soltos na pasta, SEM subpastas por nível.
-> 3. **Refletir 100% do externo** — tudo que existe no backend DEVE existir localmente.
-
-**Para cada scope de Input — materializar em `workspace/Input/{nome}/`:**
-
-```
-function loadScope(pageId, targetDir):
-  allPages = []
-  collectAllPages(pageId, allPages)
-
-  para cada page em allPages:
-    // PEDIR MARKDOWN PRIMEIRO (MCP converte do storage format)
-    result = mcp__atlassian__confluence_get_page(page_id=page.id, convert_to_markdown=true)
-    content = result.content (ou result.body — depende do MCP)
-
-    content = preservarFormatacao(content)
-
-    filename = sanitize(page.title) + ".md"
-    salvar content em {targetDir}/{filename}
-    registrar no load-log
-
-  // Attachments de CADA page
-  para cada page em allPages:
-    attachments = mcp__atlassian__confluence_get_attachments(page_id=page.id)
-    para cada att:
-      bytes = mcp__atlassian__confluence_download_attachment(page_id=page.id, filename=att.title)
-      salvar em {targetDir}/{att.title}
-      registrar no load-log
-
-function collectAllPages(pageId, result):
-  children = mcp__atlassian__confluence_get_page_children(page_id=pageId)
-  para cada child:
-    result.push(child)
-    collectAllPages(child.id, result)    // recursão total
-```
-
-### 3.1 Função `preservarFormatacao(content)` — regras obrigatórias
-
-O MCP pode retornar markdown "parcial" (com tags HTML misturadas) ou storage format
-(XHTML do Confluence). A função DEVE preservar toda a estrutura semântica:
-
-**Passo 1 — Macros do Confluence (prioridade alta — preservar semântica)**
-
-| Macro Confluence | Converter pra markdown |
-|------------------|------------------------|
-| `<ac:structured-macro ac:name="code">...<ac:plain-text-body><![CDATA[...]]></>` | ```` ```{lang}\n{código}\n``` ```` (pegar linguagem de `<ac:parameter ac:name="language">`) |
-| `<ac:structured-macro ac:name="info\|note\|warning\|tip">` | `> ℹ️` (info), `> 📝` (note), `> ⚠️` (warning), `> 💡` (tip) + conteúdo como blockquote |
-| `<ac:structured-macro ac:name="expand">` | `<details><summary>{title}</summary>\n{body}\n</details>` |
-| `<ac:structured-macro ac:name="panel">` | blockquote simples `> ` |
-| `<ac:link><ri:page ri:content-title="X" /></>` | `[X](../X.md)` (link interno) |
-| `<ac:image><ri:attachment ri:filename="X" /></>` | `![X](X)` (imagem inline — attachment já é baixado) |
-
-**Passo 2 — Tabelas (crítico — fidelidade alta)**
-
-Preservar estrutura completa:
-```
-<table>
-  <tbody>
-    <tr><th>Col A</th><th>Col B</th></tr>
-    <tr><td>val1</td><td>val2</td></tr>
-  </tbody>
-</table>
-```
-vira:
-```
-| Col A | Col B |
-|-------|-------|
-| val1 | val2 |
-```
-
-**NUNCA** achatar tabela em lista ou parágrafo — perde dados estruturados.
-Se célula tem formatação inline (bold, link), preservar dentro da célula.
-
-**Passo 3 — Tags semânticas padrão**
-
-| HTML | Markdown |
-|------|----------|
-| `<h1>` → `<h6>` | `#` → `######` |
-| `<strong>`, `<b>` | `**texto**` |
-| `<em>`, `<i>` | `*texto*` |
-| `<u>` | `<u>texto</u>` (markdown não tem underline nativo — manter tag) |
-| `<s>`, `<del>` | `~~texto~~` |
-| `<a href="URL">` | `[texto](URL)` |
-| `<ul><li>` | `- item` |
-| `<ol><li>` | `1. item` |
-| `<code>` inline | `` `código` `` |
-| `<pre>` sem macro code | ```` ``` ```` bloco |
-| `<blockquote>` | `> texto` |
-| `<hr>` | `---` |
-| `<br>` | quebra de linha |
-| `<p>` (simples) | parágrafo (linha em branco antes/depois) |
-
-**Passo 4 — Remover metadata/lixo do Confluence**
-
-Strip silencioso (sem manter nada):
-- `<p local-id="uuid">` → remove tag, mantém conteúdo
-- Atributos `ac:schema-version`, `ac:macro-id`, `ac:local-id`, `ri:version-at-save`
-- `<ri:user>`, `<ri:space>` sem contexto útil
-- Comentários HTML `<!-- ... -->`
-- Entidades HTML: `&nbsp;` → espaço, `&amp;` → `&`, `&lt;` → `<`, `&gt;` → `>`
-
-**Passo 5 — Limpeza final**
-
-- Colapsar 3+ linhas em branco consecutivas em 2
-- Trim whitespace no fim de cada linha
-- Garantir que arquivo termine com uma única newline
-
-**Passo 6 — Validação**
-
-Após conversão, o markdown resultante NÃO deve conter:
-- Nenhuma tag `<ac:...>`, `<ri:...>`, `<p local-id=...>`
-- Nenhum `&nbsp;` ou entidade HTML não convertida
-- Tabelas sem pipes markdown
-
-Se qualquer um aparecer, é bug da função — reportar ao user no load-log com flag `FORMAT_WARN`.
-
-**Para cada scope de Output — materializar em `workspace/Output/{nome}/`:**
-
-Mesmo processo, mas:
-- Container no backend tem nome conforme `naming.output_container` (ex: `out_app_barbearia`)
-- Artifacts dentro dele são PRD, TRD, Progresso, etc.
-- Materializar cada um como `{tipo}.md` (ex: `PRD.md`, `TRD.md`, `Progresso.md`)
-- Nome local do scope é extraído do container (remove prefixo `out_`)
-
-**Para Filesystem** (`adapter: filesystem`):
-
-```
-function loadScope(sourcePath, targetDir):
-  // Se source == targetDir → no-op
-  // Senão: copiar TODOS os arquivos recursivamente pra targetDir (flat)
-```
-
-### 4. Log incremental (`.ai/load-log.md`)
-
-Formato append-only:
-
-```markdown
-## Load: {nome} — {ISO_DATETIME}
-
-### Input
-| Item ID | Title | Version | SHA256 | Local Path | Status |
-|---------|-------|---------|--------|------------|--------|
-| 294950 | app_barbearia | 3 | a3f5... | workspace/Input/app_barbearia/app_barbearia.md | NOVO |
-| 491572 | Requisitos | 2 | 8b1c... | workspace/Input/app_barbearia/requisitos.md | NOVO |
-
-### Output
-| Item ID | Title | Version | SHA256 | Local Path | Status |
-|---------|-------|---------|--------|------------|--------|
-| 393238 | app_barbearia - PRD | 2 | 4d2a... | workspace/Output/app_barbearia/PRD.md | NOVO |
-| 425998 | app_barbearia - TRD | 1 | 7f3e... | workspace/Output/app_barbearia/TRD.md | NOVO |
-```
-
-**Se `incremental: true`** (default):
-- Comparar hash com log anterior antes de baixar
-- `INALTERADO` = hash igual, não sobrescreve
-- `MODIFICADO` = hash diferente, sobrescreve
-- `NOVO` = não existia no log
-- `REMOVIDO` = existia no log mas sumiu do backend (log only, não deleta local)
-
-### 5. Ajustar `.gitignore` conforme o adapter
-
-Se o adapter NÃO é `filesystem`:
-- Verificar se `.gitignore` contém `# SFW: workspace ignored`
-- Se NÃO contém, adicionar:
-  ```
-  # SFW: workspace ignored (external backend detected)
-  workspace/Output/**
-  !workspace/Output/.gitkeep
-  ```
-
-Se o adapter É `filesystem` e o bloco existe, removê-lo.
-
-### 6. Informar o usuário
-
-**Para `/sf-load <nome>`:**
-```
-Scope "{nome}" carregado:
-
-  Input:  {N} arquivos ({X novos, Y modificados, Z inalterados})
-  Output: {M} artefatos ({A novos, B modificados, C inalterados})
-          ou "nenhum artefato publicado ainda"
-
-Próximo passo:
-  /sf-start {nome}    ← entrada única (bootstrap ou feature, detecta via docs/)
-
-Log: .ai/load-log.md
-```
-
-**Para `/sf-load --all`:**
-```
-Projeto sincronizado:
-
-  Input:  {N} scopes, {X} arquivos total
-  Output: {M} scopes, {Y} artefatos total
-
-Scopes encontrados:
-  - app_barbearia (Input: 5 arquivos, Output: PRD + TRD + Progresso)
-  - feat_login (Input: 3 arquivos, Output: nenhum)
-  - feat_pagamento (Input: 2 arquivos, Output: PRD)
-
-Log: .ai/load-log.md
-```
-
-## Notas
-
-- `/sf-load` é **idempotente** — rodar N vezes não muda nada se backend não mudou
-- `/sf-load` **nunca modifica o backend** — só lê
-- `/sf-load` **nunca deleta arquivos locais** — marca REMOVIDO no log mas mantém
-- Attachments ficam flat junto com os .md
-- **Estrutura local é FLAT** — não replica hierarquia do backend
-- **Recursão é total** — desce até o último nível
-- Nomes sanitizados: espaços → `_`, caracteres especiais removidos
-- Output que não existe no backend é pulado silenciosamente (ainda não publicado)
-- `/sf-load --all` é útil no início de sessão pra ter tudo atualizado
-
-## Erros
-
-| Erro | Ação |
-|------|------|
-| `sfw.config.yml` não existe | Parar → orientar /sf-mcp ou setup manual |
-| MCP não disponível | Parar → "Reinicie o VS Code com Copilot Chat" |
-| Scope não encontrado no Input | Parar, listar scopes disponíveis |
-| Auth error (401/403) | Parar → "Verifique .mcp.json" |
-| Page sem conteúdo | OK — salvar vazio, registrar no log |
-| Output não tem container pro scope | OK — pular, informar "nenhum artefato publicado ainda" |
-
-## Referências
-
-- Adapter interface: `.github/adapters/interface.md`
-- Confluence adapter: `.github/adapters/confluence.md`
-- Filesystem adapter: `.github/adapters/filesystem.md`
-- Setup guide: `.github/adapters/SETUP.md`
-- Naming: `.github/adapters/naming.md`
+
+# /sf-load <nome> | --all
+
+Puxa conteúdo do backend configurado (Confluence, filesystem, etc.) e materializa localmente.
+
+## Modos
+
+| Modo | O que traz | Destino local |
+|------|-----------|---------------|
+| `/sf-load <nome>` | Input **e** Output do scope `{nome}` | `workspace/Input/{nome}/` + `workspace/Output/{nome}/` |
+| `/sf-load --all` | **Tudo** — todos os scopes de Input e Output | `workspace/Input/*/` + `workspace/Output/*/` |
+
+## Por que trazer Output também?
+
+O Output pode já ter artefatos publicados (PRD, TRD, Progresso) por outra sessão
+ou outro dev. Se você não traz, o pipeline pensa que não existe e tenta recriar.
+Trazer Output garante continuidade.
+
+## Quando usar
+
+- **Antes de `/sf-start`** — traz insumos frescos + artefatos existentes
+- **Após o PM adicionar novos insumos** — re-sincroniza incrementalmente
+- **Início de sessão num projeto existente** — `/sf-load --all` pra ter tudo atualizado
+- **Não obrigatório** se o projeto é 100% local (sem `sfw.config.yml`)
+
+## Pré-condições
+
+| # | Validação | Se falhar |
+|---|-----------|-----------|
+| 1 | `sfw.config.yml` existe na raiz do projeto | Parar → "Rode /sf-mcp confluence ou configure manualmente. Veja .github/adapters/SETUP.md" |
+| 2 | `sfw.config.yml` tem seção `input` e `output` | Parar → "Seções input/output não encontradas no sfw.config.yml" |
+| 3 | Adapter acessível (MCP rodando pra Confluence) | Parar → orientar setup conforme `.github/adapters/SETUP.md` |
+
+## Execução
+
+### 1. Carregar configuração
+
+Ler `sfw.config.yml` e extrair:
+- `input.adapter` + `input.config` — pra puxar Input
+- `input.config.parent_page_id` — page-mãe do Input no backend
+- `output.targets[0].adapter` + `output.targets[0].config` — pra puxar Output
+- `output.targets[0].config.parent_page_id` — page-mãe do Output no backend
+- `input.cache.local_dir` — default `workspace/Input/`
+- `input.cache.log` — default `.ai/load-log.md`
+- `naming.output_container` — template pra nome da pasta de Output (ex: `out_{scope}`)
+
+### 2. Determinar o que trazer
+
+**Se `/sf-load <nome>`:**
+- **Input**: buscar scope `{nome}` nos filhos de `input.parent_page_id`
+  - Match exato por título — se não encontrou, ERRO
+- **Output**: buscar container `out_{nome}` (ou conforme `naming.output_container`) nos filhos de `output.parent_page_id`
+  - Se não encontrou → OK, ainda não foi publicado. Pular silenciosamente.
+
+**Se `/sf-load --all`:**
+- **Input**: listar TODOS os filhos de `input.parent_page_id`
+- **Output**: listar TODOS os filhos de `output.parent_page_id`
+- Processar cada um como se fosse `/sf-load <nome>` individual
+
+### 3. Trazer conteúdo — RECURSIVO ATÉ O ÚLTIMO NÍVEL, FLAT LOCAL
+
+> **3 REGRAS INVIOLÁVEIS:**
+> 1. **Descer até o último nível** — `get_page_children` retorna só 1 nível. O agent DEVE fazer loop recursivo.
+> 2. **Local é flat** — todos os arquivos soltos na pasta, SEM subpastas por nível.
+> 3. **Refletir 100% do externo** — tudo que existe no backend DEVE existir localmente.
+
+**Para cada scope de Input — materializar em `workspace/Input/{nome}/`:**
+
+```
+function loadScope(pageId, targetDir):
+  allPages = []
+  collectAllPages(pageId, allPages)
+
+  para cada page em allPages:
+    // PEDIR MARKDOWN PRIMEIRO (MCP converte do storage format)
+    result = mcp__atlassian__confluence_get_page(page_id=page.id, convert_to_markdown=true)
+    content = result.content (ou result.body — depende do MCP)
+
+    content = preservarFormatacao(content)
+
+    filename = sanitize(page.title) + ".md"
+    salvar content em {targetDir}/{filename}
+    registrar no load-log
+
+  // Attachments de CADA page
+  para cada page em allPages:
+    attachments = mcp__atlassian__confluence_get_attachments(page_id=page.id)
+    para cada att:
+      bytes = mcp__atlassian__confluence_download_attachment(page_id=page.id, filename=att.title)
+      salvar em {targetDir}/{att.title}
+      registrar no load-log
+
+function collectAllPages(pageId, result):
+  children = mcp__atlassian__confluence_get_page_children(page_id=pageId)
+  para cada child:
+    result.push(child)
+    collectAllPages(child.id, result)    // recursão total
+```
+
+### 3.1 Função `preservarFormatacao(content)` — regras obrigatórias
+
+O MCP pode retornar markdown "parcial" (com tags HTML misturadas) ou storage format
+(XHTML do Confluence). A função DEVE preservar toda a estrutura semântica:
+
+**Passo 1 — Macros do Confluence (prioridade alta — preservar semântica)**
+
+| Macro Confluence | Converter pra markdown |
+|------------------|------------------------|
+| `<ac:structured-macro ac:name="code">...<ac:plain-text-body><![CDATA[...]]></>` | ```` ```{lang}\n{código}\n``` ```` (pegar linguagem de `<ac:parameter ac:name="language">`) |
+| `<ac:structured-macro ac:name="info\|note\|warning\|tip">` | `> ℹ️` (info), `> 📝` (note), `> ⚠️` (warning), `> 💡` (tip) + conteúdo como blockquote |
+| `<ac:structured-macro ac:name="expand">` | `<details><summary>{title}</summary>\n{body}\n</details>` |
+| `<ac:structured-macro ac:name="panel">` | blockquote simples `> ` |
+| `<ac:link><ri:page ri:content-title="X" /></>` | `[X](../X.md)` (link interno) |
+| `<ac:image><ri:attachment ri:filename="X" /></>` | `![X](X)` (imagem inline — attachment já é baixado) |
+
+**Passo 2 — Tabelas (crítico — fidelidade alta)**
+
+Preservar estrutura completa:
+```
+<table>
+  <tbody>
+    <tr><th>Col A</th><th>Col B</th></tr>
+    <tr><td>val1</td><td>val2</td></tr>
+  </tbody>
+</table>
+```
+vira:
+```
+| Col A | Col B |
+|-------|-------|
+| val1 | val2 |
+```
+
+**NUNCA** achatar tabela em lista ou parágrafo — perde dados estruturados.
+Se célula tem formatação inline (bold, link), preservar dentro da célula.
+
+**Passo 3 — Tags semânticas padrão**
+
+| HTML | Markdown |
+|------|----------|
+| `<h1>` → `<h6>` | `#` → `######` |
+| `<strong>`, `<b>` | `**texto**` |
+| `<em>`, `<i>` | `*texto*` |
+| `<u>` | `<u>texto</u>` (markdown não tem underline nativo — manter tag) |
+| `<s>`, `<del>` | `~~texto~~` |
+| `<a href="URL">` | `[texto](URL)` |
+| `<ul><li>` | `- item` |
+| `<ol><li>` | `1. item` |
+| `<code>` inline | `` `código` `` |
+| `<pre>` sem macro code | ```` ``` ```` bloco |
+| `<blockquote>` | `> texto` |
+| `<hr>` | `---` |
+| `<br>` | quebra de linha |
+| `<p>` (simples) | parágrafo (linha em branco antes/depois) |
+
+**Passo 4 — Remover metadata/lixo do Confluence**
+
+Strip silencioso (sem manter nada):
+- `<p local-id="uuid">` → remove tag, mantém conteúdo
+- Atributos `ac:schema-version`, `ac:macro-id`, `ac:local-id`, `ri:version-at-save`
+- `<ri:user>`, `<ri:space>` sem contexto útil
+- Comentários HTML `<!-- ... -->`
+- Entidades HTML: `&nbsp;` → espaço, `&amp;` → `&`, `&lt;` → `<`, `&gt;` → `>`
+
+**Passo 5 — Limpeza final**
+
+- Colapsar 3+ linhas em branco consecutivas em 2
+- Trim whitespace no fim de cada linha
+- Garantir que arquivo termine com uma única newline
+
+**Passo 6 — Validação**
+
+Após conversão, o markdown resultante NÃO deve conter:
+- Nenhuma tag `<ac:...>`, `<ri:...>`, `<p local-id=...>`
+- Nenhum `&nbsp;` ou entidade HTML não convertida
+- Tabelas sem pipes markdown
+
+Se qualquer um aparecer, é bug da função — reportar ao user no load-log com flag `FORMAT_WARN`.
+
+**Para cada scope de Output — materializar em `workspace/Output/{nome}/`:**
+
+Mesmo processo, mas:
+- Container no backend tem nome conforme `naming.output_container` (ex: `out_app_barbearia`)
+- Artifacts dentro dele são PRD, TRD, Progresso, etc.
+- Materializar cada um como `{tipo}.md` (ex: `PRD.md`, `TRD.md`, `Progresso.md`)
+- Nome local do scope é extraído do container (remove prefixo `out_`)
+
+**Para Filesystem** (`adapter: filesystem`):
+
+```
+function loadScope(sourcePath, targetDir):
+  // Se source == targetDir → no-op
+  // Senão: copiar TODOS os arquivos recursivamente pra targetDir (flat)
+```
+
+### 4. Log incremental (`.ai/load-log.md`)
+
+Formato append-only:
+
+```markdown
+## Load: {nome} — {ISO_DATETIME}
+
+### Input
+| Item ID | Title | Version | SHA256 | Local Path | Status |
+|---------|-------|---------|--------|------------|--------|
+| 294950 | app_barbearia | 3 | a3f5... | workspace/Input/app_barbearia/app_barbearia.md | NOVO |
+| 491572 | Requisitos | 2 | 8b1c... | workspace/Input/app_barbearia/requisitos.md | NOVO |
+
+### Output
+| Item ID | Title | Version | SHA256 | Local Path | Status |
+|---------|-------|---------|--------|------------|--------|
+| 393238 | app_barbearia - PRD | 2 | 4d2a... | workspace/Output/app_barbearia/PRD.md | NOVO |
+| 425998 | app_barbearia - TRD | 1 | 7f3e... | workspace/Output/app_barbearia/TRD.md | NOVO |
+```
+
+**Se `incremental: true`** (default):
+- Comparar hash com log anterior antes de baixar
+- `INALTERADO` = hash igual, não sobrescreve
+- `MODIFICADO` = hash diferente, sobrescreve
+- `NOVO` = não existia no log
+- `REMOVIDO` = existia no log mas sumiu do backend (log only, não deleta local)
+
+### 5. Ajustar `.gitignore` conforme o adapter
+
+Se o adapter NÃO é `filesystem`:
+- Verificar se `.gitignore` contém `# SFW: workspace ignored`
+- Se NÃO contém, adicionar:
+  ```
+  # SFW: workspace ignored (external backend detected)
+  workspace/Output/**
+  !workspace/Output/.gitkeep
+  ```
+
+Se o adapter É `filesystem` e o bloco existe, removê-lo.
+
+### 6. Informar o usuário
+
+**Para `/sf-load <nome>`:**
+```
+Scope "{nome}" carregado:
+
+  Input:  {N} arquivos ({X novos, Y modificados, Z inalterados})
+  Output: {M} artefatos ({A novos, B modificados, C inalterados})
+          ou "nenhum artefato publicado ainda"
+
+Próximo passo:
+  /sf-start {nome}    ← entrada única (bootstrap ou feature, detecta via docs/)
+
+Log: .ai/load-log.md
+```
+
+**Para `/sf-load --all`:**
+```
+Projeto sincronizado:
+
+  Input:  {N} scopes, {X} arquivos total
+  Output: {M} scopes, {Y} artefatos total
+
+Scopes encontrados:
+  - app_barbearia (Input: 5 arquivos, Output: PRD + TRD + Progresso)
+  - feat_login (Input: 3 arquivos, Output: nenhum)
+  - feat_pagamento (Input: 2 arquivos, Output: PRD)
+
+Log: .ai/load-log.md
+```
+
+## Notas
+
+- `/sf-load` é **idempotente** — rodar N vezes não muda nada se backend não mudou
+- `/sf-load` **nunca modifica o backend** — só lê
+- `/sf-load` **nunca deleta arquivos locais** — marca REMOVIDO no log mas mantém
+- Attachments ficam flat junto com os .md
+- **Estrutura local é FLAT** — não replica hierarquia do backend
+- **Recursão é total** — desce até o último nível
+- Nomes sanitizados: espaços → `_`, caracteres especiais removidos
+- Output que não existe no backend é pulado silenciosamente (ainda não publicado)
+- `/sf-load --all` é útil no início de sessão pra ter tudo atualizado
+
+## Erros
+
+| Erro | Ação |
+|------|------|
+| `sfw.config.yml` não existe | Parar → orientar /sf-mcp ou setup manual |
+| MCP não disponível | Parar → "Reinicie o VS Code com Copilot Chat" |
+| Scope não encontrado no Input | Parar, listar scopes disponíveis |
+| Auth error (401/403) | Parar → "Verifique .mcp.json" |
+| Page sem conteúdo | OK — salvar vazio, registrar no log |
+| Output não tem container pro scope | OK — pular, informar "nenhum artefato publicado ainda" |
+
+## Referências
+
+- Adapter interface: `.github/adapters/interface.md`
+- Confluence adapter: `.github/adapters/confluence.md`
+- Filesystem adapter: `.github/adapters/filesystem.md`
+- Setup guide: `.github/adapters/SETUP.md`
+- Naming: `.github/adapters/naming.md`