Um bom alinhamento habilita uma boa execução.
O handbook é um conjunto de padrões e práticas de desenvolvimento que uso em meus projetos pessoais. Estes padrões e práticas são baseados na minha experiência pessoal.
O handbook é importante para desenvolver e entregar software com velocidade e qualidade. O handbook também é importante para alinhar humanos e agentes de IA, para um ambiente de desenvolvimento acelerado com IA produtivo e seguro (Harness).
O handbook é estruturado como páginas organizadas em grupos, usando esta estrutura:
handbook/
<group-name>/
page-title.md
<group-name>/
page-title.md
Cada grupo é um diretório que pode conter páginas ou outros grupos.
Cada página é um arquivo Markdown, estruturado como:
# TÍTULO DA PÁGINA
## O Que
Descrição do assunto, em dois ou três parágrafos.
## Por Que
Importância do assunto, em dois ou três parágrafos.
## Como
Descrição do assunto, usando quantos parágrafos forem necessários. Podem ser organizados em seções específicas.Este handbook foi inspirado no Handbook do GitLab.