jarvis-ai-framework 4.0.0 → 5.0.0

package/workflows/product/prod.spec.ard.md

@@ -18,7 +18,7 @@ Antes de iniciar, revise o arquivo de regras invioláveis em `$PROD_RULES/**/*`.
 
 Este fluxo é a **porta de entrada de produto** para o ARD. Ele levanta com o PM, em linguagem de produto, o que a arquitetura precisa atender (restrições, requisitos não funcionais, integrações, volumes e riscos) e, com isso, **conduz o ARD pelo fluxo de engenharia** (`eng.create-ard`), sem duplicá-lo.
 
-> ⚠️ **O ARD é um documento de engenharia.** O arquivo resultante fica em `$DOCS_FOLDER/engineering/ARD/` (como no `eng.create-ard`), e as decisões de arquitetura pertencem à engenharia. Este comando só levanta os requisitos e abre o fluxo. Diga isso ao usuário no início.
+> ⚠️ **O ARD é um documento de engenharia.** O arquivo resultante fica em `$ENG_DOCS/ARD/` (como no `eng.create-ard`), e as decisões de arquitetura pertencem à engenharia. Este comando só levanta os requisitos e abre o fluxo. Diga isso ao usuário no início.
 
 Utilize o `$ARGUMENTS` que o usuário passar como ponto de partida e para entender o contexto do que foi pedido.
 <requirement>
@@ -45,12 +45,12 @@ Utilize o `$ARGUMENTS` que o usuário passar como ponto de partida e para entend
 
 | Passo | Skill | Condição |
 |-------|-------|----------|
-| Gate 1: Reconhecer o contexto | `/jarvis-docs-central` (via `jarvis docs sync --silent`) | Se `CENTRAL_DOCS_STORAGE` estiver definido no ENV.md e for preciso buscar o PRD ou FRD relacionado |
+| Gate 1: Reconhecer o contexto | `/jarvis-docs-central` (via `jarvis docs sync --silent`) | Se `CENTRAL_DOCS_STORAGE` estiver definido no ENV.md e for preciso conhecer as funcionalidades já implementadas relacionadas |
 | Gate 4: Conduzir o ARD | `/eng.create-ard` | Sempre, depois de os requisitos serem confirmados: modo `new`, com `--prd` quando houver PRD (workflow de engenharia; o aviso de transição de domínio é dado antes) |
 
 ## Resultado final
 - Um **resumo dos requisitos arquiteturais** confirmado pelo usuário (Gate 3), entregue como insumo ao `eng.create-ard`
-- O **ARD** gerado pelo `eng.create-ard` (numeração `ARD-###`, versão `1.0.0`, template `$IDE/templates/engineering/ARD-template.md` e caminho `$DOCS_FOLDER/engineering/ARD/{ARD-ID}-{slug}.md`)
+- O **ARD** gerado pelo `eng.create-ard` (numeração `ARD-###`, versão `1.0.0`, template `$IDE/templates/engineering/ARD-template.md` e caminho `$ENG_DOCS/ARD/{ARD-ID}-{slug}.md`)
 - Rascunhos WIP, se houver, em `$SESSIONS_DIR/prod/{TASK_MANAGER_KEY}/`; o documento canônico é o ARD
 - O arquivo final no mesmo idioma da interação do usuário
 
@@ -64,7 +64,7 @@ Utilize o `$ARGUMENTS` que o usuário passar como ponto de partida e para entend
 
 ### Gate 1: Reconhecer o contexto
 1. Valide o `ENV.md` (regra geral de produto) e avise que o ARD é um documento de engenharia.
