From 971bf356683768fd188b560462fc46b3e01daa02 Mon Sep 17 00:00:00 2001
From: Michael Sitarzewski <msitarzewski@users.noreply.github.com>
Date: Sun, 12 Jul 2026 01:12:49 -0500
Subject: [PATCH] zcode: gitignore generated output + add integration README
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bring the ZCode integration in line with the other tools: the 243 generated
agent files (integrations/zcode/agents/*.md) are output of `convert.sh`, not
source — add a .gitignore rule so they can't be committed, and add
integrations/zcode/README.md documenting generate/install (matching the vibe
and qwen integration READMEs).

Verified: generated agents are now git-ignored, the README is tracked, and
check-tools.sh still passes at 16 tools.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WKnDRWM4izsB8WAXKszhsq
---
 .gitignore                   |  1 +
 integrations/zcode/README.md | 29 +++++++++++++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 integrations/zcode/README.md

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.