15. Lições Aprendidas¶
Esta seção registra, ao final de cada unidade da disciplina, o que a equipe aprendeu com o processo de Engenharia de Requisitos, com o ScrumXP e com o contato real com a Associação Mães Guerreiras. Cada bloco abaixo deve ser preenchido pela equipe logo após a Retrospectiva da unidade correspondente (seção 5.1).
Unidade 1¶
1. Comunicação e Validação de Requisitos com Stakeholders
-
Desafio: A coleta de requisitos dependeu de um questionário assíncrono. As respostas das coordenadoras foram enviadas muito próximo ao prazo de entrega, revelando necessidades que não estavam mapeadas. Isso gerou um grande desalinhamento tardio, forçando a equipe a refatorar quase todo o projeto de última hora para adequar o sistema.
-
Ação de melhoria: Para as próximas unidades, a equipe mudará a forma de extrair essas informações. Substituiremos os questionários longos por reuniões síncronas curtas (ciclos rápidos de feedback) para validação direta. Além disso, estabeleceremos um acordo formal de prazos com as coordenadoras, definindo datas-limite claras para a aprovação de protótipos e requisitos, garantindo que qualquer mudança seja absorvida no início do ciclo de desenvolvimento, evitando o retrabalho na véspera da entrega.
-
Resultado (10/11/2026): as conversas com o cliente passaram a ser reuniões síncronas, gravadas: 25/09, 28/09, 26/10 e 02/11 (Evidências). A entrega do MVP foi fixada em 16/11/2026.
2. Distribuição de Tarefas e Adoção de Metodologia
-
Desafio: No início da Unidade 1, a equipe teve dificuldades para distribuir as tarefas de forma equilibrada e eficiente, pois ainda não tínhamos domínio sobre qual metodologia de trabalho utilizar e como aplicá-la na prática. Isso gerou momentos de desorganização e falta de clareza sobre as responsabilidades de cada membro.
-
Ação de melhoria: Para as próximas unidades, a equipe decidiu adotar formalmente práticas do framework Scrum. Passaremos a organizar nosso trabalho em ciclos fixos (Sprints) e utilizaremos um Product Backlog para listar e priorizar as tarefas. Além disso, definiremos responsáveis claros para cada história de usuário durante as reuniões de planejamento (Sprint Planning), garantindo que todos saibam exatamente o que precisam fazer e evitando sobrecarga ou ociosidade.
-
Resultado (10/11/2026): a equipe trabalha em sprints de 2 semanas, com o catálogo integrado como backlog e o quadro do GitHub Projects com um responsável por issue. Ainda falta registrar o planejamento de cada sprint em ata (seção 7.2).
3.Alinhamento de Expectativas e Prevenção do Excesso de Automação
-
Desafio: Através do questionário, a stakeholder expressou o desejo de uma automação completa de diversos processos físicos, como a criação de um sistema de senhas para a entrega quinzenal da "sacola verde". A equipe analisou o contexto sociotécnico e concluiu que essa automação era inviável e desnecessária. Ela criaria uma barreira tecnológica para um processo humano esporádico, dificultando a usabilidade, gerando sobrecarga cognitiva para as usuárias e prejudicando a adesão ao produto principal.
-
Ação de melhoria: A equipe assumiu seu papel de mediadora, focando em orientar o projeto para a geração de valor real, e não apenas para a entrega de funcionalidades solicitadas. Para as próximas etapas, mitigaremos essas divergências aplicando técnicas de priorização colaborativa com o cliente, como o método MoSCoW (para separar o que é essencial do que é apenas desejável) ou a Matriz de Valor de Negócio × Esforço Técnico. Assim, garantimos que os requisitos negociados tragam benefícios concretos sem complicar a rotina do projeto Mães Guerreiras.
-
Resultado (10/11/2026): MoSCoW e a matriz valor × esforço foram aplicadas com a cliente, requisito por requisito, na planilha de priorização v2 (29/10/2026); a escolha do MVP segue essa matriz (seção 10).
Unidade 2¶
1. Tratamento do feedback da outra equipe na revisão por pares
-
Desafio: A equipe que fez nossa correçāo de requisitos estava em um nível de abstraçāo diferente da nossa, implicando que deveriamos adicionar aos requisitos detalhes que nāo tinham prioridade no momento.
-
Ação de melhoria: Após o feedback do professor ficou definido que antes das correçōes com outra equipe é necessario entender em que nível de abstraçāo cada uma esta trabalhando, evitando retralhado.
2. Fronteira entre requisito funcional e regra de negócio
-
Desafio: Os RFs foram escritos com regras de negócio misturadas ao texto, como campos obrigatórios, limite de vagas e prazo para corrigir a chamada. O monitor apontou o problema, e a equipe ficou em dúvida sobre até onde um apontamento era RF ou regra (RF19 e RF20 ficaram pendentes na ata de 28/09).
-
Ação de melhoria: As regras de negócio passam a ficar numa lista própria (RN01, RN02, ...), registrada na seção 8.2 e ligada às fichas dos RFs que as aplicam. O RF descreve só a capacidade (verbo + objeto). Separar as regras também virou item da Definição de Preparado (seção 13).
3. Priorização com o cliente
-
Desafio: Na avaliação de valor de negócio, a maioria dos RFs recebeu nota 4 (Must have), o que dificultou separar o que era de fato essencial. O MVP acabou exigindo uma segunda escolha, e ficaram RFs "Must" fora dele sem uma justificativa registrada.
-
Ação de melhoria: Nas próximas priorizações, a equipe vai limitar a quantidade de itens "Must" por rodada, ou pedir ao cliente que escolha os N mais importantes de cada característica. A justificativa de cada item que ficar fora do MVP será registrada na ata.
4. Organização do escopo no site
-
Desafio: O mesmo requisito aparecia em várias seções (declaração, matriz de rastreabilidade, matriz 4×4, lista do MVP, backlog geral, backlog ordenado, critérios, regras e releases). Para entender um requisito era preciso abrir até 13 trechos, e a repetição já gerava divergências, como duas composições diferentes do MVP e links para seções que tinham mudado de número. O professor usou o nosso site como exemplo em aula (29/10/2026).
-
Ação de melhoria: Criamos um catálogo integrado com uma ficha por RF, que reúne declaração, história de usuário, origem, condições, critérios, prioridade, entrega, situação e evolução. As páginas de priorização, MVP e rastreabilidade passaram a explicar o método e a consultar o catálogo. Toda mudança agora é feita na ficha e registrada no histórico de evolução.
Unidade 3¶
1. Mudanças que não alcançaram todos os registros afetados
-
Desafio: Na avaliação de organização e atualização (03/11/2026), três falhas apareceram. Uma nota sobre o RF10 foi copiada para outras 10 fichas numa substituição em lote. Mudanças de 31/10 (RF10, RF23, RF26, RF30 e RN21) estavam nas fichas, mas não no histórico. E a validação do protótipo em 26/10 estava na ata, mas a DoR continuava dizendo que nenhum protótipo tinha sido validado. Também não havia registro de a quem cada mudança tinha sido comunicada.
-
Ação de melhoria: O histórico ganhou a coluna Comunicado a e um passo de comunicação proporcional ao impacto (14.1). As fichas ganharam o campo Necessário para, gerado a partir dos Depende de, e o script
scripts/catalogo.pyverifica o catálogo antes de cada publicação do site. Ao registrar uma decisão de reunião, a equipe confere também a DoR, as fichas e o histórico afetados.
2. Mudanças paralelas sobrescrevendo o site
-
Desafio: Um commit feito a partir de uma cópia desatualizada desfez a atualização da automação e quebrou o CI (corrigido no PR #72). Um PR com erro de formatação no catálogo foi aceito com o CI falhando (PR #55). PRs abertos ao mesmo tempo disputaram o mesmo código de mudança (MUD-044).
-
Ação de melhoria: Antes de editar, a branch parte do main atualizado. O commit lista os arquivos um a um, nunca
git add .. O merge só acontece com o CI verde, e PRs que mexem no histórico entram no mesmo dia.
3. Automação que parecia não funcionar
-
Desafio: Issues movidas no GitHub Projects não mudavam a situação dos requisitos no site. A automação só reage quando a issue é editada, fechada ou reaberta, e o GitHub mostrava todos os integrantes como "contributor", então as issues da equipe não eram reconhecidas.
-
Ação de melhoria: A regra ficou escrita na seção 13.7, a equipe passou a ser reconhecida pelo login (PR #69) e as issues usam a linha
Requisitos:e as caixasDoD RFxx. Um modelo de issue com essas linhas prontas evita que elas sejam esquecidas.
4. Representação desligada dos requisitos
-
Desafio: O site apontava para o protótipo da Sprint 6, enquanto as telas da Sprint 7 estavam em outra página do Figma. Telas cortadas esconderam um campo pedido nos critérios (as vagas da turma, CA-RF20-01). E as regras da chamada estavam espalhadas em quatro fichas e três regras de negócio, sem um modelo que as juntasse.
-
Ação de melhoria: A Visão do Produto ganhou a seção 5.5, sobre as representações usadas; as fichas da chamada ganharam o campo Representações, com o diagrama de estados da chamada. Cada tela do protótipo cita os critérios de aceitação que atende e é conferida contra eles antes da validação com o Makio.