specsfy-aux-stack

어떤 스킬인가요?

Monitorar manifests e arquivos estruturais para criar ou atualizar .specsfy/STACK.md de forma aditiva. Use quando o monitor de contexto apontar stack pendente; quando framework, linguagem, runtime, pacote estrutural, ferramenta de teste ou persistência mudar; quando a documentação técnica estiver incompleta; ou após adicionar Laravel, Next.js, Astro ou dependências relevantes. Preserva conteúdo humano existente.

설치 방법

프로젝트 폴더에서 아래 명령어를 실행하고, 설치할 에이전트를 선택하세요.

설치 명령을 직접 실행해야 적용됩니다. 지원 에이전트와 필요한 권한·라이선스는 제작자의 안내를 확인하세요.

스킬 원문 파일

interface:
  display_name: "Specsfy - Stack Auxiliar"
  short_description: "Monitora e mantém o stack técnico do projeto"
  default_prompt: "Use $specsfy-aux-stack para monitorar o stack e atualizar .specsfy/STACK.md sem perder dados existentes."

#!/usr/bin/env node
/** Atualiza a stack detectada preservando linhas e complementos humanos. */
import { existsSync } from "node:fs";
import { spawnSync } from "node:child_process";
import { readFile, readdir, mkdir, writeFile } from "node:fs/promises";
import { join, relative, resolve } from "node:path";

const START = "<!-- specsfy:stack:start -->"; const END = "<!-- specsfy:stack:end -->";
const project = resolve(process.argv.includes("--project") ? process.argv[process.argv.indexOf("--project") + 1] : process.cwd());
async function json(path) { try { const data = JSON.parse(await readFile(path, "utf8")); return data && typeof data === "object" ? data : {}; } catch { return {}; } }
const rows = [];
const add = (kind, name, source) => { if (!rows.some((row) => row.join("|") === [kind, name, source].join("|"))) rows.push([kind, name, source]); };

