Show HN: Archik – architecture diagrams as YAML, with a Claude Code skill (github.com)

Archik has introduced a groundbreaking tool that allows developers to create architecture diagrams in YAML format, streamlining collaboration with AI models like Claude Code. The tool ensures that the architecture diagram serves as a single source of truth, eliminating discrepancies between the diagram and the codebase. With features like a live canvas for real-time edits, schema validation, and an intuitive command-line interface (CLI), Archik enhances project documentation and fosters precise communication within engineering teams. This is particularly significant as it allows AI models to directly reference YAML, making structural suggestions while reliably adhering to the documented architecture. The Archik system boasts a well-defined structure with 27 node types and 12 distinct relationship styles, facilitating complex system designs without proprietary formats. Key functionalities include automatic layout management (using ELK for rendering), CI integration for schema validation, and the installation of the Claude Code skill for contextual awareness of architectural changes. This approach not only reduces the cognitive load on developers by providing clear prompts and concepts but also aligns the diagram and codebase seamlessly, making it easier to manage architectural changes and maintain coherence throughout the development lifecycle.