Caso de trabalho

Ecossistema DEV

Organizar vários projetos sem transformá-los no mesmo projeto. Quando os projetos começaram a crescer, o problema deixou de ser apenas desenvolver cada aplicação. Passou a ser necessário trabalhar em vários sistemas, com apoio de IA, sem misturar seus contextos, regras de negócio, arquiteturas e decisões.

O Ecossistema DEV surgiu dessa necessidade. Não como uma plataforma pronta ou uma stack obrigatória, mas como uma forma em evolução de organizar o desenvolvimento, preservar conhecimento e transformar experiências que funcionaram em práticas reutilizáveis.

Como começou

O problema apareceu na prática.

Trabalhar em vários projetos assistidos por IA introduziu riscos que não existiam quando havia um único sistema em foco. Os exemplos abaixo foram observados durante o trabalho e motivaram a organização atual.

  • Misturar contexto de projetos diferentes.
  • Aplicar a regra de um sistema em outro por semelhança.
  • Trabalhar no diretório ou repositório errado.
  • Transformar a ferramenta atual em regra permanente.
  • Perder decisões quando uma conversa termina.
  • Utilizar estrutura antiga como se ainda fosse vigente.
  • Automatizar antes de compreender o problema.
  • Espalhar documentação contraditória.

Por que a organização passou a ser necessária

  • Mais projetos
  • Mais contextos
  • Mais decisões
  • Maior possibilidade de ambiguidade
  • Necessidade de organização

Decisão central

Separar método de domínio.

O DevTOLAS concentra aquilo que pode ser compartilhado entre projetos: método, governança e templates. Cada projeto preserva o que é seu.

Método comum, domínios separados

DevTOLAS método · governança · templates
SmartTradedomínio · arquitetura · stack Find2Godomínio · arquitetura · stack PDF Livredomínio · arquitetura · stack

Projetos diferentes não possuem necessariamente a mesma arquitetura. O que os aproxima é a forma de trabalhar, não a solução técnica.

Continuam pertencendo a cada projeto

  • Objetivo
  • Regras de negócio
  • Arquitetura
  • Stack
  • Código
  • Banco de dados
  • Infraestrutura
  • Identidade visual
  • Credenciais
  • Decisões específicas do domínio

Padronizar a forma de trabalhar não significa padronizar indiscriminadamente a solução.

DevTOLAS

O que pode ser compartilhado.

O DevTOLAS é a fonte metodológica comum atual do ecossistema. Ele organiza princípios e critérios para iniciar, analisar, planejar, implementar, testar, auditar, documentar, preservar contexto, tratar risco, organizar continuidade e avaliar reutilização.

Ele não é framework, biblioteca, runtime, arquitetura obrigatória nem stack comum. Nenhum projeto o importa ou o executa.

Fluxo geral de trabalho

  • Analisar
  • Planejar
  • Implementar
  • Testar
  • Auditar
  • Documentar
  • Avaliar o que pode ser reutilizado

Isso é orientação de trabalho, não pipeline rígido. A profundidade aplicada depende da natureza e do risco da mudança.

Contexto

A IA trouxe um problema novo.

Quando o trabalho passou a ser assistido por agentes, o contexto deixou de ser implícito e precisou ser tratado explicitamente. O padrão atual é um workspace por projeto.

Workspace individual

Workspace do projeto Projeto atual + DevTOLAS

Outros projetos permanecem fora do contexto normal de trabalho.

O objetivo é reduzir ruído, mistura de informações, utilização acidental de código e transporte indevido de regras entre projetos.

Workspace não é controle de acesso. Ele reduz exposição e mistura de contexto no trabalho cotidiano, mas não constitui uma barreira formal de segurança do sistema operacional.

Instruções persistentes

AGENTS.md — o que não depende da conversa.

Onde a instrução vive

  • Projeto
  • AGENTS.md
  • Agente trabalhando naquele contexto

Esse arquivo pode manter orientação persistente sobre identidade do projeto, caminhos, fontes documentais, limites, regras de Git, cuidados com informações sensíveis, relacionamento com o DevTOLAS e validações esperadas.

A consequência é menos dependência de repetir instruções a cada nova sessão.

Instruções persistentes também envelhecem e precisam ser revisadas. O próprio ecossistema já precisou corrigir caminhos e referências metodológicas antigas.

Governança

Controle proporcional ao risco.

