designDivergente: do planejamento ao roadmap de evolução

Como organizei as etapas de desenvolvimento, acompanhei a implementação com IA e estruturei a evolução de um produto editorial digital.

O desenvolvimento do designDivergente foi organizado como um projeto de Design Engineering, com etapas definidas, ferramentas integradas e controle sobre o que seria implementado, validado e publicado.

O objetivo inicial era reconstruir o blog, preservando a versão anterior e estabelecendo uma base técnica que facilitasse a manutenção e a evolução do produto.

Para isso, organizei o trabalho em sete fases, de F0 a F6, utilizando o Claude Code como agente de implementação e mantendo a definição de requisitos, a revisão e a aprovação das entregas sob minha responsabilidade.

Processo de desenvolvimento: F0 a F6

A reconstrução da V5.0.0 seguiu um fluxo incremental, com tarefas planejadas, critérios de aceite e verificações antes de avançar para a próxima etapa.

Fase e Principais atividades

• Fase 0 — Diagnóstico: Auditoria técnica, inventário do projeto, análise do Sanity, Git e interface existente.
• Fase 1 — Preparação: Proteção da V4, organização do repositório, branches, dependências e ambiente.
• Fase 2 — Design System: Definição de tipografia, tokens, componentes, temas e padrões visuais.
• Fase 3 — Design Specification: Especificação das páginas, interações, responsividade, estados e critérios de aceite.
• Fase 4 — Implementação: Desenvolvimento das interfaces, integração com Sanity, busca, filtros e SEO.
• Fase 5 — QA: Testes técnicos, visuais, funcionais, acessibilidade, regressões e refinamentos.
• Fase 6 — Publicação: Versionamento, deploy na Vercel e validação da V5.0.0 em produção.

O processo não era apenas sequencial. Cada fase podia exigir correções e novas verificações antes de ser considerada concluída.

O fluxo de trabalho seguia seis passos

• Escopo → Especificação → Implementação → Testes → Aprovação → Registro.

O Claude Code executava as tarefas técnicas dentro do escopo autorizado. Eu acompanhava os relatórios, verificava os resultados e decidia pela aprovação ou necessidade de ajustes. Essa organização ajudou a manter o desenvolvimento rastreável e a reduzir o risco de alterações não planejadas.

Ferramentas e responsabilidades

A arquitetura e o fluxo operacional combinaram ferramentas com responsabilidades específicas:

• Claude Code: Implementação assistida, análises, correções e verificações.
• Next.js, React e TypeScript: Estrutura da aplicação, páginas e componentes.
• Tailwind CSS e Untitled UI: Estilos, fundamentos visuais e componentes reutilizáveis.
• Sanity: Modelagem e gerenciamento editorial.
• Git e GitHub: Versionamento, histórico e controle de mudanças.
• Vercel: Hospedagem, previews e deploy.
• TypeScript, ESLint e testes automatizados: Verificação técnica e funcional.

A separação entre web/, responsável pela aplicação pública, e studio/, destinado ao Sanity, permitiu manter a gestão editorial independente da apresentação dos artigos.

Changelog: entregas realizadas

O histórico de versões registra a reconstrução e os primeiros avanços da infraestrutura editorial:

Roadmap: próximas funcionalidades

Depois da V5.1.0, organizei novas frentes de desenvolvimento, priorizando a evolução da arquitetura antes de adicionar funcionalidades mais complexas. Tarefas planejadas:

• Arquitetura de dados: auditar schemas, relacionamentos, consultas e contratos de dados.
• Motion System: definir tokens de movimento, transições e microinterações acessíveis.
• Áudio editorial: modelar narrações, integrar arquivos ao Sanity e desenvolver um player.
• Inputs e formulários: especificar campos, validação, segurança e persistência de informações.
• Governança: ampliar testes, monitoramento, documentação e processos de manutenção.

Essas frentes ainda não representam funcionalidades implementadas. Fazem parte do planejamento para ampliar o produto conforme as necessidades forem validadas.

Decisões de escopo: o que não será desenvolvido agora

Algumas possibilidades foram avaliadas, mas ficaram fora das primeiras entregas.

• Podcast conversacional: a proposta inicial de áudio foi direcionada para a narração fiel dos artigos, em vez de discussões geradas por IA.
• Geração automática de áudio: a primeira versão deverá utilizar produção manual ou semiautomática, com revisão humana.
• Novo banco de dados: a adoção foi adiada até que exista uma necessidade concreta não atendida pela infraestrutura atual.
• Funcionalidades avançadas de interação: recursos como contas, preferências e recomendações não foram priorizados nesta etapa.

Essas são decisões de priorização ou retirada de alternativas do escopo inicial, não descontinuações de funcionalidades já publicadas. Os registros não documentam uma funcionalidade em produção que tenha sido formalmente descontinuada.

Evolução do produto e próximos passos

A próxima etapa do designDivergente será revisar a arquitetura de dados para preparar a implementação dessas novas funcionalidades. A evolução continuará de forma incremental, com especificação, implementação assistida por IA, testes e validação. O objetivo é construir uma base sustentável para ampliar o produto, mantendo o controle sobre a qualidade, a manutenção e a complexidade técnica.