/** Busca manifests locais, respeitando exclusões usuais e o .gitignore aplicável. */
async function manifestRoots(directory, found = []) {
  const ignored = new Set([".git", ".agents", ".claude", ".specify", ".venv", "venv", "node_modules", "vendor", "dist", "build", "coverage", "__pycache__"]);
  const entries = await readdir(directory, { withFileTypes: true });
  if (directory === project || entries.some((entry) => entry.isFile() && ["package.json", "composer.json", "pyproject.toml", "requirements.txt", "go.mod", "Cargo.toml", "Gemfile"].includes(entry.name))) found.push(directory);
  for (const entry of entries) {
    if (!entry.isDirectory() || ignored.has(entry.name) || entry.name.startsWith("venv_")) continue;
    const child = join(directory, entry.name);
    if (spawnSync("git", ["check-ignore", "--quiet", "--", child], { cwd: directory }).status === 0) continue;
    await manifestRoots(child, found);
  }
  return found;
}
for (const directory of await manifestRoots(project)) {
  const prefix = relative(project, directory).replaceAll("\\", "/") + (directory === project ? "" : "/");
  const composer = await json(join(directory, "composer.json"));
  const packageJson = await json(join(directory, "package.json"));
const composerPackages = { ...(composer.require ?? {}), ...(composer["require-dev"] ?? {}) };
for (const [dependency, kind, label] of [["laravel/framework", "Framework", "Laravel"], ["php", "Linguagem", "PHP"], ["pestphp/pest", "Testes", "Pest"], ["phpunit/phpunit", "Testes", "PHPUnit"]]) if (dependency in composerPackages) add(kind, label, `\`${prefix}composer.json\` (\`${dependency}\`)`);
if (Object.keys(composer).length && !rows.some((row) => row[1] === "PHP")) add("Linguagem", "PHP", prefix + "composer.json");
const packages = { ...(packageJson.dependencies ?? {}), ...(packageJson.devDependencies ?? {}) };
for (const [dependency, kind, label] of [["next", "Framework", "Next.js"], ["astro", "Framework", "Astro"], ["react", "Biblioteca", "React"], ["typescript", "Linguagem", "TypeScript"], ["vitest", "Testes", "Vitest"], ["prisma", "Persistência", "Prisma"], ["@prisma/client", "Persistência", "Prisma Client"], ["drizzle-orm", "Persistência", "Drizzle ORM"]]) if (dependency in packages) add(kind, label, `\`${prefix}package.json\` (\`${dependency}\`)`);
if (Object.keys(packageJson).length) add("Runtime", "Node.js", prefix + "package.json");
if (existsSync(join(directory, "docker-compose.yml")) || existsSync(join(directory, "compose.yaml"))) add("Infraestrutura", "Containers", "arquivo Compose");

  if (existsSync(join(directory, "pyproject.toml")) || existsSync(join(directory, "requirements.txt"))) add("Linguagem", "Python", prefix + (existsSync(join(directory, "pyproject.toml")) ? "pyproject.toml" : "requirements.txt"));
}
// Registra a declaração; a validade dos padrões pertence ao verify_evidence.
if (existsSync(join(project, ".specsfy", "migrations.json"))) add("Migrations", "Runner próprio declarado", "`.specsfy/migrations.json`");
const target = join(project, ".specsfy", "STACK.md"); let existing = existsSync(target) ? await readFile(target, "utf8") : "";
/** Divide apenas separadores reais; barras escapadas permanecem na célula. */
function tableCells(line) {
  const cells = []; let value = ""; let slashes = 0;
  for (const character of line) {
    if (character === "|" && slashes % 2 === 0) { cells.push(value.trim()); value = ""; }
    else value += character;
    slashes = character === "\\" ? slashes + 1 : 0;
  }
  cells.push(value.trim());
  return cells.slice(1, -1);
}
const old = [], preserved = [];
if (existing.includes(START) && existing.includes(END)) {
  for (const line of existing.split(START)[1].split(END)[0].split(/\r?\n/u)) {
    if (!line.trim()) continue;
    if (!/^\|/.test(line)) { preserved.push(line); continue; }
    const cells = tableCells(line);
    if (cells[0] === "Camada" || cells.every((cell) => /^:?-+:?$/.test(cell))) continue;
    if (cells.length === 3) old.push(cells); else preserved.push(line);
  }
}
for (const row of old) add(...row);
const active = rows.length ? rows : [["Framework", "A confirmar", "Nenhum manifest reconhecido"]];
const block = `${START}\n| Camada | Tecnologia | Evidência |\n| --- | --- | --- |\n${active.map((row) => `| ${row.join(" | ")} |`).join("\n")}\n${preserved.length ? preserved.join("\n") + "\n" : ""}${END}`;
const updated = existing.includes(START) && existing.includes(END) ? `${existing.split(START)[0]}${block}${existing.split(END).slice(1).join(END)}`.trimEnd() + "\n" : `${(existing.trim() || "# Stack do sistema")}\n\n## Inventário detectado\n\n${block}\n`;
if (updated !== existing) { await mkdir(join(project, ".specsfy"), { recursive: true }); await writeFile(target, updated); console.log(target); }

---
name: specsfy-aux-stack
description: Monitorar manifests e arquivos estruturais para criar ou atualizar .specsfy/STACK.md de forma aditiva. Use quando o monitor de contexto apontar stack pendente; quando framework, linguagem, runtime, pacote estrutural, ferramenta de teste ou persistência mudar; quando a documentação técnica estiver incompleta; ou após adicionar Laravel, Next.js, Astro ou dependências relevantes. Preserva conteúdo humano existente.
---

# Manter o stack

## Preparação obrigatória

Antes de executar esta skill, carregue obrigatoriamente `$specsfy-setup` na
raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.
Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma
pendência.

## Modo de interação

Modo de interação: `sem perguntas`.
Não formule perguntas nesta skill. Quando faltar informação confirmada,
sinalize o campo pendente para a etapa conversacional responsável.

1. Ler instruções locais, `PROJECT.md` e o `STACK.md` existente.
2. Executar `node scripts/update_stack.mjs --project <raiz>`.
3. Conferir cada linha contra manifests, lockfiles e configurações presentes.
4. Manter decisões, notas e linhas humanas fora do bloco
   `specsfy:stack`; nunca removê-las.
5. Acrescentar manualmente somente fatos sustentados por uma fonte executável e
   citar essa fonte na coluna `Evidência`.
6. Se a mudança também alterar persistência, carregar
   `$specsfy-aux-database`.
7. Executar `$specsfy-setup` em modo de monitoramento e não devolver o handoff
   enquanto `.specsfy/STACK.md` continuar pendente.

Não copiar árvores inteiras de dependências. Registrar tecnologias estruturais,
suas responsabilidades e evidências úteis para agentes compreenderem o sistema.