docs: split CLAUDE.md into AGENTS.md for Codex compatibility

df0474e81d9680c50d22607677d114d47e0e56fa · 2026-03-27 13:28:03 -0700 · Trevin Chow

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Files touched

A AGENTS.md
M CLAUDE.md

Diff

commit df0474e81d9680c50d22607677d114d47e0e56fa
Author: Trevin Chow <trevin@trevinchow.com>
Date:   Fri Mar 27 13:28:03 2026 -0700

    docs: split CLAUDE.md into AGENTS.md for Codex compatibility
    
    Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 AGENTS.md | 37 +++++++++++++++++++++++++++++++++++++
 CLAUDE.md | 38 +-------------------------------------
 2 files changed, 38 insertions(+), 37 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..0ff67fb7
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,37 @@
+# CLI Printing Press - Development Conventions
+
+## Build & Test
+
+```bash
+go build -o ./printing-press ./cmd/printing-press
+go test ./...
+```
+
+**IMPORTANT: Always use relative paths for build output.** Never build to `/tmp` or any shared absolute path. Multiple worktrees run concurrently and will stomp on each other. Use `./printing-press` exactly as shown above.
+
+## Project Structure
+
+- `cmd/printing-press/` - CLI entry point
+- `internal/spec/` - Internal YAML spec parser
+- `internal/openapi/` - OpenAPI 3.0+ parser
+- `internal/generator/` - Template engine + quality gates
+- `internal/catalog/` - Catalog schema validator
+- `catalog/` - API catalog entries (YAML)
+- `skills/` - Claude Code skill definitions
+- `testdata/` - Test fixtures (internal + OpenAPI specs)
+
+## Commit Style
+
+Conventional commits: `feat(scope):`, `fix(scope):`, `docs:`, `refactor:`
+
+## Adding Catalog Entries
+
+Catalog entries in `catalog/` must pass `internal/catalog` validation:
+- Required fields: name, display_name, description, category, spec_url, spec_format, tier
+- spec_url must use HTTPS
+- category must be: auth, payments, email, developer-tools, project-management, communication, crm, example
+- tier must be: official or community
+
+## Quality Gates
+
+Generated CLIs must pass 7 gates: go mod tidy, go vet, go build, binary build, --help, version, doctor.
diff --git a/CLAUDE.md b/CLAUDE.md
index 0ff67fb7..43c994c2 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,37 +1 @@
-# CLI Printing Press - Development Conventions
-
-## Build & Test
-
-```bash
-go build -o ./printing-press ./cmd/printing-press
-go test ./...
-```
-
-**IMPORTANT: Always use relative paths for build output.** Never build to `/tmp` or any shared absolute path. Multiple worktrees run concurrently and will stomp on each other. Use `./printing-press` exactly as shown above.
-
-## Project Structure
-
-- `cmd/printing-press/` - CLI entry point
-- `internal/spec/` - Internal YAML spec parser
-- `internal/openapi/` - OpenAPI 3.0+ parser
-- `internal/generator/` - Template engine + quality gates
-- `internal/catalog/` - Catalog schema validator
-- `catalog/` - API catalog entries (YAML)
-- `skills/` - Claude Code skill definitions
-- `testdata/` - Test fixtures (internal + OpenAPI specs)
-
-## Commit Style
-
-Conventional commits: `feat(scope):`, `fix(scope):`, `docs:`, `refactor:`
-
-## Adding Catalog Entries
-
-Catalog entries in `catalog/` must pass `internal/catalog` validation:
-- Required fields: name, display_name, description, category, spec_url, spec_format, tier
-- spec_url must use HTTPS
-- category must be: auth, payments, email, developer-tools, project-management, communication, crm, example
-- tier must be: official or community
-
-## Quality Gates
-
-Generated CLIs must pass 7 gates: go mod tidy, go vet, go build, binary build, --help, version, doctor.
+@AGENTS.md

← f6f63599 docs: prevent concurrent worktree build collisions · back to Cli Printing Press · fix(generate): reject non-empty output directory without --f 862dfa70 →