Z-Series

The open documentation standard for the AI era.

---

Markdown was built for humans.
Z-Series is built for AI.

---

The Problem

Every OSS project has documentation. But documentation today is written for humans — full of prose, filler words, and verbose explanations. When AI reads it, it wastes hundreds of tokens just to extract a handful of facts.

Meanwhile, AI is becoming the primary way people discover software. Perplexity. ChatGPT. Claude. Gemini. When someone asks "what's the best tool for X?" — AI reads your docs and decides. If your docs are verbose and unstructured, AI misses the point. Your project doesn't get recommended.

There is no standard for this. Until now.

---

The Solution

Z-Series is an open standard for AI-native project documentation.

A .z1 file is:

• Token-efficient — 10x fewer tokens than a README.md
• AI-generated — no human effort required
• Machine-indexed — structured for Google and AI search
• Self-promoting — projects get discovered without manual promotion

---

How It Works

AI reads your project
↓
Generates .z1 file automatically
↓
File lives in your repo
↓
Google + AI search index it deeply
↓
Your project gets found

---

The Standard

Format	Purpose	Reader
.md	Human documentation	Humans
.z1	AI-native documentation	AI + Search engines

Z1 is not a replacement for README.md.
It is the documentation layer that humans will never write but AI always needs.

---

The Family

Z-Series is a family of open standards, not a single file format.

Spec	Status	Description
Z1	✅ Stable v1.1	AI-native project documentation
Z2	🔬 Draft	AI-native API documentation
Z3	🔬 Draft	AI-native changelog standard
Z4–Z7	📋 Reserved	Security, compatibility, governance, lifecycle

See Z-SERIES-ROADMAP.md for the full family roadmap.

---

Quick Start

Generate a .z1 file for your project:

1. Copy the prompt from PROMPT.md
2. Paste into any AI (Claude, ChatGPT, Gemini)
3. Add the output .z1 file to your repo root
4. Done.

---

Adoption

Z-Series is an open standard. Free. MIT licensed. No ownership.

The goal is simple — if enough projects adopt Z1, AI search engines will natively support it. Just like robots.txt. Just like schema.org.

---

Repository Structure

z-series/
├── README.md              ← You are here
├── VISION.md              ← Why Z-Series exists
├── Z-SERIES-ROADMAP.md    ← The family of standards
├── Z1.md                  ← Z1 format specification
├── PROMPT.md              ← AI generation prompt
├── schema.json            ← Machine-readable Z1 schema
├── CONTRIBUTING.md        ← How to contribute
├── LICENSE                ← MIT
└── examples/
    ├── k1.z1              ← Example: format standard
    ├── library.z1         ← Example: code library (fastparse)
    └── tool.z1            ← Example: CLI tool (ripgrep)

---

License

MIT — free forever, for everyone.

---

Z-Series — built for the world AI is becoming.