-2. Identifique o PRD ou FRD de origem em `$PROD_DOCS` (ou o caminho que o usuário informar) e leia-o. Se `CENTRAL_DOCS_STORAGE` estiver definido, busque no central docs o PRD ou FRD relacionado.
+2. Identifique o PRD ou FRD de origem em `$PROD_DOCS` (ou o caminho que o usuário informar) e leia-o. Se `CENTRAL_DOCS_STORAGE` estiver definido, consulte também no Central docs as funcionalidades já implementadas relacionadas (o PRD e o FRD ficam em `$PROD_DOCS`).
 3. Resuma em poucas linhas o que a especificação pede e confirme com o usuário que é essa a origem. Se `AREA` do usuário não for `ENGINEERING`, avise que o ARD seguirá o fluxo de engenharia e deve ser revisado por alguém da engenharia.
 
 ### Gate 2: Levantar os requisitos arquiteturais em termos de produto

package/workflows/product/prod.spec.breakdown.md

@@ -65,7 +65,7 @@ O artefato de breakdown segue o template `$PROD_TEMPLATES/prod-breakdown-templat
 Se `CENTRAL_DOCS_STORAGE` estiver no `ENV.md`:
 
 1. `jarvis docs sync --silent` (best-effort)
-2. Localizar Documento de Requisitos de Produto / funcional relacionado (nome, tags, `TASK_MANAGER_KEY`)
+2. Localizar no Central docs as funcionalidades já implementadas relacionadas (nome, tags, `TASK_MANAGER_KEY`); o Documento de Requisitos de Produto / funcional vem de `$PROD_DOCS`
 3. Usar como contexto; se não achar, seguir com arquivos locais em `$PROD_DOCS`
 
 ## Sessões

package/workflows/product/prod.spec.epic.md

@@ -43,7 +43,6 @@ Utilize o `$ARGUMENTS` que o usuário passar como ponto de partida e para entend
 |-------|-------|----------|
 | Busca no Central Docs (condicional) | `/jarvis-docs-central` (via `jarvis docs sync --silent`) | Se `CENTRAL_DOCS_STORAGE` estiver definido no ENV.md, antes de criar o épico |
 | Próximas etapas | `/prod.spec.issue` | Depois de criar o épico, se o usuário quiser escrever as histórias ou tarefas relacionadas |
-| Publicação no Central Docs (condicional) | `/jarvis-docs-central` (via `jarvis docs publish --tipo epic`) | Se `CENTRAL_DOCS_STORAGE` estiver definido, o épico estiver salvo e aprovado e o usuário responder "Sim, publicar agora" |
 
 ## Resultado final
 - Por padrão, use o modelo `$PROD_TEMPLATES/prod-epic-template.md` integralmente
@@ -124,44 +123,15 @@ Após a aprovação do usuário:
 
 Se `CENTRAL_DOCS_STORAGE` definido no ENV.md, antes de criar o épico:
 
-- Executar busca automática no central-docs:
+- Consultar no Central docs as funcionalidades já implementadas relacionadas (o que existe hoje):
   ```bash
   jarvis docs sync --silent
   ```
-- Buscar PRD e épicos existentes relacionados usando o contexto do usuário
-- Se PRD ou épico encontrado: carregar como contexto e informar o usuário
+- Buscar PRD e épicos existentes em `$PROD_DOCS` e, no Central docs, as funcionalidades já implementadas relacionadas
+- Se encontrar: carregar como contexto e informar o usuário
 - Se não encontrado: continuar com fluxo normal
 
-## Publicação no Central Docs (condicional)
+## Central docs
 
-Após salvar o épico localmente e obter aprovação do usuário:
+Este documento é um **documento de trabalho**: fica em `$PROD_DOCS`/`$ENG_DOCS` (`docs/jarvis/`) e **não** é publicado no Central docs. O Central docs registra só o que foi implementado, e quem o atualiza é o `/eng.spec-consolidate`, depois do PR da entrega.
 
-1. Se `CENTRAL_DOCS_STORAGE` definido no ENV.md:
-   - Perguntar ao usuário:
-     ```
-     Deseja publicar este épico no repositório central de documentação?
-     - ( ) Sim, publicar agora
-     - ( ) Não, vou publicar depois manualmente
-     ```
-
-2. Se **Sim**:
-   - Executar:
-     ```bash
-     jarvis docs publish \
-       --file {caminho_do_epico} \
-       --tipo epic
-     ```
-
-3. Informar resultado:
-   - ✅ Sucesso: "Épico publicado no Central docs." (com git: "PR aberto: [URL]")
-   - ❌ Erro: Exibir mensagem de erro e orientar troubleshooting
-
-4. Se **Não**:
-   - Informar: "Para publicar depois, execute: `jarvis docs publish --file {caminho} --tipo epic`"
-
-> **Nota**: se a pasta do Central docs for um repositório git, a publicação abre um Pull/Merge Request e o épico só entra na branch base depois do merge. Sem git, o documento é gravado direto e o índice é regenerado.
-
-Utilize o que o usuário fornecer analisar em:
-<requirement>
-#$ARGUMENTS
-</requirement>

package/workflows/product/prod.spec.frd.md

@@ -35,7 +35,6 @@ Utilize o `$ARGUMENTS` que o usuário passar como ponto de partida e para entend
 | Passo | Skill | Condição |
 |-------|-------|----------|
 | Busca no Central Docs (condicional) | `/jarvis-docs-central` (via `jarvis docs sync --silent`) | Se `CENTRAL_DOCS_STORAGE` estiver definido no ENV.md |
-| Publicação no Central Docs (condicional) | `/jarvis-docs-central` (via `jarvis docs publish --tipo frd`) | Se `CENTRAL_DOCS_STORAGE` estiver definido, o FRD estiver salvo e aprovado e o usuário responder "Sim, publicar agora" |
 
 ## Princípios Fundamentais
 1. **Sempre use o template** `$PROD_TEMPLATES/prod-frd-template.md` para o output final
@@ -63,17 +62,17 @@ A FRD não é um épico, história ou task: ela serve como documento de detalham
 Se `CENTRAL_DOCS_STORAGE` definido no ENV.md:
 
 1. **Buscar PRD correspondente:**
-   - Executar busca automática no central-docs:
+   - Consultar no Central docs as funcionalidades já implementadas relacionadas (o que existe hoje):
      ```bash
      jarvis docs sync --silent
      ```
-   - Buscar PRD relacionado usando:
+   - Buscar o PRD relacionado em `$PROD_DOCS` (documento de trabalho; o Central docs não guarda PRD) usando:
      - Nome/contexto fornecido pelo usuário
      - Jira ID (se disponível)
      - Tags semânticas
-   - Se PRD encontrado no central-docs:
+   - Se o PRD for encontrado em `$PROD_DOCS`:
      - Carregar automaticamente como base para o FRD
-     - Informar ao usuário: "✅ PRD encontrado no central-docs: [nome]"
+     - Informar ao usuário: "✅ PRD encontrado: [caminho]"
      - Passar como contexto para o Gate 1 (Fluxo de Trabalho, abaixo)
    - Se não encontrado:
      - Perguntar ao usuário se tem PRD localmente
@@ -187,34 +186,7 @@ O sistema deve validar os dados do formulário.
   - Se for uma spec nova:
     - Salve na pasta `$PROD_DOCS` seguindo todos os padrões de nomenclatura e estrutura de pastas já estabelecidos em `$PROD_RULES/**/*`
 
-## Publicação no Central Docs (condicional)
+## Central docs
 
-Após salvar o FRD localmente e obter aprovação do usuário:
+Este documento é um **documento de trabalho**: fica em `$PROD_DOCS`/`$ENG_DOCS` (`docs/jarvis/`) e **não** é publicado no Central docs. O Central docs registra só o que foi implementado, e quem o atualiza é o `/eng.spec-consolidate`, depois do PR da entrega.
 
-1. Se `CENTRAL_DOCS_STORAGE` definido no ENV.md:
-   - Perguntar ao usuário:
-     ```
-     Deseja publicar este FRD no repositório central de documentação?
-     - ( ) Sim, publicar agora
-     - ( ) Não, vou publicar depois manualmente
-     ```
-
-2. Se **Sim**:
-   - Executar:
-     ```bash
-     jarvis docs publish \
-       --file {caminho_do_frd} \
-       --tipo frd
-     ```
-
-3. Informar resultado:
-   - ✅ Sucesso: "FRD publicado no Central docs." (com git: "PR aberto: [URL]")
-   - ❌ Erro: Exibir mensagem de erro e orientar troubleshooting
-
-4. Se **Não**:
-   - Informar: "Para publicar depois, execute: `jarvis docs publish --file {caminho} --tipo frd`"
-
-5. Se `CENTRAL_DOCS_STORAGE` não estiver definido:
-   - Informar: "Para habilitar publicação automática, configure o Central docs no `/jarvis-init` (`CENTRAL_DOCS_STORAGE`)"
-
-> **Nota**: se a pasta do Central docs for um repositório git, a publicação abre um Pull/Merge Request e o FRD só entra na branch base depois do merge. Sem git, o documento é gravado direto e o índice é regenerado.

package/workflows/product/prod.spec.prd.md

@@ -34,7 +34,6 @@ Utilize o `$ARGUMENTS` que o usuário passar como ponto de partida e para entend
 | Passo | Skill | Condição |
 |-------|-------|----------|
 | Busca no Central Docs (condicional) | `/jarvis-docs-central` (via `jarvis docs sync --silent`) | Se `CENTRAL_DOCS_STORAGE` estiver definido no ENV.md (iteração de PRD existente) |
-| Publicação no Central Docs (condicional) | `/jarvis-docs-central` (via `jarvis docs publish --tipo prd`) | Se `CENTRAL_DOCS_STORAGE` estiver definido, o PRD estiver salvo e aprovado e o usuário responder "Sim, publicar agora" |
 
 ## Princípios Fundamentais
 1. **Sempre use o template** `$PROD_TEMPLATES/prod-prd-template.md` para o output final
@@ -48,17 +47,17 @@ Utilize o `$ARGUMENTS` que o usuário passar como ponto de partida e para entend
 Se `CENTRAL_DOCS_STORAGE` definido no ENV.md:
 
 1. **Para iteração de PRD existente:**
-   - Executar busca automática no central-docs:
+   - Consultar no Central docs as funcionalidades já implementadas relacionadas (o que existe hoje):
      ```bash
      jarvis docs sync --silent
      ```
-   - Buscar PRD relacionado usando:
+   - Buscar o PRD relacionado em `$PROD_DOCS` (documento de trabalho; o Central docs não guarda PRD) usando:
      - Nome/contexto do PRD fornecido pelo usuário
      - Jira ID (se disponível)
      - Tags semânticas
-   - Se PRD encontrado no central-docs:
+   - Se o PRD for encontrado em `$PROD_DOCS`:
      - Carregar automaticamente como base para iteração
-     - Informar ao usuário: "✅ PRD encontrado no central-docs: [nome]"
+     - Informar ao usuário: "✅ PRD encontrado: [caminho]"
      - Usar como contexto para o Gate 1 (Fluxo de Trabalho, abaixo)
    - Se não encontrado:
      - Perguntar ao usuário se tem PRD localmente
@@ -174,35 +173,7 @@ Quais métricas? A) Engajamento B) Receita C) Outro
   - Se for uma spec nova:
     - Salve na pasta `$PROD_DOCS` seguindo todos os padrões de nomenclatura e estrutura de pastas já estabelecidos em `$PROD_RULES/**/*`
 
-## Publicação no Central Docs (condicional)
+## Central docs
 
-Após salvar o PRD localmente e obter aprovação do usuário:
-
-1. Se `CENTRAL_DOCS_STORAGE` definido no ENV.md:
-   - Perguntar ao usuário:
-     ```
-     Deseja publicar este PRD no repositório central de documentação?
-     - ( ) Sim, publicar agora
-     - ( ) Não, vou publicar depois manualmente
-     ```
-
-2. Se **Sim**:
-   - Executar:
-     ```bash
-     jarvis docs publish \
-       --file {caminho_do_prd} \
-       --tipo prd
-     ```
-
-3. Informar resultado:
-   - ✅ Sucesso: "PRD publicado no Central docs." (com git: "PR aberto: [URL]")
-   - ❌ Erro: Exibir mensagem de erro e orientar troubleshooting
-
-4. Se **Não**:
-   - Informar: "Para publicar depois, execute: `jarvis docs publish --file {caminho} --tipo prd`"
-
-5. Se `CENTRAL_DOCS_STORAGE` não estiver definido:
-   - Informar: "Para habilitar publicação automática, configure o Central docs no `/jarvis-init` (`CENTRAL_DOCS_STORAGE`)"
-
-> **Nota**: se a pasta do Central docs for um repositório git, a publicação abre um Pull/Merge Request e o PRD só entra na branch base depois do merge. Sem git, o documento é gravado direto e o índice é regenerado.
+Este documento é um **documento de trabalho**: fica em `$PROD_DOCS`/`$ENG_DOCS` (`docs/jarvis/`) e **não** é publicado no Central docs. O Central docs registra só o que foi implementado, e quem o atualiza é o `/eng.spec-consolidate`, depois do PR da entrega.
 

package/workflows/warm-up.md

@@ -129,14 +129,14 @@ O perfil de comunicação é derivado de `POSITION` (conforme definido no `$IDE/
 
 ## Passo 2 — Sincronizar Documentação Central (condicional)
 
