Problem
NEXUS currently projects to CLAUDE.md for Claude Code and a separate kiro-nexus-steering.md for Kiro. There is no consistent primary format. When a new tool is added, we invent a new projection target.
Solution
Adopt AGENTS.md as the primary projection format. Both Claude Code and Gemini CLI already recognise AGENTS.md natively as a cross-tool standard (r/ClaudeCode, April 2026). This means a single AGENTS.md projection serves two major tools with zero translation overhead.
Projection hierarchy
.nexus/source.md (NEXUS-owned canonical source — rich, internal)
│
├── AGENTS.md → Claude Code, Gemini CLI (native, no conversion)
├── .kiro/steering/ → Kiro
├── .cursor/rules/ → Cursor (MDC format, via driver #17)
├── .windsurfrules → Windsurf (via driver #17)
└── .github/copilot-instructions.md → Copilot (via driver #17)
What changes
setup-nexus.sh writes AGENTS.md at repo root, not just CLAUDE.md
CLAUDE.md becomes a deprecated alias kept for backwards compatibility
- Core orchestration instructions are consolidated into a single source that
AGENTS.md is projected from
nexus sync (#new) uses this as the primary output format
Dependency
Requires #48 (core/ restructure) to be complete first so the source format is clean before projection begins.
Source: AGENTS.md cross-tool recognition confirmed in Anthropic documentation and r/ClaudeCode community, April 2026.
Problem
NEXUS currently projects to
CLAUDE.mdfor Claude Code and a separatekiro-nexus-steering.mdfor Kiro. There is no consistent primary format. When a new tool is added, we invent a new projection target.Solution
Adopt
AGENTS.mdas the primary projection format. Both Claude Code and Gemini CLI already recogniseAGENTS.mdnatively as a cross-tool standard (r/ClaudeCode, April 2026). This means a singleAGENTS.mdprojection serves two major tools with zero translation overhead.Projection hierarchy
What changes
setup-nexus.shwritesAGENTS.mdat repo root, not justCLAUDE.mdCLAUDE.mdbecomes a deprecated alias kept for backwards compatibilityAGENTS.mdis projected fromnexus sync(#new) uses this as the primary output formatDependency
Requires #48 (core/ restructure) to be complete first so the source format is clean before projection begins.
Source: AGENTS.md cross-tool recognition confirmed in Anthropic documentation and r/ClaudeCode community, April 2026.