Ciclo de referência

  • Diagnosticar
  • Propor
  • Autorizar
  • Executar
  • Validar
  • Registrar

Esse ciclo não é um workflow burocrático aplicado igualmente a toda alteração. Uma correção pequena não exige o mesmo nível de controle de uma reorganização de diretórios, de uma publicação, da remoção de arquivos, de mudança de infraestrutura, de uma operação destrutiva ou de uma alteração com grande impacto.

Quanto maior o impacto, maior deve ser o controle.

Princípio central

Os fundamentos prevalecem sobre as ferramentas.

O ecossistema utiliza hoje VS Code, Codex, Git, GitHub, Lovable e skills específicas. Essas ferramentas atendem ao cenário atual. Elas não são o método.

Ferramentas — papéis que podem mudar

Ambiente de desenvolvimento
VS Code hoje. Papel exercido por qualquer ambiente compatível — por exemplo, Cursor.
Agente de desenvolvimento
Codex hoje. Papel exercido por outro agente compatível — por exemplo, Claude.
Plataforma de construção
Lovable hoje. Papel exercido por outra plataforma compatível — por exemplo, Replit.
Versionamento
Git com serviço de repositório. Hoje GitHub; o papel pode ser exercido por outro serviço.

Esses exemplos indicam apenas papéis substituíveis. Não houve teste de substituição, não há comparação comercial entre as ferramentas, não há afirmação de equivalência técnica e não há recomendação de troca.

Fundamentos que devem sobreviver à troca

  • Separar contexto
  • Analisar antes
  • Planejar
  • Implementar
  • Testar
  • Auditar
  • Documentar
  • Controlar risco
  • Preservar rastreabilidade
  • Avaliar reutilização

Uma mudança de ferramenta pode exigir adaptação em integrações, skills, automações e procedimentos específicos. Isso não exige necessariamente abandonar os princípios que organizam o trabalho.

Princípio estável ≠ implementação operacional permanente.

Não existe aqui promessa de independência técnica absoluta nem afirmação de ausência comprovada de lock-in. O que se procura demonstrar é que a definição do método não se apoia na ferramenta utilizada hoje.

Síntese

Duas independências.

Entre projetos

Compartilhar método sem transportar indevidamente domínio, código, arquitetura e regras de negócio.

Das ferramentas

Utilizar ferramentas adequadas ao cenário atual sem transformar essas ferramentas na definição permanente do método.

O elemento comum é o método

Fundamentos
Vários projetosdomínio próprio
Várias ferramentasimplementação atual

Nem homogeneização dos projetos, nem permanência das ferramentas.

Automação pontual

Um problema concreto virou automação.

Topologia atual

  • Lovable
  • Git / GitHub
  • Ambiente local

Essa combinação criou uma necessidade concreta: sincronizar alterações sem sobrescrever trabalho, reescrever histórico ou resolver conflitos silenciosamente.

Git2Local

Fluxo remoto → local. Verifica condições antes da atualização e trabalha de forma conservadora.

Local2Git

Fluxo local → remoto. Verifica mudanças, possíveis segredos, validações, estado remoto e divergências antes da publicação.

Diante de uma divergência que exige julgamento humano, a automação deve parar.

O que não é utilizado como solução

  • Force push automático
  • Descarte silencioso
  • Reset destrutivo
  • Resolução arbitrária de conflitos
  • Sobrescrita apenas para completar o fluxo

Git2Local e Local2Git existem porque resolvem uma necessidade da topologia atual — Lovable ↔ Git/GitHub ↔ ambiente local. Se as ferramentas ou a topologia mudarem, essas skills podem precisar de adaptação, podem ser substituídas ou podem deixar de ser necessárias. A automação atende ao problema atual; o fundamento não depende da permanência da automação.

Critério

Nem toda dor vira ferramenta.

Da dor observada à possível reutilização

  • Problema real observado
  • Diagnóstico
  • Solução local
  • Validação
  • Registro
  • Vale reutilizar?
  • Pode ou não virar padrão

Algumas atividades possuem automação ou assistência. Outras continuam manuais, de forma intencional.

Automatizar quando existe uma dor recorrente suficientemente clara para justificar uma ferramenta.

A ausência de automação não deve ser lida automaticamente como deficiência.

Início de projeto

Criar um projeto sem escolher a solução antes do problema.

A estrutura mínima atualmente prevista para um novo projeto é deliberadamente neutra.

AGENTS.mdREADME.mddocs/workspace com projeto + DevTOLAS

