chore: drop CLAUDE.md import stubs in favour of AGENTS.md

.github/AGENTS.md

@@ -1,4 +1,4 @@
-# CLAUDE.md - CI/CD & GitHub Actions Guide
+# AGENTS.md - CI/CD & GitHub Actions Guide
 
 This file provides guidance for Claude Code and engineers working with the CI/CD infrastructure and GitHub Actions workflows in Foundry Python Core.
 
@@ -176,7 +176,7 @@ Cancels in-progress runs for same branch
 * Code quality
 * Test coverage
 * Security
-* Adherence to CLAUDE.md guidelines
+* Adherence to AGENTS.md guidelines
 
 **Secrets required**:
 

.github/workflows/claude-code-automation-pr-review.yml

@@ -45,7 +45,7 @@ jobs:
 
             You are reviewing a pull request. Please perform a thorough code review following these steps:
 
-            1. **Read CLAUDE.md** (if it exists) to understand project-specific conventions and standards.
+            1. **Read AGENTS.md** (if it exists) to understand project-specific conventions and standards.
 
             2. **Analyze the changes**:
                - Run `git diff origin/main...HEAD` to see all changes

AGENTS.md

@@ -1,16 +1,16 @@
-# CLAUDE.md
+# AGENTS.md
 
 This file provides comprehensive guidance to Claude Code (claude.ai/code) when working with the Foundry Python Core repository.
 
 ## You do raise the bar, always
 
 It is your goal to enable the contributor while insisting on highest standards at all times:
 
-* Fully read, understand and follow this CLAUDE.md and **ALL** recursively referenced documents herein for guidance on style and conventions.
+* Fully read, understand and follow this AGENTS.md and **ALL** recursively referenced documents herein for guidance on style and conventions.
 * In case of doubt apply best practices of enterprise grade software engineering.
 * On every review you make or code you contribute raise the bar on engineering and operational excellence in this repository
 * Do web research on any libraries, frameworks, principles or tools you are not familiar with.
-* **CRITICAL: Continuously update this CLAUDE.md** when you discover new learnings, tool usage patterns, architecture insights, or efficiency improvements. This ensures you become a more effective pair programmer over time. Document what you learned, why it matters, and how to apply it.
+* **CRITICAL: Continuously update this AGENTS.md** when you discover new learnings, tool usage patterns, architecture insights, or efficiency improvements. This ensures you become a more effective pair programmer over time. Document what you learned, why it matters, and how to apply it.
 
 ### Code Quality Principles
 
@@ -75,7 +75,7 @@ mise run test_lowest_direct     # Unit tests with lowest-direct deps (lower-boun
 
 **Coverage**: Goal 100%, minimum 85%.
 
-See [tests/CLAUDE.md](tests/CLAUDE.md) for detailed testing guidance including markers, fixtures, parallelization, and best practices.
+See [tests/AGENTS.md](tests/AGENTS.md) for detailed testing guidance including markers, fixtures, parallelization, and best practices.
 
 ## Development Workflow
 
@@ -160,7 +160,7 @@ All tool configuration lives in these files (single source of truth):
 
 **Tests run on**: Python 3.11-3.14, Linux (ubuntu-latest)
 
-See [.github/CLAUDE.md](.github/CLAUDE.md) for complete CI/CD documentation.
+See [.github/AGENTS.md](.github/AGENTS.md) for complete CI/CD documentation.
 
 
 

src/aignostics_foundry_core/AGENTS.md

@@ -1,4 +1,4 @@
-# CLAUDE.md - Foundry Python Core Package Overview
+# AGENTS.md - Foundry Python Core Package Overview
 
 This file provides an overview of all modules in `aignostics_foundry_core`, their features, and interactions.
 
@@ -461,7 +461,7 @@ assert "cache" in system.reason
 
 ### Module Documentation
 
-Consider creating `CLAUDE.md` files in module subdirectories for detailed documentation of complex modules.
+Consider creating `AGENTS.md` files in module subdirectories for detailed documentation of complex modules.
 
 ---
 

tests/AGENTS.md

@@ -1,6 +1,6 @@
-# CLAUDE.md - Test Suite
+# AGENTS.md - Test Suite
 
-This file provides guidance for working with the test suite. For general project guidance, see the root [CLAUDE.md](../CLAUDE.md).
+This file provides guidance for working with the test suite. For general project guidance, see the root [AGENTS.md](../AGENTS.md).
 
 ## Critical Test Patterns