From a46a8cc5aeeccaa08491b34a0f26881cb5b492b3 Mon Sep 17 00:00:00 2001 From: Neelay Shah Date: Mon, 21 Sep 2026 11:44:26 +0200 Subject: [PATCH] chore: drop CLAUDE.md import stubs in favour of AGENTS.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Claude Code reads AGENTS.md directly (v2.1.277+), including nested AGENTS.md loaded on demand when it opens files in a subdirectory, so the one-line `@AGENTS.md` stubs are no longer needed. Removes the four stubs and rewrites every remaining CLAUDE.md reference — headings, cross-links and the PR-review workflow prompt — to AGENTS.md. Co-Authored-By: Claude Opus 5 (1M context) --- .github/AGENTS.md | 4 ++-- .github/CLAUDE.md | 1 - .github/workflows/claude-code-automation-pr-review.yml | 2 +- AGENTS.md | 10 +++++----- CLAUDE.md | 1 - src/aignostics_foundry_core/AGENTS.md | 4 ++-- src/aignostics_foundry_core/CLAUDE.md | 1 - tests/AGENTS.md | 4 ++-- tests/CLAUDE.md | 1 - 9 files changed, 12 insertions(+), 16 deletions(-) delete mode 100644 .github/CLAUDE.md delete mode 100644 CLAUDE.md delete mode 100644 src/aignostics_foundry_core/CLAUDE.md delete mode 100644 tests/CLAUDE.md diff --git a/.github/AGENTS.md b/.github/AGENTS.md index b50e480..a851779 100644 --- a/.github/AGENTS.md +++ b/.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**: diff --git a/.github/CLAUDE.md b/.github/CLAUDE.md deleted file mode 100644 index 43c994c..0000000 --- a/.github/CLAUDE.md +++ /dev/null @@ -1 +0,0 @@ -@AGENTS.md diff --git a/.github/workflows/claude-code-automation-pr-review.yml b/.github/workflows/claude-code-automation-pr-review.yml index 4dfeede..d87da54 100644 --- a/.github/workflows/claude-code-automation-pr-review.yml +++ b/.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 diff --git a/AGENTS.md b/AGENTS.md index 264b3e3..066cd9a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,4 +1,4 @@ -# CLAUDE.md +# AGENTS.md This file provides comprehensive guidance to Claude Code (claude.ai/code) when working with the Foundry Python Core repository. @@ -6,11 +6,11 @@ This file provides comprehensive guidance to Claude Code (claude.ai/code) when w 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. diff --git a/CLAUDE.md b/CLAUDE.md deleted file mode 100644 index 43c994c..0000000 --- a/CLAUDE.md +++ /dev/null @@ -1 +0,0 @@ -@AGENTS.md diff --git a/src/aignostics_foundry_core/AGENTS.md b/src/aignostics_foundry_core/AGENTS.md index 069f7ab..bf44aec 100644 --- a/src/aignostics_foundry_core/AGENTS.md +++ b/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. --- diff --git a/src/aignostics_foundry_core/CLAUDE.md b/src/aignostics_foundry_core/CLAUDE.md deleted file mode 100644 index 43c994c..0000000 --- a/src/aignostics_foundry_core/CLAUDE.md +++ /dev/null @@ -1 +0,0 @@ -@AGENTS.md diff --git a/tests/AGENTS.md b/tests/AGENTS.md index d396c29..c7aa12f 100644 --- a/tests/AGENTS.md +++ b/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 diff --git a/tests/CLAUDE.md b/tests/CLAUDE.md deleted file mode 100644 index 43c994c..0000000 --- a/tests/CLAUDE.md +++ /dev/null @@ -1 +0,0 @@ -@AGENTS.md