What problem does this solve
cladding authors CLAUDE.md to carry project/agent instructions, but that file is read only by Claude-family hosts. The vendor-neutral, Linux-Foundation-stewarded AGENTS.md standard (https://agents.md/) is now read natively by Codex, Cursor, Copilot, Gemini CLI, Aider, Zed, and others (60k+ repos). Since cladding already targets three hosts (Claude Code / Codex / Gemini CLI), its spec-derived context is stranded behind a Claude-only filename — other agents in the same repo don't see it.
Proposed shape
Generate/maintain an AGENTS.md alongside CLAUDE.md, derived from the same sources cladding already owns:
spec.yaml::project + ai_hints (preferred persona, forbidden/preferred patterns, primary branch, test framework)
docs/conventions.md (style derived from code)
Emit it during clad init / clad sync so it stays in step. cladding's own AGENTS.md already exists for code-style — this is about generating one for adopting projects from their spec.
Versioning scope (GOVERNANCE.md §2)
In-scope check (GOVERNANCE.md §4.1 / §4.2)
Alternatives considered
- Symlink
AGENTS.md → CLAUDE.md — but the two have different intended audiences/sections; a derived file (spec-sourced, host-neutral) is cleaner and keeps CLAUDE.md as the Claude-specific layer.
Willing to implement?
From a competitive-gap analysis (portability cluster).
What problem does this solve
cladding authors
CLAUDE.mdto carry project/agent instructions, but that file is read only by Claude-family hosts. The vendor-neutral, Linux-Foundation-stewardedAGENTS.mdstandard (https://agents.md/) is now read natively by Codex, Cursor, Copilot, Gemini CLI, Aider, Zed, and others (60k+ repos). Since cladding already targets three hosts (Claude Code / Codex / Gemini CLI), its spec-derived context is stranded behind a Claude-only filename — other agents in the same repo don't see it.Proposed shape
Generate/maintain an
AGENTS.mdalongsideCLAUDE.md, derived from the same sources cladding already owns:spec.yaml::project+ai_hints(preferred persona, forbidden/preferred patterns, primary branch, test framework)docs/conventions.md(style derived from code)Emit it during
clad init/clad syncso it stays in step. cladding's ownAGENTS.mdalready exists for code-style — this is about generating one for adopting projects from their spec.Versioning scope (GOVERNANCE.md §2)
In-scope check (GOVERNANCE.md §4.1 / §4.2)
AGENTS.mdreflectsai_hints/conventions for a fixture projectAlternatives considered
AGENTS.md → CLAUDE.md— but the two have different intended audiences/sections; a derived file (spec-sourced, host-neutral) is cleaner and keepsCLAUDE.mdas the Claude-specific layer.Willing to implement?
From a competitive-gap analysis (portability cluster).