Doc Harness: Uma Habilidade de Código do Claude para Manter o Estado do Projeto Entre Sessões

Doc Harness é uma habilidade do Claude Code projetada para resolver o problema de agentes de IA perderem o controle do estado do projeto durante sessões de trabalho de longa duração. Ele cria um sistema de documentação leve dentro da pasta do seu projeto que qualquer agente pode ler para entender o status do projeto, seguir regras estabelecidas e continuar o trabalho de forma contínua.

O Que Ele Resolve

A ferramenta aborda problemas comuns ao usar o Claude Code em projetos que abrangem várias sessões: redefinições de contexto onde os agentes esquecem o trabalho recente, dificuldade em navegar por projetos com 30+ arquivos, esquecimento gradual de regras estabelecidas (como "sempre teste antes de fazer commit") e a necessidade de gastar 20+ minutos reexplicando projetos para novos agentes.

Como Funciona

Doc Harness mantém cinco arquivos estruturados na pasta do seu projeto. O arquivo principal é CURRENT_STATUS.md, que usa uma estrutura de "carro em movimento":

• Histórico recente (onde você esteve)
• Detalhe do trabalho atual (onde você está)
• Próximos passos (para onde você vai)
• Princípios de trabalho (como dirigir)

Quando uma fase de trabalho termina, os detalhes são arquivados permanentemente e o status é limpo para a próxima fase.

Comandos

A habilidade fornece dois comandos principais:

• /doc-harness init - Cria cinco documentos personalizados para o seu projeto
• /doc-harness check - Audita a saúde da documentação (verifica se os arquivos estão registrados e se o status está atualizado) e lê as regras do projeto de volta para o agente, solicitando reflexão sobre se as regras estão sendo seguidas

Princípio Central

A ferramenta opera com o princípio "Anote ou Perde" - reconhecendo que o contexto de IA é temporário enquanto os arquivos são permanentes. Cada resultado, decisão ou insight importante deve ser salvo em um arquivo e registrado no índice.

Instalação

git clone https://github.com/cilidinezy-commits/doc-harness.git
cp -r doc-harness/skill ~/.claude/skills/doc-harness

Após a instalação, você pode dizer ao seu agente "configurar documentação do projeto" sem precisar de comandos de barra se preferir linguagem natural.

Compatibilidade

Funciona para qualquer tipo de projeto, incluindo artigos de pesquisa, recursos SaaS, análise de dados, artigos, bibliotecas de software e qualquer coisa que abranja várias sessões. Versões em inglês e chinês estão incluídas, e a ferramenta é lançada sob licença MIT.