specsfy-setup

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Preparar contexto do projeto

准备项目上下文

Modo de interação

交互模式

Modo de interação:

perguntas

. Antes de formular qualquer pergunta, leia e aplique o

Contrato de perguntas numeradas

.specsfy/Spec.md

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
```
specsfy doctor --project <raiz>
```
e corrigir cada requisito ausente antes de preparar o contexto. O diagnóstico confere Node.js, Git, npm, acesso ao projeto e o
```
skills CLI
```
, com fallback por
```
npx
```
.

Executar

node scripts/setup_context.mjs --project <raiz>

. Renderizar

PROJECT.md

STACK.md

RULES.md

DATABASE.md

a partir de

.specsfy/templates/custom/<Nome>.md

quando existir ou dos arquivos gerenciados

.specsfy/templates/Project.md

Stack.md

Rules.md

Database.md

caso contrário; não manter modelos paralelos embutidos no script.

No início e no fim de cada mudança, executar:

bash

node scripts/monitor_context.mjs --project <raiz> --check

Inspecionar os quatro arquivos iniciais,
```
.specsfy/PACKAGES.md
```
quando gerado e a fonte 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, persistência ou dependências mudar, carregar
```
$specsfy-documentator
```
depois das auxiliares e reconstruir
```
docs/
```
e
```
.specsfy/PACKAGES.md
```
a partir de todo o projeto.
Somente quando a pessoa solicitar ou indicar explicitamente o uso de Gitflow para o projeto (ver references/gitflow.md), anunciar o handoff, carregar
```
$specsfy-specialist-gitflow
```
e registrar a convenção de branches confirmada em
```
RULES.md
```
via
```
$specsfy-aux-rules
```
. Nunca propor, presumir ou aplicar Gitflow a partir da estrutura de branches do repositório, da presença de uma branch
```
develop
```
ou de qualquer outro sinal implícito.

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 nas fontes 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

DATABASE.md

PACKAGES.md

.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 fontes 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.

交互模式：

问答式

。在提出任何问题之前，请阅读并应用

.specsfy/Spec.md

中的

编号问题约定

。

在撰写前阅读
```
AGENTS.md
```
、
```
CLAUDE.md
```
和本地说明。
当需要审核代理文件中的保留块时，阅读可发布指南。
执行
```
specsfy doctor --project <raiz>
```
并在准备上下文之前修复每个缺失的要求。该诊断会检查Node.js、Git、npm、项目访问权限以及
```
skills CLI
```
，并可通过
```
npx
```
作为备选方案。

执行

node scripts/setup_context.mjs --project <raiz>

。当存在

.specsfy/templates/custom/<Nome>.md

时，从该文件生成

PROJECT.md

、

STACK.md

、

RULES.md

和

DATABASE.md

；否则从

.specsfy/templates/Project.md

、

Stack.md

、

Rules.md

和

Database.md

这些托管文件生成；请勿在脚本中保留并行的内嵌模板。

在每次变更开始和结束时，执行：

bash

node scripts/monitor_context.mjs --project <raiz> --check

检查初始的四个文件、生成后的
```
.specsfy/PACKAGES.md
```
以及脚本使用的技术栈源文件。
切勿替换现有的上下文文件，即使内容不完整。在
```
AGENTS.md
```
和
```
CLAUDE.md
```
中，仅更新框架限定的块并保留块外的所有内容。
为了补充或修正技术栈、规则或数据，需告知交接并分别加载
```
$specsfy-aux-stack
```
、
```
$specsfy-aux-rules
```
或
```
$specsfy-aux-database
```
。
当应用、持久化或依赖项发生变更时，在加载辅助工具后加载
```
$specsfy-documentator
```
，并从整个项目重建
```
docs/
```
和
```
.specsfy/PACKAGES.md
```
。
仅当用户明确要求或指示对项目使用Gitflow时（查看references/gitflow.md），告知交接，加载
```
$specsfy-specialist-gitflow
```
，并通过
```
$specsfy-aux-rules
```
将确认的分支约定记录在
```
RULES.md
```
中。切勿从仓库的分支结构、
```
develop
```
分支的存在或任何其他隐含信号推断、假设或应用Gitflow。

切勿绕过

PENDING

结果。更新指定的文档并重新执行监控。对于对项目历史或目的无实质性影响的应用变更，在任务源中记录此评估，并使用

--acknowledge-project-no-change

重复执行。对规则变更应用相同的规范，使用

--acknowledge-rules-no-change

；切勿使用确认来掩盖真实的文档变更。

将

PROJECT.md

保留在根目录。将

STACK.md

、

RULES.md

、

DATABASE.md

和

PACKAGES.md

保留在

.specsfy/

目录下。将这些文档视为项目衍生的上下文，而非规范、关卡或实施授权。

对于包含多个框架的项目，记录所有观察到的源；切勿默认选择单一技术栈。如果未识别到任何框架，创建通用模板并声明确认待处理。