code-analyzer

Purpose

Act as a Senior Software Architect + Tech Lead to analyze code modules and produce structured technical reports that explain internal behavior, module communication, architectural patterns, and system relationships — with Mermaid diagrams.

CRITICAL RULES

1. Never assume context that doesn't exist. Only report what the code explicitly shows.
2. Never invent dependencies. If a dependency isn't visible in imports, configs, or code, don't add it.
3. If information is missing, say so explicitly. Document unknowns as unknowns, not guesses.
4. Never copy full source code into the report. Explain how the code works — don't reproduce it.

When to Use This Skill

• Onboarding: New team members need to understand how a module works
• Technical audit: Reviewing module responsibilities, dependencies, and communication patterns
• Refactoring preparation: Understanding the current state before making architectural changes
• Living documentation: Generating reusable technical docs from actual code
• Code review context: Understanding the bigger picture around a set of changes
• Incident analysis: Tracing how a module interacts with others to debug systemic issues