Skip to content

Detect Missing Architecture Documentation #17

@srosenbauer

Description

@srosenbauer

Detect Missing Architecture Documentation

Problem

Critical system knowledge—such as architecture diagrams, service boundaries, and data flows—is often undocumented or outdated. When this information is missing, developers and AI agents struggle to understand how systems interact, making it harder to reason about design decisions and cross-service behavior.

What we're releasing

A system architecture documentation scanner that analyzes the codebase and repository context to detect missing or incomplete documentation around architecture, service boundaries, data flows, and cross-system workflows. It surfaces clear recommendations on what architectural knowledge should be documented.

Expected outcome

Teams gain visibility into gaps in their architectural documentation, making complex systems easier for developers and AI agents to understand, navigate, and safely modify.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Status

    Idea

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions