stack-diagram README

README проекта с github.com/caru-ini/stack-diagram. Одним файлом markdown: README.md.

stack-diagram

Release License skills.sh

Describe your stack in a sentence. Get an architecture diagram with official logos.

Architecture diagram: a user reaches Next.js on Vercel over HTTPS; Next.js calls a Hono API in the same Vercel deployment over RPC; Hono queries Neon over SQL and calls Clerk for sessions and Stripe for checkout; GitHub Actions deploys

Diagram our stack: Next.js and a Hono API on Vercel. Postgres on Neon, auth with Clerk, payments with Stripe. GitHub Actions deploys.

npx skills add caru-ini/stack-diagram

Works with Claude Code, Codex, Cursor and other agents that support skills. In the Claude apps, upload stack-diagram.zip from Releases as a skill.

More examples

Monorepo tooling diagram: a developer pushes to GitHub Actions, which runs Turborepo and publishes to npm; inside the pnpm workspace, Lefthook runs Biome before each commit and Turborepo runs Biome and Vitest

Dev tooling, not just clouds

Draw our monorepo tooling: a pnpm workspace with Turborepo, Biome, Vitest and Lefthook. GitHub Actions runs CI and publishes to npm.
AI app diagram: a user asks Next.js on Vercel, which runs a vector search on Supabase pgvector and sends a prompt to Claude; Inngest syncs Notion docs every night and stores embeddings in Supabase

AI apps

Draw our docs chatbot: Next.js on Vercel searches Supabase pgvector and answers with Claude. Inngest syncs Notion every night.
AWS diagram: a user reaches CloudFront over HTTPS; CloudFront serves static paths from S3 and sends API paths to an ALB in a VPC's public subnet; the ALB forwards to Fargate in a private subnet, which queries RDS over SQL and uses ElastiCache as a cache

AWS, with AWS's own icons

Draw our app on AWS: CloudFront in front of S3 and an ALB in a public subnet. Fargate, RDS and ElastiCache sit in a private subnet.
Google Cloud diagram: a user reaches Cloud Load Balancing over HTTPS; the load balancer serves static paths from Cloud Storage and sends API paths to GKE in one region of a VPC; GKE queries Cloud SQL over SQL and uses Memorystore as a cache

Google Cloud, with Google's own icons

Draw our app on Google Cloud: a global load balancer in front of Cloud Storage and GKE. GKE, Cloud SQL and Memorystore run in one region of a VPC.
Azure diagram: a user reaches Azure Front Door over HTTPS; Front Door serves static paths from Azure Blob Storage and sends API paths to Azure App Service in the Japan East region; App Service queries Azure SQL Database over SQL and uses Azure Managed Redis as a cache, both through private endpoints in a virtual network

Azure, with Microsoft's own icons

Draw our app on Azure: Front Door in front of Blob Storage and App Service. App Service reaches Azure SQL and Managed Redis through private endpoints in a VNet.

Light and dark

Every diagram is rendered in both themes. Tiles stay white so logos keep their own colors, and group labels switch to the brand's dark-theme logo.

The monorepo tooling diagram cut diagonally: light theme on the upper left, dark theme on the lower right

Share it as an artifact

The diagram is one HTML file with its fonts and logos inlined, so it renders anywhere without a network. Publish it as a Claude artifact and share the link, or drop it into a repo or wiki. The PNGs and the React component are rendered from the same file.

The docs chatbot diagram as an HTML page in a browser window, with a title, a short description, the diagram, a legend and a footer

After drawing, the agent offers once to post the diagram to the public gallery at https://stacks.caru.moe. It shows what will be public (the light and dark PNGs, an English title, the tech stack and a display name) and posts only after you say yes twice. Your prompt is never sent. A GitHub login is optional and never shown; it only lets you delete the post later. The site's source is in site/.

What you get

Requires Python 3.9+ and network access for the logos. PNG export uses Playwright with Chromium.

Star history

Chart of GitHub stars for caru-ini/stack-diagram over time

Licenses and trademarks

stack-diagram (caru-ini/stack-diagram)

Ищем в базе…

Что это такое?Это навык для агента, который превращает однострочное описание вашего технологического стека в архитектурную диаграмму с официальными логотипами брендов. Работает внутри Claude Code, Codex, Cursor и других агентов, поддерживающих навыки.
Это отдельное приложение или то, что запускает мой агент для программирования?Это упакованный «навык для агента» с инструкциями и скриптами, которые совместимые агенты для программирования загружают и выполняют. Это не самостоятельное приложение, которое вы запускаете сами.
Как добавить его в моего агента?Скачайте stack-diagram.zip со страницы Releases проекта и загрузите его как навык в приложениях Claude; другие агенты, поддерживающие навыки, загружают его так же.
Что нужно установить, чтобы это работало?Для работы навыка нужны Python 3.9+ и доступ к сети, чтобы он мог загружать логотипы; для генерации PNG дополнительно нужны Playwright с браузером Chromium.
Логотипы входят в комплект или их нужно загружать из интернета каждый раз?Логотипы не входят в комплект навыка - они загружаются в реальном времени при сборке из источников вроде svgl, devicon, gilbarbara/logos или из собственного пакета иконок AWS, поэтому интернет-соединение нужно каждый раз.
В каких форматах можно получить диаграмму?Самодостаточный HTML-файл со встроенными шрифтами и логотипами (по умолчанию), PNG, React-компонент без зависимостей или артефакт Claude - все они создаются из одного исходного файла.
Поддерживаются ли светлая и тёмная темы?Да, каждая диаграмма создаётся в обеих темах. Плитки остаются белыми, чтобы логотипы сохраняли свои цвета, а подписи групп переключаются на вариант логотипа бренда для тёмной темы.
Можно ли использовать это для чего-то, кроме облачной инфраструктуры?Да, в README есть примеры и за пределами облаков, например диаграмма монорепозитория на pnpm/Turborepo/Biome/Vitest или стек приложения на Next.js + Supabase + Claude AI.
Как он не даёт стрелкам пересекать подписи?Линии прокладываются в обход подписей, поэтому стрелки никогда не пересекают текст, а агент отрисовывает и проверяет диаграмму перед тем, как вернуть её вам.
Автор
caru-ini
Размер
3.4 MB
Звёзды
2.6K
Возраст
17 д
Коммиты · 90 дней