diff --git a/graph/configurations/z-image-restructured-as-proper-python-package-with-uv-tool-i-002fc4.md b/graph/configurations/z-image-restructured-as-proper-python-package-with-uv-tool-i-002fc4.md
new file mode 100644
index 00000000000..402b4404970
--- /dev/null
+++ b/graph/configurations/z-image-restructured-as-proper-python-package-with-uv-tool-i-002fc4.md
@@ -0,0 +1,34 @@
+---
+id: 002fc433-6969-4f1d-b400-50b8324bb82d
+type: configuration
+title: "z-image restructured as proper Python package with uv tool install"
+tags: [z-image, python, uv, cli-tools, configuration, claude-code-config, skills]
+importance: 0.65
+confidence: 0.8
+created: "2026-03-01T05:48:22.211904+00:00"
+updated: "2026-03-01T05:48:22.211904+00:00"
+---
+
+# z-image Restructured as Proper Python Package
+
+## Before
+- Location: `~/.claude/skills/z-image/` (embedded in skills directory)
+- Had embedded venv and `generate.py` directly in the skills folder
+- Bash wrapper at `~/bin/z-image`
+
+## After
+- App location: `/mnt/NV2/Development/z-image/`
+- Structure: proper Python package with `pyproject.toml` and `src/` layout
+  - `src/z_image/cli.py` — main CLI entry point
+- Installation: `uv tool install -e .` (editable install)
+- Binary location: `~/.local/bin/z-image` (from console_scripts entry point)
+- Skills location: only `SKILL.md` remains in `~/.claude/skills/z-image/`
+
+## Changes Made
+- Removed old bash wrapper at `~/bin/z-image`
+- Removed embedded venv from skills directory
+- Created `pyproject.toml` with `console_scripts` entry point
+- Moved source into `src/z_image/` layout
+
+## Pattern Applied
+Skills should only contain `SKILL.md` instructions. Application code lives in proper development location and is referenced by CLI command name, not path.