@fontdata/ai-harness 2.0.0 → 2.2.0

package/src/init.js

@@ -1,317 +0,0 @@
-import { existsSync, readdirSync, statSync } from 'node:fs';
-import { resolve } from 'node:path';
-import * as p from '@clack/prompts';
-import { loadCatalog, allCommands, recommendedCommands } from './catalog.js';
-import { installCommand, installClaudeMd, installMaster, installSkill } from './installer.js';
-
-/** Encerra o fluxo com mensagem amigável quando o usuário cancela (Ctrl+C). */
-function bail(value) {
-  if (p.isCancel(value)) {
-    p.cancel('Operação cancelada.');
-    process.exit(0);
-  }
-  return value;
-}
-
-/**
- * Quantos itens a lista pode mostrar de uma vez sem estourar a altura do terminal.
- * Calcula a partir das linhas reais do terminal (process.stdout.rows), deixando
- * margem para a mensagem e os indicadores de rolagem do clack. Sem isso, em um
- * terminal baixo a lista sobrepõe as renderizações ("itens duplicados").
- */
-function viewportItems(min = 3, reserve = 6) {
-  const rows = process.stdout.rows || 20;
-  return Math.max(min, rows - reserve);
-}
-
-/**
- * Manifestos de stack: se algum existir na raiz, é um projeto já existente.
- */
-const PROJECT_MANIFESTS = [
-  'package.json', 'pyproject.toml', 'requirements.txt', 'go.mod',
-  'Cargo.toml', 'pom.xml', 'build.gradle', 'build.gradle.kts',
-  'composer.json', 'Gemfile', 'Makefile', 'CMakeLists.txt',
-  'tsconfig.json', 'pubspec.yaml', 'mix.exs',
-];
-
-/** Pastas de código-fonte que, se tiverem conteúdo, indicam projeto existente. */
-const SOURCE_DIRS = ['src', 'app', 'lib', 'source'];
-
-/**
- * Detecta se a pasta alvo já é um projeto com código ('existing') ou está
- * essencialmente vazia/recém-criada ('new'). Ignora .git e .claude — a presença
- * deles sozinha não caracteriza um projeto existente.
- */
-function detectProjectKind(repoPath) {
-  // 1. Manifesto de stack na raiz.
-  if (PROJECT_MANIFESTS.some((f) => existsSync(resolve(repoPath, f)))) return 'existing';
-
-  // 2. Arquivo de solução/projeto .NET na raiz.
-  let rootEntries = [];
-  try {
-    rootEntries = readdirSync(repoPath);
-  } catch {
-    return 'new';
-  }
-  if (rootEntries.some((f) => /\.(sln|csproj|fsproj|vbproj)$/i.test(f))) return 'existing';
-
-  // 3. Pasta de código-fonte com algum conteúdo.
-  for (const dir of SOURCE_DIRS) {
-    const dirPath = resolve(repoPath, dir);
-    try {
-      if (statSync(dirPath).isDirectory() && readdirSync(dirPath).length) return 'existing';
-    } catch {
-      // pasta não existe — segue.
-    }
-  }
-
-  return 'new';
-}
-
-/**
- * Seleção interativa em dois níveis: menu de grupos → submenu de itens do grupo
- * → volta ao menu de grupos. Mantém cada lista pequena (cabe em terminais baixos)
- * e mostra o quanto já foi marcado em cada grupo. Retorna os comandos escolhidos.
- *
- * `initialIds` define os comandos já marcados ao abrir (ex.: recomendados em
- * projeto novo). Em projeto existente vem vazio — o usuário marca só os avulsos.
- */
-async function selectByGroups(catalog, initialIds = new Set()) {
-  const selectedIds = new Set(initialIds);
-  const DONE = '__done__';
-
-  for (;;) {
-    const groupOptions = catalog.groups.map((g) => {
-      const chosen = g.commands.filter((c) => selectedIds.has(c.id)).length;
-      return {
-        value: g.id,
-        label: `${g.title}  (${chosen}/${g.commands.length})`,
-        hint: chosen ? `${chosen} marcado(s)` : undefined,
-      };
-    });
-    groupOptions.push({
-      value: DONE,
-      label: `✓ Concluir e instalar  (${selectedIds.size} comando(s) marcado(s))`,
-    });
-
-    const groupChoice = bail(
-      await p.select({
-        message: 'Escolha um grupo para marcar comandos — ou Concluir:',
-        options: groupOptions,
-        maxItems: viewportItems(),
-      })
-    );
-
-    if (groupChoice === DONE) break;
-
-    const group = catalog.groups.find((g) => g.id === groupChoice);
-    const picked = bail(
-      await p.multiselect({
-        message: `${group.title} — espaço marca, enter volta ao menu de grupos:`,
-        options: group.commands.map((c) => ({ value: c.id, label: c.title, hint: c.description })),
-        initialValues: group.commands.filter((c) => selectedIds.has(c.id)).map((c) => c.id),
-        required: false,
-        maxItems: viewportItems(),
-      })
-    );
-
-    // Reconcilia só este grupo: limpa os ids dele e re-adiciona os que ficaram marcados.
-    for (const c of group.commands) selectedIds.delete(c.id);
-    for (const id of picked) selectedIds.add(id);
-  }
-
-  return allCommands(catalog).filter((c) => selectedIds.has(c.id));
-}
-
-export async function runInit(initialPath) {
-  const catalog = loadCatalog();
-
-  p.intro('Fontdata · ai-harness — instalador do harness para Claude Code');
-
-  // 1. Diretório alvo
-  const repoInput = bail(
-    await p.text({
-      message: 'Em qual pasta do projeto deseja instalar?',
-      placeholder: '. (pasta atual)',
-      initialValue: initialPath || '.',
-    })
-  );
-  const repoPath = resolve(process.cwd(), repoInput.trim() || '.');
-
-  if (!existsSync(repoPath)) {
-    p.cancel(`Pasta não encontrada: ${repoPath}`);
-    process.exit(1);
-  }
-
-  // Detecta o tipo de projeto: muda como a seleção "Manual" começa.
-  const projectKind = detectProjectKind(repoPath);
-  p.note(
-    projectKind === 'existing'
-      ? 'Projeto existente detectado. Na opção "Escolher manualmente" nada vem marcado — ideal para cadastrar comandos avulsos.'
-      : 'Projeto novo detectado. Na opção "Escolher manualmente" os comandos recomendados já vêm marcados.',
-    projectKind === 'existing' ? 'Projeto existente' : 'Projeto novo'
-  );
-
-  // 2. O que instalar
-  const scope = bail(
-    await p.select({
-      message: 'O que deseja instalar?',
-      options: [
-        { value: 'recommended', label: 'Conjunto recomendado', hint: 'núcleo de setup + dia a dia' },
-        { value: 'all', label: 'Tudo', hint: `${allCommands(catalog).length} comandos` },
-        {
-          value: 'manual',
-          label: 'Escolher manualmente',
-          hint: projectKind === 'existing' ? 'seleção por categoria (nada marcado)' : 'seleção por categoria (recomendados marcados)',
-        },
-      ],
-    })
-  );
-
-  let selected;
-  if (scope === 'all') {
-    selected = allCommands(catalog);
-  } else if (scope === 'recommended') {
-    selected = recommendedCommands(catalog);
-  } else {
-    // Projeto novo começa com os recomendados marcados; existente começa vazio.
-    const initialIds =
-      projectKind === 'new'
-        ? new Set(recommendedCommands(catalog).map((c) => c.id))
-        : new Set();
-    selected = await selectByGroups(catalog, initialIds);
-  }
-
-  // 3. Comando-mestre /harness
-  const wantMaster = bail(
-    await p.confirm({
-      message: 'Incluir também o comando-mestre /harness (conduz a sequência de setup em ordem)?',
-      initialValue: true,
-    })
-  );
-
-  // Se o /harness foi escolhido, garante que os comandos que ele invoca também sejam instalados.
-  let autoAdded = [];
-  if (wantMaster) {
-    const required = catalog.master.requires || [];
-    const selectedIds = new Set(selected.map((c) => c.id));
-    const missing = allCommands(catalog).filter(
-      (c) => required.includes(c.id) && !selectedIds.has(c.id)
-    );
-    if (missing.length) {
-      selected = [...selected, ...missing];
-      autoAdded = missing.map((c) => c.title);
-    }
-  }
-
-  // Resolve dependências por comando (campo `requires`): se um comando selecionado
-  // depende de outro, o dependente entra junto, mesmo que não tenha sido marcado —
-  // como acontece com o /harness.
-  {
-    const selectedIds = new Set(selected.map((c) => c.id));
-    const deps = allCommands(catalog).filter(
-      (c) =>
-        !selectedIds.has(c.id) &&
-        selected.some((sel) => (sel.requires || []).includes(c.id))
-    );
-    if (deps.length) {
-      selected = [...selected, ...deps];
-      autoAdded = [...autoAdded, ...deps.map((c) => c.title)];
-    }
-  }
-
-  // 4. CLAUDE.md base
-  const claudeExists = existsSync(resolve(repoPath, catalog.claudeMd.target));
-  let claudeMode = 'create';
-  const wantClaude = bail(
-    await p.confirm({
-      message: claudeExists
-        ? 'Já existe um CLAUDE.md na raiz. Deseja tratá-lo?'
-        : 'Criar o CLAUDE.md base na raiz (filosofia de orquestração/TDD)?',
-      initialValue: !claudeExists,
-    })
-  );
-  if (wantClaude && claudeExists) {
-    claudeMode = bail(
-      await p.select({
-        message: 'O que fazer com o CLAUDE.md existente?',
-        options: [
-          { value: 'backup', label: 'Sobrescrever criando .bak', hint: 'recomendado' },
-          { value: 'overwrite', label: 'Sobrescrever sem backup' },
-          { value: 'skip', label: 'Manter o existente' },
-        ],
-      })
-    );
-  }
-
-  // 5. Confirmação final
-  if (selected.length === 0 && !wantMaster && !wantClaude) {
-    p.outro('Nada selecionado. Nenhuma alteração feita.');
-    return;
-  }
-
-  // Skills exigidas pelos comandos selecionados (campo `requiresSkills`).
-  const skillCatalog = catalog.skills || [];
-  const neededSkillIds = new Set(selected.flatMap((c) => c.requiresSkills || []));
-  const neededSkills = skillCatalog.filter((sk) => neededSkillIds.has(sk.id));
-
-  // Política global de conflito: perguntamos UMA vez se houver risco de sobrescrever.
-  const anyConflict =
-    selected.some((c) => existsSync(resolve(repoPath, '.claude', 'commands', `${c.id}.md`))) ||
-    (wantMaster && existsSync(resolve(repoPath, '.claude', 'commands', `${catalog.master.id}.md`))) ||
-    neededSkills.some((sk) => existsSync(resolve(repoPath, '.claude', 'skills', sk.id)));
-
-  let conflictPolicy = 'overwrite';
-  if (anyConflict) {
-    conflictPolicy = bail(
-      await p.select({
-        message: 'Alguns itens já existem no destino. O que fazer com os conflitos?',
-        options: [
-          { value: 'overwrite', label: 'Sobrescrever os existentes' },
-          { value: 'skip', label: 'Pular os que já existem' },
-        ],
-      })
-    );
-  }
-
-  // Execução
-  const s = p.spinner();
-  s.start('Instalando...');
-
-  const results = { created: [], overwritten: [], skipped: [] };
-  for (const cmd of selected) {
-    const status = installCommand(cmd, repoPath, () => conflictPolicy);
-    results[status].push(cmd.title);
-  }
-  if (wantMaster) {
-    const status = installMaster(catalog, repoPath, () => conflictPolicy);
-    results[status].push(catalog.master.title);
-  }
-
-  const skillResults = { created: [], overwritten: [], skipped: [] };
-  for (const skill of neededSkills) {
-    const status = installSkill(skill, repoPath, () => conflictPolicy);
-    skillResults[status].push(skill.title);
-  }
-
-  let claudeResult = null;
-  if (wantClaude) {
-    claudeResult = installClaudeMd(catalog, repoPath, claudeExists ? claudeMode : 'create');
-  }
-
-  s.stop('Instalação concluída.');
-
-  // Resumo
-  const lines = [];
-  if (results.created.length) lines.push(`Criados (${results.created.length}): ${results.created.join(', ')}`);
-  if (results.overwritten.length) lines.push(`Sobrescritos (${results.overwritten.length}): ${results.overwritten.join(', ')}`);
-  if (results.skipped.length) lines.push(`Pulados (${results.skipped.length}): ${results.skipped.join(', ')}`);
-  const skillsInstalled = [...skillResults.created, ...skillResults.overwritten];
-  if (skillsInstalled.length) lines.push(`Skills (${skillsInstalled.length}): ${skillsInstalled.join(', ')}`);
-  if (skillResults.skipped.length) lines.push(`Skills puladas (${skillResults.skipped.length}): ${skillResults.skipped.join(', ')}`);
-  if (autoAdded.length) lines.push(`Adicionados como dependência (${autoAdded.length}): ${autoAdded.join(', ')}`);
-  if (claudeResult) lines.push(`CLAUDE.md: ${claudeResult}`);
-  p.note(lines.join('\n') || 'Nada a instalar.', `Resumo · ${repoPath}`);
-
-  p.outro('Abra o projeto no Claude Code e digite "/" para ver os comandos instalados.');
-}

