Skip to content

Do zero ao primeiro ticket ​

Monte a pasta de trabalho ~/dev/dev-tools e leve o primeiro pedido de ~/dev/minha-app até 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.

  1. Crie a pasta da aplicação e a pasta de trabalho
bash
mkdir -p ~/dev/{minha-app,dev-tools}
  1. Na pasta de trabalho crie o ambiente choliba
bash
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.tgz

Nã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.

  1. 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:

bash
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.json

Tudo é 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:

json
{
  "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:

json
{
  "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 em appDir, 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 no baseURL, 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).

  1. Instale os agentes que escrevem o ticket, os testes e o código
bash
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/implementer

Cada um traz as skills que declara. O que mais dá para instalar está em Instalar agentes, skills e MCPs.

  1. 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
  1. Do ticket ao código implementado

A aplicação precisa responder no baseURL. O ticket novo fica minha-app-1:

bash
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-1

Os testes desse ticket, a qualquer momento:

bash
bun choliba run tests minha-app:1