Metodologia de Desenvolvimento do Sistema LAC
Define como uma necessidade é transformada, por meio de uma jornada de evolução, de aprendizagem cognitiva transversal e de um ciclo de desenvolvimento governado, em mudanças arquiteturais, componentes, artefatos implantados e uma nova versão coerente do Livro Ajustável de Conhecimento.
Posição física e semântica
Problema resolvido
Como transformar demandas, perguntas, lacunas, riscos e oportunidades em mudanças coerentes, verificáveis, governadas e implantadas no Sistema LAC?
Situação inicial
Uma necessidade surge em conversa, uso real, pesquisa, avaliação, documento, erro, nova ideia ou mudança tecnológica.
Risco sem metodologia
A mudança pode gerar páginas isoladas, duplicação, sobreposição, perda de rastreabilidade, incoerência arquitetural ou implantação sem validação.
Resultado esperado
A demanda torna-se uma jornada governada, afeta elementos arquiteturais identificados, produz artefatos aceitos e gera uma nova versão do LAC.
Definição da metodologia
Ela integra Engenharia de Sistemas, Engenharia de Software, Engenharia do Conhecimento, Ciência da Informação e Dados, UX/UI, teorias da aprendizagem, governança e, quando pertinente, Engenharia de IA.
A metodologia não descreve apenas como produzir páginas. Ela orienta como compreender a necessidade, localizar o impacto na arquitetura, selecionar disciplinas, modelar a solução, construir e validar artefatos, implantar a mudança e aprender com o uso. A aprendizagem é tratada como processo cognitivo transversal: pode anteceder o desenvolvimento, acompanhá-lo durante a execução e ser reativada por novas dúvidas, evidências ou comportamentos inesperados.
Distinções essenciais
| Elemento | Função | Pergunta respondida | Exemplo no LAC |
|---|---|---|---|
| Metodologia | Organiza o desenvolvimento por princípios, fases, etapas, atividades e tarefas e orienta a seleção de métodos, técnicas e procedimentos. | Como o LAC organiza e orienta seu desenvolvimento e evolução? | Esta página. |
| Método | Define um caminho especializado para realizar determinado tipo de trabalho dentro da metodologia. | Como realizar este tipo de investigação, aprendizagem, análise, modelagem ou construção? | Método de pesquisa, modelagem conceitual, avaliação ou aprendizagem. |
| Técnica | Oferece uma forma específica de executar parte de um método ou atividade. | Com que técnica realizaremos esta ação? | Entrevista, modelagem UML, análise de impacto, teste heurístico. |
| Procedimento | Define uma sequência operacional prescrita ou repetível para executar uma ação. | Qual sequência deve ser seguida para executar corretamente? | Procedimento de publicação, sincronização ou verificação. |
| Método de Aprendizagem | Orienta cognitivamente como compreender um objeto até atingir conhecimento suficiente para o propósito atual. | Como construir compreensão suficiente para responder à pergunta ou sustentar a próxima decisão? | Método Geral de Aprendizagem de Sistemas, quando o objeto possui natureza sistêmica. |
| Jornada de evolução | Instancia, acompanha e governa uma mudança concreta do estado inicial ao problema resolvido. | Como esta demanda específica progride até o problema resolvido? | Jornada de implantação de um agente de atendimento. |
| Estado | Representa uma condição significativa da Jornada em determinado momento. | Em que condição a Jornada se encontra? | Em análise, em desenvolvimento, em validação, encerrada. |
| Transição | Representa a mudança de um estado da Jornada para outro quando condições ou eventos são satisfeitos. | O que permite ou provoca a mudança de estado? | Aceite da solução provoca passagem de validação para implantação. |
| Ciclo de desenvolvimento | Realiza tecnicamente a transformação organizada pela metodologia e governada pela Jornada. | Que movimentos técnicos transformam a demanda em versão implantada? | Compreender, diagnosticar, localizar, modelar, construir, verificar, validar, implantar e observar. |
| Processo | Organiza um fluxo operacional recorrente que transforma entradas em saídas por atividades, regras, responsabilidades e controles. | Como um fluxo recorrente é organizado e executado? | Processo de publicação ou sincronização. |
| Rotina | Organiza a recorrência temporal de uma ação ou conjunto de ações, explicitando frequência, evento disparador, responsáveis e registro de cada ocorrência. | O que precisa ocorrer novamente, quando e por quem? | Rotina periódica de revisão de qualidade. |
| Transação | Representa um ciclo delimitado de solicitação, processamento, resposta, atualização de estado e resultado observável. | Que solicitação deve ser processada e retornar um resultado observável? | Submeter uma nova versão para revisão e receber seu resultado. |
| Execução | Registra a ocorrência concreta de uma tarefa ou atividade em determinado contexto, tempo, estado e executor. | Quem ou o que realizou o trabalho, quando e em qual contexto? | Autor executa a revisão de uma página no navegador. |
| Operação | É a ação técnica elementar realizada durante uma execução. | Qual ação técnica foi efetivamente realizada? | Abrir arquivo, validar link, calcular, registrar, salvar ou atualizar. |
| Regra ou política | Define obrigação, limite, autorização ou critério. | O que pode, deve ou não deve ocorrer? | Política de autorização de agentes. |
| Artefato | Materializa conhecimento, software, decisão ou controle. | O que foi produzido e pode ser usado, validado e versionado? | Página, modelo, grafo, código, política, registro ou teste. |
Alinhamento conceitual da metodologia
Esta metodologia especializa, para o desenvolvimento e a evolução do LAC, as dimensões definidas no Modelo Conceitual de Referência do LAC. Os conceitos se relacionam na execução, mas pertencem a dimensões distintas e não formam uma única cadeia hierárquica.
| Dimensão | Elementos centrais | Pergunta | Relação com as demais |
|---|---|---|---|
| Estrutura do trabalho | Fase → Etapa → Atividade → Tarefa | Como decompor e organizar o trabalho? | Atividades e tarefas podem utilizar métodos, técnicas e procedimentos e produzir artefatos, entregas, evidências e decisões. |
| Modo de realização | Método → técnicas / procedimentos | Como realizar este tipo de trabalho? | É selecionado conforme objeto, etapa, disciplina, risco, contexto e conhecimento necessário. |
| Dinâmica da mudança | Jornada → Estado ↔ Transição | Como uma mudança concreta progride? | Evidências, decisões e resultados do trabalho podem satisfazer predicados e permitir transições. |
| Operação recorrente | Processo / Rotina | Como o fluxo recorrente é organizado e quando se repete? | Processos e rotinas podem mobilizar atividades e tarefas e utilizar métodos e procedimentos. |
| Realização delimitada | Transação | Que solicitação deve ser processada e retornar resultado observável? | Pode ocorrer dentro de processos, rotinas ou Jornadas e atualizar dados, registros ou estados operacionais. |
| Execução concreta | Execução → Operação | Quem ou o que realizou a ação, quando, como e com qual resultado? | Materializa tarefas e preserva contexto, executor, entradas, saídas e evidências. |
Modelo geral da transformação
Aprendizagem como processo cognitivo transversal
A aprendizagem não é uma etapa isolada da metodologia. Ela pode ocorrer antes do desenvolvimento, acompanhá-lo durante a execução e ser reativada sempre que o conhecimento disponível deixar de ser suficiente para decidir ou avançar.
Anterior ao desenvolvimento
Quando a demanda envolve um sistema ou objeto ainda insuficientemente compreendido, a Jornada aciona um Método de Aprendizagem antes de avançar para decisões de análise, requisitos, arquitetura ou construção.
Transversal ao desenvolvimento
Durante análise, modelagem, construção, testes e validação podem surgir lacunas de compreensão. O método pode ser reaplicado sem interromper conceitualmente a Jornada.
Acoplada às evidências
Resultados, falhas, feedback, testes e comportamento em uso podem tornar insuficiente o conhecimento existente e reativar a aprendizagem.
Jornada de evolução
A jornada de evolução é a unidade organizadora de uma mudança concreta no LAC. Ela governa a progressão por estados e transições; não contém fases como estados próprios. As fases e etapas pertencem à metodologia e organizam o trabalho realizado durante a Jornada.
Inicia
Com uma demanda, pergunta, lacuna, risco, oportunidade ou necessidade de correção.
Orienta
Pelo problema resolvido, estados, transições, papéis, decisões, critérios de aceitação e artefatos.
Conclui
Quando os critérios de aceitação são satisfeitos, os artefatos estão implantados e a mudança pode ser rastreada.
Ciclo de desenvolvimento
O ciclo de desenvolvimento é o mecanismo técnico-gerencial pelo qual a metodologia realiza a transformação governada pela Jornada. Seus movimentos atravessam as fases e etapas e se materializam em atividades, tarefas, execuções e operações. Pode ser iterativo, incremental e recursivo. O movimento “Compreender” não substitui o Método de Aprendizagem; ele consome e atualiza a compreensão necessária ao trabalho técnico e gerencial.
Hierarquia do trabalho metodológico
A decomposição do trabalho da metodologia é organizada em quatro níveis complementares: Fase → Etapa → Atividade → Tarefa. Essa hierarquia descreve o trabalho a realizar; não substitui a máquina de estados da Jornada de Evolução, que descreve como a mudança progride entre estados e transições.
| Nível | Função | Pergunta respondida | Exemplo |
|---|---|---|---|
| Fase | Agrupa etapas com uma finalidade macro comum. | Em que grande momento da transformação estamos? | Compreensão e análise. |
| Etapa | Define uma unidade metodológica com questão principal e saídas mínimas. | Que resultado intermediário precisa ser alcançado? | Analisar impacto arquitetural. |
| Atividade | Organiza um conjunto coerente de ações dentro de uma etapa. | Que trabalho precisa ser realizado para cumprir a etapa? | Identificar elementos arquiteturais afetados. |
| Tarefa | Representa a ação operacional mais granular e atribuível. | O que exatamente deve ser feito agora? | Localizar referências ao artefato alterado. |
Estrutura arquitetural como referencial
A estrutura arquitetural responde onde a mudança ocorre e quais níveis podem ser afetados. Uma alteração em um artefato pode permanecer local ou revelar impacto em componentes, módulos, subsistemas, no Sistema LAC ou em seu ecossistema.
Disciplinas aplicáveis
Engenharia de Sistemas
Fronteiras, necessidades, requisitos, interfaces, decomposição e integração.
Engenharia de Software
Arquitetura, componentes, código, testes, versões, implantação e manutenção.
Engenharia do Conhecimento
Conceitos, relações, ontologias, regras, inferência, representação e validação.
Ciência da Informação e Dados
Organização, metadados, recuperação, proveniência, qualidade e persistência.
UX e UI
Interação, navegação, acessibilidade, compreensão, feedback e experiência.
Engenharia de IA
Modelos de fundação, contexto, RAG, agentes, ferramentas, avaliação e guardrails.
Teorias educacionais
Aprendizagem, progressão, mediação, atividades, avaliação e adaptação.
Governança
Decisão, autorização, responsabilidade, risco, rastreabilidade e controle da evolução.
Engenharia de IA na metodologia do LAC
A Engenharia de IA é uma disciplina especializada aplicada quando a solução envolve modelos de fundação, agentes, recuperação aumentada, memória, ferramentas ou inferência apoiada por IA.
| Aspecto | Aplicação na metodologia | Artefatos típicos |
|---|---|---|
| Seleção de abordagem | Decidir entre regra, consulta estruturada, busca, ML tradicional, modelo de fundação ou composição híbrida. | Registro de decisão arquitetural e critérios de seleção. |
| Contexto e RAG | Selecionar fontes, recuperar conteúdo e montar contexto rastreável. | Modelo de contexto, índice, metadados, corpus e casos de recuperação. |
| Agentes | Definir propósito, estado, ferramentas, autonomia, memória, limites e escalonamento. | Especificação do agente, máquina de estados, matriz de autorização e prompts. |
| Avaliação | Medir utilidade, fundamentação, consistência, segurança, custo e comportamento. | Rubricas, casos de teste, conjunto de avaliação e registros de execução. |
| Governança | Controlar versões, fornecedores, dados, acesso, ações permitidas e responsabilidade. | Políticas, inventário de modelos, trilhas de auditoria e registros de incidentes. |
Fases e etapas metodológicas integradas
| Fase | Etapa | Questão principal | Saídas mínimas |
|---|---|---|---|
| 1. Formulação da mudança | 1. Registrar a demanda | O que aconteceu, quem é afetado e por que isso importa? | Demanda identificada, origem, responsável inicial e evidências. |
| 2. Definir o problema resolvido | Como reconheceremos que a situação desejada foi alcançada? | Resultado pretendido, limites e critérios preliminares. | |
| 3. Abrir a jornada | Como a mudança será acompanhada e governada? | Identificador, estados, papéis, transições e produtos esperados. | |
| 2. Compreensão e análise | 4. Analisar o estado atual | O que já existe, o que falta, o que pode ser reutilizado e o que ainda precisamos compreender? | Diagnóstico, inventário, lacunas, riscos, dependências e, quando necessário, aprendizagem adicional. |
| 5. Analisar impacto arquitetural | Quais sistemas, subsistemas, módulos, componentes e artefatos mudam? | Matriz de impacto e relacionamentos afetados. | |
| 6. Selecionar métodos e disciplinas | Quais conhecimentos e técnicas são adequados? | Abordagem de solução e decisões justificadas. | |
| 3. Concepção e construção | 7. Modelar a solução | Como a solução deve funcionar e se integrar? | Modelos conceitual, funcional, lógico, comportamental e físico, conforme necessário. |
| 8. Construir artefatos | O que deve ser criado ou alterado? | Páginas, modelos, código, dados, regras, testes e documentação. | |
| 4. Avaliação | 9. Verificar e validar | A solução está correta, resolve o problema e o conhecimento que sustenta a decisão continua suficiente? | Evidências, resultados de testes, aceite, pendências e possíveis necessidades de reaprendizagem. |
| 5. Implantação | 10. Implantar e sincronizar | Como a mudança entra em uso sem perder controle? | Versão implantada, registro de promoção e paridade de ambientes. |
| 6. Uso e evolução | 11. Observar e aprender | Que efeitos, dúvidas, evidências ou comportamentos o uso real revelou? | Métricas, feedback, incidentes, aprendizagem incorporada, reativação do Método de Aprendizagem quando necessária, melhorias e novas demandas. |
Artefatos produzidos
Artefatos de demanda
Registro da necessidade, pergunta, problema resolvido, escopo e evidências.
Artefatos de jornada
Plano, estados, transições, critérios, responsabilidades, decisões e histórico.
Artefatos arquiteturais
Modelos conceituais, funcionais, lógicos, físicos, grafos e matrizes de impacto.
Artefatos de conhecimento
Objetos de conhecimento, vocabulários, taxonomias, ontologias, textos e knowgramas.
Artefatos de software e dados
HTML, CSS, JavaScript, APIs, esquemas, scripts, configurações e bases de dados.
Artefatos de governança
Políticas, regras, autorizações, versões, registros de decisão, testes e auditoria.
Governança da metodologia
Decisão
Quem pode propor, analisar, aprovar, implantar, publicar, operar e revisar.
Rastreabilidade
Origem da demanda, decisões tomadas, artefatos alterados, versões e responsáveis.
Controle de mudança
Critérios de aceitação, gestão de dependências, sincronização e possibilidade de reversão.
Demandas com maior risco, impacto ou autonomia exigem maior formalidade. Uma correção visual local pode usar um ciclo simplificado; um agente que atua sobre dados ou publica conteúdo exige especificação, autorização, avaliação e monitoramento mais rigorosos.
Critérios de verificação e validação
| Critério | Pergunta de verificação | Evidência esperada |
|---|---|---|
| Necessidade | A demanda e seu contexto estão claros? | Registro da demanda e atores afetados. |
| Problema resolvido | É possível reconhecer o estado desejado? | Critérios de aceitação observáveis. |
| Coerência arquitetural | A solução respeita fronteiras, relações e responsabilidades? | Modelo e análise de impacto. |
| Consistência semântica | Termos, conceitos e relações são compatíveis com o LAC? | Vocabulário e modelos atualizados. |
| Correção técnica | Os artefatos funcionam conforme especificado? | Testes, inspeções e resultados reproduzíveis. |
| Utilidade | A solução ajuda o papel ou público a atingir o objetivo? | Teste de uso, demonstração ou aceite. |
| Governança | Responsabilidades, versões, riscos e autorizações estão definidos? | Registros e políticas aplicáveis. |
| Implantação | A versão correta está no ambiente correto? | Registro de promoção e auditoria de paridade. |
| Suficiência do conhecimento | Há compreensão suficiente para sustentar a próxima decisão ou etapa da Jornada? | Justificativa, modelos, evidências e ausência de lacunas críticas não tratadas. |
| Evolução | O uso pode gerar aprendizagem e novas melhorias? | Feedback, métricas e mecanismo de nova demanda. |
Exemplo aplicado: agente de atendimento ao visitante
| Elemento metodológico | Aplicação |
|---|---|
| Demanda | O visitante não sabe onde iniciar e precisa expressar sua necessidade em linguagem natural. |
| Problema resolvido | O visitante é acolhido, compreendido e encaminhado para uma jornada adequada, mantendo controle sobre a decisão. |
| Jornada de evolução | Implantar capacidade inteligente de identificação e encaminhamento de necessidades. |
| Estrutura afetada | Subsistemas de visitante, jornadas, conhecimento, comunicação e governança. |
| Disciplinas | Engenharia de Sistemas, Software, Conhecimento, IA, UX/UI e Governança. |
| Artefatos | Especificação do agente, taxonomia de necessidades, prompts, matriz necessidade–jornada, interface, casos de teste e política de autorização. |
| Validação | Casos representativos de visitantes, qualidade do encaminhamento, clareza da justificativa, segurança e possibilidade de correção humana. |
| Implantação | Publicação controlada, registro da versão, observação do uso e abertura de novas demandas. |
Papéis e responsabilidades
| Papel | Responsabilidade metodológica |
|---|---|
| Demandante | Apresenta necessidade, contexto, evidências e expectativa de resultado. |
| Gestor do LAC | Prioriza, abre ou autoriza jornadas, acompanha riscos e coordena implantação. |
| Autor | Elabora conhecimento, modelos, páginas e demais artefatos. |
| Arquiteto | Analisa impacto, integração, decomposição e coerência sistêmica. |
| Curador | Verifica qualidade conceitual, semântica, documental e de fontes. |
| Desenvolvedor | Constrói, integra, testa e mantém artefatos técnicos. |
| Validador ou usuário | Confirma se a solução é compreensível, utilizável e adequada à necessidade. |
| Agente de IA | Pode apoiar tarefas autorizadas, sempre conforme nível de autonomia, política e supervisão aplicáveis. |
Implantação e nova versão do LAC
A mudança somente se torna parte efetiva do LAC quando seus artefatos são promovidos ao ambiente de uso correspondente, suas relações são atualizadas e a versão implantada pode ser identificada.
Evolução da própria metodologia
A metodologia também é um artefato evolutivo. Deve ser revisada quando novas jornadas revelarem lacunas, quando surgirem novos tipos de componentes ou disciplinas, quando os critérios de validação forem insuficientes ou quando a governança exigir maior precisão.
Preservar
- Problema resolvido como orientação.
- Jornada como unidade de mudança.
- Arquitetura como referencial de impacto.
- Artefatos como materialização.
- Governança e rastreabilidade.
Adaptar
- Número e profundidade das etapas.
- Disciplinas selecionadas.
- Formalidade documental.
- Métodos de modelagem e avaliação.
- Automação e participação de agentes.