feat(setup): document Relay v3 cross-platform skill support

Bump Relay setup docs to version 3.0.0 and add a changelog section
describing cross-platform installation and context file generation.

Update workflow guidance to be platform-agnostic by replacing
Claude-specific skill paths with generic skill-directory references, and
refresh skill listings (including `/relay-help` and `/relay-superplan`)
so users on Claude Code, Codex CLI, and Gemini CLI follow the same flow.feat(setup): document Relay v3 cross-platform skill support

Bump Relay setup docs to version 3.0.0 and add a changelog section
describing cross-platform installation and context file generation.

Update workflow guidance to be platform-agnostic by replacing
Claude-specific skill paths with generic skill-directory references, and
refresh skill listings (including `/relay-help` and `/relay-superplan`)
so users on Claude Code, Codex CLI, and Gemini CLI follow the same flow.

Author: momobits

.claude/skills/relay-help/workflow.md

@@ -141,6 +141,7 @@ Check if any items are in-progress (have pipeline sections appended):
 | **/relay-verify** | Verify implementation |
 | **/relay-notebook** | Create verification notebook |
 | **/relay-resolve** | Close out and archive completed work |
+| **/relay-help** | Navigation guidance — where you are now |
 
 ## Workflow Paths
 

.claude/skills/relay-setup/workflow.md

@@ -29,15 +29,21 @@ Create this file to track the installed Relay version:
 
 | Field | Value |
 |-------|-------|
-| **Version** | 2.0.5 |
+| **Version** | 3.0.0 |
 | **Installed** | [YYYY-MM-DD] |
 | **Source** | https://github.com/momobits/Relay |
 | **Format** | skills |
 
 ## Changelog
 
+### 3.0.0 — Cross-platform support
+- Skills install to both `.claude/skills/` (Claude Code) and `.agents/skills/` (Codex CLI, Gemini CLI)
+- Installer generates AGENTS.md and GEMINI.md context files
+- Workflow language updated for platform-agnostic tool references
+- Added `/relay-superplan` (16 skills total)
+
 ### 2.0.2 — Skills-based workflow
-- Converted 14 prompts to Claude Code skills plus new `/relay-help` navigation skill (15 total)
+- Converted 14 prompts to skills plus new `/relay-help` navigation skill (15 total)
 - Added `/relay-help` navigation skill
 - Skills are auto-discovered — no more `@file.md` references
 - `.relay/` is now data-only (issues, features, status, config, archives)
@@ -48,24 +54,28 @@ Create this file to track the installed Relay version:
 
 ## Skills Manifest
 
-| Skill | File | Purpose |
-|-------|------|---------|
-| /relay-setup | .claude/skills/relay-setup/ | Initialize Relay in a project |
-| /relay-scan | .claude/skills/relay-scan/ | Generate relay-status.md |
-| /relay-order | .claude/skills/relay-order/ | Prioritize work ordering |
-| /relay-discover | .claude/skills/relay-discover/ | Scan codebase for issues |
-| /relay-new-issue | .claude/skills/relay-new-issue/ | File a specific bug or gap |
-| /relay-brainstorm | .claude/skills/relay-brainstorm/ | Explore feature ideas |
-| /relay-design | .claude/skills/relay-design/ | Design features from brainstorm |
-| /relay-cleanup | .claude/skills/relay-cleanup/ | Archive stale brainstorms |
-| /relay-analyze | .claude/skills/relay-analyze/ | Validate before implementation |
-| /relay-plan | .claude/skills/relay-plan/ | Create implementation plan |
-| /relay-superplan | .claude/skills/relay-superplan/ | Create plan via 5 competing agents |
-| /relay-review | .claude/skills/relay-review/ | Adversarial review of plan |
-| /relay-verify | .claude/skills/relay-verify/ | Verify implementation |
-| /relay-notebook | .claude/skills/relay-notebook/ | Verification notebook |
-| /relay-resolve | .claude/skills/relay-resolve/ | Close out and archive |
-| /relay-help | .claude/skills/relay-help/ | Navigation guidance |
+Skills are in your platform's skill directory:
+- Claude Code: `.claude/skills/relay-*/`
+- Codex CLI / Gemini CLI: `.agents/skills/relay-*/`
+
+| Skill | Purpose |
+|-------|---------|
+| /relay-setup | Initialize Relay in a project |
+| /relay-scan | Generate relay-status.md |
+| /relay-order | Prioritize work ordering |
+| /relay-discover | Scan codebase for issues |
+| /relay-new-issue | File a specific bug or gap |
+| /relay-brainstorm | Explore feature ideas |
+| /relay-design | Design features from brainstorm |
+| /relay-cleanup | Archive stale brainstorms |
+| /relay-analyze | Validate before implementation |
+| /relay-plan | Create implementation plan |
+| /relay-superplan | Create plan via 5 competing agents |
+| /relay-review | Adversarial review of plan |
+| /relay-verify | Verify implementation |
+| /relay-notebook | Verification notebook |
+| /relay-resolve | Close out and archive |
+| /relay-help | Navigation guidance |
 
 ### Status files
 
@@ -305,4 +315,4 @@ When setup is complete, tell the user:
 
 - Status files (relay-status.md, relay-ordering.md) are generated artifacts — they get real content after running the prepare skills
 - relay-config.md is populated during Phase 2 and maintained manually + refreshed by /relay-resolve after each resolved phase
-- The Relay skills (/relay-discover, /relay-scan, /relay-order, /relay-analyze, etc.) must be present in .claude/skills/ for the workflow to function
+- The Relay skills (/relay-discover, /relay-scan, /relay-order, /relay-analyze, etc.) must be present in the skill directory for the workflow to function

.claude/skills/relay-superplan/workflow.md

