Comece agora
Da ideia a um time entregando sob o H1VE.
Duas camadas. Primeiro o método — o que fazer, com ou sem ferramenta. Depois a plataforma de referência — como operá-lo de verdade, pelo painel, pela CLI ou pela sua IA.
O H1VE é um método, não uma ferramenta. Estes passos valem seja qual for a ferramenta que você use — descrevem como um time de humanos e agentes de IA trabalha sob o H1VE. A Camada 2 mostra como torná-lo concreto com a plataforma de referência.
- 1
Desenhe o projeto em uma folha
Antes de qualquer código, o founder e o arquiteto preenchem o H1VE Canvas — problema, visão, usuários, escopo, time, fundação técnica, primeiras fatias, gates, riscos. Uma sentada, uma folha.
Por quê
O canvas é a semente. Dele nascem os quatro documentos de fundação — visão, especificação funcional, especificação técnica e roadmap.
- 2
Escreva os documentos de fundação
Expanda o canvas nos quatro documentos que definem o projeto, com a IA como parceira de escrita. Este é o bolo; toda spec seguinte é uma fatia.
- Visão & Escopo — por que existe, para quem, os limites
- Especificação Funcional — o que faz, na visão do usuário
- Especificação Técnica — como é construído: stack, dados, decisões
- Roadmap — o escopo fatiado em fases
- 3
Defina o time e os papéis
Atribua os cinco papéis: founder, arquiteto, dev, QA, data. Num time pequeno uma pessoa pode acumular vários chapéus — mas as responsabilidades nunca se fundem. Um revisor nunca valida sozinho o próprio trabalho.
- 4
Fatie a primeira spec do roadmap
Pegue o primeiro item do roadmap e transforme em SPEC-001 — escopo, arquivos tocados, critérios de aceite, riscos. A IA ajuda a redigir; um humano aprova. Sem código sem uma spec aprovada.
- 5
Rode pelo ciclo
O dev constrói com a IA, só dentro da spec. Depois o trabalho flui pelos gates:
- CI — confere a mecânica — tipos, lint, testes
- QA e Data — validam de forma independente — ambos precisam assinar
- O arquiteto — faz o merge final — o único que pode
O loop
Quando a feature chega na main, está no ar. Fatie a próxima spec. Repita. A fundação é feita uma vez; o ciclo se repete por feature.
O método precisa de um lugar para viver. O H1VE é neutro em relação à ferramenta, mas uma implementação de referência torna o ciclo e os gates reais. A plataforma de referência — o H1VE Flow — dá três formas de trabalhar, escolhidas por onde você está, não por preferência. Todas agem no mesmo projeto.
A plataforma de referência · três interfaces
A plataforma — para gestão & visibilidade
O painel web é a casa do método. A swim lane mostra cada feature pelos nove estágios em tempo real. Founders criam e atribuem features, aprovam specs e acompanham os gates. QA e Data assinam aqui. O arquiteto revisa e faz o merge.
É aqui que você vê o sistema inteiro — blockers, a fila do arquiteto, métricas de saúde técnica, a caixa de entrada do que cada papel deve.
Use quando
Você está gerindo o time, aprovando specs, assinando, ou quer a visão de cima de onde tudo está.
A CLI — para devs, no terminal
A ferramenta de linha de comando nf deixa o dev operar o H1VE sem sair do terminal. Ela detecta a branch git atual e encontra a feature correspondente — sua spec, estágio e blockers ativos — automaticamente.
# veja seu trabalho atribuído e a feature atualnf status # inicie uma feature — cria a branch, vinculanf start # registre um blocker sem quebrar o fluxonf blocker "esperando as API keys" # submeta a AI declaration e mova p/ PRnf doneUse quando
Você é dev, imerso no terminal, e quer tocar o trabalho sem trocar de contexto para o painel.
O MCP-Server — para o seu agente de IA
O MCP-Server conecta o seu agente de IA diretamente ao fluxo do H1VE. Por ele, o agente vê a feature atual — spec, estágio, blockers — e pode agir: mover um estágio, registrar um blocker, submeter a AI declaration, tudo de dentro da sua conversa com ele. Sem copiar e colar contexto.
# dentro do seu agente de IA, com o MCP-Server conectado:Você: qual é a feature atual e a spec dela?Agente: lê a branch → retorna SPEC-014, estágio dev, sem blockers ativos. Você: terminei — submeta a declaration.Agente: escreve a AI declaration, move p/ PR.Use quando
Você trabalha lado a lado com o seu agente de IA e quer que ele opere o fluxo com você — o loop mais apertado entre construir e rastrear.
Um projeto, três portas
Painel, CLI e MCP agem sobre os mesmos dados, pelas mesmas regras. Um dev pode iniciar uma feature na CLI, a IA pode movê-la pelo MCP, e o founder a vê ao vivo no painel — na hora. Escolha a porta mais perto de onde você já está.
Pronto para construir do jeito H1VE?
Comece pelo canvas e pelo playbook. Depois rode sua primeira fatia pelo ciclo.