archik 0.6.7 → 0.6.9

package/README.md

@@ -1,12 +1,40 @@
-# Archik
+<p align="center">
+  <img src="./docs/logo.svg" alt="archik" width="120">
+</p>
+
+<h1 align="center">archik</h1>
+
+<p align="center">
+  <em>The shared vocabulary between you and Claude Code, at the engineering level.</em>
+</p>
 
-> An architecture diagram tool where the file is the source of truth — and Claude can edit it alongside you.
+[![npm version](https://badge.fury.io/js/archik.svg)](https://www.npmjs.com/package/archik)
+[![CI](https://github.com/bacharSalleh/archik/actions/workflows/ci.yml/badge.svg)](https://github.com/bacharSalleh/archik/actions/workflows/ci.yml)
+[![GitHub Repo stars](https://img.shields.io/github/stars/bacharSalleh/archik)](https://github.com/bacharSalleh/archik/stargazers)
+[![NPM Downloads](https://img.shields.io/npm/dm/archik)](https://www.npmjs.com/package/archik)
+[![License](https://img.shields.io/npm/l/archik?color=blue)](./LICENSE)
+[![Node](https://img.shields.io/node/v/archik?color=339933&logo=node.js&logoColor=white)](https://nodejs.org)
+[![Twitter Follow](https://img.shields.io/twitter/follow/bach__92?style=social)](https://x.com/bach__92)
 
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/archik/docs/hero.svg" alt="Sample Archik diagram of an LLM-assisted support system" width="780">
+  <img src="./docs/hero.svg" alt="Sample Archik diagram of an LLM-assisted support system" width="780">
 </p>
 
-You write a small YAML file describing your nodes (services, databases, queues, agents, LLMs, …) and the edges between them. Archik gives you a live browser canvas, a CLI for CI, and an installable AI skill so Claude Code understands your architecture file the same way you do — no proprietary format, no coordinates in the YAML, no manual layout.
+archik gives your project — and the AI editing it — *one file* that
+describes what the system actually looks like. Services, databases,
+queues, agents, LLMs, the edges between them. Plain YAML, schema-
+validated, no coordinates, no proprietary format.
+
+Open it in your browser for a live canvas. Render it in CI for a
+self-contained SVG. Install the [Claude Code skill](#for-claude-code--other-llms)
+so the model edits the same file you do — *the diagram and the
+codebase stop drifting because Claude treats the diagram as the
+spec*.
+
+If you've ever asked an AI agent "where would I add X?" and watched
+it guess from filenames, archik is the fix: the YAML answers the
+question, and Claude is required to read it before doing structural
+work.
 
 ## Quickstart