Prepara a sessão de trabalho. Ele confere se o acesso ao WiseWork está funcionando, descobre quem é você, fixa o produto em que você vai trabalhar e guarda no seu projeto uma cópia do que você mais consulta — por padrão, suas tasks abertas e um resumo de atividades. A sprint ativa entra se você pedir. Também atualiza os style guides da sua instância na sua máquina.
É o único comando que fixa o produto. Todos os outros usam o que ele deixou pronto.
Como utilizar
Rode sem argumentos para inicializar com o projeto já fixado, ou passe um nome de projeto em texto livre para fixar ou trocar de projeto. Ao final, mostra o resumo da sessão: sua identidade, o projeto fixado e o que foi pré-carregado — por padrão, as suas tasks abertas, o resumo de atividades e os style guides.
Exemplos
/ww:init
/ww:init projeto checkout
/ww:init muda para o produto omni-route
/ww:init com a sprint
/ww:init sem o resumo de atividades
/ww:init sem os style guides
Na ambiguidade
Sem dizer nada, ele reconhece você sozinho e mantém o produto já fixado. Se você citar um nome, fixa esse. Se houver mais de um produto possível, pergunta em vez de escolher.
Notas
É o único comando que fixa o produto, e o único que refaz a cópia local por inteiro. Rode de novo ao trocar de produto ou quando desconfiar que a lista está velha.
Uma vez no começo do dia ou da sessão. E de novo quando você troca de produto, ou quando desconfia que a lista de tasks está velha.
- Confere o acesso. Diferente dos outros comandos, que confiam no que já está gravado no projeto, ele consulta o WiseWork ao vivo. Se a conexão ou o token estiverem com problema, o comando para aqui e diz exatamente qual é o caso, com o código da requisição para o suporte. Token expirado, inexistente, revogado ou credencial inválida apontam para o
/ww:config:mcp. Tempo esgotado e falha de rede dizem o contrário — o problema não é o seu token, é a conexão ou o endereço da API. Ele nunca segue com uma sessão pela metade.
- Descobre quem é você e guarda essa identidade para os outros comandos.
- Fixa o produto. Se nenhum estiver fixado, a própria verificação de identidade já tenta fixar o produto cujo repositório cadastrado no WiseWork corresponde ao remote do git desta pasta. Se nenhum produto corresponder (ou mais de um), ou se você pediu outro, ele lista os seus produtos e fixa o escolhido. Quando o nome que você escreveu bate com um só, usa aquele; quando há dúvida, pergunta.
- Pré-carrega o que você mais usa, tudo ao mesmo tempo.
- Mostra um resumo da sessão: quem é você, qual produto ficou fixado e o que foi carregado.
Você escolhe o conjunto, por projeto:
| O que | Ligado por padrão |
|---|
| Suas tasks abertas | sim |
| Resumo de atividades | sim |
| Style guides | sim |
| Sprint ativa | não |
- Suas tasks abertas — as tasks no seu nome que ainda estão em aberto. Tasks concluídas, canceladas, arquivadas ou na geladeira nunca entram nessa lista.
- Resumo de atividades — o mesmo digest do /ww:talk:activity-summary, montado a partir do histórico do seu repositório dos últimos 2 dias e dos registros locais de task. Este passo não consulta o WiseWork, mas precisa de
git e python3 na máquina.
- Style guides — os guias de estilo da galeria do WiseWork, que o /ww:implement, o /ww:fix e o /ww:review:task seguem. É o mesmo do /ww:config:style-guides: só baixa os guias novos ou com versão nova, então depois da primeira vez quase sempre não há nada a baixar. Os guias ficam na sua máquina, valem para todos os projetos, e nenhum guia seu é apagado.
- Sprint ativa — a sprint em andamento, com estatísticas e a lista de tasks. Se não houver sprint ativa, isso é dito claramente.
Para mudar o padrão de vez, use o /ww:config:preferences. Para mudar só desta vez, diga na própria frase: “com a sprint”, “sem o resumo de atividades”, “sem os style guides”. Um pedido assim não muda o produto que você fixou.
O /ww:init faz as consultas ao WiseWork para os outros comandos não precisarem fazer. Depois dele, comandos como o /ww:task:list respondem a partir dessa cópia local, na hora, sem ida e volta à rede, e os comandos que mudam tasks atualizam só as linhas que tocaram. Só este comando regenera a cópia por inteiro — a cada execução, os arquivos são reescritos.
- Sem flags. Você escreve o pedido em português mesmo.
- Roda em silêncio. Durante a execução você só vê uma pergunta, quando ela é necessária, ou a mensagem de parada; o resto vem no resumo final.
- O comando nunca esconde um erro. Falhas aparecem com contexto suficiente para você agir.
- O que ele grava fica fora do git. A identidade, o produto fixado e as cópias locais ficam em
.dr_ai/, que é pessoal da sua máquina. No início de cada sessão o plugin acrescenta .dr_ai/ ao .gitignore do projeto, se o git ainda não ignorar a pasta.
