How do I install the Specsfy Monorepo Documentator skill?

Run npx skillmds@latest add promovaweb/specsfy-monorepo-documentator 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 Monorepo Documentator 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 Monorepo Documentator?

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 Monorepo Documentator free to use?

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

Who published Specsfy Monorepo Documentator?

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

Specsfy Monorepo Documentator by promovaweb

Name: Specsfy Monorepo Documentator
Author: promovaweb

Specsfy Monorepo Documentator

Manter a documentação oficial do próprio projeto Specsfy no monorepo promovaweb/specsfy. Use somente na raiz oficial quando o pedido for documentar o Specsfy, reconciliar mudanças transversais, revisar docs/develop/context/ ou atualizar guias em docs/user/. Não use em projetos consumidores; para reconstruir a documentação de uma aplicação, use specsfy-documentator.

promovaweb Updated Sep 17, 2026

File contents

Documentar o monorepo Specsfy

Executar na raiz:

python3 -B \
  .agents/skills/specsfy-monorepo-documentator/scripts/collect_monorepo_evidence.py \
  --workspace .

Interromper se o coletor informar que o diretório não representa o monorepo oficial.
Ler integralmente o AGENTS.md da raiz e as instruções dos módulos afetados.
Ler docs/develop/context/README.md e apenas os contextos roteados pela mudança.
Ler o padrão documental antes de editar topologia, classificação ou percurso de leitura.
Comparar cada afirmação com código, teste, manifest, configuração, schema, documentação operacional ou contexto normativo do módulo responsável.
Atualizar ambos os percursos quando a mudança alcançar arquitetura e uso:
- documentação para usuários em docs/user/;
- documentação técnica em docs/develop/. Manter docs/user/installation.md como guia canônico de instalação e uma página em docs/user/skills/ para cada skill base. Manter a jornada pedagógica única em docs/user/reading-order.txt, começando pelo método, seguida de instalação, primeira entrega, fluxo base, operação e uso avançado.
Usar links relativos entre módulos. URLs públicas usam https://github.com/promovaweb/specsfy.
Após qualquer mudança em docs/user/, versionar e reconstruir PDF, EPUB e manifesto com make ebook.
Executar testes focais dos módulos, regressão integrada e revisar o único status e diff do monorepo.

Política de evidência

Registrar como fato apenas o que uma fonte atual comprovar.
Distinguir decisão vigente, estado implementado, inferência e lacuna.
Preservar o estado observado quando fontes divergirem.
Não copiar inventários extensos derivados de manifests, rotas, schemas ou testes.
Não copiar segredos, dados de produção ou conteúdo interno sem finalidade.
Não criar plan.md, tasks.md, research.md, data-model.md ou specs/ na raiz.

Fronteira com o documentador do consumidor

Esta skill documenta a metodologia, a arquitetura do monorepo e seus guias oficiais. Para <projeto>/docs/ de uma aplicação consumidora, carregue $specsfy-documentator.

Exclusividade local

Manter a fonte somente em .agents/skills/specsfy-monorepo-documentator/.
Expor a mesma fonte ao Claude pelo symlink .claude/skills/specsfy-monorepo-documentator.
Não criar skill homônima em skills/ nem incluí-la no instalador.
Em pedido somente de auditoria, coletar e ler sem publicar arquivos.

---name: specsfy-monorepo-documentatordescription: Manter a documentação oficial do próprio projeto Specsfy no monorepo promovaweb/specsfy. Use somente na raiz oficial quando o pedido for documentar o Specsfy, reconciliar mudanças transversais, revisar docs/develop/context/ ou atualizar guias em docs/user/. Não use em projetos consumidores; para reconstruir a documentação de uma aplicação, use specsfy-documentator.---# Documentar o monorepo Specsfy1. Executar na raiz:```bashpython3 -B \ .agents/skills/specsfy-monorepo-documentator/scripts/collect_monorepo_evidence.py \ --workspace .```1. Interromper se o coletor informar que o diretório não representa o monorepo oficial.2. Ler integralmente o `AGENTS.md` da raiz e as instruções dos módulos afetados.3. Ler `docs/develop/context/README.md` e apenas os contextos roteados pela mudança.4. Ler [o padrão documental](references/documentation-standard.md) antes de editar topologia, classificação ou percurso de leitura.5. Comparar cada afirmação com código, teste, manifest, configuração, schema, documentação operacional ou contexto normativo do módulo responsável.6. Atualizar ambos os percursos quando a mudança alcançar arquitetura e uso: - documentação para usuários em `docs/user/`; - documentação técnica em `docs/develop/`. Manter `docs/user/installation.md` como guia canônico de instalação e uma página em `docs/user/skills/` para cada skill base. Manter a jornada pedagógica única em `docs/user/reading-order.txt`, começando pelo método, seguida de instalação, primeira entrega, fluxo base, operação e uso avançado.7. Usar links relativos entre módulos. URLs públicas usam `https://github.com/promovaweb/specsfy`.8. Após qualquer mudança em `docs/user/`, versionar e reconstruir PDF, EPUB e manifesto com `make ebook`.9. Executar testes focais dos módulos, regressão integrada e revisar o único status e diff do monorepo.## Política de evidência- Registrar como fato apenas o que uma fonte atual comprovar.- Distinguir decisão vigente, estado implementado, inferência e lacuna.- Preservar o estado observado quando fontes divergirem.- Não copiar inventários extensos derivados de manifests, rotas, schemas ou testes.- Não copiar segredos, dados de produção ou conteúdo interno sem finalidade.- Não criar `plan.md`, `tasks.md`, `research.md`, `data-model.md` ou `specs/` na raiz.## Fronteira com o documentador do consumidorEsta skill documenta a metodologia, a arquitetura do monorepo e seus guiasoficiais. Para `<projeto>/docs/` de uma aplicação consumidora, carregue`$specsfy-documentator`.## Exclusividade local- Manter a fonte somente em `.agents/skills/specsfy-monorepo-documentator/`.- Expor a mesma fonte ao Claude pelo symlink `.claude/skills/specsfy-monorepo-documentator`.- Não criar skill homônima em `skills/` nem incluí-la no instalador.- Em pedido somente de auditoria, coletar e ler sem publicar arquivos.

Frequently asked questions