Missing Documentation for Design

Incomplete Base
Structure: Simple
Description

This weakness occurs when software lacks clear design documentation, making it difficult to understand how the system is structured and intended to work.

Extended Description

Without proper design documentation—such as architectural diagrams, data flow charts, or component interaction descriptions—developers struggle to grasp the system's overall logic and dependencies. This knowledge gap slows down maintenance, complicates feature additions, and obscures how data and security controls move through the application. This lack of visibility directly impacts security. It becomes harder to identify vulnerable design patterns, trace the root cause of issues, or assess the impact of changes. Fixing bugs or patching vulnerabilities becomes a time-consuming investigation, increasing the risk that flaws will be overlooked or that fixes will introduce new problems elsewhere in the poorly understood system.

References 1
Providing a Framework for Effective Software Quality Assessment
Robert A. Martin and Lawrence H. Shafer
07-1996
ID: REF-963