How do I install the Specsfy Setup skill?

Run npx skillmds@latest add promovaweb/specsfy-setup-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Specsfy Setup safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Specsfy Setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Specsfy Setup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Specsfy Setup?

promovaweb (@promovaweb) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Specsfy Setup by promovaweb — Agent Skill

Name: Specsfy Setup
Author: promovaweb

Specsfy Setup

Preparar, monitorar ou reconciliar o contexto persistente de um projeto Specsfy. Use ao iniciar o framework, antes e depois de mudanças na aplicação, ao verificar consistência documental, quando PROJECT.md ou os arquivos .specsfy/STACK.md, .specsfy/RULES.md e .specsfy/DATABASE.md estiverem ausentes, ou quando for necessário sugerir modelos coerentes com Laravel, Next.js, Astro ou um stack genérico. Pode ser executada repetidamente e deve preservar todo conteúdo já existente.

promovaweb Updated Sep 22, 2026

File contents

Preparar contexto do projeto

Ler AGENTS.md, CLAUDE.md e instruções locais antes de escrever.
Ler as diretrizes publicáveis quando precisar auditar o bloco reservado em arquivos de agentes.
Executar python3 -B scripts/setup_context.py --project <raiz>. Renderizar PROJECT.md, STACK.md, RULES.md e DATABASE.md a partir de .specsfy/templates/custom/<Nome>.md quando existir ou dos arquivos gerenciados .specsfy/templates/Project.md, Stack.md, Rules.md e Database.md caso contrário; não manter modelos paralelos embutidos no script.
No início e no fim de cada mudança, executar:

python3 -B scripts/monitor_context.py --project <raiz> --check

Inspecionar os quatro arquivos e a evidência de stack usada pelo script.
Nunca substituir um arquivo de contexto existente, mesmo com conteúdo incompleto. Em AGENTS.md e CLAUDE.md, atualizar somente o bloco delimitado do framework e preservar tudo fora dele.
Para completar ou corrigir stack, regras ou dados, anunciar o handoff e carregar respectivamente $specsfy-aux-stack, $specsfy-aux-rules ou $specsfy-aux-database.
Quando aplicação ou persistência mudar, carregar $specsfy-documentator depois das auxiliares e reconstruir docs/ a partir de todo o código.

Não contornar um resultado PENDING. Atualizar o documento indicado e executar o monitor novamente. Para mudança de aplicação sem impacto material na história ou finalidade, registrar essa avaliação na evidência da tarefa e repetir com --acknowledge-project-no-change. Aplicar a mesma disciplina a regras com --acknowledge-rules-no-change; nunca usar o reconhecimento para ocultar uma mudança documental real.

Manter PROJECT.md na raiz. Manter STACK.md, RULES.md e DATABASE.md em .specsfy/. Tratar esses documentos como contexto derivado do projeto, não como spec, gate ou autorização de implementação.

Em projeto com mais de um framework, registrar todas as evidências observadas; não escolher silenciosamente um único stack. Se nenhum framework for identificado, criar o modelo genérico e declarar que a confirmação está pendente.

---name: specsfy-setup-3description: Preparar, monitorar ou reconciliar o contexto persistente de um projeto Specsfy. Use ao iniciar o framework, antes e depois de mudanças na aplicação, ao verificar consistência documental, quando PROJECT.md ou os arquivos .specsfy/STACK.md, .specsfy/RULES.md e .specsfy/DATABASE.md estiverem ausentes, ou quando for necessário sugerir modelos coerentes com Laravel, Next.js, Astro ou um stack genérico. Pode ser executada repetidamente e deve preservar todo conteúdo já existente.---# Preparar contexto do projeto1. Ler `AGENTS.md`, `CLAUDE.md` e instruções locais antes de escrever.2. Ler [as diretrizes publicáveis](references/framework-instructions.md) quando precisar auditar o bloco reservado em arquivos de agentes.3. Executar `python3 -B scripts/setup_context.py --project <raiz>`. Renderizar `PROJECT.md`, `STACK.md`, `RULES.md` e `DATABASE.md` a partir de `.specsfy/templates/custom/<Nome>.md` quando existir ou dos arquivos gerenciados `.specsfy/templates/Project.md`, `Stack.md`, `Rules.md` e `Database.md` caso contrário; não manter modelos paralelos embutidos no script.4. No início e no fim de cada mudança, executar:```bashpython3 -B scripts/monitor_context.py --project <raiz> --check```5. Inspecionar os quatro arquivos e a evidência de stack usada pelo script.6. Nunca substituir um arquivo de contexto existente, mesmo com conteúdo incompleto. Em `AGENTS.md` e `CLAUDE.md`, atualizar somente o bloco delimitado do framework e preservar tudo fora dele.7. Para completar ou corrigir stack, regras ou dados, anunciar o handoff e carregar respectivamente `$specsfy-aux-stack`, `$specsfy-aux-rules` ou `$specsfy-aux-database`.8. Quando aplicação ou persistência mudar, carregar `$specsfy-documentator` depois das auxiliares e reconstruir `docs/` a partir de todo o código.Não contornar um resultado `PENDING`. Atualizar o documento indicado e executaro monitor novamente. Para mudança de aplicação sem impacto material na históriaou finalidade, registrar essa avaliação na evidência da tarefa e repetir com`--acknowledge-project-no-change`. Aplicar a mesma disciplina a regras com`--acknowledge-rules-no-change`; nunca usar o reconhecimento para ocultar umamudança documental real.Manter `PROJECT.md` na raiz. Manter `STACK.md`, `RULES.md` e `DATABASE.md` em`.specsfy/`. Tratar esses documentos como contexto derivado do projeto, não comospec, gate ou autorização de implementação.Em projeto com mais de um framework, registrar todas as evidências observadas;não escolher silenciosamente um único stack. Se nenhum framework foridentificado, criar o modelo genérico e declarar que a confirmação estápendente.

Frequently asked questions