From bc18869755542b7d849399816960eebc935c6062 Mon Sep 17 00:00:00 2001 From: Alexander Nachtmann Date: Tue, 13 Oct 2026 03:34:49 +0200 Subject: [PATCH] Keep AGENTS.md as the only instruction file The root CLAUDE.md only imported AGENTS.md and pointed at the test guide, so it goes. The test guide moves from tests/CLAUDE.md to tests/AGENTS.md, and the four places that link it (AGENTS.md, the CI-workflows skill, the coverage-hunter agent and the Coverage failure message in build/Build.cs) point there. Co-Authored-By: Claude Opus 5.5 --- .agents/skills/dotcov-ci-workflows/SKILL.md | 2 +- AGENTS.md | 2 +- CLAUDE.md | 3 --- agents/coverage-hunter/agent.md | 2 +- build/Build.cs | 2 +- tests/{CLAUDE.md => AGENTS.md} | 0 6 files changed, 4 insertions(+), 7 deletions(-) delete mode 100644 CLAUDE.md rename tests/{CLAUDE.md => AGENTS.md} (100%) diff --git a/.agents/skills/dotcov-ci-workflows/SKILL.md b/.agents/skills/dotcov-ci-workflows/SKILL.md index 9fc011f..9e93660 100644 --- a/.agents/skills/dotcov-ci-workflows/SKILL.md +++ b/.agents/skills/dotcov-ci-workflows/SKILL.md @@ -38,7 +38,7 @@ description: >- - Native RID packages and the portable fallback must exist before the `DotCov.Tool` pointer is pushed. Keep pointer publication last. - Coverage uses the shared project settings described in the - [test guide](../../../tests/CLAUDE.md). Consume reports from the intended + [test guide](../../../tests/AGENTS.md). Consume reports from the intended run only; missing measurements cannot produce a passing badge or gate. - The coverage gate (`fallout Coverage --reports TestResults`) rejects missing src projects and coverage below the thresholds in `build/Build.cs`. diff --git a/AGENTS.md b/AGENTS.md index e71eff5..0449a54 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,7 +7,7 @@ Coverage stays at 100% of lines and branches: `fallout Coverage` and CI fail bel list the files that fell short. Close each gap with a test that drives a public entry point, or delete the code if no input can reach it; never exclude code from measurement. For test isolation, measurement or runner diagnostics, read the -[test guide](tests/CLAUDE.md). +[test guide](tests/AGENTS.md). ## Skills diff --git a/CLAUDE.md b/CLAUDE.md deleted file mode 100644 index 7084876..0000000 --- a/CLAUDE.md +++ /dev/null @@ -1,3 +0,0 @@ -@AGENTS.md - -Tests, Coverage (MTP/coverlet) und Fallout: @tests/CLAUDE.md diff --git a/agents/coverage-hunter/agent.md b/agents/coverage-hunter/agent.md index deb3f9b..a882346 100644 --- a/agents/coverage-hunter/agent.md +++ b/agents/coverage-hunter/agent.md @@ -37,7 +37,7 @@ If you can delegate to copies of yourself, you are the lead: 3. When all four have reported, apply their patches in /workspace/dotcov, resolve conflicts, and rerun the Coverage command until it passes. Then deliver. If you were handed a slice, you are a hunter: -- Work only in your worktree and only on your slice's code and its tests. Read AGENTS.md, tests/CLAUDE.md and src/DotCov.Fallout/AGENTS.md first and follow their TUnit rules. +- Work only in your worktree and only on your slice's code and its tests. Read AGENTS.md, tests/AGENTS.md and src/DotCov.Fallout/AGENTS.md first and follow their TUnit rules. - Hunt the hardest bugs first: wrong results without an error, boundary and empty input, culture and encoding, number parsing and rounding, stream ownership and disposal, path handling, and any promise a name, doc comment or caller makes that the code breaks. Prove each bug with a test that fails on the current code, then make the smallest fix that makes it pass. - Then close every coverage gap in your slice with tests that drive public entry points and assert results. Delete code no input can reach unless it is public API; test public API instead. - While you work, run only the tests you touch (`dotnet test --project tests/DotCov.Tests --treenode-filter ...`). Before reporting, run the full `dotnet fallout Coverage` once in your worktree and confirm every test passes. diff --git a/build/Build.cs b/build/Build.cs index 00b351a..05a9134 100644 --- a/build/Build.cs +++ b/build/Build.cs @@ -71,7 +71,7 @@ class Build : FalloutBuild args.AddRange(["--badge-dir", Path.GetFullPath(BadgeDirectory, RootDirectory)]); await RunDotCov([.. args], failure: "Coverage must stay at 100% of lines and branches. For each file dotcov lists above, add a test that " + - "drives the uncovered line or branch through a public entry point (tests/CLAUDE.md), or delete the " + + "drives the uncovered line or branch through a public entry point (tests/AGENTS.md), or delete the " + "code if no input can reach it. Never exclude code from measurement."); }); diff --git a/tests/CLAUDE.md b/tests/AGENTS.md similarity index 100% rename from tests/CLAUDE.md rename to tests/AGENTS.md