Esse início não precisa escolher antecipadamente linguagem, framework, banco de dados ou infraestrutura.

A tecnologia deve responder ao problema. O template não deve decidir o problema pela tecnologia.

A criação ainda é parcialmente assistida por instruções e templates. Não existe uma plataforma completa de scaffold automatizado.

Continuidade

Sem depender da conversa.

Uma sessão de IA não deve ser a única memória do projeto. Quando necessário, o registro local guarda alterações, validações, decisões, riscos, pendências e próxima ação.

Git e documentação vigente permanecem fontes mais importantes do que a memória de uma conversa.

Isso não significa gerar documentação burocrática a cada interação. A continuidade deve ser proporcional à necessidade.

Evolução

O ambiente também precisou ser corrigido.

O Ecossistema DEV não nasceu pronto. Passou por reorganizações, correções de caminhos, separação de material antigo, consolidação do DevTOLAS, revisão de workspaces e criação de novas ferramentas para problemas observados.

Evolução conceitual, não cronologia exata

  • Estruturas anteriores
  • Reorganizações e auditorias
  • DevTOLAS consolidado
  • Workspaces isolados
  • Skills pontuais
  • Ecossistema atual

Referência

Vigente não é a mesma coisa que histórico.

Material vigente

Referência operacional atual do trabalho. O DevTOLAS é a fonte metodológica comum de hoje.

Evidência histórica

Estruturas e documentos antigos preservados para consulta, sem permanecer como referência operacional. O GPTOLAS faz parte dessa história.

Quando existe valor histórico, arquivar pode ser preferível a simplesmente apagar.

Não existem duas metodologias ativas em paralelo.

Limite da padronização

Padronizar sem homogeneizar.

Pode ser diferente

  • Stacks
  • Bancos de dados
  • Infraestrutura
  • Ferramentas
  • Publicação

Pode permanecer comum

  • Critérios
  • Princípios
  • Governança
  • Formas de validação
  • Organização
  • Responsabilidade
  • Rastreabilidade

Método comum ≠ arquitetura comum obrigatória.

Estado atual

O que já existe e o que ainda está em consolidação.

Já existe hoje

  • Organização estrutural do ambiente
  • DevTOLAS como método comum
  • Projetos isolados
  • Workspaces por projeto
  • AGENTS.md
  • Templates neutros
  • Git
  • Git2Local e Local2Git
  • Auditoria de workspace
  • Princípios de governança
  • Preservação de histórico
  • Documentação e continuidade
  • Automações pontuais

Ainda está em consolidação

  • Ausência de CI comum para validar método, templates e documentação
  • Poucas evidências de testes automatizados das skills
  • Ausência de métricas transversais
  • Ausência de telemetria comum
  • Falta de correlação uniforme entre tarefa, teste, commit e deploy
  • Dependência relevante de disciplina humana
  • Isolamento de contexto sem controle formal de acesso
  • Inconsistências documentais ainda existentes
  • Projetos com níveis diferentes de organização
  • Ausência de comprovação de utilização por múltiplas equipes
  • Governança da área de infraestrutura ainda pouco definida

Essas lacunas fazem parte do estado atual e permanecem visíveis por escolha.

Delimitação

O que o Ecossistema DEV não é.

  • Uma stack obrigatória
  • Um framework comum
  • Uma biblioteca de runtime
  • Um pipeline universal de CI/CD
  • Uma plataforma integrada
  • Uma Fábrica de Software concluída
  • Um conjunto obrigatório de ferramentas
  • Um sistema que elimina julgamento humano

É o estado atual de uma forma de organizar e governar o desenvolvimento, ainda em evolução.

Origem

Como os projetos alimentam o ecossistema.

Do trabalho real ao conhecimento comum

PDF LivreFind2GoSmartTradeSia2Fa
  • Experiências reais
  • Problemas e decisões
  • Aprendizados
  • Avaliar reutilização
Permanece localdecisão específica do sistema
Pode virar conhecimento comumDevTOLAS → novos projetos

O Ecossistema DEV não nasceu antes dos projetos. Ele está surgindo a partir deles.

Problemas encontrados durante o desenvolvimento geram decisões. Algumas permanecem específicas do sistema. Outras, depois de avaliadas, podem transformar-se em conhecimento reutilizável. É assim que experiências isoladas começam a formar uma maneira organizada de produzir software.

Ver as evidências