AI writes your architecture docs—from your code

Share
AI writes your architecture docs—from your code

AI that writes your architecture docs—from your code

Architecture docs often lag behind reality. This research shows a semi-automated way to generate Software Architecture Descriptions (SADs) directly from source code.

  • Recover the system’s structure with reverse engineering to build a high-level component diagram.
  • Use a large language model to highlight architecturally significant “core” components via prompt engineering.
  • Generate state-machine diagrams that capture how components behave, guided by few-shot examples and domain hints.

Why it matters: less manual effort, faster onboarding, lower cognitive load, and documentation that stays aligned with the codebase.

Demonstrated on C++, but the approach is broadly applicable. It pairs human oversight with LLMs to abstract complexity and accurately reflect behavior.

By Ahmad Hatahet, Christoph Knieke, and Andreas Rausch. Read the paper: http://arxiv.org/abs/2511.05165v1

Paper: http://arxiv.org/abs/2511.05165v1

Register: https://www.AiFeta.com

#SoftwareArchitecture #LLM #ReverseEngineering #Documentation #DeveloperExperience #Cplusplus #AI #SoftwareEngineering

Read more

Aikaleimat voivat kertoa hoitojaksoista – jos kone ymmärtää säännöt

Aikaleimat voivat kertoa hoitojaksoista – jos kone ymmärtää säännöt

Lääkärin työpöydällä vilisee merkintöjä: diagnoosikoodeja, laboratoriotuloksia, lääkityksen aloituksia ja lopetuksia. Kaikella on päivämäärä ja kellonaika. Silti se, mitä lääkäri oikeasti tarvitsee, on tarina: milloin sairausjakso alkoi, mitä hoitoa annettiin ja milloin se päättyi. Tietokone osaa hakea yksittäisiä rivejä nopeasti. Mutta osaako se nähdä kokonaisuuden? Tähän asti moni järjestelmä on tyytynyt

By Kari Jaaskelainen
Yhteinen sävel voi olla alue, ei lause

Yhteinen sävel voi olla alue, ei lause

Useimmat verkkoalustat kysyvät meiltä samaa kysymystä yhä uudelleen: oletko samaa vai eri mieltä? Peukku ylös, peukku alas. Silti arjessa harva mielipide tiivistyy yhteen lauseeseen. Ihmiset myös välittävät joistakin aiheista paljon, toisista vähemmän. Jos etsimme yhteistä maaperää, pitäisikö meidän etsiä sitä yksittäisten väittämien sijasta jostakin niiden väliltä? Tähän asti verkon keskustelualustoilla

By Kari Jaaskelainen