Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

v2.2.1: fix cramped sg-name label, document security-group padding

tt-a1iea0b18835e59
diff --git a/CHANGELOG.md b/CHANGELOG.md
index eaf144ce..f059693d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,14 @@
All notable changes are documented here. Format loosely follows [Keep a Changelog](https://keepachangelog.com/).
+## [2.2.1] — 2026-04-15
+
+### Fixed
+- **Security group label crowding.** The `sg-name :port` label on the dashed rose boundary sat only ~1px above the Load Balancer box inside it (boundary `y=265 h=80`, inner box `y=280`, label baseline `y=279`). Bumped the boundary to `y=250 h=100` and moved the label to `y=268`, giving ~12px clear gap between the label baseline and the inner component. Same pattern documented in `SKILL.md` so Claude stops generating crowded boundaries.
+
+### Changed
+- `SKILL.md`: new **Security Group & Region Boundary Padding** section with the 30/50 offset rule (boundary `y = inner.y - 30`, `h = inner.h + 50`, label baseline 18px below boundary top) and a concrete code example.
+
## [2.2.0] — 2026-04-15
### Added
diff --git a/README.md b/README.md
index c73a61c7..8ab09cf8 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@ Archify is a [Claude Skill](https://support.claude.com/en/articles/12512180-usin
![License](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square)
![Claude](https://img.shields.io/badge/Claude-Skill-7C3AED?style=flat-square)
-![Version](https://img.shields.io/badge/version-2.2-0891b2?style=flat-square)
+![Version](https://img.shields.io/badge/version-2.2.1-0891b2?style=flat-square)
## Preview
diff --git a/archify.zip b/archify.zip
index 568c7ad0..06dd6241 100644
Binary files a/archify.zip and b/archify.zip differ
diff --git a/archify/SKILL.md b/archify/SKILL.md
index 42524b5b..32041ad4 100644
--- a/archify/SKILL.md
+++ b/archify/SKILL.md
@@ -129,6 +129,26 @@ Component B: y=170, height=60 -> ends at y=230
**Wrong:** Placing a message bus at y=160 when Component B starts at y=170 (causes overlap)
**Right:** Placing a message bus at y=140, centered in the 40px gap (y=130 to y=170)
+### Security Group & Region Boundary Padding
+
+When a component sits inside a `c-security-group` or `c-region` boundary, the small label on the boundary (e.g., `sg-name :port`, `AWS Region: us-west-2`) needs room above the inner component — otherwise the label visually crashes into the box below it.
+
+**Rule:** boundary `y` = inner-component `y` − 30, boundary `height` = inner-component `height` + 50. Place the label 18px below the boundary top (baseline). This yields ~12px clear gap between the label baseline and the inner component's top edge.
+
+**Example** — a Load Balancer (y=280, h=50) inside a security group:
+
+```svg
+<!-- Security group — extends 30px above and 20px below the inner box -->
+<rect x="350" y="250" width="120" height="100" rx="8" class="c-security-group" stroke-width="1"/>
+<text x="358" y="268" class="t-security" font-size="8">sg-name :port</text>
+
+<!-- Inner component — unchanged coordinates -->
+<rect x="360" y="280" width="100" height="50" rx="6" class="c-mask"/>
+<rect x="360" y="280" width="100" height="50" rx="6" class="c-cloud" stroke-width="1.5"/>
+```
+
+If the inner component is taller (e.g., a 100px multi-line box), keep the 30/50 offsets — the extra vertical room on top stays the same, the bottom padding grows naturally.
+
### Legend Placement
**CRITICAL:** Place legends OUTSIDE all boundary boxes (region boundaries, cluster boundaries, security groups).
diff --git a/archify/assets/template.html b/archify/assets/template.html
index fc6548fc..5334b55f 100644
--- a/archify/assets/template.html
+++ b/archify/assets/template.html
@@ -491,9 +491,11 @@
<text x="255" y="448" class="t-muted" font-size="8" text-anchor="middle">&bull; bucket-three</text>
<text x="255" y="466" class="t-cloud" font-size="7" text-anchor="middle">OAI Protected</text>
- <!-- Security Group (dashed boundary) -->
- <rect x="350" y="265" width="120" height="80" rx="8" class="c-security-group" stroke-width="1"/>
- <text x="358" y="279" class="t-security" font-size="8">sg-name :port</text>
+ <!-- Security Group (dashed boundary). NOTE: extra vertical headroom
+ so the sg-name label has ~12px breathing room above the inner
+ component. Pattern: boundary y = inner.y - 30, h = inner.h + 50. -->
+ <rect x="350" y="250" width="120" height="100" rx="8" class="c-security-group" stroke-width="1"/>
+ <text x="358" y="268" class="t-security" font-size="8">sg-name :port</text>
<!-- Component inside security group -->
<rect x="360" y="280" width="100" height="50" rx="6" class="c-mask"/>
diff --git a/examples/images/archify-dark.png b/examples/images/archify-dark.png
index d843a39c..481b6751 100644
Binary files a/examples/images/archify-dark.png and b/examples/images/archify-dark.png differ
diff --git a/examples/images/archify-light.png b/examples/images/archify-light.png
index a6f9ef23..203dfa9c 100644
Binary files a/examples/images/archify-light.png and b/examples/images/archify-light.png differ
diff --git a/examples/images/archify-menu.png b/examples/images/archify-menu.png
index 801d1733..2f6f6dd5 100644
Binary files a/examples/images/archify-menu.png and b/examples/images/archify-menu.png differ
diff --git a/examples/web-app.html b/examples/web-app.html
index b280a5dc..82f7984d 100644
--- a/examples/web-app.html
+++ b/examples/web-app.html
@@ -491,9 +491,11 @@
<text x="255" y="448" class="t-muted" font-size="8" text-anchor="middle">&bull; bucket-three</text>
<text x="255" y="466" class="t-cloud" font-size="7" text-anchor="middle">OAI Protected</text>
- <!-- Security Group (dashed boundary) -->
- <rect x="350" y="265" width="120" height="80" rx="8" class="c-security-group" stroke-width="1"/>
- <text x="358" y="279" class="t-security" font-size="8">sg-name :port</text>
+ <!-- Security Group (dashed boundary). NOTE: extra vertical headroom
+ so the sg-name label has ~12px breathing room above the inner
+ component. Pattern: boundary y = inner.y - 30, h = inner.h + 50. -->
+ <rect x="350" y="250" width="120" height="100" rx="8" class="c-security-group" stroke-width="1"/>
+ <text x="358" y="268" class="t-security" font-size="8">sg-name :port</text>
<!-- Component inside security group -->
<rect x="360" y="280" width="100" height="50" rx="6" class="c-mask"/>