diff --git a/.gitignore b/.gitignore
index 602fb349..6c27b742 100644
--- a/.gitignore
+++ b/.gitignore
@@ -84,4 +84,5 @@ integrations/osaurus/agency-*/
 integrations/hermes/agency-agents-router/
 integrations/vibe/agents/
 integrations/vibe/prompts/
+integrations/zcode/agents/
 graphify-out/
diff --git a/integrations/zcode/README.md b/integrations/zcode/README.md
new file mode 100644
index 00000000..1a55fffe
--- /dev/null
+++ b/integrations/zcode/README.md
@@ -0,0 +1,29 @@
+# ZCode Integration
+
+[ZCode](https://z.ai) is Z.ai's GLM-based coding agent harness. Each agency
+agent is rendered as a standalone Markdown agent file with `name` and
+`description` frontmatter, which ZCode discovers from its agents directory.
+
+The generated files come from `scripts/convert.sh --tool zcode`, which writes
+one Markdown file per agency agent into `integrations/zcode/agents/`. Those
+generated files are not committed (see `.gitignore`); regenerate them locally.
+
+## Generate
+
+From the repository root:
+
+```bash
+./scripts/convert.sh --tool zcode
+```
+
+## Install
+
+Run the installer from your target directory:
+
+```bash
+cd /your/project && /path/to/agency-agents/scripts/install.sh --tool zcode
+```
+
+Agents install to `~/.config/zcode/agents/<slug>.md` (user scope). Use
+`--division` / `--agent` to install a subset, or set `ZCODE_AGENTS_DIR` to
+override the destination.