In the Justifai project, maintaining up-to-date and accurate architecture documentation for our evolving serverless environment was a consistent challenge. As features rapidly develop and AWS services are integrated, manual diagrams quickly become stale, leading to misunderstandings and increased onboarding time.

In the justifai project, maintaining up-to-date and accessible architectural documentation is paramount. As systems evolve, so must their representations. A common challenge arises when balancing the need for visually rich, high-level diagrams with the precision and maintainability of 'diagrams as code'. This post explores how justifai addresses this by implementing a dual diagram strategy.