jarvis-ai-framework 8.2.0 → 8.3.0

package/bin/commands/init.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, realpathSync } from "node:fs";
 import { join, dirname, basename, resolve, sep } from "node:path";
 import { createInterface } from "node:readline";
-import { syncAssets } from "../lib/core/sync-engine.js";
+import { syncAssets, applyRuleOverlay } from "../lib/core/sync-engine.js";
 import { discoverAll } from "../lib/core/scanner.js";
 import {
   IDES,
@@ -23,6 +23,7 @@ import {
   removeStaleSkills,
 } from "../lib/core/stale-skills.js";
 import { parseEnvEntries, planEnvUpgrade, applyEnvUpgrade } from "../lib/core/env-upgrade.js";
+import { DEFAULT_COMPANY_PROFILE, isValidCompanyProfile } from "../lib/core/company-profile.js";
 import { checkCli, getVendor } from "../lib/integrations/cli-runner.js";
 import {
   expandEnv,
@@ -76,6 +77,32 @@ export function upgradePendencies({ pendingAxes, envPlan }) {
   return reasons;
 }
 
+/**
+ * Pergunta do perfil de empresa no `--upgrade` (#199). Pura: recebe o `ask` (uma pergunta → a
+ * resposta) e o `warn` (um aviso na hora), e devolve o perfil próprio ou `null` para o default.
+ * Enter = default; nome inválido é perguntado mais uma vez; inválido de novo = default, com aviso.
+ * Testável sem terminal.
+ * @param {(question: string) => Promise<string>} ask
+ * @param {{ defaultProfile?: string, warn?: (message: string) => void }} [opts]
+ * @returns {Promise<string | null>}
+ */
+export async function promptCompanyProfile(
+  ask,
+  { defaultProfile = DEFAULT_COMPANY_PROFILE, warn = () => {} } = {}
+) {
+  const prompt = `Perfil de empresa (COMPANY_PROFILE) [Enter = ${defaultProfile}]: `;
+  let answer = (await ask(prompt)).trim();
+  if (answer && !isValidCompanyProfile(answer)) {
+    warn(
+      "Nome inválido: use letras minúsculas, números e hífen, e não o nome de uma pasta do core. Tente de novo ou Enter para o default."
+    );
+    answer = (await ask(prompt)).trim();
+  }
+  if (answer && isValidCompanyProfile(answer)) return answer === defaultProfile ? null : answer;
+  if (answer) warn(`Nome inválido de novo: gravando o default ${defaultProfile}.`);
+  return null;
+}
+
 /**
  * Leitor de linhas que não perde resposta: guarda as linhas que chegam antes da pergunta
  * (pipe com várias linhas, como `printf 's\n3\n'`) e devolve `null` quando a entrada fecha
@@ -564,11 +591,40 @@ async function runUpgrade(cwd, flags) {
     }
   }
 
+  // 3.2 Perfil de empresa (#199): a chave nova nasce com o default; com terminal e sem --yes,
+  // pergunta. Só o nome da chave e "default/definido" saem no resumo, nunca o valor.
+  let companyProfile = null;
+  if (addedKeys.includes("COMPANY_PROFILE")) {
+    if (!flags.yes && process.stdin.isTTY) {
+      const rl = createInterface({ input: process.stdin, output: process.stdout });
+      companyProfile = await promptCompanyProfile((q) => ask(rl, q), {
+        warn: (m) => logger.info(`${YELLOW}  ${m}${NC}`),
+      });
+      rl.close();
+    } else if (!flags.yes) {
+      logger.info(
+        `${DIM}  Sem terminal interativo e sem --yes: COMPANY_PROFILE fica no default ${DEFAULT_COMPANY_PROFILE}.${NC}`
+      );
+    }
+  }
+
   const overrides =
     docsPlan.moves.length > 0 && !accepted ? declineEnvValues(docsPlan, addedKeys, env) : {};
+  if (companyProfile) overrides.COMPANY_PROFILE = companyProfile;
   const today = new Date().toISOString().slice(0, 10);
   applyEnvUpgrade(envPath, envPlan, today, overrides);
 
+  // 3.3 Perfil respondido agora: o sync acima rodou com o default. Reaplica o overlay do perfil
+  // gravado (pasta dele criada, rules dele por cima). A pasta do default criada antes fica: todo
+  // workspace a tem, e o upgrade não apaga nada em overlays/.
+  if (companyProfile) {
+    const again = { copied: [], skipped: [], errors: [] };
+    applyRuleOverlay(join(workspaceDir, `.${getIDEFolder(ide)}`), again);
+    for (const item of again.copied) logger.info(`${BLUE}  ↳ ${item}${NC}`);
+    for (const item of again.skipped) logger.info(`${DIM}  ↳ ${item}${NC}`);
+    for (const e of again.errors) logger.error(`${RED}  ✗ ${e}${NC}`);
+  }
+
   // 3.1 Skills instalados que saíram do framework: só lista; remove com confirmação ou --remove-stale
   const ideSkillsDir = join(workspaceDir, `.${getIDEFolder(ide)}`, "skills");
   const stale = findStaleSkills({
@@ -619,6 +675,11 @@ async function runUpgrade(cwd, flags) {
   logger.info(
     `  • ENV.md: ${addedKeys.length ? `+ ${addedKeys.join(", ")}` : "nenhuma variável nova"}`
   );
+  if (addedKeys.includes("COMPANY_PROFILE")) {
+    logger.info(
+      `  • COMPANY_PROFILE: ${companyProfile ? "definido" : `default (${DEFAULT_COMPANY_PROFILE})`}`
+    );
+  }
   if (Object.keys(overrides).length) {
     logger.info(`  • Mantidos no caminho antigo: ${Object.keys(overrides).join(", ")}`);
   }

package/bin/lib/cli/program.js

@@ -25,6 +25,7 @@ import { docsPublish } from "../../commands/docs-publish.js";
 import { installRtk } from "../../commands/install-rtk.js";
 import { tokens } from "../../commands/tokens.js";
 import { map } from "../../commands/map.js";
+import { fork } from "../../commands/fork.js";
 import { dailyReport } from "../../commands/daily-report.js";
 import { runCreateMerge } from "../vcs/create-merge.js";
 import { runCreateIssue } from "../vcs/create-issue.js";
@@ -177,6 +178,32 @@ export function buildProgram() {
     .option("--env-file <path>")
     .action((options) => tokens(toLegacyFlags(options)));
 
+  cmd(program, "fork")
+    .description(
+      "Overlay de empresa: copia um artefato do core para $IDE/overlays/{COMPANY_PROFILE}/, com carimbo"
+    )
+    .argument(
+      "[nome]",
+      "Workflow, skill ou agente pelo nome, ou rules/…, rules-on-demand/…, templates/… por caminho"
+    )
+    .option(
+      "--list",
+      "Lista o que está forkado no overlay ativo (só lista; não compara com o core)"
+    )
+    .option(
+      "--update",
+      "Recarimba o fork com a versão atual do core (forked_from); o conteúdo não muda"
+    )
+    .option(
+      "--diff",
+      "Com --update: só mostra o diff fork × core atual, por seção (🔴 em possível mudança de contrato), sem gravar"
+    )
+    .option("--delete", "Remove o fork do overlay; rules voltam à versão do core na IDE")
+    .option("--candidate", "Marca o fork como candidato a core (core_candidate: true)")
+    .option("--ide <ide>")
+    .option("--env-file <path>")
+    .action((nome, options) => fork(toLegacyFlags(options, { _: [nome].filter(Boolean) })));
+
   cmd(program, "map")
     .description("Mapa de chamadas de um workflow, skill ou agente")
     .argument("[name]", "Nome do workflow, skill ou agente")

package/bin/lib/core/company-profile.js

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview Perfil de empresa (`COMPANY_PROFILE`, #199): nome do overlay ativo em
+ * `$IDE/overlays/{perfil}/`. A chave nunca fica vazia: o default é `stark-industries`,
+ * o overlay padrão do Jarvis. Um nome fora do padrão ou igual a uma pasta do core cai
+ * no default, com aviso. Este módulo só decide o nome; quem lê e grava arquivos é quem o chama.
+ * @module core/company-profile
+ */
+
+/** @constant {string} Perfil default: o overlay padrão de todo workspace */
+export const DEFAULT_COMPANY_PROFILE = "stark-industries";
+
+/** @constant {RegExp} Mesmo padrão dos nomes de skill (minúsculas, números e hífen) */
+export const COMPANY_PROFILE_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+
+/**
+ * Pastas do core que um perfil não pode usar como nome: o overlay espelha estas pastas,
+ * e `overlays/rules/` ficaria ambíguo com `rules/`.
+ * @constant {ReadonlyArray<string>}
+ */
+export const CORE_FOLDERS = Object.freeze([
+  "agents",
+  "skills",
+  "workflows",
+  "commands",
+  "rules",
+  "rules-on-demand",
+  "templates",
+  "scripts",
+  "overlays",
+]);
+
+/**
+ * @param {string} name
+ * @returns {boolean} true se o nome serve como perfil (padrão e fora das pastas do core)
+ */
+export function isValidCompanyProfile(name) {
+  return COMPANY_PROFILE_PATTERN.test(name) && !CORE_FOLDERS.includes(name);
+}
+
+/**
+ * Resolve o perfil ativo a partir do valor lido do `ENV.md` (já sem aspas e comentário).
+ * Vazio ou ausente → default com aviso ℹ️ (ENV editado à mão ou anterior à #199);
+ * inválido → default com aviso ⚠️. O aviso vai no retorno, nunca em log: quem chama decide.
+ * @param {string | undefined | null} raw - valor de `COMPANY_PROFILE`
+ * @returns {{ profile: string, warning: string | null, isDefault: boolean }}
+ */
+export function resolveCompanyProfile(raw) {
+  const value = (raw ?? "").trim();
+  if (!value) {
+    return {
+      profile: DEFAULT_COMPANY_PROFILE,
+      isDefault: true,
+      warning:
+        raw === undefined || raw === null
+          ? null
+          : `ℹ️ COMPANY_PROFILE vazio: usando o perfil default ${DEFAULT_COMPANY_PROFILE}. Rode /jarvis-init para definir um perfil próprio.`,
+    };
+  }
+  if (CORE_FOLDERS.includes(value)) {
+    return {
+      profile: DEFAULT_COMPANY_PROFILE,
+      isDefault: true,
+      warning: `⚠️ COMPANY_PROFILE não pode ser o nome de uma pasta do core (${CORE_FOLDERS.join(", ")}). Usando o perfil default ${DEFAULT_COMPANY_PROFILE}.`,
+    };
+  }
+  if (!COMPANY_PROFILE_PATTERN.test(value)) {
+    return {
+      profile: DEFAULT_COMPANY_PROFILE,
+      isDefault: true,
+      warning: `⚠️ COMPANY_PROFILE "${value}" inválido (use letras minúsculas, números e hífen). Usando o perfil default ${DEFAULT_COMPANY_PROFILE}.`,
+    };
+  }
+  return { profile: value, isDefault: value === DEFAULT_COMPANY_PROFILE, warning: null };
+}
+
+/**
+ * Lê `COMPANY_PROFILE=` de um texto de `ENV.md` (primeira ocorrência, sem aspas nem comentário
+ * de fim de linha) e resolve o perfil. ENV.md sem a chave (anterior à #199) → default com o ℹ️,
+ * como a chave vazia; sem ENV.md (`envText` ausente, primeiro `jarvis init`) → default sem aviso.
+ * @param {string | undefined} envText
+ * @returns {{ profile: string, warning: string | null, isDefault: boolean }}
+ */
+export function readCompanyProfile(envText) {
+  if (envText === undefined || envText === null) return resolveCompanyProfile(undefined);
+  const match = /^[ \t]*COMPANY_PROFILE=(.*)$/m.exec(envText);
+  if (!match) return resolveCompanyProfile("");
+  const raw = match[1]
+    .replace(/\s+#.*$/, "")
+    .trim()
+    .replace(/^["']|["']$/g, "");
+  return resolveCompanyProfile(raw);
+}

package/bin/lib/core/sync-engine.js

@@ -5,14 +5,16 @@ import {
   readdirSync,
   renameSync,
   readFileSync,
+  realpathSync,
   writeFileSync,
   rmSync,
 } from "node:fs";
 import { execSync } from "node:child_process";
-import { join, relative, basename } from "node:path";
+import { join, relative, basename, dirname, sep } from "node:path";
 import { getFrameworkRoot } from "../utils/paths.js";
 import { getIDEFolder } from "../config/ide-config.js";
 import { extractFrontmatterBlock } from "../utils/frontmatter.js";
+import { readCompanyProfile } from "./company-profile.js";
 import {
   SYNC_DIRS,
   SYNC_ROOT_FILES,
@@ -94,6 +96,9 @@ export function syncAssets(targetDir, ide, opts = {}) {
     }
   }
 
+  // RuleResolver (#199): rules/ e rules-on-demand/ do overlay do perfil ativo por cima das do core.
+  applyRuleOverlay(ideDir, result, { dryRun: opts.dryRun });
+
   // Copy root files to IDE folder
   for (const file of SYNC_ROOT_FILES) {
     const src = join(frameworkRoot, file);
@@ -198,6 +203,164 @@ export function syncAssets(targetDir, ide, opts = {}) {
   return result;
 }
 
+/** Pastas do overlay que a IDE carrega sozinha e por isso são resolvidas aqui, na instalação. */
+const OVERLAY_RULE_DIRS = Object.freeze(["rules", "rules-on-demand"]);
+
+/**
+ * Como `collectMdFiles`, mas inclui links simbólicos para arquivo (o `Dirent` de um link não é
+ * `isFile()`), para o `realpath` decidir se o alvo está dentro do overlay. Link para pasta não é seguido.
+ */
+function collectOverlayFiles(dir, acc) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) collectOverlayFiles(full, acc);
+    else if ((entry.isFile() || entry.isSymbolicLink()) && entry.name.endsWith(".md"))
+      acc.push(full);
+  }
+}
+
+/**
+ * Linha `> Overlay: {perfil} (forked_from …)` logo depois do frontmatter (ou na primeira linha,
+ * sem frontmatter): quem abre `.{ide}/rules/` vê que a cópia veio do overlay e onde editar.
+ * @param {string} content - Conteúdo do arquivo do overlay (não é alterado lá)
+ * @param {string} profile
+ * @returns {string}
+ */
+export function withOverlayMarker(rawContent, profile) {
+  // CRLF (fork editado no Windows) vira LF: a IDE lê igual e o frontmatter é reconhecido.
+  const content = rawContent.replace(/\r\n?/g, "\n");
+  const block = extractFrontmatterBlock(content);
+  const forked = block === null ? null : /^forked_from:\s*(.+)$/m.exec(block);
+  const marker = `> Overlay: ${profile} (forked_from ${forked ? forked[1].trim() : "sem carimbo"})`;
+  if (block === null) return `${marker}\n\n${content}`;
+  const fenceEnd = content.indexOf("\n---", 3);
+  const lineEnd = content.indexOf("\n", fenceEnd + 1);
+  if (lineEnd === -1) return `${content}\n\n${marker}\n`;
+  const head = content.slice(0, lineEnd + 1);
+  const tail = content.slice(lineEnd + 1).replace(/^\n+/, "");
+  return `${head}\n${marker}\n\n${tail}`;
+}
+
+/** A marcação exatamente como `withOverlayMarker` a escreve; captura o perfil. */
+const OVERLAY_MARKER = /^> Overlay: ([a-z0-9][a-z0-9-]*) \(forked_from .*\)$/;
+
+/**
+ * Lê a marcação de overlay de uma cópia na IDE: só vale na posição em que `withOverlayMarker` a
+ * grava (primeira linha útil depois do frontmatter, ou a primeira linha do arquivo) e no formato
+ * exato. Uma rule própria que cite a marcação no corpo não é confundida com uma cópia do overlay.
+ * @param {string} rawContent
+ * @returns {string | null} o perfil da marcação, ou `null`
+ */
+export function readOverlayMarker(rawContent) {
+  const content = rawContent.replace(/\r\n?/g, "\n");
+  let rest = content;
+  if (extractFrontmatterBlock(content) !== null) {
+    const fenceEnd = content.indexOf("\n---", 3);
+    const lineEnd = content.indexOf("\n", fenceEnd + 1);
+    rest = lineEnd === -1 ? "" : content.slice(lineEnd + 1);
+  }
+  const first = rest.split("\n").find((line) => line.trim() !== "");
+  const match = first ? OVERLAY_MARKER.exec(first) : null;
+  return match ? match[1] : null;
+}
+
+/**
+ * Cópia na IDE marcada `> Overlay: …` que o overlay **ativo** não tem é de outro perfil (ou saiu do
+ * overlay à mão). Sem isto, a IDE continuaria carregando a regra de uma empresa inativa, inclusive
+ * quando só este passo roda (`jarvis fork`, reaplicação do upgrade), sem o `cpSync` do core antes.
+ * Se o core tem o arquivo, a cópia volta a ser a do core; senão, é removida. Só a IDE é tocada.
+ */
+function removeOrphanOverlayRules(ideDir, overlayDir, result, { dryRun, frameworkRoot }) {
+  for (const dir of OVERLAY_RULE_DIRS) {
+    const ideRules = join(ideDir, dir);
+    if (!existsSync(ideRules)) continue;
+    const files = [];
+    collectMdFiles(ideRules, files);
+    for (const file of files) {
+      const marker = readOverlayMarker(readFileSync(file, "utf-8"));
+      if (marker === null) continue;
+      const rel = relative(ideRules, file);
+      if (existsSync(join(overlayDir, dir, rel))) continue; // o overlay ativo a recopia em seguida
+      const shown = `${dir}/${rel.split(sep).join("/")}`;
+      const core = join(frameworkRoot, dir, rel);
+      if (existsSync(core)) {
+        if (!dryRun) cpSync(core, file);
+        result.copied.push(`(overlay) ${shown}: voltou ao core (era do perfil ${marker})`);
+      } else {
+        if (!dryRun) rmSync(file, { force: true });
+        result.copied.push(`(overlay) ${shown}: órfã removida da IDE (era do perfil ${marker})`);
+      }
+    }
+  }
+}
+
+/**
+ * RuleResolver (#199). Lê `COMPANY_PROFILE` do `.{ide}/ENV.md` (vazio, inválido ou sem ENV.md →
+ * `stark-industries`), garante a pasta `overlays/{perfil}/` e copia por cima de `.{ide}/rules/` e
+ * `.{ide}/rules-on-demand/` cada `.md` do overlay com o mesmo caminho relativo, marcado.
+ * Workflows, skills, agentes e templates não passam por aqui: a rule de precedência os resolve na chamada.
+ *
+ * Única escrita em `overlays/`: criar a pasta vazia do perfil. Nenhum arquivo é gravado, alterado
+ * ou apagado dentro dela. Caminho que resolve (realpath) para fora do overlay é ignorado com aviso.
+ * @param {string} ideDir - Pasta da IDE (ex.: `{workspace}/.claude`)
+ * @param {{ copied: string[], skipped: string[], errors: string[] }} result - Acumulador do sync
+ * @param {{ dryRun?: boolean }} [opts]
+ * @returns {string} O perfil ativo
+ */
+export function applyRuleOverlay(ideDir, result, { dryRun = false, frameworkRoot } = {}) {
+  const envPath = join(ideDir, "ENV.md");
+  const envText = existsSync(envPath) ? readFileSync(envPath, "utf-8") : undefined;
+  const { profile, warning } = readCompanyProfile(envText);
+  if (warning) result.skipped.push(`(overlay) ${warning}`);
+
+  const overlayDir = join(ideDir, "overlays", profile);
+  removeOrphanOverlayRules(ideDir, overlayDir, result, {
+    dryRun,
+    frameworkRoot: frameworkRoot ?? getFrameworkRoot(),
+  });
+
+  if (!existsSync(overlayDir)) {
+    if (!dryRun) mkdirSync(overlayDir, { recursive: true });
+    result.copied.push(`Overlay ${profile}: pasta ${dryRun ? "seria criada" : "criada"}`);
+    return profile;
+  }
+
+  const overlayRoot = realpathSync(overlayDir);
+  for (const dir of OVERLAY_RULE_DIRS) {
+    const srcDir = join(overlayDir, dir);
+    if (!existsSync(srcDir)) continue;
+    const files = [];
+    collectOverlayFiles(srcDir, files);
+    for (const file of files) {
+      const rel = relative(srcDir, file);
+      const shown = `${dir}/${rel.split(sep).join("/")}`;
+      let real;
+      try {
+        real = realpathSync(file);
+      } catch {
+        result.skipped.push(`(overlay) ${shown}: link quebrado, ignorado`);
+        continue;
+      }
+      if (!real.startsWith(overlayRoot + sep)) {
+        result.skipped.push(`(overlay) ${shown}: aponta para fora do overlay, ignorado`);
+        continue;
+      }
+      try {
+        const content = readFileSync(file, "utf-8");
+        const dest = join(ideDir, dir, rel);
+        if (!dryRun) {
+          mkdirSync(dirname(dest), { recursive: true });
+          writeFileSync(dest, withOverlayMarker(content, profile), "utf-8");
+        }
+        result.copied.push(`(overlay) ${shown}`);
+      } catch (err) {
+        result.errors.push(`(overlay) ${shown}: ${err.message}`);
+      }
+    }
+  }
+  return profile;
+}
+
 /**
  * Detecta RTK no PATH e reconcilia RTK_ENABLED no ENV.md + rtk-rules.md na IDE.
  * - RTK encontrado → RTK_ENABLED=true no ENV.md, mantém rule

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jarvis-ai-framework",
-  "version": "8.2.0",
+  "version": "8.3.0",
   "description": "Jarvis framework",
   "type": "module",
   "bin": {
@@ -11,7 +11,7 @@
     "prepublishOnly": "echo 'Publishing jarvis-framework...'",
     "publish:gitlab": "npm publish",
     "test:comandos": "node test/comandos-docs.test.js",
-    "test:filtro": "node --test test/profile-filter.test.js test/token-report.test.js test/flow-map.test.js test/env-loader.test.js test/sync-engine.test.js test/vcs-api.test.js test/fetch-file.test.js test/publish-file.test.js test/docs-storage.test.js test/env-upgrade.test.js test/docs-migrate.test.js test/init-upgrade.test.js test/workspace-mode.test.js test/stale-skills.test.js test/session-scan.test.js test/framework-refs.test.js test/validate-frontmatter.test.js test/mcp-config.test.js test/integrations-catalog.test.js test/cli-runner.test.js test/tasks-comment.test.js test/version.test.js test/gate-checklist-rodadas.test.js test/publish-comments-rules.test.js test/pre-pr-criterio.test.js test/nomes-soltos.test.js",
+    "test:filtro": "node --test test/profile-filter.test.js test/token-report.test.js test/flow-map.test.js test/env-loader.test.js test/sync-engine.test.js test/vcs-api.test.js test/fetch-file.test.js test/publish-file.test.js test/docs-storage.test.js test/env-upgrade.test.js test/docs-migrate.test.js test/init-upgrade.test.js test/workspace-mode.test.js test/stale-skills.test.js test/session-scan.test.js test/framework-refs.test.js test/validate-frontmatter.test.js test/mcp-config.test.js test/integrations-catalog.test.js test/cli-runner.test.js test/tasks-comment.test.js test/version.test.js test/gate-checklist-rodadas.test.js test/publish-comments-rules.test.js test/pre-pr-criterio.test.js test/nomes-soltos.test.js test/company-profile.test.js test/company-overlay-rules.test.js test/fork.test.js",
     "lint": "eslint bin/ test/",
     "lint:fix": "eslint bin/ test/ --fix",
     "format": "prettier --write bin/ test/",

package/rules/AGENTS.md

@@ -14,6 +14,7 @@ A pasta `rules/` contem **regras e diretrizes** que governam o comportamento do
 
 ```
 rules/                        # Sempre carregadas no início da sessão
+├── company-overlay-rules.md  # Overlay de empresa (COMPANY_PROFILE): overlay > especialização > core, conferido na chamada
 ├── engineering/              # Regras de engenharia
 │   ├── eng-rules.md          # Regras gerais de engenharia
 │   ├── eng.bump-rules.md     # Regras para versionamento

package/rules/company-overlay-rules.md

@@ -0,0 +1,15 @@
+---
+env_file: "@/ENV.md"
+---
+
+> **Applies to:** HUB: all | POSITION: all | AREA: all | SQUAD: all
+
+# Overlay de empresa — precedência na chamada
+
+Perfil ativo: `COMPANY_PROFILE` do `ENV.md` (vazio = `stark-industries`, o overlay padrão). O overlay fica em `$IDE/overlays/{COMPANY_PROFILE}/` e espelha o core: `workflows/`, `skills/`, `agents/`, `rules/`, `rules-on-demand/`, `templates/`.
+
+**Antes de seguir um workflow, skill ou agente, ou de ler um template ou uma rule-on-demand por caminho**, confira `$IDE/overlays/{COMPANY_PROFILE}/{tipo}/{mesmo caminho}`. Existe → leia-o e siga-o **em vez** do do core. Não existe → siga o core, sem aviso.
+
+Precedência: **overlay > especialização de stack > core.**
+
+Não escreva no overlay: só o `/jarvis-fork` (CLI `jarvis fork`) grava lá, com confirmação. `rules/` não passa por aqui: a cópia em `$IDE/rules/` já vem resolvida na instalação (sync e Passo 8 do `/jarvis-init`), marcada com `> Overlay: …` quando é da empresa.

package/skills/AGENTS.md

@@ -78,6 +78,8 @@ skills/
 │   └── assets/
 ├── jarvis-report-issue/         # Reportar bug no próprio Jarvis (JARVIS_PROJECT)
 │   └── SKILL.md
+├── jarvis-fork/                 # Fork guiado de um artefato do core para o overlay da empresa (COMPANY_PROFILE; CLI jarvis fork)
+│   └── SKILL.md
 ├── jarvis-context-detect/       # Detecta contexto do projeto/tarefa
 │   └── SKILL.md
 └── jarvis-docs-central/         # Sync/publish docs no central-docs (GitHub/GitLab)
@@ -241,6 +243,7 @@ Skills são invocados de formas diferentes dependendo da IDE:
 | Arquitetura C4 | `eng-backend-arch-c4` |
 | 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` |
+| Ajustar um comando do core a uma empresa sem editar o core (fork para `$IDE/overlays/{COMPANY_PROFILE}/`), listar, atualizar ou remover forks | `jarvis-fork` |
 | Decisão de arquitetura do Jarvis (agent, skill, workflow ou rule?), simplificação, tendências | `jarvis-evolution-architect` |
 | 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` |

package/skills/SKILLS-ROADMAP.md

@@ -141,6 +141,11 @@ Removidas: `checkin`, `checkout`, `daily`, `task-log`, `send-priority`, `sent-pr
 - **Trigger**: auto-report de bugs no framework Jarvis pela CLI do host (`gh`), depois da pergunta
 - **Status**: `criado`
 
+### `jarvis-fork` ✅
+- **Trigger**: um comando do core não serve a esta empresa; "customizar o Jarvis para este cliente"
+- **Escopo**: conversa até achar a seção que incomoda, menor ajuste, simulação e fork no overlay (`$IDE/overlays/{COMPANY_PROFILE}/`) só com o Sim, pelo CLI `jarvis fork`; `--list`, `--update`, `--delete`; pergunta de alcance (só da empresa ou melhoria para o core via `jarvis-report-issue`)
+- **Status**: `criado` (#199)
+
 ### `jarvis-docs-index` / `jarvis-docs-central` / `jarvis-context-detect` ✅
 - **Trigger**: indexação de docs, sync com repo central, detecção de contexto
 - **Status**: `criado`