From 6da78d0a2bd8106a2ea2be24998c11b2eba3da5c Mon Sep 17 00:00:00 2001 From: anvil Date: Thu, 23 Apr 2026 15:01:54 +0000 Subject: [PATCH] docs(claude-md): add current-state header, align on main/paxai.app MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ax-cli's CLAUDE.md was already concise (57 lines) and clean of drift. Two additive touches for consistency with the wider CLAUDE.md PR wave: 1. Decision-table current-state header at top (target × branch × URL × gating). Same shape as ax-backend / ax-frontend / ax-mcp-server / ax-agents so operators get a uniform entry point across the 5 repos. 2. Short "How to ship" section noting ax-cli ships via PyPI from main, and aws/prod is historical / not a target for this repo. No content removed; ~10 lines added. Co-Authored-By: Claude Opus 4.7 (1M context) --- CLAUDE.md | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 6e53f51..030d1f5 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,14 @@ -# CLAUDE.md - -This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. +# CLAUDE.md — ax-cli + +> **Current state (read first, 2026-04-23)** +> +> | Target | Branch | URL | Gating | +> |---|---|---|---| +> | Local dev | any | local backend | none | +> | Staging | `dev/staging` | https://dev.paxai.app | @orion merge review | +> | Production | `main` | https://paxai.app | @madtank signoff + CI (PyPI as `axctl`) | +> +> **`aws/prod` is frozen legacy** — do not target. ax-cli ships via PyPI from `main`. ## What This Is @@ -55,3 +63,9 @@ User login credentials are deliberately separate from runtime agent config: - Selection: `AX_ENV`, `AX_USER_ENV`, `axctl login --env`, and user-authored commands that take `--env` Do not put reusable user PATs in `.ax/config.toml` or `~/.ax/config.toml`. User PATs bootstrap and mint agent credentials; agent runtime work should use agent PAT profiles or project-local agent runtime config. + +## How to ship + +1. Branch off `dev/staging` (or `main` for tight hotfixes). +2. PR against `main`. CI runs pytest + ruff. Merge → PyPI publish on tag. +3. `ax-cli` does not use `aws/prod` — that branch exists for historical alignment only.