package/src/installer.js

@@ -1,92 +0,0 @@
-import { cpSync, copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { templatesDir } from './catalog.js';
-
-/** Garante que o diretório de um arquivo exista. */
-function ensureDir(filePath) {
-  mkdirSync(dirname(filePath), { recursive: true });
-}
-
-/**
- * Copia um comando (template) para <repo>/.claude/commands/<id>.md.
- * Retorna o status da operação: 'created' | 'overwritten' | 'skipped'.
- *
- * @param {object} cmd           Item do catálogo (precisa de id e file).
- * @param {string} repoPath      Raiz do repositório alvo.
- * @param {function} resolveConflict  (destPath) => 'overwrite' | 'skip'. Chamado só se o destino existir.
- */
-export function installCommand(cmd, repoPath, resolveConflict) {
-  const source = join(templatesDir, cmd.file);
-  const dest = join(repoPath, '.claude', 'commands', `${cmd.id}.md`);
-
-  if (existsSync(dest)) {
-    const decision = resolveConflict ? resolveConflict(dest) : 'overwrite';
-    if (decision === 'skip') return 'skipped';
-    ensureDir(dest);
-    copyFileSync(source, dest);
-    return 'overwritten';
-  }
-
-  ensureDir(dest);
-  copyFileSync(source, dest);
-  return 'created';
-}
-
-/**
- * Instala/atualiza o CLAUDE.md base na raiz do repositório.
- * mode: 'overwrite' | 'skip' | 'backup' (cria CLAUDE.md.bak antes de sobrescrever).
- * Retorna 'created' | 'overwritten' | 'skipped' | 'backed-up'.
- */
-export function installClaudeMd(catalog, repoPath, mode = 'overwrite') {
-  const source = join(templatesDir, catalog.claudeMd.file);
-  const dest = join(repoPath, catalog.claudeMd.target);
-
-  if (!existsSync(dest)) {
-    writeFileSync(dest, readFileSync(source, 'utf8'));
-    return 'created';
-  }
-
-  if (mode === 'skip') return 'skipped';
-
-  if (mode === 'backup') {
-    copyFileSync(dest, `${dest}.bak`);
-    writeFileSync(dest, readFileSync(source, 'utf8'));
-    return 'backed-up';
-  }
-
-  writeFileSync(dest, readFileSync(source, 'utf8'));
-  return 'overwritten';
-}
-
-/**
- * Copia uma skill (pasta com SKILL.md e references/) para
- * <repo>/.claude/skills/<id>/. Retorna 'created' | 'overwritten' | 'skipped'.
- *
- * @param {object} skill         Item do catálogo (precisa de id e dir).
- * @param {string} repoPath      Raiz do repositório alvo.
- * @param {function} resolveConflict  (destPath) => 'overwrite' | 'skip'. Chamado só se o destino existir.
- */
-export function installSkill(skill, repoPath, resolveConflict) {
-  const source = join(templatesDir, skill.dir);
-  const dest = join(repoPath, '.claude', 'skills', skill.id);
-
-  if (existsSync(dest)) {
-    const decision = resolveConflict ? resolveConflict(dest) : 'overwrite';
-    if (decision === 'skip') return 'skipped';
-    cpSync(source, dest, { recursive: true });
-    return 'overwritten';
-  }
-
-  mkdirSync(dirname(dest), { recursive: true });
-  cpSync(source, dest, { recursive: true });
-  return 'created';
-}
-
-/** Instala o comando-mestre /harness (mesmo mecanismo de installCommand). */
-export function installMaster(catalog, repoPath, resolveConflict) {
-  return installCommand(
-    { id: catalog.master.id, file: catalog.master.file },
-    repoPath,
-    resolveConflict
-  );
-}

package/src/run.js

@@ -1,99 +0,0 @@
-import { spawnSync } from 'node:child_process';
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-import { loadCatalog, allCommands } from './catalog.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-/** Raiz do pacote — é ela que vira o plugin carregado via `claude --plugin-dir`. */
-export const pluginRoot = join(__dirname, '..');
-
-/** Nome do plugin, lido do manifesto para não duplicar a string. */
-export function pluginName() {
-  const manifest = JSON.parse(
-    readFileSync(join(pluginRoot, '.claude-plugin', 'plugin.json'), 'utf8')
-  );
-  return manifest.name;
-}
-
-/**
- * Ids executáveis: os comandos dos grupos mais o comando-mestre, que fica fora
- * de `groups` no catálogo.
- */
-export function runnableIds(catalog = loadCatalog()) {
-  const ids = allCommands(catalog).map((cmd) => cmd.id);
-  if (catalog.master?.id) ids.unshift(catalog.master.id);
-  return [...new Set(ids)];
-}
-
-/** Ids mais parecidos com o que foi digitado, para sugerir em caso de erro. */
-export function suggestIds(input, ids) {
-  const needle = input.toLowerCase();
-  return ids
-    .filter((id) => id.includes(needle) || needle.includes(id) || id.startsWith(needle.slice(0, 4)))
-    .slice(0, 5);
-}
-
-const SYSTEM_NOTE =
-  'Os slash commands do harness Fontdata estão disponíveis nesta sessão com o prefixo ' +
-  '`/PLUGIN:` (ex.: `/PLUGIN:gerar-spec`). Quando uma instrução referenciar um comando ' +
-  'como `/nome`, entenda que se trata de `/PLUGIN:nome`.';
-
-/**
- * Executa um comando do catálogo abrindo o Claude Code na pasta atual, com o
- * pacote carregado como plugin da sessão — sem instalar nada no projeto.
- */
-export function runCommand(id, args = [], claudeFlags = []) {
-  const catalog = loadCatalog();
-  const ids = runnableIds(catalog);
-  const wanted = id.replace(/^\//, '');
-
-  if (!ids.includes(wanted)) {
-    const near = suggestIds(wanted, ids);
-    console.error(`Comando desconhecido: ${wanted}`);
-    if (near.length) console.error(`\nVocê quis dizer: ${near.join(', ')}`);
-    console.error('\nRode `npx @fontdata/ai-harness list` para ver o catálogo completo.');
-    return 1;
-  }
-
-  const name = pluginName();
-  const prompt = [`/${name}:${wanted}`, ...args].join(' ').trim();
-  const argv = [
-    '--plugin-dir',
-    pluginRoot,
-    '--append-system-prompt',
-    SYSTEM_NOTE.replaceAll('PLUGIN', name),
-    ...claudeFlags,
-    '--',
-    prompt,
-  ];
-
-  const result = spawn(argv);
-
-  if (result.error?.code === 'ENOENT') {
-    console.error(
-      'Claude Code não encontrado no PATH.\n' +
-        'Instale com: npm install -g @anthropic-ai/claude-code'
-    );
-    return 127;
-  }
-  if (result.error) {
-    console.error('Erro ao executar o Claude Code:', result.error.message);
-    return 1;
-  }
-  return result.status ?? 0;
-}
-
-/**
- * No Windows o `claude` costuma ser um `.cmd`, que o spawn sem shell não
- * resolve; nesse caso repetimos a chamada pelo shell, com os argumentos citados.
- */
-function spawn(argv) {
-  const direct = spawnSync('claude', argv, { stdio: 'inherit', cwd: process.cwd() });
-  if (direct.error?.code === 'ENOENT' && process.platform === 'win32') {
-    const quoted = argv.map((arg) => `"${String(arg).replaceAll('"', '\\"')}"`).join(' ');
-    return spawnSync(`claude ${quoted}`, { stdio: 'inherit', cwd: process.cwd(), shell: true });
-  }
-  return direct;
-}

package/templates/commands/auditar-performance.md

@@ -1,27 +0,0 @@
----
-description: Audita o projeto em busca de gargalos de performance (queries, bundle, renders, algoritmos).
----
-
-# Auditoria de performance
-
-Foco (opcional — ex.: "backend", "frontend", "tela X", "endpoint Y"): $ARGUMENTS
-
-Se eu não especifiquei, analise o projeto como um todo e priorize os pontos de maior impacto.
-
-Passos:
-
-1. Identifique a stack e analise os pontos quentes mais comuns:
-   - **Banco/dados**: queries N+1, falta de índices, `SELECT *`, paginação ausente, chamadas em loop.
-   - **Backend**: trabalho síncrono bloqueante, ausência de cache, serialização cara, I/O repetido.
-   - **Frontend**: tamanho do bundle, imports pesados, re-renders desnecessários, imagens não otimizadas, ausência de lazy-load.
-   - **Algoritmos**: complexidade desnecessária (O(n²) evitável), estruturas de dados inadequadas.
-2. Para cada achado, estime **impacto** (alto/médio/baixo) e **esforço** de correção, com o trecho de evidência (`arquivo:linha`).
-3. Onde possível, **meça** em vez de adivinhar (profiler, `EXPLAIN`, análise de bundle, logs de tempo). Não instale ferramentas novas sem me perguntar.
-4. Apresente um relatório priorizado por **impacto/esforço** com a correção recomendada de cada item. Não altere código sem minha confirmação.
-
-## Onde gravar o relatório
-
-Grave o relatório em `docs/investigacoes/<yyyy-mm-dd>-<slug>.md` — `<yyyy-mm-dd>` é a data atual e
-`<slug>` resume o tema auditado. **Não** grave em `docs/bugs/`: aquela pasta é só para defeito com
-sintoma reproduzível, causa-raiz e correção. Se a auditoria virar trabalho de correção, o plano
-vai para `docs/plans/`.

package/templates/commands/auditar-seguranca.md

@@ -1,64 +0,0 @@
----
-description: Auditoria de segurança e LGPD — segredos, deps vulneráveis, inputs sem validação, configs inseguras e conformidade com a Lei nº 13.709/2018.
----
-
-# Auditoria de segurança e LGPD
-
-Foco (opcional): $ARGUMENTS
-
-Esta é uma auditoria **defensiva** do próprio projeto, em duas frentes: **segurança técnica** e
-**conformidade com a LGPD**. Se `$ARGUMENTS` restringir o escopo (ex.: `só segurança`, `só lgpd`,
-`autenticação`), respeite-o; sem argumento, rode as duas frentes.
-
-## Parte 1 — Segurança técnica
-
-1. **Segredos**: procure chaves de API, senhas, tokens e credenciais hardcoded no código e no histórico recente. Verifique se `.env` está no `.gitignore`.
-2. **Dependências**: rode o auditor da stack (`npm audit`, `pip-audit`, `osv-scanner`, etc., se disponível) e liste vulnerabilidades conhecidas por severidade.
-3. **Validação de entrada**: identifique inputs sem validação/sanitização — risco de injeção (SQL, comando, XSS), path traversal e desserialização insegura.
-4. **AuthZ/AuthN**: rotas sem proteção, checagem de permissão ausente, segredos de sessão fracos, CORS permissivo demais.
-5. **Configuração**: modo debug em produção, headers de segurança ausentes, TLS, exposição de stack traces.
-6. Classifique cada achado em **CRÍTICO / ALTO / MÉDIO / BAIXO** (estilo CVSS), com evidência (`arquivo:linha`) e correção recomendada. Não exponha valores de segredos reais no relatório — referencie só a localização. Não altere código sem minha confirmação.
-
-## Parte 2 — Conformidade com a LGPD
-
-Use a skill **`lgpd-checker`**, instalada em `.claude/skills/lgpd-checker/`. Leia
-`.claude/skills/lgpd-checker/SKILL.md` e siga as fases dela; consulte
-`references/checklist.md` para a lista completa de verificações e `references/lgpd-artigos.md`
-para citar o artigo correto. Em resumo:
-
-- **Fase 1 — Reconhecimento**: tipo de aplicação, stack e se o sistema trata dados pessoais de
-  pessoa física. Se não tratar, registre isso com justificativa e pule a Parte 2.
-- **Fase 2 — Análise por categoria** (CAT-1 a CAT-11): bases legais e consentimento, minimização,
-  dados sensíveis, segurança técnica, logs e auditoria, direitos dos titulares, retenção e
-  eliminação, privacy by design, transferência internacional, documentação e governança,
-  notificação de incidentes. Faça **busca ativa** no código — não presuma conformidade.
-- **Fase 3 — Severidade e veredito**: classifique cada achado em
-  **CRÍTICO / ALTO / MÉDIO / BAIXO / INFO**, sempre citando o artigo da LGPD e uma recomendação
-  técnica concreta. Conclua o veredito de conformidade: ✅ CONFORME (nenhum CRÍTICO/ALTO),
-  ⚠️ PARCIALMENTE CONFORME (só MÉDIO/BAIXO) ou ❌ NÃO CONFORME (algum CRÍTICO/ALTO).
-
-CAT-4 (segurança técnica) se sobrepõe à Parte 1: **não duplique achados** — registre o achado uma
-vez na Parte 1 e referencie-o na CAT-4 com o artigo da LGPD correspondente.
-
-## Relatório
-
-Entregue um relatório único com:
-
-1. **Sumário executivo** — contagem de achados por severidade em cada frente e o veredito de
-   conformidade LGPD.
-2. **Achados críticos primeiro**, para eu saber o que atacar antes.
-3. **Segurança técnica** — achados da Parte 1 (severidade, `arquivo:linha`, correção).
-4. **Conformidade LGPD** — achados por categoria, no formato de
-   `.claude/skills/lgpd-checker/references/report-template.md`, com artigo citado.
-5. **Pontos positivos** — o que já está correto e conforme.
-6. **Plano de ação** em ordem de prioridade.
-
-Se faltar código para avaliar alguma categoria, diga explicitamente
-("Não foi possível avaliar [CAT-X] — arquivos de [tipo] não encontrados") em vez de presumir.
-
-## Onde gravar o relatório
-
-Grave o relatório em `docs/investigacoes/<yyyy-mm-dd>-<slug>.md` — `<yyyy-mm-dd>` é a data atual e
-`<slug>` resume o tema auditado. **Não** grave em `docs/bugs/`: aquela pasta é só para defeito com
-sintoma reproduzível, causa-raiz e correção. Se a auditoria virar trabalho de correção, o plano
-vai para `docs/plans/`.

package/templates/commands/auditar-ui.md

@@ -1,38 +0,0 @@
----
-description: Navega a aplicação via Playwright MCP e audita UX/UI e/ou acessibilidade (a11y), gerando um relatório por tela e severidade.
----
-
-# Auditoria de interface via navegador
-
-Usando o **MCP do Playwright**, abra o navegador **na minha tela** (para que eu acompanhe a navegação) e audite a aplicação.
-
-## Parâmetros
-
-Podem vir em `$ARGUMENTS`:
-
-$ARGUMENTS
-
-Preciso de quatro coisas. Para o que **não** veio em `$ARGUMENTS`, **pare e me pergunte antes de abrir o navegador**, oferecendo o exemplo como valor padrão que eu posso aceitar ou substituir:
-
-- **Lente da auditoria:** `ux` (UX/UI), `a11y` (acessibilidade) ou `tudo` (as duas) — padrão: `tudo`.
-- **URL** da aplicação (ex.: `http://localhost:3000`)
-- **Usuário** para login (ex.: `admin@admin.com.br`)
-- **Senha** para login (ex.: `admin`)
-
-Só prossiga depois que eu confirmar. Se `$ARGUMENTS` já trouxer os dados, use-os diretamente sem perguntar.
-
-## Passos
-
-1. Faça login e navegue por **todas** as telas, clicando em todos os menus e botões.
-2. Para cada tela, audite conforme a lente escolhida:
-   - **UX/UI** — clareza e consistência visual, hierarquia, feedback das ações, estados de vazio/erro/carregamento, fluxos confusos, responsividade.
-   - **a11y (WCAG AA)** — contraste de cores, uso correto de ARIA e roles, navegação por teclado (tab order, foco visível, atalhos), textos alternativos em imagens, labels em formulários, hierarquia de headings e foco em modais.
-3. Classifique cada achado por severidade — **CRÍTICO** (bloqueia o uso), **SÉRIO**, **MODERADO**, **MENOR** — citando o critério **WCAG** quando for um achado de a11y.
-4. Compile um **relatório único**, agrupado por **tela** e **severidade**, com a correção recomendada de cada item. Não altere código — apenas reporte o que precisa ser criado ou melhorado.
-
-## Onde gravar o relatório
-
-Grave o relatório em `docs/investigacoes/<yyyy-mm-dd>-<slug>.md` — `<yyyy-mm-dd>` é a data atual e
-`<slug>` resume o tema auditado. **Não** grave em `docs/bugs/`: aquela pasta é só para defeito com
-sintoma reproduzível, causa-raiz e correção. Se a auditoria virar trabalho de correção, o plano
-vai para `docs/plans/`.

package/templates/commands/codigo-morto.md

@@ -1,22 +0,0 @@
----
-description: Varre o projeto em busca de código morto (imports, exports, funções e arquivos não usados) e propõe remoção.
----
-
-# Caça ao código morto
-
-Escopo (opcional — pasta ou módulo): $ARGUMENTS
-
-Passos:
-
-1. Varra o projeto procurando: imports não utilizados, exports sem consumidores, funções/variáveis/classes nunca referenciadas, arquivos órfãos e dependências declaradas mas não usadas.
-2. Prefira ferramentas já disponíveis na stack (ex.: linter, `knip`, `ts-prune`, `depcheck`, `vulture`, analisadores nativos). **Não instale nada novo** sem me perguntar.
-3. Para cada achado, classifique a confiança: **ALTA** (claramente morto), **MÉDIA** (pode ser usado via reflexão/dinâmica/rota/teste), **BAIXA** (suspeito). Cuidado com APIs públicas, entrypoints, plugins e código acessado por string.
-4. Apresente a lista agrupada por confiança e **pergunte o que devo remover**. Não apague nada de **MÉDIA/BAIXA** sem confirmação.
-5. Após remover, rode build e testes para garantir que nada quebrou.
-
-## Onde gravar o relatório
-
-Grave o relatório em `docs/investigacoes/<yyyy-mm-dd>-<slug>.md` — `<yyyy-mm-dd>` é a data atual e
-`<slug>` resume o tema auditado. **Não** grave em `docs/bugs/`: aquela pasta é só para defeito com
-sintoma reproduzível, causa-raiz e correção. Se a auditoria virar trabalho de correção, o plano
-vai para `docs/plans/`.