specsfy-monorepo-documentator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

bash

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.

bash

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

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

specs/

na raiz.

请勿在根目录创建

plan.md

、

tasks.md

、

research.md

、

data-model.md

或

specs/

目录。

Esta skill documenta a metodologia, a arquitetura do monorepo e seus guias oficiais. Para

<projeto>/docs/

de uma aplicação consumidora, carregue

$specsfy-documentator

本skill用于记录方法论、单体仓库架构及官方指南。如需处理消费类应用的

<projeto>/docs/

目录，请使用

$specsfy-documentator

。

Manter a fonte somente em

.agents/skills/specsfy-monorepo-documentator/

Expor a mesma fonte ao Claude pelo symlink

.claude/skills/specsfy-monorepo-documentator

仅在

.agents/skills/specsfy-monorepo-documentator/

目录下保留源码。