Utilizando harness em sua empresa
Vou mostrar como transformar os modelos, agentes, habilidades e automações presentes nas ferramentas e fluxos de trabalho da sua equipe em um sistema coordenado.
O que a maioria das equipes tem hoje é bem diferente. Seus modelos, habilidades e automações estão em ferramentas separadas, conversas privadas e configurações individuais.
Cada pessoa precisa ensinar à sua IA o que sabe e como funciona. O contexto, as correções e os fluxos de trabalho que elas criam raramente chegam a outras pessoas.
Uma pessoa informa Claude sobre a estratégia mais recente. Outra pede ao Codex para pesquisar em uma pasta antiga. Uma terceira reconstrói um fluxo de trabalho útil de memória. Cada conversa contém uma versão ligeiramente diferente do assunto.
Criamos essa camada compartilhada com a sede. Ela fica abaixo do Claude Code, Codex, Cursor ou qualquer outro modelo de código aberto que sua equipe escolher, transportando o contexto e as funcionalidades da empresa entre eles.
Vamos construir um.
Começaremos com um funcionário de inteligência semanal que chega na segunda-feira já sabendo o que mudou: quais decisões foram tomadas, quais projetos foram alterados, quais riscos aumentaram e quais foram os próximos passos da equipe.
Ao final, sua equipe terá:
- Um único local onde cada agente pode obter o contexto atual da empresa;
- regras operacionais que sobrevivem a novos chats e mudanças de modelo;
- um trabalhador de inteligência semanal que qualquer membro da equipe pode executar;
- Habilidades compartilhadas e automações que melhoram à medida que a equipe as utiliza;
- Um ciclo de revisão e sincronização que transforma a melhoria de uma pessoa no novo ponto de partida da equipe.
Não comece mapeando a empresa inteira. Teste a estrutura em um fluxo de trabalho repetível e, em seguida, expanda-a cada vez que a equipe encontrar outro processo que valha a pena compartilhar.
1. Construir o ambiente em torno do modelo
Um modelo pode raciocinar, escrever e chamar ferramentas. Ele ainda precisa de um ambiente que explique como o trabalho acontece dentro da sua empresa.
Um harness útil responde a cinco perguntas:
- O que a IA sabe?
- Como ele encontra o contexto relevante?
- Quais regras deve seguir?
- Que tipo de trabalho repetitivo ele pode executar?
- De que forma cada execução melhora a seguinte?
Um prompt de sistema extenso pode responder a algumas dessas perguntas em uma sessão. Uma interface corporativa torna as respostas estruturadas, persistentes e acessíveis a todos.
O conhecimento é pesquisável. As regras sobrevivem ao chat. As ferramentas têm limites. O trabalho deixa vestígios. Os fluxos de trabalho aceitos tornam-se reutilizáveis em vez de desaparecerem quando a conversa termina.
É por isso que o mesmo modelo pode parecer completamente diferente em duas empresas diferentes. O modelo pode ser idêntico, mas o ambiente de trabalho não.
O modelo fornece a inteligência. O sistema fornece a empresa.
2. Teste o dispositivo em um fluxo de trabalho real.
Tentar modelar a empresa inteira primeiro pode resultar em semanas de contexto organizado, mas sem nenhuma prova de que a ferramenta melhora uma única tarefa específica.
Comece com um fluxo de trabalho que tenha quatro propriedades:
- Isso acontece com frequência;
- Os limites são claros;
- Depende do contexto da empresa;
- Um ser humano consegue avaliar o resultado rapidamente.
- Um resumo semanal de informações sobre a empresa é adequado.
As informações já existem, mas estão dispersas em atas de reuniões, arquivos de projetos, decisões e na cabeça das pessoas. O resultado é útil para toda a equipe, e um fundador pode rapidamente verificar se o briefing está correto.
Defina o contrato antes de criar o trabalhador.
Entradas
- reuniões dos últimos 7 dias
- Estado atual do projeto
- decisões, compromissos e questões em aberto
- riscos e trabalho bloqueado
- Processo
- recuperar as fontes relevantes
- Verifique cada afirmação factual.
- Contradições superficiais e informações faltantes
- sintetizar as mudanças a nível da empresa
- Saída
- decisões tomadas
- progresso por projeto
riscos e obstáculos
Compromissos para a próxima semana
lista de fontes
Limite
apenas rascunho
Parar para revisão humana antes da distribuição
Se o fluxo de trabalho ainda muda a cada execução, mantenha-o manual. Um processo deve se tornar repetível antes de se tornar infraestrutura compartilhada.
3. Forneça à IA uma memória empresarial duradoura.
Comece com a configuração guiada atual do HQ. Instale o HQ, crie o espaço de trabalho da empresa e abra o HQ como o diretório de trabalho ativo na ferramenta de IA que sua equipe já utiliza.
O guia de início rápido de código aberto consiste em um único comando:
npx criar-hq
Agora, adicione apenas o contexto necessário para o resumo semanal.
Comece com esta estrutura:
sede
empresas
sua-empresa
company-breef.md
conhecimento: decisões e planos de ação
fontes: reuniões
sinais
pessoas
projetos
políticas: inteligência-semanal.md
trabalhadores: inteligência semanal
Comece por aqui e adicione conhecimento mais aprofundado, habilidades, automações e funcionários específicos da empresa somente quando um fluxo de trabalho real assim o exigir.
O resumo da empresa explica o que a empresa faz, como gera receita e o que é importante no momento. Os projetos refletem o estado atual da empresa. As decisões documentam o motivo pelo qual a equipe escolheu determinado caminho. Os arquivos de pessoas tornam a responsabilidade visível.
A inteligência de reuniões registra os compromissos, riscos, dúvidas e decisões que nunca chegaram a ser incluídos em um documento finalizado.
Não inclua a empresa inteira em todas as solicitações. A carta constitutiva da sede fornece ao agente um mapa de onde o conhecimento, as políticas, os projetos e os funcionários estão localizados. O agente segue esse mapa e recupera a fonte mais detalhada necessária para a tarefa.
Forneça ao agente um ponto de entrada pequeno e estável, e um contexto mais aprofundado sob demanda.
Isso mantém a memória da empresa disponível sem consumir a janela de contexto antes do início do trabalho.
4. Transformar o julgamento da empresa em política
O conhecimento informa ao trabalhador o que aconteceu. A política informa como a sua empresa espera que o trabalho seja realizado.
Crie o arquivo companies/your-company/policies/weekly-intelligence.md:
Política de inteligência semanal
Justifique cada afirmação factual com uma fonte.
Apresente evidências contraditórias. Nunca as resolva em silêncio.
O relatório de riscos utiliza o nível de urgência original da fonte.
Identifique informações ausentes, desatualizadas ou incertas.
Nunca inclua segredos ou contexto interempresarial.
Aguarde a aprovação humana antes da distribuição.
Mantenha a primeira política curta o suficiente para que as pessoas a cumpram.
Existem três níveis de controle:
Uma instrução pede ao agente que siga uma preferência.
Uma política torna a regra duradoura ao longo das sessões e entre diferentes pessoas.
Um gancho ou dispositivo de retenção mecânica bloqueia a ação quando uma falha seria custosa.
“Cite suas fontes” pode começar como política. “Nunca envie sem aprovação” merece ser aplicado nos limites da ação.
Não tente descrever todos os comportamentos possíveis. Codifique as poucas invariantes que devem sobreviver a todos os modelos, membros da equipe e projetos.
5. Empacote o fluxo de trabalho como um trabalhador compartilhado.
Agora, transforme o procedimento aceito em um recurso reutilizável da sede.
Execute o comando /newworker e atribua a ele uma tarefa específica. Um analista geral da empresa parece útil, mas é difícil de testar e fácil de usar incorretamente. Um worker de inteligência semanal tem entradas, saídas e condições de parada bem definidas.
Descrição da vaga:
Nome: inteligência-semanal
Objetivo: Elaborar um relatório semanal da empresa, com fontes confiáveis, para revisão humana.
Fontes permitidas
Resumo da empresa
reuniões dos últimos 7 dias
projetos atuais
decisões e compromissos
Procedimento
Confirme o período de reporte.
Recupere as fontes permitidas.
Extrair informações sobre decisões, progresso, riscos e compromissos.
Verificar as afirmações comparando-as com o material original.
Sinalize contradições, lacunas e informações desatualizadas.
Redija o resumo no formato exigido.
Saída necessária
sumário executivo
decisões tomadas
movimento de projeto
riscos e obstáculos
compromissos da próxima semana
questões não resolvidas
lista de fontes
Nunca
inventar fatos faltantes
Leia o contexto de outra empresa
expor segredos
enviar ou publicar o briefing
Concluído quando: Todas as afirmações forem comprovadas ou classificadas como incertas, e a versão preliminar estiver pronta para revisão humana.
O conhecimento da empresa fornece os fatos. A política fornece o julgamento. O trabalhador fornece a sequência repetível.
Uma única sugestão pode gerar um relatório útil. Um colaborador disponibiliza o método para outro membro da equipe na próxima sexta-feira.
6. Faça com que cada correção melhore o arnês.
Não considere a primeira execução bem-sucedida como infraestrutura finalizada.
Execute o processo, revise o briefing e diagnostique cada correção na camada apropriada.
Informação em falta → Melhorar o conhecimento da empresa.
Contexto incorreto → Melhore o roteamento e as descrições dos recursos.
Erro repetido → Aprimorar a habilidade do trabalhador.
Comportamento inseguro → Melhore a política ou o mecanismo de defesa.
Entregável fraco → Melhorar o contrato de produção.
Informação desatualizada → Melhore o conhecimento sobre jardinagem.
Se o funcionário perder uma decisão porque a reunião nunca foi registrada, reescrever o enunciado não resolverá o problema. Melhore o fluxo de conhecimento.
Se continuar a esconder riscos sob atualizações menores, refine o contrato de saída.
Caso alguém solicite a distribuição do documento sem aprovação, reforce a política e o controle de acesso.
A pergunta pertinente é: que parte do ambiente permitiu esse erro?
Corrija essa camada e execute o mesmo exemplo novamente. A correção deverá persistir mesmo após a alteração que a revelou.
É assim que o julgamento humano se consolida. Você ensina o sistema uma vez e, em seguida, disponibiliza o comportamento aprimorado para execuções posteriores, em vez de repetir a correção em conversas privadas.
7. Torne o arnês mais inteligente a cada vez que a equipe o utilizar.
Assim que o briefing, a política e o trabalhador forem aprovados na revisão, execute /hq-sync.
É aqui que o HQ se transforma em multiplayer de IA.
A equipe de vendas pode transformar o gerenciamento de objeções em uma habilidade. O suporte pode codificar regras de escalonamento. A equipe de operações pode aprimorar um relatório. A equipe de engenharia pode adicionar uma etapa de revisão.
Quando cada contribuição passa pela revisão, ela é sincronizada com a plataforma principal e passa a fazer parte da infraestrutura compartilhada da empresa.
O próximo membro da equipe herda o contexto, as regras, as habilidades, os funcionários e as automações que a empresa já comprovou. Ele não precisa do chat ou das instruções originais.
Eles abrem a sede em sua ferramenta de IA preferida e continuam a partir da versão aprimorada.
Este é o ciclo cumulativo da sede: usar a estrutura, aprimorar uma camada, revisá-la, sincronizá-la e elevar o ponto de partida de todos.
O modelo pode ser Claude, Codex, ChatGPT ou um modelo de código aberto. A camada da empresa continua a ficar mais inteligente por baixo dele.
O isolamento da empresa ainda se aplica. A sincronização não deve homogeneizar os tenants, ignorar permissões ou inserir segredos em arquivos compartilhados. Um ambiente compartilhado só funciona quando o limite em torno do que é “compartilhado” permanece explícito.
A aprendizagem compartilhada também aumenta a responsabilidade. Uma instrução deficiente agora pode afetar a todos, portanto, trate a atividade principal como se fosse uma atividade de produção.
Analise cada contribuição antes da sincronização. Mantenha as políticas restritas. Teste os workers com exemplos reais. Use /harness-audit para inspecionar a eficiência do contexto, os controles de qualidade, a persistência, a busca e a segurança à medida que a configuração cresce.
Assim que uma alteração for aprovada na revisão, sincronize-a. Em seguida, escolha o próximo fluxo de trabalho repetível e melhore novamente a linha de base compartilhada.
A progressão completa é:
Memória → contexto → política → trabalhador → revisão → padrão da equipe
Comece com uma tarefa recorrente esta semana. Defina suas entradas, saídas e critérios de aprovação. Execute-a manualmente, corrija-a e, em seguida, transforme o método aprovado em um recurso que sua equipe possa compartilhar.
O modelo estará em constante mudança. A memória, as regras e as melhores práticas de trabalho da sua empresa não devem ser redefinidas com essas mudanças.
Se você deseja construir um sistema de segurança compartilhado para sua própria equipe, pode experimentar o HQ.
Post original: https://x.com/VibeMarketer_/status/2086808854898323774
