flowral.docs

Workforce do Flowral — curadoria do Prumo

Fonte externa analisada: poppyTM/prumo/workforce, consultada em 23/10/2026. Na árvore observada: 39 agents, 189 skills e 20 recipes. A página docs/en/workforce/index.md do Prumo fala em 16 recipes, portanto há uma divergência entre documentação e diretórios presentes. Esses números caracterizam o Prumo, não a distribuição Flowral.

Decisão de curadoria: reutilizar conceitos e divisão de papéis, redigindo conteúdo original adaptado para o Flowral. Não copiar as 189 skills ou exigir instalação do Prumo. O source do usuário AGENTS.md anexado tem o título Digi-Tactics engineering guide: foram preservadas diretrizes gerais e removidas premissas exclusivas de game/TypeScript.

O que aproveitamos das fontes

Padrão de origem Aplicação no Flowral
Prumo AGENT.md + manifest (purpose, inputs, outputs, skills, capabilities, stop conditions, handoff) Perfis OpenCode V2 pequenos em .opencode/agents; descrição, riscos, contexto, evidências e limitações nos corpos
Prumo SKILL.md (use when, do not use, workflow, verification, references) .opencode/skills/<id>/SKILL.md carregada só quando a tarefa pede
Prumo recipe.json/RECIPE.md com passos/gates Receitas de revisão/implementação em docs/development/recipes/, humanas e portáveis; não inventar orquestrador
Digi-Tactics: preservar trabalho, verificação honesta e rollback Regras centrais do AGENTS.md
Digi-Tactics: fronteiras de domínio, comandos validados, helpers descritivos Rust domain/services/adapters/Slint e IO explícito
Digi-Tactics: contexto progressivo, testes em camadas, handoff 1 especificação + código/testes relevantes; reports com pass/fail/not run/blocked
Digi-Tactics: browser/host guardrails VM e Slint MCP locais, sem browser pessoal, sem disco real, processo próprio e orçamento de workers

Descartado deliberadamente: Bun, strict TS/TSX, Three.js, React, WebGL2, gameplay, docs/GDD.md, capturas de camera/seed/lighting de jogos, exigência automática de docs inglês/português e skills de marketing, compiladores, e-commerce, multiplayer e SaaS. O Flowral já usa documentação pt-BR. Alguns exemplos das skills do Prumo impõem hardening ACP não especificado como requisito do protocolo: separar contrato do ACP de política de segurança interna e validar versão.

Agentes selecionados (configurados como subagents OpenCode V2)

Agente Origem conceitual Prumo Responsabilidade Modo
flowral-architect systems-architect, technology-decision-agent ADR, limites de dependência, perf/compatibilidade leitura e parecer
flowral-systems systems-architect, devops-engineer Void/runit/XBPS/ISO, boot e reversão proposta e implementação controlada
flowral-wayland renderer-engineer, systems-architect Swirl IPC, Layer Shell, foco e lifecycle implementação controlada
flowral-ui design-system-engineer, ui-component-engineer componentes Rust/Slint, tokens Flower Paper, previews implementação controlada
flowral-ai backend-engineer, security-architect OpenCode V2+, ACP/MCP, providers e secrets implementação controlada
flowral-performance performance-agent PSS/RAM/CPU/frame-time real no E430 revisão e medição
flowral-accessibility accessibility-reviewer teclado, contraste, foco, reduced motion, leitura revisão independente
flowral-security security-reviewer, isolation-auditor comandos privilegiados, rede, auth/lock, supply-chain revisão independente
flowral-reviewer quality-reviewer, reviewer correctness, limites, testes, regressões revisão independente
flowral-release release-verifier ISO BIOS/UEFI, pacotes, checklists e provenance gates de release

Agents próprios não são dez processos permanentes: são perfis opcionais para delegação explícita, não todos chamados a cada feature. Os de revisão são apenas leitura e impedidos de editar/shell pelo frontmatter; permissions não substitui isolamento do host.

Skills selecionadas

Skill Derivada de conceitos Prumo Quando usar
flowral-rust lang-rust, clean-code, error-handling code/crates Rust e adapters
flowral-void systems-architect + release-engineering + containers pacotes XBPS, runit, ISO e serviços
flowral-wayland desktop-security, surface-protocol-conformance IPC Swirl, Layer Shell, lifecycle/foco
flowral-slint ui-implementation, design-tokens, visual-qa UI, tokens, 6 temas e preview
flowral-accessibility accessibility, cognitive-clarity, keyboard-accessibility testes de interface e navegação
flowral-performance performance-native, benchmarking PSS/CPU/responsividade/energia no E430
flowral-security desktop-security, process-execution-security, secrets-security segurança de GUI/DBus/polkit/lock
flowral-agent-protocols acp-security, mcp-security, surface-protocol-conformance adapters OpenCode V2 e ACP/MCP
flowral-preview visual-regression, testing-quality Slint MCP, vm/virsh, screenshots reais
flowral-release release-engineering, ci-cd, supply-chain-security release ISO, boot, hashes e rollback
flowral-docs documentation, grounded-implementation, lean-progressive-context docs e atualização de roadmap/ADRs

Skill não é biblioteca de runtime nem pacote da ISO. Ela descreve como executar uma tarefa de desenvolvimento.

Receitas mínimas

Receita Especialistas Ordem
UI Slint ui → accessibility → reviewer contrato → componente → preview/screenshot → revisão
Mudança de sistema systems/wayland → security → reviewer baseline VM → alteração → rollback → teste
Integração IA ai → security → reviewer schema → mock → validação → teste
Release systems → performance → security/release build ISO → boots → auditar → publicar apenas com autorização

Mapa para agentes

  • Principal: o agente atual OpenCode/Claude/Codex controla a tarefa. Os perfis flowral-* são subagents opcionais. Limitar a profundidade a um nível quando possível; evitar fanout sem necessidade.
  • Implementador não se autoaprova. Reviewer distinto verifica diff e artefatos, mas não se deve afirmar independência humana só por usar um segundo modelo.
  • Handoff contém objetivo, commit/diff, arquivos tocados, testes pass/fail/not run/blocked, riscos e próximo passo; dados sensíveis são redigidos.
  • Nenhuma aprovação silenciosa de sudo, mudança de boot/partition, push/release ou credenciais.
  • OpenCode V2 não equivale a ACP V2.

Compatibilidade e referências

Formato de agentes verificado em OpenCode V2 Agents: .opencode/agents/*.md com frontmatter description, mode: subagent e permissions quando necessárias. Formato de skills: OpenCode V2 Skills: .opencode/skills/<name>/SKILL.md com name e description. Não escolher modelo/provedor hardcoded por agente.

Diretório de referência Prumo: src/prumo/resources/workforce/ (agents, skills, recipes). As skills originais têm escopo genérico e não foram copiadas integralmente; scripts e templates de Prumo não são dependências do Flowral. Atualizar estes documentos quando o projeto efetivamente implementar novos binários ou fluxo de testes.