AI & Software EngineeringKnowledge Atlas
Catalogues / NDSE2 chapter guides and sources

C:C05

Chapter 5: Quality, Architecture and Maintainability

A guide to the published second edition, with literal citations separated from wider editorial reading suggestions.

Open this group in the atlasChapter catalogue entry

Chapter guide

Separates immediate correctness from architectural fit and maintenance obligations. Through duplication, post-merge evidence and a second change to the running service, it develops fitness checks and explicit stewardship instead of treating a passing test suite as complete quality assurance.

Qualità, architettura e manutenibilità

Sintesi in italiano

Distingue la correttezza immediata dalla coerenza architetturale e dagli obblighi di manutenzione. Duplicazioni, evidenze successive al merge e un secondo cambiamento al servizio guidano controlli di adeguatezza e responsabilità di manutenzione esplicite.

Learning goals

  • review generated code for architectural fit as well as immediate correctness
  • write fitness checks for critical system invariants
  • locate who will maintain the result when the original agent and reviewer are gone
Obiettivi in italiano

Obiettivi di apprendimento

  • sottoporre il codice generato a review non solo per la correttezza immediata, ma anche per la coerenza architetturale
  • scrivere controlli di fitness per gli invarianti critici del sistema
  • individuare chi si occuperà della manutenzione quando l'agent e il reviewer originari non saranno più disponibili
Chapter outline
  • 5.1 What counts as code quality?
  • 5.2 Reading AI-versus-human studies correctly
  • 5.3 Code smells are signals, not incidents
  • 5.4 Generated duplication and missed reuse
  • 5.5 Architectural fit in a living codebase
  • 5.6 Post-merge evolution and maintenance burden
  • 5.7 Tracing quality across agents and projects
  • 5.8 Authorship is not stewardship
  • 5.9 A second change exposes the difference
  • 5.10 Architecture fitness in the approval service
  • 5.11 Worked engineering example: test the architecture, not just the output
  • 5.12 Practice exercise: choose a maintainable implementation
Struttura del capitolo
  • 5.1 Che cosa significa qualità del codice?
  • 5.2 Come leggere correttamente gli studi che confrontano AI e sviluppatori
  • 5.3 I code smell sono segnali, non incidenti
  • 5.4 Duplicazioni generate e riuso trascurato
  • 5.5 Coerenza architetturale in un codebase in evoluzione
  • 5.6 Evoluzione dopo il merge e onere della manutenzione
  • 5.7 Seguire la qualità tra agent e progetti
  • 5.8 Scrivere il codice non significa esserne responsabili
  • 5.9 È la seconda modifica a far emergere la differenza
  • 5.10 Verificare l'architecture fitness nel servizio di approvazione
  • 5.11 Esempio ingegneristico svolto: verificare l'architettura, non soltanto l'output
  • 5.12 Esercizio pratico: scegliere un'implementazione manutenibile

Cited in the published chapter

18 linked atlas references from literal citations in the English and Italian editions. General bibliography membership and identifier-index entries are counted separately.

SE@PoliMi bibliography 17

Martin Fowler’s website 1

Trace literal citations to chapter sections

Locations come from the supplied English and Italian source files. Chapter text and figure captions are identified separately; identifier-index references and general bibliography membership are not treated as chapter citations.

Complete citation locators and source hashes

Editorial reading mappings

Broader topical suggestions can overlap the cited sources. A mapping does not add a citation to the published edition or establish that a practice is effective.

SE@PoliMi bibliography 56

Addy Osmani 5

The Pragmatic Engineer 31

Martin Fowler’s website 17

Earlier Non-Deterministic books 8

Software Engineering Practices 6