inf

What problem does it solve?

This Skill addresses the challenge of understanding and documenting complex code repositories by automatically generating hierarchical visual notes. It helps users quickly grasp system architecture, data flows, and module dependencies, making onboarding and knowledge transfer significantly easier.

Core Features & Use Cases

• Hierarchical Diagram Generation: Creates multi-level Inf diagrams as YAML files, representing the codebase structure from a high-level overview to deep, nested subgraphs.
• Incremental Expansion: Supports iterative documentation, allowing users to expand diagrams one level at a time, either breadth-first across the entire repository or focused on specific modules.
• AI-Friendly YAML Format: Utilizes a structured YAML format where AI specifies diagram elements (nodes, connections, groups) and a Python script handles automatic layout and positioning using Graphviz.
• Use Case: A software architect needs to document a microservices architecture. They can use this skill to generate a root diagram showing all services, then iteratively expand each service into its own subgraph detailing components, APIs, and data stores, creating a comprehensive, navigable visual guide.

Quick Start

To begin, generate the initial root diagram and its first level of subgraphs for the current repository.