Harness SDLC Agêntico e Infraestrutura Self-Hosted
Engenharia de harness — construiu a infraestrutura que constrói software: um pipeline SDLC orquestrado e configuração de self-hosting com acesso duplo no Mac Mini.
Overview
A maioria das demonstrações de engenharia de IA para em "eu dei um prompt a um modelo." Este projeto trata da camada abaixo: o harness que transforma um arquivo de spec em uma feature revisada, commitada e integrada à produção — de forma confiável, repetível e com um humano no loop em cada etapa. O pipeline SDLC é um conjunto de comandos slash estruturados para Claude Code que conduzem o trabalho de spec por uma sequência definida: planejar → decompor → implementar → testar → revisar → documentar → finalizar. Cada fase roda em um worktree git isolado, escreve um relatório com nome previsível, e bloqueia a próxima fase até que a validação passe. Tarefas paralelas rodam em worktrees separados e fazem merge em ordem de dependência. O pipeline está em execução contra specs reais de produção — não é uma demonstração. A camada de self-hosting complementa o pipeline: um Mac Mini atua como servidor de duas faces. O Cloudflare Tunnel expõe o portfólio Next.js publicamente em learn-agentic-ai.com sem abrir uma porta na rede doméstica. O Tailscale fornece uma rede overlay privada para desenvolvimento local, ferramentas internas e acesso administrativo. O site roda em Node.js 22 por trás do tunnel; builds são disparados manualmente e o processo reiniciado no lugar — sem Kubernetes, sem gastos em nuvem, sem complexidade operacional além do necessário. O objetivo do design é simplicidade em cada camada: 18 comandos composáveis em vez de um orquestrador monolítico, git worktrees em vez de uma fila de jobs personalizada, Cloudflare Tunnel em vez de um balanceador de carga. Engenharia de harness é tornar o rotineiro confiável para que o trabalho interessante — a engenharia de IA de verdade — possa avançar rápido.
Technical Stack
Orquestração
- ▸Claude Code
- ▸Bash
- ▸Git Worktrees
- ▸Comandos SDLC
Infraestrutura
- ▸Mac Mini
- ▸Cloudflare Tunnel
- ▸Tailscale
- ▸Node.js 22
Aplicação
- ▸Next.js 15
- ▸TypeScript
- ▸React 19
- ▸Tailwind CSS
Key Features
18 comandos SDLC slash composáveis cobrindo o ciclo de vida completo da spec: planejar → implementar → testar → revisar → documentar → finalizar
Execução paralela segura com git worktrees isolados por tarefa — cada tarefa tem seu próprio branch, contexto e árvore de trabalho
Pipeline multi-fase com gates obrigatórias: cada fase lê o arquivo de saída da fase anterior; as fases de teste e revisão bloqueiam documento e merge
Mac Mini com acesso duplo: Cloudflare Tunnel para tráfego público do portfólio, Tailscale para desenvolvimento privado e acesso administrativo
Hospedagem pública sem abertura de portas — conexão de saída do Cloudflare Tunnel, sem regras de firewall de entrada necessárias
Merge em ordem de dependência: worktrees paralelos completam independentemente e fazem merge na ordem definida pela spec
Artefatos de relatório estruturado em cada fase — toda execução de spec produz uma trilha de auditoria permanente e inspecionável
Integração de suite de validação: lint, gates de tipo TypeScript (dois configs por design), validação de conteúdo e execução completa do Jest exigidos antes de qualquer veredicto PASS
Code Examples
Technical Challenges
Projetar fases do pipeline que sejam independentemente re-entrantes — qualquer fase pode ser re-executada após uma correção sem corromper saídas de fases anteriores
Manter isolamento limpo dos worktrees: node_modules e cache do Next.js compartilhados entre worktrees sem contaminação cruzada
Estruturar a rede de duas faces para que tráfego público e privado nunca interfiram e a configuração sobreviva a reinicializações do Mac Mini com confiabilidade
Definir limites de fase que sejam significativos para um revisor humano, não apenas para uma máquina — cada gate deve representar um checkpoint de qualidade real