Diário do Apex e da tese
Tudo desde o 6d212b6, o primeiro commit do repositório, lido a partir do próprio histórico: 1.171 commits entre uma plataforma de governação e a dissertação que a descreve. Entregue no prazo. Projeto encerrado.
- Entregue
- 7 de outubro de 2026
- Defendida
- 23 de outubro de 2026
- Nota da dissertação
- 17/20
- Nota final do mestrado
- Por atribuir
- dias, do primeiro ao último commit
- 186
- commits no total
- 1.171
- dias a escrever a tese
- 83
- commits em docs/thesis
- 199
- páginas na versão final
- 99/100
- participantes na avaliação
- 13/12
Contexto
Governed Human-AI Collaboration Across the Software Development Lifecycle: A Process Framework and Its Reference Implementation
Introdução
Uma dissertação de mestrado em Engenharia Informática e de Computadores (MEIC-T) no IST, seguindo a Design Science Research Methodology: identificar um problema, desenhar um artefacto que o resolva, demonstrá-lo num contexto real e avaliá-lo. O trabalho tem duas metades, separadas de propósito: uma framework (o método) e o Apex (uma instanciação funcional dela).
Contexto
A IA generativa e os grandes modelos de linguagem passaram do preenchimento automático a contribuidores ativos em todo o ciclo de vida. Os profissionais descrevem agora requisitos em linguagem natural e supervisionam o que o modelo produz. A adoção ultrapassou o método: as equipas usam estas ferramentas todos os dias sem um processo acordado sobre onde a IA participa e onde para.
Problema
Uma revisão sistemática da literatura de 646 artigos encontrou benefícios reais a par de riscos recorrentes em fiabilidade, segurança, rastreabilidade e responsabilização. A principal lacuna por resolver: não existe orientação estruturada e repetível para integrar a IA em fluxos de trabalho profissionais. O seu valor depende tanto do processo à volta do modelo como do próprio modelo.
Solução
Uma framework de processo que trata a IA como colaboradora de primeira classe, cujo resultado tem de ser delimitado, validado e rastreado: seis fases (Descoberta, Design, Implementação, Testes, Implantação, Manutenção), cinco portões de qualidade, responsabilidades atribuídas a chapéus, Bolts em vez de sprints e três métricas de governação. Tudo assenta numa especificação persistente e versionada que liga cada artefacto gerado ao seu requisito. O Apex executa-a de ponta a ponta com backends reais de Taiga/Plane, GitHub e Figma, e foi avaliado no projeto Outfolio e com 13 participantes.
Documentos
Contribuições
Commits por dia em todo o repositório. 11 rondas de revisão do Overleaf foram também sincronizadas neste histórico.
Linha do tempo
Repositório criado
Primeiro commit: bolt, uma aplicação Streamlit de um só processo, com seis vistas de fase, um adaptador Taiga e especificações OpenSpec funcionais e técnicas. FastAPI + Next.js vieram depois, a 18-19 de maio.
Afinações no fluxo de gravação da Fase 2
Indicador de progresso e mensagem de estado acrescentados ao botão Save & Lock Design.
Novo cabeçalho da Fase 3
Título, subtítulo e um diagrama de processo recolhível acrescentados por cima do quadro de tarefas.
Disposição automática de diagramas
Disposição automática com um clique nos painéis do diagrama ER e do fluxo de ecrãs.
Botão Choose New Story
A etapa Lock & Export da Fase 3 ganha um seletor direto de histórias.
Enriquecimento de contexto a partir do repositório GitHub
Versão inicial do que viria a ser o pacote repomix do lado do servidor.
Painel de análise de governação lançado
Bolt Cycle Time, Context Traceability Rate, AI Defect Escape Rate: as três métricas que a tese define mais tarde no Capítulo 6.
Temperatura determinística + verificação do DAG na Fase 3
Política de temperatura fixada (0 estruturado / 0,2 criativo); cobertura de tarefas verificada no servidor.
Explicação de EARS na Fase 1
Explicação integrada da Easy Approach to Requirements Syntax, mais um indicador de carregamento das restrições.
Redis com várias réplicas em produção
Bloqueio distribuído verificado com os IP reais do Azure; o backend deixa de estar forçado a uma só réplica.
Painel de verificação com modelo alternativo
Um segundo modelo pode agora rever o resultado do primeiro, com um painel de resultados mais completo.
Integração com o Figma lançada
Proxy no backend, ligação de frames a histórias e alterações de design assinaladas como desvio na manutenção da Fase 6.
Chave de API própria
Chaves OpenAI, Google e Anthropic suportadas por projeto.
Registo de uso e custo lançado
Telemetria real de tokens e custos, com o modelo mais barato nas chamadas de triagem.
Vista de clusters de rastreabilidade
react-force-graph acrescentado como vista alternativa do grafo de rastreabilidade entre especificação e código.
Delta de design na Fase 2
Regeneração incremental do design para histórias acrescentadas depois do bloqueio inicial.
Pacote repomix no servidor
O github-context.md passa a ser gerado por um shallow clone + repomix reais, em vez de uma leitura da árvore de ficheiros no cliente.
Sistema visual gerado por IA
Geração de design tokens acrescentada à Fase 2.
Perguntas de clarificação na Fase 1
Verificação de ambiguidade entre o rascunho em linguagem natural e o Gherkin compilado.
Sistema de design Impeccable definido
PRODUCT.md / DESIGN.md escritos, com "The Spec Ledger" como North Star.
Seletor de ficheiros de agente como base
AGENTS.md/CLAUDE.md/CODEX.md/GEMINI.md passam a ser contexto selecionável em todas as fases.
Outfolio escolhido como sujeito de QA
Um produto real de portfólio para OutSystems, escolhido como o projeto em que o Apex seria demonstrado de ponta a ponta. No mesmo dia: registo do ciclo de vida dos Bolts por tarefa.
Auditoria completa ao repositório com 5 agentes
Todas as conclusões Critical/High/Medium/Low fechadas em 24 horas.
Avisos de erro tipados e traduzidos
Todas as falhas passam a ser mostradas por omissão através de um único hook partilhado QueryCache/MutationCache.
Estrutura da dissertação criada
Modelo do IST preparado. Os dez capítulos criados como esboços \todo, no mesmo dia em que a revisão dos avisos de erro saiu na aplicação.
Elementos pré-textuais fechados
Estrutura da capa, declaração e agradecimentos fixada antes de haver conteúdo em qualquer capítulo.
Integração com o Plane.so integrada
Segundo adaptador de gestão de projeto, com paridade total com o Taiga, motivado pela migração de ferramenta de uma organização parceira a meio do projeto.
Estatísticas do Capítulo 5 com fonte
As duas estatísticas motivadoras de RCT/telemetria rastreadas até aos artigos originais.
Limitações da API do Plane mitigadas
Três limites permanentes da plataforma Plane contornados onde possível e documentados onde não.
Capítulo 6 comprimido de 28 para 18 pp.
O primeiro corte a sério no capítulo da framework, antes de o limite de páginas se tornar decisivo.
Capítulo 7 escrito
O capítulo da implementação de referência do Apex: arquitetura, mapeamento de construtos, QA e limitações.
Desenho do Capítulo 8 pré-registado
Critérios da demonstração escritos antes de qualquer trabalho de campo, para impedir seleção a posteriori.
Instrumentos de avaliação construídos
8 Google Forms (4 instrumentos × EN/PT): consentimento, Raw NASA-TLX, SUS e questionário de UX do Apex.
AI Defect Escape Rate real e independente da ferramenta
Calculada a partir de issues de gestão de projeto ligadas, tanto no Taiga como no Plane.
Revisão de redundâncias
Corte em todo o documento, de 107 para 106 pp., com cada remoção verificada de forma independente.
Piloto P0 contado como participante
Sessão verificada sem problemas nos quatro instrumentos; deixou de ser um piloto descartado.
Piloto P0 revela dois erros reais
Limite de tokens do pacote GitHub e contexto desatualizado tratado como "High Confidence", ambos encontrados ao vivo na primeira sessão real de avaliação.
Correção de páginas em branco no LaTeX
openright→openany, cleardoublepage→clearpage. Páginas recuperadas sem cortar conteúdo.
Recolha de dados da avaliação concluída
13 participantes para um objetivo de 12, os quatro instrumentos devolvidos, ninguém desistiu.
Novo diagrama do ciclo de vida
Diagrama Graphviz de seis fases acrescentado como Figura 6.1 e reutilizado na capa.
Lote de comentários do orientador
Citações experimentadas em apalike e depois de volta a IEEEtran numerado, seguindo o precedente de Cruz. Profundidade do índice de 5 para 3. Causa do sublinhado em emph encontrada no pacote changes. Figura 7.1 dividida, Declaração movida para página própria, Capítulo 7 renomeado "Proposal Implementation", nome completo do orientador acrescentado à capa.
Capítulo 9 escrito com dados reais do estudo
Resultados de SUS/TLX/UX, seguidos de três revisões no mesmo dia à secção de Discussão.
PDF renomeado com jobname
O ficheiro de saída passou a ist1103641-tomas-taborda-dissertacao.pdf; a fonte continuou a ser main.tex.
Capítulo 7 renomeado "Implementation"
Só muda o título, para o distinguir melhor do "Proposal" do Capítulo 6.
Resumo alargado, Secções 5-8 escritas
Da Implementação de Referência à Discussão, a partir do conteúdo já real dos Capítulos 7 e 9.
Registo manual de Fix-Bolts
Passa a ser possível abrir relatórios de erro no painel sem um cenário de QA falhado como origem.
Erro de perda de dados no Fix-Bolt encontrado e corrigido
O fail_gate reescrevia o bug_report_<id>.md em vez de acrescentar um cabeçalho datado. Perda real de dados, encontrada ao escrever o capítulo que descreve os Fix-Bolts.
Visualizador do registo de implantação
Botão View Deployment Log acrescentado à Fase 5, que mostra diretamente o deployment-log.md.
Motivos das falhas na cadeia de artefactos visíveis
A análise explica agora PORQUE é que a cadeia de rastreabilidade de uma história está incompleta.
Dados de análise da avaliação exportados
apex-analytics.md/csv e apex-spec-drift gerados a partir do projeto Outfolio em produção.
Primeira revisão estrutural de cortes
2 páginas recuperadas sem tocar na narrativa.
Capítulos 8 e 10 escritos com evidência real
Preenchidos os dois últimos capítulos \todo, com uma revisão de cortes de páginas no mesmo commit.
Auditoria final de conformidade com o IST
Ambos os limites de páginas confirmados: 71/80 no texto principal, 99/100 no documento completo.
Resumo alargado ganha figuras e uma tabela
Diagrama do ciclo de vida, uma tabela de mapeamento de construtos e uma captura real do Portão de Implantação.
Bolt Cycle Time em falta na exportação
O painel calculava-o; a exportação Markdown/CSV nunca o mostrava. Encontrado ao procurar um número para o Capítulo 8.
Narrativa da organização parceira corrigida
O terceiro contexto de demonstração, abandonado, estava descrito por engano como um teste deliberado ao adaptador; corrigido para a sequência real (Taiga → migração para Plane → atraso).
Legenda da Figura 7.1 corrigida
Legenda reescrita para corresponder à captura real do passo Review Draft ao seu lado.
Ligações dos instrumentos no Apêndice B
URLs reais dos Google Forms EN/PT de cada instrumento, reunidos num só sítio e referidos a partir do Capítulo 9. Corrigido na mesma revisão um erro do xurl (URLs a sair da margem da página).
Revisão de dois-pontos, Capítulo 6
14 frases "afirmação: explicação" reescritas como frases simples ou com um since/because.
Revisão de dois-pontos, Capítulo 8
12 casos reescritos, com a mesma regra.
Revisão de dois-pontos, Capítulo 9
24 casos reescritos, a maior revisão individual; enumerações genuínas e introduções a citações ficaram como estavam.
Revisão de dois-pontos, Capítulo 10
5 casos reescritos, o último dos quatro capítulos.
Frase perdida de resposta de IA removida
Apagado um preâmbulo "Below is a tighter version...", colado por engano no corpo do Capítulo 9.
Revisão final do documento completo
Cada ficheiro .tex comparado com o zip "probably final"; edições genuínas mantidas, reversões desatualizadas recusadas com justificação.
Pendentes encerrados
Lista de pendentes do REGULATIONS.md resolvida: Agradecimentos confirmados, espaçamento da bibliografia e Tabela 9.3 fechados sem ação, secção do júri marcada como vazia por previsão.
Este painel construído
Gerado diretamente a partir do git log e do REGULATIONS.md. Nenhum número nesta página é uma estimativa.
Dissertação e resumo alargado entregues
Entregues no prazo do IST: dissertação com 99/100 pp., resumo alargado com 8/10 pp. Correções de último dia: revisão de dois-pontos e declaração de uso de IA no resumo alargado, um subtítulo invisível na capa e dados do júri não confirmados retirados.
Defendida, 17/20
Defesa pública perante o júri. Dissertação classificada com 17/20.
Versão final pós-defesa
Referências a papéis tornadas coerentes com a Tabela 6.3 (PM como Product Manager, redação coerente com os chapéus), uma segunda revisão de coerência em capítulos e resumos, a decisão do chapéu PM registada no retorno de desvio de negócio do Cap. 8, e o júri confirmado impresso na capa.
Painel encerrado
Última atualização com dados pós-entrega, defesa e nota, mais uma secção de Contexto. Sem mais atualizações previstas.
Taxonomia de commits
Todo o repositório, por prefixo de conventional commit.
Capítulos
Todos criados a 4 ago. 2026 como esboços \todo. As datas abaixo indicam quando chegou conteúdo real.
| Capítulo | Primeiro conteúdo real | Commits |
|---|---|---|
| 1. Introdução | início de ago. 2026 | 11 |
| 2. Metodologia | início de ago. 2026 | 15 |
| 3. Enquadramento | início de ago. 2026 | 8 |
| 4. Revisão sistemática | início de ago. 2026 | 18 |
| 5. Problema | 11 ago. 2026 | 11 |
| 6. Proposta (framework) | 19-20 ago. 2026 | 45 |
| 7. Apex (implementação) | 20 ago. 2026 | 41 |
| 8. Demonstração | 21 ago. 2026 desenho, 24 set. 2026 conteúdo | 27 |
| 9. Avaliação | 14 set. 2026 | 39 |
| 10. Conclusão | 24 set. 2026 | 20 |
| Apêndice A | Sem data registada | 11 |
| Apêndice B: instrumentos de avaliação | Sem data registada | 18 |
Encontrado ao escrever sobre o assunto
Erros reais do Apex revelados pelo trabalho da tese e da demonstração.
Limite de tokens do pacote GitHub
A geração do pacote de programação era truncada em silêncio acima de um limite de tokens, descoberto ao vivo a meio do piloto.
Contexto desatualizado tratado como "High Confidence"
Uma superfície consultiva de governação indicava confiança alta com evidência que já não estava atual.
Defeito num endpoint partilhado propagado a nove histórias
Um erro de especificação comum que apareceu em nove histórias. Só foi apanhado porque a demonstração correu à escala de um projeto completo; o plano pré-registado era uma só unidade.
Fix-Bolt reescreve o relatório de erro
O fail_gate substituía o ficheiro bug_report_<id>.md inteiro em vez de acrescentar; um erro real de perda de histórico, corrigido na mesma sessão em que foi encontrado.
Passagem da Fase 6 descartava o conteúdo em silêncio
O controlo que abre um item de Manutenção na Fase 1 não levava conteúdo nenhum. O defeito só se via ao usar o retorno; ler o código não o revelava.
Base de dados de produção apagada pelo implementador de IA
Um script destrutivo de reposição correu contra a produção sem verificar o ambiente, durante uma tarefa de rotina para semear dados. Nenhum portão apanha uma ação destrutiva feita dentro de uma fase.
Deteção de regressões em falta nas exportações de governação
O registo da demonstração tem uma regressão real, introduzida por um Fix-Bolt e reparada por outro, mas as exportações não têm nenhum campo de regressões para a mostrar.
Bolt Cycle Time em falta na exportação
Calculado e mostrado no painel, nunca escrito na exportação Markdown/CSV. Encontrado ao tentar citar o número na tese.
Número de páginas
Limites do IST: texto principal até 80 páginas, documento completo até 100.
107→106
Revisão de redundâncias: cortadas frases repetidas sem perder conteúdo.
107→94
A correção de páginas em branco no LaTeX recuperou páginas sem cortar conteúdo.
−2pp
Primeira revisão estrutural de cortes.
99/100
Auditoria final de conformidade: ambos os limites confirmados com margem.
100/100
O valor do Bolt Cycle Time e as ligações do Apêndice B levaram ao limite.
99/100
A revisão de dois-pontos recuperou 1 p. de margem.
99/100
Revisão de coerência pós-defesa, número de páginas inalterado. Final.
O que a avaliação encontrou
Capítulo 9: 13 sessões não moderadas baseadas em tarefas, mais a demonstração no Outfolio. Dos 12 construtos de governação mapeados (Tabela 7.1), 10 ficaram realizados, 1 usou um indicador indireto e 1 ficou parcial. O Bolt Cycle Time foi inicialmente medido com o indicador errado, o que se detetou ao comparar a implementação com a sua própria definição escrita. A deteção de desvios da especificação ficou parcial para a especificação técnica.
- média SUS, nota D
- 56,73
- carga NASA-TLX, baixa
- 21,5/100
- Context Traceability Rate
- 92,6%
- Conformidade com a especificação
- 98,65%
- AI Defect Escape Rate
- 1,85%
- Bolt Cycle Time, mediana
- 0,22 h
- épicos / histórias do Outfolio
- 9 / 54
- dias de calendário, demonstração
- 9
- commits do Outfolio
- 123
- retornos exercitados
- 3 / 3
Escala
Árvore de trabalho final, mais os totais de diff de todo o histórico.
- linhas de frontend, .ts/.tsx
- 48,9 mil
- linhas de backend, .py
- 26,8 mil
- linhas de testes de backend
- 22,6 mil
- inserções, todo o histórico
- 252,8 mil
- remoções, todo o histórico
- 61,7 mil
- dia mais ativo, commits (18 jul.)
- 47
- rondas de revisão do Overleaf sincronizadas
- 11
Commits da tese, últimas 8 semanas
Só docs/thesis, pela data de início de cada semana ISO.
Estado final
- documento completo, PDF final
- 99/100
- texto principal, última auditoria a 27 set. 2026
- 71/80
- resumo alargado, PDF final em inglês
- 8/10
- defendida a 23 out. 2026
- 17/20
- participantes, nenhum desistiu
- 13/12
Pendentes, encerrados a 5 out. 2026
Agradecimentos
Conteúdo e nome do orientador confirmados; o pendente no REGULATIONS.md era uma nota antiga.
Espaçamento simples na bibliografia
Fechado sem avançar. O documento tem margem sem as páginas extra que recuperaria.
Tabela 9.3 (matriz NASA-TLX)
Fica, por decisão explícita. Sem mais propostas para a apagar.
Secção do júri
Deixada em branco na entrega por previsão; o júri confirmado foi impresso na capa na versão final de 26 de outubro de 2026.
Ambos os limites de páginas
Texto principal 71/80, documento completo 99/100; ambos cumpridos nas versões entregue e final.
Recolha de dados da avaliação
13 participantes para um objetivo de 12. Os quatro instrumentos devolvidos. Ninguém desistiu.
Gerado a partir do git log local e do docs/thesis/REGULATIONS.md. Última atualização a 27 out. 2026, depois da defesa. Último commit a 26 out. 2026.

