Pitch: Orkas — do briefing de um app a um escopo revisável
Antes de pedir código à IA, separe requisitos, propostas e dúvidas do briefing.
O Orkas é um workspace de IA para desktop, de código aberto e local-first. O Commander coordena agentes especialistas em torno dos arquivos do projeto: neste exemplo, o ProductDeveloper organiza o escopo e o ContentWriter redige a especificação. Você pode conectar provedores de modelos compatíveis com suas próprias chaves de API ou escolher modelos gerenciados pelo Orkas.
Entrada: três pedidos para um app de notas
A. As notas continuam sendo arquivos Markdown em uma pasta escolhida pelo usuário.
B. Preciso abrir, editar, salvar e buscar uma palavra sem depender de internet.
C. Gostaria de etiquetas e sincronização. Há uma pessoa e cinco dias para o primeiro ciclo; nenhum serviço de sincronização foi escolhido.
Exemplo e saída fictícios, sem implementação ou execução medida no Orkas. O requisito sem rede é do app imaginado, não dos modelos usados no Orkas.
Pedido ao Commander
Use somente os três registros. Com o ProductDeveloper, separe requisitos, propostas técnicas e perguntas em aberto; com o ContentWriter, prepare uma especificação curta e uma mensagem de alinhamento. Preserve Markdown. Não invente integrações, respostas ou estimativas. Não altere arquivos nem implemente código nesta etapa.
Saída ilustrativa completa
Objetivo: editar e encontrar notas Markdown locais. Recorte proposto, ainda não aprovado.
| Item | Recorte proposto | Decisão pendente |
|---|---|---|
| Arquivos | Abrir uma nota na pasta escolhida; não varrer outras pastas. | Confirmar quais arquivos podem ser acessados. |
| Edição | Editar e salvar no arquivo selecionado. | Salvamento explícito é aceitável ou precisa ser automático? |
| Busca | Buscar texto sem modelo remoto. | Deve ignorar maiúsculas e acentos? |
| Etiquetas | Adiar neste ciclo. | Escolher onde armazená-las sem perder a portabilidade. |
| Sincronização | Adiar neste ciclo. | Definir serviço, autenticação e política de conflitos. |
Restrições propostas: não sobrescrever silenciosamente alterações externas; informar falhas de gravação e preservar o texto. Concorrência e gravação segura exigem desenho e revisão no código. Esta especificação não prova implementação.
Mensagem para alinhar o trabalho:
O recorte cobre abrir, editar, salvar e buscar texto em notas Markdown locais. Etiquetas e sincronização dependem de decisões de formato e serviço. Salvamento explícito e busca simples são propostas a confirmar. Precisamos avaliar o esforço antes de assumir o prazo de cinco dias.
A entrega distingue pedido, proposta e dúvida. O prazo não está garantido; confira cada decisão antes de pedir código.
Reutilizar o contexto sem perder as ressalvas
No projeto, guarde briefing, especificação e decisões aprovadas. Instruções, memória, Library e Skills ajudam a reutilizar contexto e critérios; registre mudanças de escopo.
O código desktop é MIT e público. Arquivos e resultados ficam locais por padrão; chamadas a modelos remotos enviam o conteúdo necessário ao provedor escolhido. Comece com material sem dados sensíveis e ajuste as permissões ao trabalho.
O núcleo é gratuito; modelos e serviços opcionais podem gerar custos. Há instaladores para macOS e Windows; no Linux, a documentação descreve execução a partir do código-fonte em ambientes compatíveis. Confira o README.
Comece com um briefing conhecido: confira cada frase e resolva as dúvidas antes de pedir código.
Divulgação: apresentação do Orkas preparada com assistência de IA para sua divulgação. Exemplo e saídas ilustrativos.