Projeto Existente
Como adicionar o harness a um projeto que já existe.
Passo 1: Auditar
/harness-init
O inicializador inspeciona o projeto sem escrever arquivos. Ele descobre:
- Instruções existentes.
- Estado de progresso atual.
- Comandos de verificação e startup.
- Stack do projeto.
O resultado é um gap report — o que existe, o que falta.
Passo 2: Instalar o mínimo viável
Para projetos pequenos, o mínimo útil e:
| Artefato | Por que existe |
|---|---|
AGENTS.md curto | Regras, entry points e segurança |
feature_list.json ou tasks.md | WIP e próximas unidades |
| Arquivo de progresso | Blockers e próxima ação |
| Comando de verificação | Baseline objetivo |
session-handoff.md | Retomar em outro dia |
Passo 3: Ou instalar o pacote completo
/harness-bootstrap
O bootstrap propõe o pacote full com confirmação. Ele detecta a stack, descobre como verificar o projeto e mostra cada arquivo como create, merge ou skip.
Passo 4: Primeira sessão com harness
- Rode o comando de verificação descoberto.
- Se falhar, registre o erro antes de criar features.
- Preencha ou revise a lista de features.
- Garanta WIP=1.
- Comece toda sessão com
/harness-session-start.
Adicione o restante dos artefatos apenas quando um failure mode real for observado — não crie burocracia sem necessidade.