Como uma criança que é inteligente, mas não entende as práticas recomendadas de código.
Você precisa dizer claramente à IA o que deseja:
- É um aplicativo da Web?
- Quais são os recursos necessários?
- Qual é a estrutura?
E assim por diante.
Veja como fazer da IA seu desenvolvedor full-stack:
O contexto é crucial!
Você precisa de uma forte barreira contextual para a IA.
Objetivo: não permitir que a IA faça suposições. Todas as informações são fornecidas por você.
Dessa forma, a IA trabalhará com você, e não contra você.
Em seguida, discute a documentação que precisa ser anexada para fornecer o máximo de suporte contextual.
1. documento de requisitos do projeto
Este documento descreve o projeto como um todo:
- Perfil do projeto
- Declaração do problema
- prescrição
- usuário-alvo
- pilha de tecnologia
- funcionalidade principal
- Escopo do trabalho
Este documento é uma breve descrição de seu projeto.
Em seguida, adicione uma documentação mais específica para orientar a IA em cada etapa.
2. documentação do processo e da funcionalidade do aplicativo
Imagine que você está explicando seu aplicativo a um amigo:
"Quando um usuário se registra, ele acessa o painel. No painel, há 4 seções: seção de métricas, seção de análise, etc."
Este documento fornece o fluxo completo de tempo de execução de ponta a ponta do aplicativo.
chamar a atenção para algoA IA é solicitada a incluir no documento Não use balas.
Esse documento é importante porque fornece à IA um diagrama/plano para planejar a execução de cada página.
3. documentação da pilha de tecnologia e do pacote de dependências
Agora, fornecendo a base técnica para a IA.
Seu projeto usa Python? ou Nextjs? Supabase ou Firebase para o back-end?
Este documento detalhará a pilha de tecnologia que a IA precisa usar para criar seu aplicativo.
Certifique-se de escolher uma pilha de tecnologia comumente usada, porque coisas como Claude e LLMs como o GPT-4 são treinados principalmente com base em estruturas amplamente utilizadas.
Estou usando Nextjs 14, TaliwindCSS, shadcnUI e radixUI para o frontend e Supabase para o backend.
Todas as plataformas a seguir preferem essa pilha de tecnologia:
O Python também é excelente para aplicativos de alto desempenho que não exigem uma interface de usuário moderna.
4. documentação da estrutura do documento
Esse documento é vital se você não quiser entrar em um ciclo vicioso de erros constantes.
A IA pode criar arquivos duplicados, salvar arquivos no local errado ou até mesmo excluir códigos concluídos.
Para resolver esse problema, forneça a estrutura do documento com antecedência.
chamar a atenção para algoVerifique se a IA é necessária para criar a estrutura do arquivo no formato ASCII.
Faça uma captura de tela para salvar a estrutura do arquivo e anexe-a ao documento.
5. documentação da API
A IA não sabe, por padrão, como as APIs de qualquer plataforma estão configuradas.
Precisamos anexar a documentação de todas as APIs que serão usadas no aplicativo.
Os exemplos incluem a API do OpenAI, a documentação da API do Claude, a documentação do Supabase, etc.
Copie as instruções do site deles e cole-as em seu documento e, em seguida, anexe esse documento ao AI.
6. documentação do projeto de arquitetura de back-end
A arquitetura é basicamente seu projeto de back-end.
Ele contém todas as tabelas de banco de dados, buckets de armazenamento e tabelas de informações do usuário (autenticação) que precisam ser criadas.
Eu uso o Supabase porque a IA é capaz de gerar consultas SQL que você pode executar diretamente no Supabase em segundos.
Fazendo isso, posso criar meu banco de dados e anexá-lo ao front end em menos de uma hora.
ponto brilhanteClaude é excelente em projetar arquiteturas de back-end e, se você criar a documentação correta, a IA seguirá facilmente as orientações.
7. arquivo .cursorrules
Muitas pessoas não usam essa ferramenta. Ela é semelhante à ChatGPT de comandos personalizados.
O arquivo .cursorrules precisa ser específico do projeto, em vez de um prompt genérico de "regras de IA".
Dependendo da pilha de tecnologia e dos requisitos do projeto, a IA é solicitada a criar um arquivo .cursorrules.
Esse documento informará à IA onde cada documento está localizado (mapa de navegação do Cursor).
Ajude a IA a navegar de forma mais eficiente com esse arquivo.
8. documentação do layout da interface do usuário
Este documento tornará sua interface de front-end mais agradável esteticamente. Quando usado com a v0, ele cria componentes de front-end com um estilo consistente.
A maioria das pessoas subestima o poder de uma interface de usuário (UI) limpa.
"As primeiras impressões são importantes."
Esse documento deve conter as seguintes informações: pacotes de interface do usuário usados, fontes, esquemas de cores, ícones, efeitos e assim por diante.
9. pistas do sistema
A IA pode ser solicitada a criar palavras de prompt do sistema específicas do projeto para v0, bolt ou qualquer ferramenta que você possa usar.
Isso ajuda a se comunicar com a ferramenta e elimina a necessidade de fornecer um contexto mais longo a cada vez.
Você sabe por que o Claude tem um desempenho melhor em sua plataforma do que por meio do uso da API? É porque as dicas do sistema são excelentes.
Faça o mesmo com seu projeto e você se tornará melhor amigo da IA.
Gastei 80% do meu tempo de desenvolvimento criando a documentação e obtive ótimos resultados nos 20% restantes.
Introdução: codeguide.dev
Um aplicativo que ajuda você a fazer um brainstorming e escrever todos os documentos importantes para anexar à IA.
Palavra de alerta do sistema
Documento PRD
Projeto arquitetônico
Documentação do processo de solicitação
Documentação do layout da interface do usuário
Espere um pouco!
link (em um site)::http://codeguide.dev
