infer-architecture

What problem does it solve?

It prevents teams from getting stuck by opaque codebases by converting existing implementation details into an explicit, shareable logical architecture that can guide subsequent engineering work.

Core Features & Use Cases

• Module structure inference: Enumerates top-level modules and assigns roles based on content, not just naming.
• Evidence-backed pattern detection: Identifies design patterns by grepping for known constructs and records file-level evidence.
• Conventions and LLD characterization: Infers framework conventions and low-level design patterns such as dependency injection, error handling, logging, validation, and async/concurrency style.
• Optional LTM alignment: Matches observed patterns against provided long-term architecture knowledge to cite relevant references.
• Architecture output generation: Writes architecture-inference.yaml with structured results suitable for downstream tech-spec and planning workflows.

Quick Start

Run infer-architecture with the codebase root as project_root and set output_base to the directory where you want architecture-inference.yaml written.