brandfy-setup

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Configurar o Brandfy

配置Brandfy

Protocolo operacional

操作规范

Plano e progresso: criar um plano visível e atualizar o estado após a inspeção, a configuração e a validação.
Fontes de verdade: ler o
```
AGENTS.md
```
do projeto, os arquivos existentes em
```
.brandfy/
```
e a referência agents-consumer.md.
Escopo e idempotência: preservar configurações e artefatos existentes. O setup só cria arquivos ausentes, migra o manual legado para
```
BRAND.md
```
e substitui apenas o bloco Brandfy no
```
AGENTS.md
```
.
Validação: executar o setup com
```
--check
```
depois da escrita e revisar o
```
git diff
```
.
Resumo final: informar arquivos criados, arquivos preservados, validações e pendências.

计划与进度： 创建可视化计划，并在检查、配置和验证后更新状态。
真实数据源： 阅读项目的
```
AGENTS.md
```
、
```
.brandfy/
```
中的现有文件以及参考文档agents-consumer.md。
范围与幂等性： 保留现有配置和工件。安装程序仅创建缺失的文件，将旧手册迁移至
```
BRAND.md
```
，仅替换
```
AGENTS.md
```
中的Brandfy块。
验证： 在写入后使用
```
--check
```
参数执行安装程序，并查看
```
git diff
```
结果。
最终总结： 告知已创建的文件、保留的文件、验证结果以及待办事项。

Fluxo

流程

Localizar a raiz do projeto e ler suas instruções.

Executar:

bash

node <caminho-da-skill>/scripts/setup.mjs --project .

Abrir
```
.brandfy/config.yaml
```
e ajustar nome, país, idioma, destino e fase da marca com o usuário.
Quando o briefing ainda estiver incompleto, usar
```
$brandfy-entrevista
```
para conduzir a descoberta e preencher os arquivos sem inventar respostas.
Preencher
```
.brandfy/brief.md
```
apenas com fatos confirmados. Manter lacunas explícitas, com pergunta e responsável.
Conferir o bloco delimitado por
```
brandfy:consumer
```
no
```
AGENTS.md
```
.

Executar:

bash

node <caminho-da-skill>/scripts/setup.mjs --project . --check

Depois do setup, abra

.brandfy/config.yaml

BRAND.md

brand/README.md

para confirmar o destino, o guia e o índice. Um segundo uso deve terminar sem alterações, e qualquer diferença indica configuração incompleta ou bloco do agente antigo.

Em um projeto antigo, o manual que ainda estiver em

brand/README.md

passa para

BRAND.md

; uma cópia anterior fica em

brand/archive/

quando necessário.

执行：

bash

node <caminho-da-skill>/scripts/setup.mjs --project .

打开
```
.brandfy/config.yaml
```
，与用户一起调整品牌的名称、国家、语言、目标和阶段。
当简报仍不完整时，使用
```
$brandfy-entrevista
```
引导探索，在不编造答案的前提下填充文件。
仅使用已确认的事实填充
```
.brandfy/brief.md
```
。明确保留空白，标注问题和负责人。
检查
```
AGENTS.md
```
中由
```
brandfy:consumer
```
界定的块。

执行：

bash

node <caminho-da-skill>/scripts/setup.mjs --project . --check

安装完成后，打开

.brandfy/config.yaml

、

BRAND.md

和

brand/README.md

以确认目标、指南和索引。再次运行安装程序应无任何更改，若出现差异则表明配置不完整或存在旧Agent块。

对于旧项目，仍在

brand/README.md

中的手册将迁移至

BRAND.md

；必要时，旧版本副本将保存在

brand/archive/

中。

Raciocínio do especialista

专家思路

Tratar o setup como preparação de governança, não como criação da marca. Confirmar responsáveis por respostas e aprovações, localização das comprovações, arquivos canônicos e forma de resolver pendências. Uma estrutura completa com informação fraca continua sendo um projeto incompleto.

将安装视为治理准备，而非品牌创建。确认答案和审批的负责人、验证材料的位置、标准文件以及待办事项的解决方式。信息不完善的完整结构仍属于未完成项目。