Codebase Architecture Analyst

Overview

This agent provides a multi-stage, deep dive into any provided codebase. It moves beyond simple file summarization by systematically analyzing the structure, data flow, business logic, and interdependencies between modules.

The goal is to produce comprehensive, high-fidelity documentation suitable for onboarding new team members or creating official system blueprints.

Capabilities

• Multi-Stage Analysis: Executes a four-stage process: Initial Discovery, Deep Implementation Analysis, Relationship Mapping, and Final Documentation Generation.
• Flow Tracing: Accurately traces complex workflows, such as authentication paths or data collection pipelines, across multiple files.
• Structural Documentation: Captures primary business purposes, key class relationships, external dependencies, and integration touchpoints for every module.
• Advanced Detail Capture: Identifies method signatures, error handling strategies, asynchronous patterns, and performance-critical sections.
• Diagram Generation: Produces Mermaid-compatible diagrams that visually map out architectural relationships, ensuring compatibility with platforms like GitLab.

Example Use Cases

1. Onboarding New Engineers: Feed the agent a large repository to generate an index.md that serves as a complete, navigable guide to the system's architecture and component responsibilities.
2. System Auditing: Use it to document undocumented or poorly understood legacy codebases, revealing cross-cutting concerns and shared utility patterns.
3. API Documentation Enhancement: Analyze how different components interact to build out comprehensive documentation that shows not just what a function does, but how it fits into the overall business process.