refactor(skills): cut the workflows to ~100 lines and scale phases by tier

Each workflow was ~300 lines of grep-count "VERIFICAR" steps and ran every phase for every request. Phases now state their minimum tier, checks are the quality gate plus real tools, detail moved to references/, and machine-specific paths and non-public skills are gone. Security references move to OWASP Top 10:2025, ASVS 5.0 and the OWASP LLM Top 10. Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-24 21:52:06 -03:00
1 parent c18d3356ae
commit f2db2d69da
@@ -0,0 +1,45 @@
+# C4 em Mermaid
+
+Regras: até 20 elementos por view, toda seta com rótulo (o que trafega e por qual protocolo),
+IDs estáveis reaproveitados em ADRs e no threat model, declaração na ordem de leitura
+(de quem usa para o que é usado).
+
+## Context
+
+```mermaid
+C4Context
+  title Contexto: Sistema de Pedidos
+  Person(cliente, "Cliente", "Compra pelo site")
+  System(pedidos, "Sistema de Pedidos", "Cria e acompanha pedidos")
+  System_Ext(pagamento, "Gateway de pagamento", "Cobra o cartão")
+  Rel(cliente, pedidos, "Cria pedido", "HTTPS")
+  Rel(pedidos, pagamento, "Autoriza cobrança", "HTTPS/REST")
+```
+
+## Container
+
+```mermaid
+C4Container
+  title Containers: Sistema de Pedidos
+  Person(cliente, "Cliente")
+  System_Boundary(sp, "Sistema de Pedidos") {
+    Container(web, "Web", "Next.js", "Interface")
+    Container(api, "API", "FastAPI", "Regras de pedido")
+    ContainerDb(db, "Banco", "PostgreSQL", "Pedidos e itens")
+    Container(worker, "Worker", "Celery", "Cobrança assíncrona")
+  }
+  System_Ext(pagamento, "Gateway de pagamento")
+  Rel(cliente, web, "Usa", "HTTPS")
+  Rel(web, api, "Chama", "HTTPS/JSON")
+  Rel(api, db, "Lê e grava", "SQL/TLS")
+  Rel(api, worker, "Enfileira cobrança", "Redis")
+  Rel(worker, pagamento, "Autoriza", "HTTPS")
+```
+
+## Render
+
+```bash
+npx -y @mermaid-js/mermaid-cli -i docs/architecture/c4.mmd -o /tmp/c4.svg
+```
+
+Se o comando falhar, o diagrama tem erro de sintaxe e não está pronto.