devloop
Setup
x rule init :ror # ou um ruleset específico do projeto
x env use agent-browser # para verificação visual
Workflow
objetivo → rule.yml → código → verificação → issue
1. Defina o objetivo → escreva rule.yml
Antes de codar, crie um rule.yml para a tarefa:
goal: "Corrigir a versão em inglês mostrando tags chinesas na seção Features"
keyresults:
- kr-1: "As tags de Features no modo inglês são todas em inglês"
- kr-2: "As tags de Features no modo chinês permanecem em chinês"
- kr-3: "O build passa sem regressões"
rules:
- id: kr-1-verify
name: english-tags-no-chinese
apply: "src/components/Features.tsx"
level: error
desc:
- Quando language=en, todos os itens details[] devem estar em inglês
- Nenhum caractere chinês em nenhuma tag badge no modo inglês
Campos de rule: id, name, apply, level, desc, tldr. Veja x rule -h.
DEVE incluir goal e keyresults — os dois campos obrigatórios de toda tarefa de dev.
2. Execute → verificação visual (frontend)
agent-browser open <url> --session <proj> --headed
agent-browser --session <proj> screenshot /tmp/before.png
# ... faça as alterações ...
agent-browser --session <proj> screenshot /tmp/after.png
DEVE tirar screenshot antes e depois. Compare com a intenção:
- Verificação pela visão da IA: o after.png corresponde ao objetivo?
- Se não corresponder → itere e tire um novo screenshot
- Apague todos os dados privados (tokens, e-mails, informações pessoais) antes de enviar
3. Verifique com x rule
x rule scan <files> # rápido (~1 min), para o loop interno
x rule check <files> # minucioso (~10 min)
x rule audit <files> # relatório completo (~30 min)
4. Sincronize com o rastreador de issues
Veja issue/SKILL.md. Mínimo: poste objetivo, key-results, rule.yml e os screenshots antes/depois na issue.
Ferramentas do agente
x rule scan— verificação rápida durante a iteraçãox rule check— conformidade completa antes do commitagent-browser screenshot— prova visual antes/depoisgh issue create/comment— sincroniza objetivo + rule.yml com o rastreador
Relacionados
- rule — rule.yml é o esqueleto da verificação
- score — a pontuação de KRs usa o framework de score
- install — prepara o ambiente de desenvolvimento
- agent-browser — verificação visual antes/depois
- issue — sincroniza objetivo + KRs + screenshots com o rastreador de issues
- repo — faz pull/push do trabalho nos repos
- prompt — as convenções de prompt frequentemente conduzem tarefas do devloop