@nathanramorim/forge-sdd 3.0.0-beta → 3.0.0-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +48 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -40,9 +40,55 @@ npx @nathanramorim/forge-sdd@latest init
|
|
|
40
40
|
npx @nathanramorim/forge-sdd@latest init . --agent copilot,gemini --name meu-projeto
|
|
41
41
|
```
|
|
42
42
|
|
|
43
|
-
##
|
|
43
|
+
## Orquestração Independente, Portão de Governança (A/B/C), Constituição por IDs e Auto-Skills (v3.0.0-beta)
|
|
44
|
+
|
|
45
|
+
> **De um agente solitário para uma esteira de 5 especialistas trabalhando em paralelo por você.**
|
|
46
|
+
> Na versão 3.0, você alinha a visão com o **Líder**, aprova a planta do projeto e aciona uma linha de produção autônoma: planejadores, construtores em paralelo e um auditor independente entregam o software validado em um **Painel Executivo** para sua decisão final.
|
|
47
|
+
|
|
48
|
+
```mermaid
|
|
49
|
+
flowchart LR
|
|
50
|
+
subgraph Voce["VOCÊ // DIREÇÃO E APROVAÇÃO"]
|
|
51
|
+
V1["01. Alinha a demanda"]
|
|
52
|
+
V2["02. Aprova a especificação"]
|
|
53
|
+
V3["03. Recebe o Painel Executivo"]
|
|
54
|
+
end
|
|
55
|
+
|
|
56
|
+
subgraph Equipe["FORGE-SDD 3.0 // ESTEIRA AUTÔNOMA EM 5 ESTAÇÕES"]
|
|
57
|
+
direction TB
|
|
58
|
+
E1["01 // LÍDER (Orquestrador)<br/>Coordena as estações e reporta a você"]
|
|
59
|
+
E2["02 // PRODUTO & ARQUITETO<br/>Especificação técnica e verificação de reuso"]
|
|
60
|
+
E3["03 // PLANEJADOR<br/>Decompõe em tarefas e vincula regras"]
|
|
61
|
+
|
|
62
|
+
subgraph Paralelo["EXECUÇÃO SIMULTÂNEA // FILA DETERMINÍSTICA"]
|
|
63
|
+
B1["04A // BUILDER A<br/>Frente Independente 1"]
|
|
64
|
+
B2["04B // BUILDER B<br/>Frente Independente 2"]
|
|
65
|
+
end
|
|
66
|
+
|
|
67
|
+
E5["05 // AUDITOR DE GOVERNANÇA<br/>(Somente Leitura — audita arquitetura,<br/>boas práticas e segurança)"]
|
|
68
|
+
SK["MOTOR AUTO-SKILLS<br/>Padrões recorrentes (3x) viram<br/>habilidades reutilizáveis automaticamente"]
|
|
69
|
+
end
|
|
70
|
+
|
|
71
|
+
V1 --> E1
|
|
72
|
+
E1 --> E2
|
|
73
|
+
E2 -->|"Portão FLX-01"| V2
|
|
74
|
+
V2 -->|"Aprovado"| E3
|
|
75
|
+
E3 --> B1 & B2
|
|
76
|
+
B1 & B2 --> E5
|
|
77
|
+
E5 -->|"Laudo técnico"| E1
|
|
78
|
+
E5 -.->|"Cataloga padrão"| SK
|
|
79
|
+
E1 -->|"O que foi feito, estado por etapa<br/>e o que resta no backlog"| V3
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
| Estação | Função Executiva | Responsabilidade na Esteira |
|
|
83
|
+
| :--- | :--- | :--- |
|
|
84
|
+
| **01 // Líder** | *Gerente de Operações* | Único ponto de contato humano. Aciona as estações e consolida o **Painel Executivo (Camada C)** (*o que foi feito, status de cada etapa e o que falta*). |
|
|
85
|
+
| **02 // Produto & Arquiteto** | *Autoria da Especificação* | Desenha a solução e verifica o que já existe (`Reuse Check`). **Nenhuma implementação inicia sem sua aprovação na especificação (`FLX-01`).** |
|
|
86
|
+
| **03 // Planejador** | *Engenharia de Plano* | Decompõe a especificação aprovada em tarefas atômicas e seleciona apenas os módulos de regras aplicáveis a cada tarefa. |
|
|
87
|
+
| **04 // Builders** | *Execução em Fila* | Consomem tarefas de uma **fila determinística** (`forge-sdd queue`): frentes independentes rodam **em paralelo**; dependências aguardam liberação. |
|
|
88
|
+
| **05 // Governança** | *Auditoria Independente* | **Sem permissão de escrita em código.** Audita se a entrega respeitou arquitetura, boas práticas e segurança antes de devolver ao Líder. |
|
|
44
89
|
|
|
45
|
-
|
|
90
|
+
### Destaques Técnicos da `v3.0.0-beta`
|
|
91
|
+
* **5 Estações Coordenadas (`.agents/roles/`):** fonte canônica única dos papéis com adaptadores finos para Claude Code, Gemini e GitHub Copilot.
|
|
46
92
|
* **Constituição por IDs Estáveis + Rules Modulares (`.agents/rules/sdd-*.md`):** `sdd/memory/constitution.md` mantém "o quê e por quê" enxuto com IDs (`ARQ`, `SEG`, `DUP`, `COD`, `TST`, `FLX`, `GOV`), enquanto as rules detalham "como cumprir" sob demanda sem duplicar texto (`GOV-04`).
|
|
47
93
|
* **Fila do Builder (`forge-sdd queue`) e Portão em 3 Camadas (`forge-sdd gate`):** exige seção `"O que já existe"` (Reuse Check `DUP-02`) na Spec, roda checks determinísticos `P-xx` (Camada A) e valida o parecer JSON baseado em evidências do Analista de Governança (Camada B) antes da aprovação humana no Líder (Camada C).
|
|
48
94
|
* **Auto-Skills (`forge-sdd skills`) e Pacotes de Governança (`forge-sdd governance`):** atividades padronizadas repetidas viram skills reutilizáveis em `.agents/skills/` sincronizadas para `.claude/skills/` e `.gemini/skills/`.
|
package/package.json
CHANGED