Os dois arquivos de configuração

Compatível com ww1.14.0

O plugin /ww toca em dois arquivos com esquemas diferentes. Confundir os dois é fácil: você procura “onde fica a preferência X” e não acha, porque está olhando no arquivo errado.

.dr_ai/settings.json

Lido pelo plugin e pelo servidor MCP workforce — nunca pelo Claude Code em si. O plugin só usa o bloco workforce: é ali que ficam a sua identidade e o projeto fixado. Não é um arquivo do time: o plugin coloca .dr_ai/ no .gitignore do projeto (veja o que o plugin grava em .dr_ai).

Identidade e projeto fixado (workforce)

workforce.project_id, workforce.project_name, workforce.project_pinned_at

Escrito porworkforce_context_set (chamado pelo /ww:init); o workforce_whoami também fixa o projeto pelo remoto do git quando nenhum está fixado

Lido porskill workforce-context (usada pelos comandos /ww) e servidor MCP, que injeta o projeto nas tools que o omitem

SignificadoProjeto fixado e quando foi fixado

workforce.member_id, workforce.member_name, workforce.email, workforce.resolved_at

Escrito porworkforce_whoami e workforce_context_set (os dois chamados pelo /ww:init)

Lido porskill workforce-context

SignificadoSua identidade resolvida e quando foi resolvida

workforce.frontend_url

Escrito porworkforce_whoami, quando o MCP tem FRONTEND_URL configurada

SignificadoCópia do endereço da plataforma web, base dos links das tasks

Quem grava esse bloco é o servidor MCP workforce, sempre que o /ww:init chama workforce_whoami ou workforce_context_set. Nenhum comando /ww edita o arquivo diretamente.

Chaves que o plugin não lê

Chaves herdadas do DR_AI, como directories, preferences, user, quality e git, são ignoradas: nenhum comando /ww as lê ou grava. Os valores que elas configuravam agora são fixos:

O quê	Valor fixo
Documentos dos comandos /ww:doc:*	.dr_ai/docs
Relatórios de review (/ww:review:task, /ww:review:pr)	.dr_ai/code-reviews
Padrões de qualidade do projeto (/ww:review:task)	.dr_ai/docs/standards
Idioma dos reviews	o idioma da conversa
Assinatura dos comentários do /ww:review:pr	WiseWork Code Review
Provider git do /ww:review:pr	detectado pelo remoto
Guia aberto pelo /ww:talk:help	https://wisework.help/plugin/

Dica

Para mudar identidade ou projeto, rode /ww:init (com o nome do projeto, para trocar). Editar o JSON à mão não é necessário, e chaves fora do bloco workforce não têm efeito.

.claude/settings.local.json

Escrito por /ww:config:preferences. Lido pelo Claude Code, não pelo plugin — com uma única exceção, o workforce.init.preload, que o /ww:init lê.

outputStyle

Lido porClaude Code

SignificadoEstilo de output padrão — /ww:config:preferences nunca toca nesta chave

permissions.allow, permissions.deny

Lido porClaude Code

SignificadoPermissões para comandos; preferences garante "mcp__workforce" em allow

enabledPlugins

Lido porClaude Code

SignificadoPlugins ativos. O instalador wisework instala o plugin como ww@wisework (ou ww@wisework-beta no canal beta)

includeCoAuthoredBy, alwaysThinkingEnabled, skipDangerousModePermissionPrompt, terminalProgressBarEnabled, showTurnDuration, spinnerTipsEnabled

Lido porClaude Code

SignificadoPreferências gerais, aplicadas com defaults por preferences

workforce.project_id, .project_name, .member_id, .member_name, .email, .language, .verbosity

Lido porninguém

SignificadoCópia mapeada — visível para consulta humana, nunca lida por nenhum comando ou pelo MCP

workforce.init.preload.sprint, .my_tasks, .activity_summary

Lido por/ww:init (único consumidor)

SignificadoQuais caches a fase de pré-carga do /ww:init gera

Defaultsprint: false, my_tasks: true, activity_summary: true

Atenção

Dentro do bloco workforce de .claude/settings.local.json, os campos de identidade (project_id, member_id, email, …) são só uma cópia mapeada para consulta, nunca lida programaticamente — a fixação funcional mora exclusivamente em .dr_ai/settings.json, gravada pelo servidor MCP (workforce_whoami e workforce_context_set), e editar a cópia aqui não muda o contexto da sessão. A exceção é workforce.init.preload, que é funcional: o /ww:init lê essas três chaves para decidir o que pré-carregar.

Quem escreve qual

Ação	Arquivo escrito
/ww:init	.dr_ai/settings.json (bloco workforce, gravado pelo servidor MCP via workforce_whoami e workforce_context_set)
/ww:config:preferences	.claude/settings.local.json (preferências do Claude Code + bloco workforce mapeado, incluindo o init.preload funcional)
Instalador npx -y wisework@latest install --slug=<slug>	~/.claude.json (registro do MCP workforce, escopo user), ~/.npmrc (credencial do pacote do MCP) e ~/.claude/settings.json (marketplace e, conforme o questionário, statusLine e outputStyle) — nenhum é local ao projeto
/ww:config:mcp (alternativa manual)	~/.claude.json (escopo user) e ~/.npmrc
Chaves fora do bloco workforce em .dr_ai/settings.json	Ninguém — o plugin não lê nem grava

Ver também

• /ww:init
• /ww:config:preferences
• /ww:config:mcp
• O MCP do WiseWork