Régys Borges da SilveiraLivros
Desenvolvimento & Agentes de IA
Você define as regras. Você verifica o resultado.
Seu Projeto, Suas Regras
Um guia prático de Markdown e skills para agentes de desenvolvimento.
Transforme o conhecimento do seu projeto em instruções claras, skills reutilizáveis e mudanças que você consegue verificar.
Sobre o livro
Uma visão completa da obra.
Seu Projeto, Suas Regras apresenta um percurso para transformar o conhecimento de um repositório em documentos úteis, instruções claras e procedimentos reutilizáveis. O ponto de partida é o cotidiano de quem desenvolve em Delphi, mas o método pode ser adaptado a outras linguagens sem exigir mudança de ambiente.
As sete partes e os 20 capítulos previstos começam com um exercício em um sistema de chamados, passam por Markdown, regras por diretório, contexto e skills, e chegam à implementação, investigação de bugs, testes, refatoração e revisão. O repositório complementar reúne modelos, dados fictícios e oito receitas. Uma referência opcional em JavaScript permite explorar o caso; os procedimentos Delphi orientam a adaptação ao projeto do leitor.
O desafio
Você reconhece esta situação?
O agente altera o código, mas ignora uma regra que só a equipe conhece: o projeto que deve ser compilado, um arquivo que não pode ser editado diretamente ou o teste que demonstra que a mudança funciona. Como tornar esse conhecimento acessível sem repetir tudo a cada pedido?
A proposta do livro
Organize o projeto para orientar e conferir o trabalho do agente.
O percurso previsto começa com uma tarefa pequena e avança pela escrita em Markdown, organização do contexto e criação de skills: procedimentos reutilizáveis que orientam uma tarefa. A proposta é relacionar cada mudança a limites e evidências, mantendo a decisão final com quem conhece o sistema.
“Uma resposta convincente não substitui compilação, teste ou revisão.”
Ao final da leitura, você será capaz de:
✓Escrever instruções em Markdown com critérios verificáveis
✓Mapear o repositório e distribuir regras por projeto e diretório
✓Criar skills com referências, modelos e scripts de apoio
✓Planejar funcionalidades e investigar bugs com limites claros
✓Distinguir resultados esperados de evidências de execução
✓Manter uma biblioteca de procedimentos revisada em equipe
Perguntas que orientam a leitura
As respostas começam com as perguntas certas.
Questões que a obra desenvolve com contexto, critérios e exemplos.
O que deve ficar nas regras do projeto e o que pertence a uma skill?
Como conferir se uma mudança respeitou o contrato da tarefa?
Como adaptar procedimentos entre agentes sem presumir comportamento idêntico?
Por dentro da obra
Uma jornada organizada para você avançar.
Conceitos e aplicações apresentados em uma sequência coerente.
Primeiro resultado e fundamentos
Parta de uma tarefa pequena e compreenda o que um agente lê, decide e executa.
Markdown e critérios
Organize documentos, instruções e condições de aceitação que possam ser conferidas.
Repositório e contexto
Mapeie arquivos, distribua regras e escolha o contexto útil para cada tarefa.
Skills reutilizáveis
Crie e avalie procedimentos com referências, modelos e scripts quando necessários.
Desenvolvimento e verificação
Aplique o percurso a funcionalidades, bugs, testes, refatoração e revisão de mudanças.
Portabilidade e manutenção
Adapte os procedimentos entre ferramentas e mantenha um kit de consulta em equipe.
Conteúdo em preparação
Estrutura prevista da obra
Conheça as 7 partes e os 20 capítulos planejados. Os títulos podem receber ajustes durante a revisão editorial.
Ver capítulos20 capítulos
Parte 1 — Primeiro resultado
- Seu primeiro projeto orientado por regras
- O que o agente lê, decide e executa
Parte 2 — Markdown para orientar agentes
- Markdown que ajuda a trabalhar
- Instruções claras e critérios verificáveis
Parte 3 — O projeto como contexto
- O mapa do seu repositório
- Regras por projeto e por diretório
- Contexto que cabe e continua útil
Parte 4 — Skills na prática
- Sua primeira skill
- Skills com referências, modelos e scripts
- Como testar e melhorar uma skill
Parte 5 — Desenvolvimento no dia a dia
- Entenda um projeto e planeje uma mudança
- Implemente uma funcionalidade com limites claros
- Investigue e corrija bugs
- Crie testes e refatore com segurança
- Revise alterações e mantenha a documentação
Parte 6 — Trabalhando entre ferramentas
- O mesmo fluxo em diferentes agentes
- Uma biblioteca portátil de procedimentos
Parte 7 — Evolução e consulta
- Quando o agente não segue o esperado
- Mantenha suas regras e skills em equipe
- Seu kit de referência para o trabalho
O que torna esta obra diferente
Profundidade para compreender. Clareza para continuar avançando.
Percurso progressivo com um sistema de chamados e dados fictícios
Método adaptável a diferentes linguagens, próximo do cotidiano Delphi
Oito receitas e modelos em repositório público separado
Distinção explícita entre resultado esperado, exemplo e execução observada
Para quem foi escrito
Encontre seu lugar nesta leitura.
Desenvolvedores Delphi e de outras linguagens que trabalham com agentes de IA.
✓ Desenvolvedores Delphi que querem organizar o trabalho com agentes✓ Desenvolvedores de outras linguagens com projetos existentes✓ Equipes que precisam versionar e revisar instruções e skills✓ Profissionais que preferem aprender executando e consultar por tarefa
Antes de começar
O que você precisa para aproveitar a leitura
✓Noções de desenvolvimento de software, terminal e Git
✓Um projeto de exercício ou uma cópia segura do seu repositório
✓JavaScript é uma referência opcional; não é necessário migrar sua aplicação
Uma escolha consciente
Talvez não seja o livro ideal se…
—Quem procura um curso introdutório de programação
—Quem espera que instruções eliminem a necessidade de testes e revisão humana
Próximo lançamento
Receba materiais e novidades sobre Seu Projeto, Suas Regras.
Cadastre-se para acompanhar conteúdos, degustações e novos materiais relacionados à obra.
Próximo lançamento
Seu Projeto, Suas Regras chega em breve.
Os links oficiais serão publicados assim que as edições estiverem disponíveis.
Continue lendo
Outros livros para sua jornada
IA & Produtividade
Não Comece do Zero
Transforme contexto, regras e exemplos em especificações reutilizáveis para criar materiais melhores com IA, sem recomeçar a cada pedido.
Conhecer →
Delphi & IA
SDD em Delphi
Coloque a especificação no centro e use a IA com mais clareza, controle e qualidade técnica.
Conhecer →
Delphi & Agentes de IA
Delphi na Era dos Agentes
Construa a ponte entre seus sistemas Delphi e agentes de IA com MCP, capacidades controladas e aprovação humana.
Conhecer →Instagram · @livrosregys
Acompanhar no Instagram ↗A leitura continua por lá.
Trechos, novidades e bastidores dos livros de Régys. Um espaço para descobrir sua próxima leitura e acompanhar o que está sendo preparado.