-Se `CENTRAL_DOCS_STORAGE` estiver configurado no ENV.md, invocar o skill `jarvis-docs-central` via Skill tool para carregar docs do produto.
+Se `CENTRAL_DOCS_STORAGE` estiver configurado no ENV.md, invocar o skill `jarvis-docs-central` via Skill tool para carregar **o que já foi implementado** no produto (funcionalidades `feature-*` e entregas recentes `delivery-*`). Os documentos de trabalho (PRD, FRD, ARD, RFC) ficam em `docs/jarvis/` e não estão no Central docs.
 
 > ⚠️ **IMPORTANTE**: NÃO executar `jarvis docs sync` diretamente via Bash.
 > Usar sempre: **Skill tool → jarvis-docs-central (Modo 1: Buscar Docs)**
 
 O skill `jarvis-docs-central` gerencia:
-- Extração de token do `.npmrc`
-- Fallback quando `index.md` não existe (navegação por árvore)
+- O adaptador de `CENTRAL_DOCS_STORAGE` (pasta, com `git pull` quando a pasta é um clone)
+- Índice ausente (o squad ainda não tem consolidação)
 - Tratamento de erros
 
 **Invocação:**
@@ -150,17 +150,15 @@ Contexto: warm-up - sincronização inicial
 ```
 🔄 Sincronizando docs de {SQUAD}/{WORKSPACE}...
 ✅ Docs sincronizados
-📊 5 documentos disponíveis:
-   - 1 PRD(s)
-   - 1 FRD(s)
-   - 2 ARD(s)
-   - 1 RFC(s)
+📊 7 documentos disponíveis:
+   - 4 funcionalidade(s)
+   - 3 entrega(s) recente(s)
 ```
 
 **Comportamento:**
 - Se `CENTRAL_DOCS_STORAGE` vazio → pula silenciosamente
-- Se erro de token → exibe aviso mas continua
-- Se `index.md` não existe → navega estrutura do repo e lista docs disponíveis
+- Se o `git pull` falhar (pasta com git) → avisa e lê a cópia local
+- Se `index.md` não existe → avisa que o squad ainda não tem consolidação (sugere `/eng.spec-consolidate --inicial`)
 - Se erro genérico → exibe mensagem clara e continua sem bloquear
 
 Após sincronizar, exibir resumo dos documentos disponíveis: