jarvis-ai-framework 2.1.0 → 2.1.1

package/bin/lib/flow-map/render.js

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Saída em texto da árvore de chamadas.
+ * @module flow-map/render
+ */
+
+const TYPE_LABEL = {
+  workflow: "workflow",
+  skill: "skill",
+  agent: "agente",
+  cli: "CLI",
+  mcp: "MCP",
+  external: "externo",
+  broken: "?",
+  unresolved: "?",
+};
+
+/**
+ * Resume a coluna `Condição` para uma linha: sem crases, "Se" em minúscula e limite de tamanho.
+ * @param {string} text
+ * @param {number} [max]
+ */
+export function summarizeCondition(text, max = 90) {
+  let t = text.replace(/[`*]/g, "").replace(/\s+/g, " ").trim();
+  if (!t || t === "—") return "";
+  t = t.charAt(0).toLowerCase() + t.slice(1);
+  return t.length > max ? `${t.slice(0, max - 1).trimEnd()}…` : t;
+}
+
+function describe(node) {
+  const head = node.kind === "menu" ? node.name : `${node.name} [${TYPE_LABEL[node.kind]}]`;
+  const notes = [];
+  const condition = summarizeCondition(node.condicao);
+  if (node.available) notes.push("disponível");
+  if (condition) notes.push(condition);
+  if (node.via) notes.push(`via ${node.via}`);
+  if (node.kind === "broken" || node.marker === "quebrada") notes.push("referência quebrada");
+  else if (node.marker === "a confirmar") notes.push("referência a confirmar");
+  if (node.status === "cycle") notes.push("ciclo: já mapeado acima");
+  else if (node.status === "seen") notes.push("já mapeado acima");
+  else if (node.status === "truncated") notes.push("truncado: use --depth N");
+  return notes.length ? `${head}  (${notes.join("; ")})` : head;
+}
+
+/**
+ * @param {import("./tree.js").TreeNode} root
+ * @returns {string[]} linhas da árvore
+ */
+export function renderTree(root) {
+  const lines = [describe(root)];
+  if (root.status === "selfContained") lines.push("└── (autocontido: não chama nenhum outro item)");
+  else if (root.status === "undeclared") lines.push("└── (sem declaração de chamadas: o item não segue a tabela padronizada)");
+
+  function walk(node, prefix) {
+    node.children.forEach((child, i) => {
+      const last = i === node.children.length - 1;
+      lines.push(`${prefix}${last ? "└── " : "├── "}${describe(child)}`);
+      walk(child, `${prefix}${last ? "    " : "│   "}`);
+    });
+  }
+  walk(root, "");
+  return lines;
+}
+
+/**
+ * @param {string} name
+ * @param {string} type
+ * @param {ReturnType<typeof import("./tree.js").reverseEdges>} edges
+ * @returns {string[]}
+ */
+export function renderReverse(name, type, edges) {
+  const lines = [`Quem chama ${name} [${TYPE_LABEL[type]}]`];
+  if (edges.length === 0) {
+    lines.push(`└── nenhum artefato chama ${name} — pode ser um ponto de entrada`);
+    return lines;
+  }
+  edges.forEach((e, i) => {
+    const notes = [];
+    if (e.passo) notes.push(`passo: ${e.passo}`);
+    if (e.available) notes.push("disponível");
+    const condition = summarizeCondition(e.condicao);
+    if (condition) notes.push(condition);
+    if (e.via) notes.push(`via ${e.via}`);
+    lines.push(`${i === edges.length - 1 ? "└── " : "├── "}${e.from} [${TYPE_LABEL[e.type]}]${notes.length ? `  (${notes.join("; ")})` : ""}`);
+  });
+  return lines;
+}

package/bin/lib/flow-map/tree.js

@@ -0,0 +1,199 @@
+/**
+ * @fileoverview Grafo de chamadas e árvore para frente.
+ * @module flow-map/tree
+ */
+
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { buildIndex } from "./index.js";
+import { parseDeclaration } from "./parse.js";
+
+export const DEFAULT_DEPTH = 4;
+
+/**
+ * Lê o índice e as declarações de todos os artefatos.
+ * @param {string} root - Raiz do framework
+ */
+export function buildGraph(root) {
+  const { items, duplicates } = buildIndex(root);
+  const decl = new Map();
+  for (const item of items.values()) {
+    decl.set(item.name, parseDeclaration(item.type, readFileSync(join(root, item.path), "utf-8")));
+  }
+  return { items, duplicates, decl };
+}
+
+/**
+ * @typedef {Object} TreeNode
+ * @property {string} name
+ * @property {"workflow"|"skill"|"agent"|"cli"|"mcp"|"external"|"broken"|"unresolved"|"menu"} kind
+ * @property {string | null} passo
+ * @property {string} condicao
+ * @property {string | null} via
+ * @property {"quebrada"|"a confirmar"|null} marker
+ * @property {boolean} available
+ * @property {null|"cycle"|"seen"|"truncated"|"undeclared"|"selfContained"} status
+ * @property {TreeNode[]} children
+ */
+
+function hasCalls(graph, name) {
+  const d = graph.decl.get(name);
+  return Boolean(d) && d.rows.some((r) => r.targets.length > 0);
+}
+
+/**
+ * Árvore do que o item chama, até `depth` níveis.
+ * @param {ReturnType<typeof buildGraph>} graph
+ * @param {string} name - Nome de um item do índice
+ * @param {{ depth?: number }} [opts]
+ * @returns {TreeNode}
+ */
+export function forwardTree(graph, name, opts = {}) {
+  const depth = opts.depth ?? DEFAULT_DEPTH;
+  const expanded = new Set([name]);
+
+  function base(partial) {
+    return { passo: null, condicao: "", via: null, marker: null, available: false, status: null, children: [], ...partial };
+  }
+
+  function childrenOf(itemName, level, ancestors) {
+    const d = graph.decl.get(itemName);
+    const children = [];
+    for (const row of d.rows) {
+      if (row.targets.length === 0) continue;
+      const grouped = row.targets.filter((t) => t.kind === "internal" || t.kind === "agent").length > 1;
+      // Em menu, a condição fica no nó do menu e não se repete em cada alvo.
+      const nodes = row.targets.map((t) => targetNode(t, grouped ? { ...row, condicao: "", via: null } : row, level + 1, ancestors));
+      if (grouped) {
+        children.push(
+          base({ name: `menu (${nodes.length} opções)`, kind: "menu", passo: row.passo, condicao: row.condicao, via: row.via, children: nodes }),
+        );
+      } else {
+        children.push(...nodes);
+      }
+    }
+    return children;
+  }
+
+  function targetNode(target, row, level, ancestors) {
+    const common = { passo: row.passo, condicao: row.condicao, via: row.via, marker: row.marker, available: row.available };
+
+    if (["cli", "mcp", "external", "unresolved"].includes(target.kind)) {
+      return base({ name: target.name, kind: target.kind, ...common });
+    }
+    const item = graph.items.get(target.name);
+    if (!item) return base({ name: target.name, kind: "broken", ...common, marker: row.marker ?? "quebrada" });
+
+    const node = base({ name: item.name, kind: item.type, ...common });
+    if (ancestors.has(item.name)) node.status = "cycle";
+    else if (expanded.has(item.name)) node.status = "seen";
+    else if (level >= depth) node.status = hasCalls(graph, item.name) ? "truncated" : null;
+    else {
+      expanded.add(item.name);
+      fill(node, level, new Set([...ancestors, item.name]));
+    }
+    return node;
+  }
+
+  function fill(node, level, ancestors) {
+    const d = graph.decl.get(node.name);
+    if (!d.declared) node.status = "undeclared";
+    else if (d.selfContained) node.status = "selfContained";
+    else node.children = childrenOf(node.name, level, ancestors);
+  }
+
+  const item = graph.items.get(name);
+  const root = base({ name, kind: item.type });
+  fill(root, 0, new Set([name]));
+  return root;
+}
+
+function levenshtein(a, b) {
+  const row = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 1; i <= a.length; i++) {
+    let prev = row[0];
+    row[0] = i;
+    for (let j = 1; j <= b.length; j++) {
+      const tmp = row[j];
+      row[j] = Math.min(row[j] + 1, row[j - 1] + 1, prev + (a[i - 1] === b[j - 1] ? 0 : 1));
+      prev = tmp;
+    }
+  }
+  return row[b.length];
+}
+
+/**
+ * Até 5 nomes parecidos (prefixo, trecho ou distância de edição de até 1 a cada 4 caracteres).
+ * @param {Map<string, unknown>} items
+ * @param {string} name
+ */
+export function suggest(items, name) {
+  const lower = name.toLowerCase();
+  return [...items.keys()]
+    .map((candidate) => {
+      const c = candidate.toLowerCase();
+      const score = c.startsWith(lower) || lower.startsWith(c) ? 0 : c.includes(lower) || lower.includes(c) ? 1 : levenshtein(lower, c) <= Math.max(1, Math.floor(Math.min(lower.length, c.length) / 4)) ? 2 : null;
+      return { candidate, score };
+    })
+    .filter((s) => s.score !== null)
+    .sort((a, b) => a.score - b.score || a.candidate.localeCompare(b.candidate))
+    .slice(0, 5)
+    .map((s) => s.candidate);
+}
+
+/**
+ * Quem declara chamar o item (arestas invertidas do mesmo grafo).
+ * @param {ReturnType<typeof buildGraph>} graph
+ * @param {string} name
+ * @returns {Array<{ from: string, type: string, passo: string | null, condicao: string, via: string | null, available: boolean }>}
+ */
+export function reverseEdges(graph, name) {
+  const edges = [];
+  for (const [from, d] of graph.decl) {
+    if (from === name) continue;
+    for (const row of d.rows) {
+      if (row.targets.some((t) => (t.kind === "internal" || t.kind === "agent") && t.name === name)) {
+        edges.push({
+          from,
+          type: graph.items.get(from).type,
+          passo: row.passo,
+          condicao: row.condicao,
+          via: row.via,
+          available: row.available,
+        });
+      }
+    }
+  }
+  return edges.sort((a, b) => a.from.localeCompare(b.from));
+}
+
+/**
+ * Confere os nomes citados nas declarações.
+ * - erro: `/nome` ou `nome (agente)` que não existe, e nomes duplicados no índice;
+ * - aviso: linha já marcada "referência quebrada" ou "a confirmar", e artefato sem declaração.
+ * @param {ReturnType<typeof buildGraph>} graph
+ * @returns {{ errors: Array<{ file: string, name: string, reason: string }>, warnings: Array<{ file: string, name: string, reason: string }> }}
+ */
+export function findBrokenReferences(graph) {
+  const errors = duplicatesOf(graph);
+  const warnings = [];
+  for (const [name, d] of graph.decl) {
+    const file = graph.items.get(name).path;
+    if (!d.declared) warnings.push({ file, name, reason: "sem declaração de chamadas" });
+    for (const row of d.rows) {
+      for (const t of row.targets) {
+        if (t.kind === "unresolved") {
+          warnings.push({ file, name: t.name, reason: `referência ${row.marker}` });
+        } else if ((t.kind === "internal" || t.kind === "agent") && !graph.items.has(t.name)) {
+          if (row.marker) warnings.push({ file, name: t.name, reason: `referência ${row.marker}` });
+          else errors.push({ file, name: t.name, reason: "não existe como workflow, skill ou agente" });
+        }
+      }
+    }
+  }
+  return { errors, warnings };
+}
+
+function duplicatesOf(graph) {
+  return graph.duplicates.map((name) => ({ file: name, name, reason: "nome repetido entre os artefatos" }));
+}

package/members.md

@@ -4,7 +4,7 @@ Lista de membros da organização com suas posições, squads e identificadores.
 
 > **Formato**: `Nome Completo | email | posição | slack_user_id`
 > **Squads válidos**: definidos em `taxonomy.md`
-> Preencha via `/members-manager` ou edite esta tabela.
+> Edite esta tabela para cadastrar os membros.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jarvis-ai-framework",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Jarvis framework",
   "type": "module",
   "bin": {
@@ -10,7 +10,8 @@
     "postinstall": "node bin/postinstall.js",
     "prepublishOnly": "echo 'Publishing jarvis-framework...'",
     "publish:gitlab": "npm publish",
-    "test:comandos": "node test/test-comandos-docs.js"
+    "test:comandos": "node test/test-comandos-docs.js",
+    "test:filtro": "node --test test/profile-filter.test.js test/token-report.test.js test/flow-map.test.js"
   },
   "files": [
     "bin/",
@@ -19,6 +20,7 @@
     "workflows/",
     "templates/",
     "rules/",
+    "rules-on-demand/",
     "taxonomy.md",
     "members.md",
     "AGENTS.md",

package/rules/AGENTS.md

@@ -13,22 +13,31 @@ A pasta `rules/` contem **regras e diretrizes** que governam o comportamento do
 ## Estrutura
 
 ```
-rules/
+rules/                        # Sempre carregadas no início da sessão
 ├── engineering/              # Regras de engenharia
 │   ├── eng-rules.md          # Regras gerais de engenharia
-│   ├── eng.start-rules.md    # Regras para /eng.start
-│   ├── eng.plan-rules.md     # Regras para /eng.plan
-│   ├── eng.work-rules.md     # Regras para /eng.work
-│   ├── eng.pr-rules.md       # Regras para /eng.pr
 │   ├── eng.bump-rules.md     # Regras para versionamento
-│   ├── eng.tech-spec-rules.md # Regras para tech specs
 │   ├── eng.specializations-rules.md # Carregamento de especializações por stack
 │   ├── eng.skills-rules.md       # Área obrigatória nos skills e aviso de skill inexistente
 │   └── qa/                   # Regras de QA
 └── product/                  # Regras de produto
     └── prod-rules.md    # Regras de especificacao
+
+rules-on-demand/              # Lidas pelo workflow que as usa (não carregadas no início)
+└── engineering/
+    ├── eng.start-rules.md    # Regras para /eng.start
+    ├── eng.plan-rules.md     # Regras para /eng.plan
+    ├── eng.work-rules.md     # Regras para /eng.work
+    ├── eng.pre-pr-rules.md   # Regras para /eng.pre-pr
+    ├── eng.pr-rules.md       # Regras para /eng.pr
+    ├── eng.tech-spec-rules.md # Regras para tech specs
+    └── eng.breakdown-subtasks-rules.md # Regras para o breakdown de subtarefas
 ```
 
+### `rules/` x `rules-on-demand/`
+
+O Claude Code carrega tudo de `.claude/rules/` no início da sessão: `rules/` fica só com o que vale sempre. Rule de uma etapa só (um comando) vai para `rules-on-demand/`, e o workflow manda lê-la (`rules_file` + "antes de começar, leia..."). O `Applies to` e o filtro por perfil valem nas duas. Efeito: `jarvis tokens`.
+
 ---
 
 ## Hierarquia de Regras
@@ -36,7 +45,7 @@ rules/
 ```
 1. .windsurf/rules / .cursor/rules  (mais alta)
 2. rules/engineering/eng-rules.md
-3. rules/engineering/eng.{comando}-rules.md
+3. rules-on-demand/engineering/eng.{comando}-rules.md
 4. rules/product/prod-rules.md (mais baixa)
 ```
 
@@ -80,6 +89,8 @@ Cada arquivo de rule declara para quais perfis se aplica via bloco `applies_to`,
 
 **Ao criar uma nova rule**, definir o bloco `applies_to` é obrigatório. Sem ele, a rule é tratada como universal — o que pode ser indesejado para rules domain-specific.
 
+**Não declarar `trigger:` no frontmatter.** O Claude Code ignora o campo e carrega toda rule da pasta (sem `paths`) no início da sessão. Quem filtra a rule por perfil é o bloco `applies_to`.
+
 ---
 
 ## Estrutura de um Arquivo de Regras

package/rules/engineering/eng-rules.md

@@ -1,5 +1,4 @@
 ---
-trigger: always_on
 env_file: "@/ENV.md"
 ---
 
@@ -171,18 +170,9 @@ env_file: "@/ENV.md"
 
 ---
 
-## 🔄 Fluxo Downstream de Cards
+## 🔄 Autonomia no card
 
-Ao orientar o usuário sobre transição de status de cards no board (Jira, GitLab, Linear ou equivalente), **sempre consultar**:
-
-> `$IDE/rules/engineering/eng.downstream-flow-rules.md`
-
-Este arquivo define:
-- Diagrama completo do fluxo (11 estágios)
-- Matriz de transições: quem move o quê e quando
-- Responsabilidades por papel, mapeadas diretamente de `taxonomy.md`
-- Critérios de entrada e saída por estágio
-- RACI consolidado
+Ao orientar o usuário sobre a movimentação de cards no board (Jira, GitLab, Linear, GitHub ou equivalente), use o princípio abaixo; não há um fluxo de colunas fixo no framework.
 
 **Princípio — autonomia do profissional:**
 - Quem assumiu o card (**DEV**, **TECH LEAD** ou **PM/TPM/GPM**) pode conduzi-lo **ponta-a-ponta**: puxar, implementar, abrir MR, merge, validar, aceite e preparar/executar deploy.

package/rules/engineering/eng-security-rules.md

@@ -1,5 +1,4 @@
 ---
-trigger: always_on
 env_file: "@/ENV.md"
 ---
 
@@ -138,7 +137,7 @@ Usar `jarvis-context-detect` para calibrar a profundidade da analise de seguranc
 | **Alto** — Audit completo | Usuario invoca `/eng.security-audit` explicitamente | Fan-out + multi-voto (3 votos por achado) | ~200k-1M (subagentes isolados) |
 
 O peso do token fica em subagentes isolados — janela da sessao principal nao lota.
-PR comum sem risco identificado = zero token extra (so as rules always_on).
+PR comum sem risco identificado = zero token extra (so as rules, que ja ficam carregadas).
 
 ---
 

package/rules/engineering/eng.integrations-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: all | SQUAD: all
 
 # Integrações — vendors via ENV

package/rules/engineering/eng.skills-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: ENGINEERING | SQUAD: all
 
 # Regras de Skills: área obrigatória e nome inexistente

package/rules/engineering/eng.specializations-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: ENGINEERING | SQUAD: all
 
 # Regras de Especializações por Stack

package/rules/product/README.md

@@ -15,6 +15,7 @@ Documentação didática (termos por extenso, exemplos, quando usar cada comando
 | `/prod.spec.discovery` | [prod.spec.discovery.md](../../docs/produto/prod.spec.discovery.md) |
 | `/prod.spec.prd` | [prod.spec.prd.md](../../docs/produto/prod.spec.prd.md) |
 | `/prod.spec.frd` | [prod.spec.frd.md](../../docs/produto/prod.spec.frd.md) |
+| `/prod.spec.ard` | [prod.spec.ard.md](../../docs/produto/prod.spec.ard.md) |
 | `/prod.spec.breakdown` | [prod.spec.breakdown.md](../../docs/produto/prod.spec.breakdown.md) |
 | `/prod.spec.clarify` | [prod.spec.clarify.md](../../docs/produto/prod.spec.clarify.md) |
 | `/prod.spec.epic` | [prod.spec.epic.md](../../docs/produto/prod.spec.epic.md) |

package/rules/product/prod-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: all | SQUAD: all
 
 ## Principais Regras
@@ -98,6 +94,7 @@ Sempre siga as instruções de acordo com as relações abaixo.
 - `$PROD_FLOWS/prod.spec.discovery.md` — Investigação inicial de uma ideia (rascunho estruturado; não define tarefas) → [docs/produto/prod.spec.discovery.md](../../docs/produto/prod.spec.discovery.md)
 - `$PROD_FLOWS/prod.spec.prd.md` — Documento de Requisitos de Produto (*Product Requirements Document*) → [docs/produto/prod.spec.prd.md](../../docs/produto/prod.spec.prd.md)
 - `$PROD_FLOWS/prod.spec.frd.md` — Documento de Requisitos Funcionais (*Functional Requirements Document*) → [docs/produto/prod.spec.frd.md](../../docs/produto/prod.spec.frd.md)
+- `$PROD_FLOWS/prod.spec.ard.md` — ARD a partir do produto (requisitos arquiteturais com o PM; conduz o `eng.create-ard`) → [docs/produto/prod.spec.ard.md](../../docs/produto/prod.spec.ard.md)
 - `$PROD_FLOWS/prod.spec.breakdown.md` — Quebra de especificação grande em fatias → [docs/produto/prod.spec.breakdown.md](../../docs/produto/prod.spec.breakdown.md)
 - `$PROD_FLOWS/prod.spec.clarify.md` — Esclarecimento de ambiguidades na spec → [docs/produto/prod.spec.clarify.md](../../docs/produto/prod.spec.clarify.md)
 - `$PROD_FLOWS/prod.spec.epic.md` — Épico (agrupador de histórias/tarefas) → [docs/produto/prod.spec.epic.md](../../docs/produto/prod.spec.epic.md)

package/rules/product/prod.spec-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: PRODUCT | SQUAD: all
 
 # Regras de Escrita de Especificação de Produto

package/rules/rtk-rules.md

@@ -1,5 +1,4 @@
 ---
-trigger: always_on
 env_file: "@/ENV.md"
 ---
 

package/{rules → rules-on-demand}/engineering/eng.breakdown-subtasks-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: all | SQUAD: all
 
 # Regras do Workflow Breakdown Subtasks

package/{rules → rules-on-demand}/engineering/eng.plan-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: ENGINEERING | SQUAD: all
 
 # Regras do Workflow Plan (Planejamento de Execução)

package/{rules → rules-on-demand}/engineering/eng.pr-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: ENGINEERING | SQUAD: all
 
 # Regras do Workflow PR (Pull Request / Merge Request)

package/{rules → rules-on-demand}/engineering/eng.pre-pr-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: ENGINEERING | SQUAD: all
 
 # Regras do Workflow Pre-PR

package/{rules → rules-on-demand}/engineering/eng.start-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: ENGINEERING | SQUAD: all
 
 # Regras do Workflow Start

package/{rules → rules-on-demand}/engineering/eng.tech-spec-rules.md

@@ -1,5 +1,4 @@
 ---
-trigger: always_on
 env_file: "@/ENV.md"
 ---
 
@@ -43,7 +42,7 @@ Sempre siga as instruções de acordo com as relações abaixo:
 
 ### Regras
 
-- **import `$IDE/rules/engineering/eng.tech-spec-rules.md`**: Regras específicas de tech spec (este arquivo)
+- **import `$IDE/rules-on-demand/engineering/eng.tech-spec-rules.md`**: Regras específicas de tech spec (este arquivo)
 
 ---
 

package/{rules → rules-on-demand}/engineering/eng.work-rules.md

@@ -1,7 +1,3 @@
----
-trigger: always_on
----
-
 > **Applies to:** HUB: all | POSITION: all | AREA: ENGINEERING | SQUAD: all
 
 # Regras do Workflow Work

package/skills/AGENTS.md

@@ -122,7 +122,7 @@ skills/
     └── SKILL.md
 ```
 
-> Pastas listadas acima refletem skills com `SKILL.md` neste repo. Não invente `skill-creator` / `taxonomy-manager` / `members-manager` se a pasta não existir.
+> Pastas listadas acima refletem skills com `SKILL.md` neste repo. Não cite uma skill que não tenha pasta em `skills/`.
 
 ---
 
@@ -219,10 +219,12 @@ O nome tem a forma `<prefixo>-<área>-<nome>`; **só os dois primeiros segmentos
 6. **Quando Usar** - Cenarios de uso
 7. **Padroes Criticos** - Regras mais importantes
 8. **Fluxo de Trabalho** - Passo a passo
-9. **Regras** - Nunca/Sempre
-10. **Checklist de Conclusao** - Validacao final
-11. **Output** - Artefatos gerados
-12. **Mensagem de Conclusao** - Feedback ao usuario
+9. **Skills invocados durante a execução do skill** - Subseção (`###`) com a tabela `| Passo | Skill | Condição |` do que o skill chama no próprio fluxo (não vale pré-requisito pedido ao usuário nem sugestão de próximo passo). Sem chamadas, uma linha `Nenhuma — skill autocontida`. Vem depois do fluxo e antes de Tratamento de Erros/Checklist
+   O `jarvis map` e o `npm run test:comandos` leem so essa tabela (e, nos agentes, `## Skills Disponíveis` e `## Workflows e Agentes Relacionados`): chamada que existir so no texto corrido nao aparece no mapa, e nome citado que nao existir faz o teste falhar.
+10. **Regras** - Nunca/Sempre
+11. **Checklist de Conclusao** - Validacao final
+12. **Output** - Artefatos gerados
+13. **Mensagem de Conclusao** - Feedback ao usuario
 
 ---
 
@@ -266,12 +268,9 @@ Skills são invocados de formas diferentes dependendo da IDE:
 | `/eng.pre-pr` | `eng-qa-test-plan` |
 | `/eng.pr` | `eng-global-pr` |
 | QA validation | `eng-qa-gate` |
-| Criar skill | `skill-creator` |
-| `/taxonomy-manager` | `taxonomy-manager` |
 | Listar especializações de stack (instaladas e registradas) | `jarvis-list-specializations` |
 | Criar uma especialização de stack (backend ou frontend) a partir do código do projeto | `jarvis-create-specialization` |
 | Decisão de arquitetura do Jarvis (agent, skill, workflow ou rule?), simplificação, tendências | `jarvis-evolution-architect` |
-| `/members-manager` | `members-manager` |
 | Mensageria, filas, RabbitMQ, events, consumers, producers | `eng-backend-rabbitmq` (especialização de backend: registrar em `BACKEND_SPECIALIZATIONS`) |
 | APIs, auth, workers, filas, caching, banco de dados | `eng-backend` (base) + `BACKEND_SPECIALIZATIONS` |
 | Componentes, UI, estado, estilos, performance, acessibilidade | `eng-frontend` (base) + `FRONTEND_SPECIALIZATIONS` |
@@ -293,19 +292,13 @@ Skills são invocados de formas diferentes dependendo da IDE:
 
 ## Criando um Novo Skill
 
-Use o skill-creator:
-
-```bash
-/skill-creator meu-novo-skill
-```
-
-Ou manualmente:
+Não há um gerador de skills: a criação é manual.
 
 1. Escolher a **área** e o nome no padrão `<prefixo>-<área>-<nome>` (ver "Áreas e nomes")
-2. Criar pasta: `skills/{nome}/`
-3. Copiar template: `skills/skill-creator/assets/SKILL-template.md`
-4. Preencher todos os placeholders, **inclusive `metadata.area`** (e `metadata.stack` se for especialização)
-5. Validar estrutura: `name` igual ao nome da pasta e área reconhecida
+2. Criar a pasta `skills/{nome}/` com um `SKILL.md`, usando como modelo um skill existente de porte parecido (por exemplo, `eng-qa-gate` para um skill de fluxo, `eng-backend-nestjs` para uma especialização)
+3. Preencher o frontmatter ("Frontmatter Obrigatorio"), **inclusive `metadata.area`** (e `metadata.stack` se for especialização), e as "Secoes Obrigatorias de um SKILL.md", incluindo a tabela `Skills invocados durante a execução do skill`
+4. Validar estrutura: `name` igual ao nome da pasta e área reconhecida
+5. Registrar o skill no `SKILLS-ROADMAP.md` e, se houver comando associado, na tabela "Mapeamento Comando → Skill"
 
 ---
 
@@ -342,12 +335,17 @@ Link para docs existentes?         → references/
 
 **Regra**: `references/` deve apontar para arquivos LOCAIS, nao URLs web.
 
+### Skill grande com temas separaveis: roteador + references/
+
+O corpo do `SKILL.md` e carregado inteiro ao invocar a skill. Quando a skill tem **3 ou mais temas que se usam isoladamente** (por exemplo guards, testes, troubleshooting), mantenha no `SKILL.md` so o que vale sempre (objetivo, quando usar, padroes criticos, arvore de decisao, regras, checklist, a tabela de skills invocados) e uma tabela "Referencias" (Tema | Quando ler | Arquivo); cada tema vai para `references/{n}-{tema}.md`. Modelo: `skills/eng-backend/`. Ja seguem o modelo: `eng-backend-nestjs`, `eng-scraper`, `eng-security-cybersecurity`, `eng-backend-rabbitmq`, `eng-frontend-microfrontend`, `eng-frontend-design-system` e `eng-qa-bug-report` (so os temas de apoio: adapters de task manager, exemplos e bug-to-test; o fluxo por modos fica no `SKILL.md`).
+
+Nao converta procedimento sequencial (passo 1, 2, 3 que se le de ponta a ponta) nem skill pequena (menos de ~8 KB): nao ha tema para pular, so mais arquivos para ler.
+
 ---
 
 ## Referencias
 
-- `skill-creator/SKILL.md` - Skill para criar skills
-- `skill-creator/assets/SKILL-template.md` - Template padrao
+- `SKILLS-ROADMAP.md` - Skills existentes e planejadas
 - `../agents/` - Agentes que usam skills
 - `../workflows/` - Workflows relacionados
 - `../rules/` - Regras que skills implementam

package/skills/SKILLS-ROADMAP.md

@@ -221,10 +221,6 @@ Removidas: `checkin`, `checkout`, `daily`, `task-log`, `send-priority`, `sent-pr
 - **Trigger**: auto-report de bugs no framework Jarvis via GitLab API
 - **Status**: `criado`
 
-### `skill-creator` ✅
-- **Trigger**: criação de novos skills
-- **Status**: `criado`
-
 ### `jarvis-docs-index` / `jarvis-docs-central` / `jarvis-context-detect` ✅
 - **Trigger**: indexação de docs, sync com repo central, detecção de contexto
 - **Status**: `criado`