flowral.docs

Fluxo de trabalho dos agentes — evidências, testes e revisão

O objetivo é implementar uma interface observável, não somente código que compila. Nenhuma ferramenta dessa especificação foi declarada já instalada ou operacional.

As tarefas podem usar os agentes e skills selecionados e receitas em docs/development/recipes/. Não invocar todos os especialistas por padrão: reservar revisão independente para mudanças sensíveis e registrar o que foi realmente testado.

Checklist de cada alteração

  1. Ler AGENTS.md, decisões e documento funcional aplicável.
  2. Trabalhar em incremento isolado; registrar critérios de aceite e risco.
  3. Executar Rust fmt/clippy/test ao existir workspace.
  4. Se altera Slint: usar preview ou viewer, inspecionar UI pelo MCP e realizar interações.
  5. Registrar capturas de tela reais (Light, Dark, teclado/foco e erro, quando aplicável).
  6. Se afeta Wayland Layer Shell, testar no Swirl nested ou na VM.
  7. Se altera boot, paquetes, rede, energia, login, armazenamento, testar na VM descartável.
  8. Para GPU e bateria, só usar o ThinkPad Edge E430 após aprovação e backup.
  9. Reportar testes executados, não executados, falhas e limites. Nunca afirmar que “viu” uma screenshot que não conseguiu inspecionar.

Evidências

Salvar como anexos de CI ou relatórios por commit, sem dados pessoais:

reports/<feature>-<commit>/
  summary.md
  environment.json
  cargo-check.txt
  slint-light.png
  slint-dark.png
  accessibility-checks.md
  vm-console.png
  performance.json

Não gravar chave de provider, token, MAC, SSID, serial de hardware ou ambiente bruto em artifacts.

Segurança e consentimento

  • Agente nunca acessa disco de host em modo escrita por padrão durante teste de ISO.
  • Slint MCP em localhost e somente para testes; desativado fora da sessão de desenvolvimento.
  • Agent executa dentro do projeto e VM autorizada, não como root universal.
  • Login/lockscreen verdadeiro exige protocolos seguros, não é substituído por overlay.
  • Screenshots de janelas privadas não são capturadas por padrão.
  • Comparação visual só deve usar imagens geradas pela implementação em teste, sem fingir evidência.

Relatório mínimo do PR

Mudança feita; versões/ambiente; screenshots inspecionadas; testes automatizados e manuais; consumo medido se relevante; regressões, funcionalidades não implementadas e plano de rollback.

Entrega inicial sugerida: primeiro protótipo Rust+Slint do gerenciador de temas Sakura, com um controle interativo validado por MCP e modo headless quando disponível.