Uma plataforma de engenharia de software de ponta a ponta, onde o Desenvolvimento Orientado a Spec (SDD) é o paradigma central. O sistema atua como um "Spec Operating System", transformando especificações estruturadas em software executável com rastreabilidade total e auxílio de IA operacional.
Diferente do desenvolvimento tradicional, aqui a Spec (Especificação) não é apenas um documento estático, mas a fonte viva de verdade que orquestra todo o ciclo de vida:
- Spec-First: Nada é desenvolvido ou alterado sem que a especificação seja atualizada primeiro.
- Transformação Automatizada: A IA consome a Spec para gerar artefatos (issues, testes, documentação).
- Sincronia Total: Qualquer desvio entre a implementação e a Spec é identificado como um "drift" de conhecimento.
A plataforma resolve o problema da fragmentação de ferramentas e perda de contexto através de:
- Contexto Contínuo: Manutenção do estado do projeto e histórico de decisões entre sessões de trabalho.
- IA Operacional: Agentes que não apenas conversam, mas executam ações sobre a codebase e infraestrutura.
- Rastreabilidade Bidirecional: Conexão direta entre
Spec ↔ Issue ↔ Código ↔ Decisão ↔ Documento.
- Monorepo: pnpm Workspaces
- Frontend: Next.js 15+, React 19, Tailwind CSS 4
- Backend: Fastify (TypeScript)
- Banco de Dados: SQLite via LibSQL & Drizzle ORM
- IA Engine: CopilotKit integrado com agentes customizados.
- Runtime de Execução: OpenCode para execução segura de tarefas de codificação.
ai_sdlc/
├── apps/
│ ├── agent/ # Backend (Lógica de Agentes, Task Runner, Persistência)
│ └── web/ # Frontend (Dashboard, Kanban, Knowledge Base, Copilot UI)
├── packages/
│ ├── shared/ # Contratos, tipagens e esquemas Zod compartilhados
│ └── tasks/ # Motores de execução para diferentes tipos de tarefas de IA
├── docs/ # Documentação detalhada do domínio e sistema
└── workspaces/ # Sandboxes temporários para execução de código pelos agentes
- Node.js (v20+)
- pnpm (v10+)
- OpenCode CLI
# Instalar dependências
pnpm install
# Inicializar banco de dados e sementes (seed)
pnpm db:init
# Iniciar ambiente de desenvolvimento (Web, Agent e OpenCode)
pnpm devAcessos:
- Web App:
http://localhost:3000 - Agent API:
http://localhost:3001
- Gestão de Spec Dinâmica: Definição estruturada de requisitos que evolui com o projeto.
- Knowledge Base (Documentação Viva): Geração automática de documentação técnica vinculada diretamente aos artefatos (código, specs e decisões).
- Geração de Issues Inteligente: Decomposição de requisitos complexos em tarefas acionáveis e rastreáveis.
- Activity Timeline: Histórico completo de quem (humano ou IA), quando e por que cada mudança ocorreu.
- Session Checkpoints: Salva o estado mental da sessão para que o desenvolvedor ou a IA possam retomar o trabalho instantaneamente sem perda de contexto.
- Sprint Health: Monitoramento em tempo real da saúde da entrega baseado no alinhamento com a Spec original.
Para entender os detalhes técnicos e filosóficos, consulte:
- 01-visao.md - Visão estratégica e princípios.
- 03-workflow.md - O ciclo de vida do SDD na prática.
- 06-AI-copilot.md - Como a IA opera sobre o contexto.