Do zero ao primeiro ticket
Monte a pasta de trabalho
~/dev/dev-toolse leve o primeiro pedido de~/dev/minha-appaté o código, com ticket e testes.
A aplicação ainda pode estar vazia. Nas saídas, /home/voce está no lugar da pasta pessoal.
- Crie a pasta da aplicação e a pasta de trabalho
mkdir -p ~/dev/{minha-app,dev-tools}- Na pasta de trabalho crie o ambiente choliba
cd ~/dev/dev-tools
echo '{ "name": "dev-tools", "private": true }' > package.json
curl -LO https://github.com/choliba/choliba/releases/download/v0.0.1-dev/choliba-0.0.1-dev.tgz
curl -LO https://github.com/choliba/choliba/releases/download/v0.0.1-dev/choliba-0.0.1-dev.tgz.sha256
sha256sum -c choliba-0.0.1-dev.tgz.sha256
bun add --trust ./choliba-0.0.1-dev.tgzNão instale se sha256sum -c não terminar em OK. O --trust autoriza o postinstall; o setup roda sozinho e cria o projeto de exemplo projects/exemplo. O que mais ele cria está em Primeiros passos. Os comandos abaixo rodam nessa pasta.
- Crie o projeto de teste da aplicação
O new project cria projects/<nome>/ a partir do modelo, com config.json, .env.example.json, tests/ e tickets/. O nome sai da pasta da aplicação quando você não o dá, e o description vem do README dela:
bun choliba new project minha-app --app-dir /home/voce/dev/minha-app --base-url http://localhost:3000
cp projects/minha-app/.env.example.json projects/minha-app/.env.jsonTudo é opcional: num terminal, o comando pergunta o que faltar, e uma resposta vazia deixa o campo como CHANGE_ME para você preencher depois. Sem terminal, ou com --no-input, ele não pergunta nada.
O config.json criado fica assim. Cada campo está em config.json do projeto. O baseURL leva http://, e o appDir é a pasta da aplicação. Deixe ligado só o Chromium, o navegador de Dependências:
{
"name": "minha-app",
"description": "Minha App",
"envs": [
{
"nome": "development",
"baseURL": "http://localhost:3000",
"appDir": "/home/voce/dev/minha-app",
"default": true
}
],
"devices": {
"chromium": true,
"firefox": false,
"webkit": false,
"mobile-chrome": false
}
}O .env.json guarda os dados que os testes usam em cada ambiente, como um usuário de teste. O formato está em .env.json do projeto. O .gitignore da pasta de trabalho o deixa fora do git. Troque os CHANGE_ME. Se a aplicação ainda não tem login, qualquer valor serve:
{
"development": {
"TEST_USERNAME": "ana",
"TEST_PASSWORD": "senha"
}
}Enquanto o .env.json não existir, o check marca o projeto com ✗, e os agentes não rodam nele, nem com --dry-run.
Se a aplicação precisa de preparo ou de alguém que a suba para os testes, diga como no ambiente do config.json. Os dois campos são opcionais:
setup: comandos que o choliba roda emappDir, em ordem, antes de cada rodada de testes e de cada execução de agente.start: o comando que sobe a aplicação. O choliba só o roda quando nada responde nobaseURL, espera a aplicação responder e a derruba no fim. Uma aplicação que você já subiu é usada como está.
Os agentes nunca sobem a aplicação. Sem start, quem sobe é você, e um agente com a aplicação fora do ar não roda (veja A aplicação do projeto).
- Instale os agentes que escrevem o ticket, os testes e o código
bun choliba add github:choliba/choliba --path .choliba/agents/product-owner
bun choliba add github:choliba/choliba --path .choliba/agents/test-writer
bun choliba add github:choliba/choliba --path .choliba/agents/implementerCada um traz as skills que declara. O que mais dá para instalar está em Instalar agentes, skills e MCPs.
- Confira
Com tudo no lugar, nada sai com ✗:
$ bun choliba check
Agentes (/home/voce/dev/dev-tools/.choliba/agents)
✓ implementer
✓ product-owner
✓ test-writer
Projetos (/home/voce/dev/dev-tools/projects)
✓ exemplo
✓ minha-app- Do ticket ao código implementado
A aplicação precisa responder no baseURL. O ticket novo fica minha-app-1:
bun choliba run agent product-owner --project minha-app --type story "a página inicial mostra o nome do site"
bun choliba run agent test-writer --project minha-app --ticket minha-app-1
bun choliba run agent implementer --project minha-app --ticket minha-app-1Os testes desse ticket, a qualquer momento:
bun choliba run tests minha-app:1