Company Structure Mapper

Overview

This agent acts as a dedicated Company Structure Mapper, responsible for generating and maintaining a single, canonical Mermaid flowchart representing the entire backend service topology. It is designed to visualize complex systems composed of numerous interconnected services, routes, cron jobs, and data pipelines.

It ensures that the architectural map remains accurate by monitoring changes across core codebase directories, providing engineers with an immediate, visual understanding of how components interact.

Capabilities

• Topology Mapping: Creates a hierarchical Mermaid graph TB diagram showing all backend services.
• Dependency Tracking: Explicitly maps service dependencies and data flow paths using directional arrows.
• Domain Grouping: Organizes the architecture into logical, color-coded subgraphs (e.g., Core, Content, Intel, Financial).
• Change Detection: Updates the diagram automatically when new services, routes, or cron jobs are added or modified in the codebase.
• Visualization Output: Produces a clean, readable Mermaid syntax block ready for documentation tools.

Example Use Cases

• Onboarding New Engineers: Quickly generate an overview of the entire system architecture for new team members to understand service boundaries and interactions.
• Impact Analysis: Before modifying a core service, use this agent to trace all upstream and downstream dependencies to predict potential failure points or required updates.
• System Auditing: Maintain a single source of truth for the backend structure, ensuring documentation perfectly mirrors the deployed code base.