@@ -54,8 +54,7 @@ The context block must include:
 
 ## Step 2 — Dispatch 5 planning agents in parallel
 
-Launch 5 agents using the Agent tool. All 5 must run **in a single message**
-(parallel dispatch). Each agent receives the same context block but a different
+Launch 5 parallel agents. All 5 must run **concurrently in a single dispatch**. Each agent receives the same context block but a different
 planning directive.
 
 **Announce to the user:** "Dispatching 5 planning agents with different strategies:

README.md

@@ -12,9 +12,11 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen?style=flat-square&logo=node.js)](https://nodejs.org)
 [![Claude Code](https://img.shields.io/badge/Claude_Code-Skills-blueviolet?style=flat-square)](https://docs.anthropic.com/en/docs/claude-code)
+[![Codex CLI](https://img.shields.io/badge/Codex_CLI-Skills-orange?style=flat-square)](https://github.com/openai/codex)
+[![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-Skills-blue?style=flat-square)](https://github.com/google-gemini/gemini-cli)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](CONTRIBUTING.md)
 
-A skill-driven workflow system that gives AI coding agents persistent memory of what was built, what broke, and what's next. It replaces the ephemeral, conversation-scoped context that AI models operate in with a structured documentation system that survives across sessions, models, and teams.
+A skill-driven workflow system that gives AI coding agents persistent memory of what was built, what broke, and what's next. Works with **Claude Code**, **OpenAI Codex CLI**, and **Google Gemini CLI**. It replaces the ephemeral, conversation-scoped context that AI models operate in with a structured documentation system that survives across sessions, models, and teams.
 
 ## The Problem
 
@@ -56,18 +58,19 @@ Or install manually:
 ```bash
 git clone https://github.com/momobits/Relay.git /tmp/relay
 cp -r /tmp/relay/.claude/skills/relay-* your-project/.claude/skills/
+cp -r /tmp/relay/.claude/skills/relay-* your-project/.agents/skills/
 rm -rf /tmp/relay
 ```
 
 ### 2. Setup
 
-In Claude Code, run:
+In your AI coding CLI (Claude Code, Codex, or Gemini), run:
 
 ```
 /relay-setup
 ```
 
-This creates the `.relay/` data directory, generates initial status files, and scans your project for customizations (edge cases, test commands, notebook patterns).
+This creates the `.relay/` data directory, generates initial status files, and scans your project for customizations (edge cases, test commands, notebook patterns). Works the same in all three CLIs.
 
 ### 3. First Run
 
@@ -89,7 +92,7 @@ Need help? Run `/relay-help` to see where you are and what to do next.
 
 ## How It Works
 
-Relay uses **Claude Code skills** — each workflow step is a skill you invoke with `/relay-*`. The skills read and write to the `.relay/` data directory, building up persistent documentation across sessions.
+Relay uses **skills** — each workflow step is a skill you invoke with `/relay-*`. The skills read and write to the `.relay/` data directory, building up persistent documentation across sessions. Skills are installed to both `.claude/skills/` (Claude Code) and `.agents/skills/` (Codex CLI, Gemini CLI).
 
 ### Workflow Categories
 
@@ -304,7 +307,7 @@ After setup, your project will have:
 ```
 your-project/
 ├── .claude/
-│   └── skills/
+│   └── skills/                   # Claude Code skills
 │       ├── relay-setup/          # Initialize Relay
 │       ├── relay-scan/           # Generate status
 │       ├── relay-order/          # Prioritize work
@@ -315,13 +318,20 @@ your-project/
 │       ├── relay-cleanup/        # Archive stale brainstorms
 │       ├── relay-analyze/        # Validate before implementation
 │       ├── relay-plan/           # Create implementation plan
-│       ├── relay-superplan/     # Create plan via 5 competing agents
+│       ├── relay-superplan/      # Create plan via 5 competing agents
 │       ├── relay-review/         # Adversarial review
 │       ├── relay-verify/         # Verify implementation
 │       ├── relay-notebook/       # Verification notebook
 │       ├── relay-resolve/        # Close out and archive
 │       └── relay-help/           # Navigation guidance
 │
+├── .agents/
+│   └── skills/                   # Codex CLI + Gemini CLI skills
+│       └── relay-*/              # (same skills, mirrored)
+│
+├── AGENTS.md                     # Codex CLI context (relay section)
+├── GEMINI.md                     # Gemini CLI context (relay section)
+│
 ├── .relay/                       # Data directory (created by /relay-setup)
 │   ├── version.md                # Installed version and skills manifest
 │   ├── relay-readme.md           # Relay documentation
@@ -360,7 +370,7 @@ your-project/
 
 To extend the workflow with a new skill:
 
-1. Create a new directory in `.claude/skills/relay-[name]/` with:
+1. Create a new directory in `.claude/skills/relay-[name]/` (and `.agents/skills/relay-[name]/`) with:
    - `SKILL.md` — frontmatter (name, description) + "Follow the instructions in ./workflow.md."
    - `workflow.md` — the full skill instructions
 

package.json

@@ -1,7 +1,7 @@
 {
   "name": "relay-workflow",
-  "version": "2.0.6",
-  "description": "Persistent memory for AI coding workflows — Claude Code skills that give agents memory of what was built, what broke, and what's next",
+  "version": "3.0.0",
+  "description": "Persistent memory for AI coding workflows — skills for Claude Code, Codex CLI, and Gemini CLI that give agents memory of what was built, what broke, and what's next",
   "main": "tools/cli.js",
   "bin": {
     "relay-workflow": "tools/cli.js"
@@ -12,6 +12,11 @@
   "keywords": [
     "claude",
     "claude-code",
+    "codex",
+    "gemini",
+    "openai",
+    "google",
+    "multi-platform",
     "ai-workflow",
     "ai-memory",
     "coding-agent",