Boas Práticas de Projetos e Artefatos

Dez hábitos práticos para obter valor real e duradouro de Projetos e Artefatos, em vez de configurar um uma vez e deixá-lo se tornar gradualmente algo menos útil.

Como Usar Esta Lista

• Trate os hábitos de Projeto (A) como manutenção contínua, não como uma tarefa de configuração única.
• Trate os hábitos de Artefato (B) como hábitos a serem aplicados toda vez que você estiver prestes a solicitar algo substancial.
• Volte ao grupo A periodicamente - Projetos tendem a se desviar gradualmente, não de uma vez só.
• Adapte estas práticas ao seu próprio fluxo de trabalho; o que importa é que o escopo, as instruções e as solicitações de edição permaneçam específicos.

A - Mantendo Projetos Organizados

• Escopo de cada Projeto em torno de um único propósito estável. Nomeie-o com base na tarefa específica e no público que ele atende, não em uma categoria ampla, para que seja óbvio mais tarde se um novo trabalho ainda pertence a ele.
• Escreva instruções personalizadas como regras verificáveis, não como conselhos gerais. "Menos de 150 palavras, um próximo passo claro" se sustenta melhor ao longo do tempo do que "mantenha a concisão".
• Faça upload apenas de arquivos que atendam a uma necessidade real e recorrente. Comece pequeno e adicione arquivos à medida que lacunas reais surgirem em conversas de teste, em vez de fazer upload de tudo que parece potencialmente relevante.
• Revise o escopo de um Projeto quando suas instruções começarem a precisar de exceções. Cláusulas frequentes como "a menos que seja sobre X" geralmente são um sinal de que o Projeto está cobrindo mais de um propósito real.
• Divida um Projeto em vez de deixá-lo se expandir. Quando dois públicos ou conjuntos de regras distintos se infiltraram em um Projeto, separe-os em seus próprios Projetos em vez de continuar corrigindo um compartilhado.

B - Mantendo Artefatos Fáceis de Revisar e Compartilhar

• Reserve Artefatos para entregas genuínas, não para cada resposta longa. Uma saída substancial que você provavelmente revisará pertence a um Artefato; uma longa explicação que você lerá uma vez geralmente está bem no chat.
• Faça solicitações de edição específicas e com escopo definido. Nomear a seção, linha ou parte exata a ser alterada produz uma revisão direcionada; uma solicitação vaga como "melhore isso" corre o risco de uma reescrita mais ampla do que você pretendia.
• Declare o que deve permanecer o mesmo, não apenas o que deve mudar. Isso é mais importante à medida que um Artefato cresce em extensão ou complexidade, onde uma edição sem escopo tem mais espaço para se propagar.
• Use o histórico de versões como parte normal da iteração, não como último recurso. Voltar a uma versão anterior e refazer a solicitação com um pedido mais específico é um movimento rotineiro, não um sinal de que algo deu errado.
• Inicie um novo Artefato quando a solicitação for realmente uma nova entrega. Dobrar uma saída nova e não relacionada na história de edição de um Artefato existente torna ambos mais difíceis de seguir posteriormente.

FAQs

Qual grupo de práticas é mais importante quando estou apenas começando?

O Grupo A primeiro. Um Projeto bem escopado torna todas as conversas dentro dele melhores desde o início, enquanto os hábitos de Artefato só importam quando você está produzindo saídas substanciais para revisar.

Com que frequência devo revisitar a configuração de um Projeto?

Não há uma programação fixa, mas revise-o sempre que as instruções personalizadas começarem a precisar de exceções frequentes, ou sempre que o uso real do Projeto parecer ter se desviado de seu propósito original.

Qual é o maior erro que as pessoas cometem com Projetos?

Deixar o escopo aumentar gradualmente - adicionando uma instrução a mais ou um arquivo a mais por vez até que um Projeto antes restrito cubra vários propósitos não relacionados e produza respostas menos consistentes.

Qual é o maior erro que as pessoas cometem com Artefatos?

Fazer solicitações de edição vagas. Uma instrução geral como "aprimore isso" tende a produzir uma revisão mais ampla e menos previsível do que uma específica que nomeia a parte exata a ser alterada.

Todo Projeto deve ter arquivos de conhecimento carregados?

Não. Alguns Projetos dependem apenas de tom e regras de comportamento e não precisam de arquivos de referência. Faça upload apenas de arquivos que atendam a uma necessidade real e recorrente para aquele Projeto específico.

É ruim reverter um Artefato para uma versão anterior?

Não, é uma parte normal da iteração. Reverter e refazer a solicitação com um pedido mais escopado é uma maneira rotineira de se recuperar de uma revisão que foi mais longe do que o pretendido.

Como sei se um Projeto se tornou muito amplo?

Observe as instruções que precisam de exceções frequentes, arquivos que se aplicam apenas a algumas conversas, ou respostas que parecem que poderiam ter vindo de um chat simples sem nenhum contexto de Projeto.

Dividir um Projeto em menores cria trabalho extra?

Algum overhead de configuração, sim, mas geralmente compensa em respostas mais consistentes e específicas em comparação com um único Projeto amplo tentando servir a múltiplos propósitos ao mesmo tempo.

Por que a lista recomenda dizer o que deve permanecer o mesmo em uma solicitação de edição?

Porque solicitações de edição sem escopo têm mais espaço para se propagar para partes do Artefato que você não pretendia tocar, especialmente à medida que o Artefato cresce em extensão ou complexidade.

Quando devo criar um novo Artefato em vez de continuar editando o atual?

Quando a nova solicitação for realmente uma entrega diferente, não uma revisão da existente. Manter saídas não relacionadas na mesma história de Artefato torna ambos mais difíceis de seguir.

Relacionado

• O que Torna um Bom Projeto: Escopo e Contexto Compartilhado - o raciocínio por trás do grupo A.
• Editando e Iterando em um Artefato - o raciocínio por trás do grupo B.
• Checklist de Configuração de Projeto: Instruções, Arquivos e Escopo - um checklist passo a passo para configurar um novo Projeto.
• Projetos e Artefatos: Duas Maneiras de Organizar o Trabalho com Claude - a distinção fundamental em que ambos os grupos se baseiam.

Versões da Stack: Escrito contra a linha de modelos Claude atual em aproximadamente Junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão), e Claude Haiku 4.5. Nomes de modelos, preços e recursos de produtos mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.