Architecture Constraints

Technical Constraints

Constraint Background

Multi-platform support

Must run on macOS, Linux, and Windows (WSL)

Python 3.10+

Existing codebase and team expertise

Organizational Constraints

Constraint Background

Open Source

Target developer community with transparent tooling

Privacy compliance (GDPR)

No automatic transmission of user data to remote servers without explicit consent

Self-contained deployment

Must be deployable without complex infrastructure dependencies

Conventions

  • Configuration: Environment variables > .env file > ~/.diag-agent/config.yaml

  • Output formats: Source (.puml, .mmd) + rendered (PNG, SVG)

  • Error handling: Interactive prompts for missing config, graceful degradation, explanations on what is wrong and what to do instead of plain errors

  • Documentation: English, AsciiDoc format