Skip to content

Reorganize PR testing docs into .claude/agents/ #2112

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 23, 2025
Merged

Reorganize PR testing docs into .claude/agents/ #2112

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .claude/docs/pr-testing-agent.md → .claude/agents/pr-testing-agent.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@
**See Also:**

- **[PR Testing Guide](pr-testing-guide.md)** - How to use this agent with Claude Code
- [Testing Build Scripts](testing-build-scripts.md) - Build/package testing requirements
- [Testing Build Scripts](../docs/testing-build-scripts.md) - Build/package testing requirements
- [CI Config Switching](../../SWITCHING_CI_CONFIGS.md) - Testing minimum vs latest dependencies
- [Local Testing Issues](../../spec/dummy/TESTING_LOCALLY.md) - Environment-specific testing issues
- [Master Health Monitoring](master-health-monitoring.md) - Post-merge CI monitoring
- [Master Health Monitoring](../docs/master-health-monitoring.md) - Post-merge CI monitoring
- [CLAUDE.md](../../CLAUDE.md) - Full development guide with CI debugging

## Agent Behavior
Expand Down Expand Up @@ -146,7 +146,7 @@ bundle exec rake

**Why this matters:**

- See [testing-build-scripts.md](testing-build-scripts.md) for real examples of silent failures
- See [../docs/testing-build-scripts.md](../docs/testing-build-scripts.md) for real examples of silent failures
- Build scripts run during `npm install`, `yalc publish`, and package installation
- Failures are often SILENT in CI but break users completely

Expand Down Expand Up @@ -211,7 +211,7 @@ gh run list --workflow="Integration Tests" --branch <pr-branch> --limit 10 --jso
# Key question: Did MY commits break it, or was it already broken?
```

**See [testing-build-scripts.md](testing-build-scripts.md) "Before You Start: Check CI Status"**
**See [../docs/testing-build-scripts.md](../docs/testing-build-scripts.md) "Before You Start: Check CI Status"**

**Reproduce failures locally:**

Expand Down
10 changes: 5 additions & 5 deletions .claude/docs/pr-testing-guide.md → .claude/agents/pr-testing-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ This guide shows you **how to use** the PR Testing Agent with Claude Code, inclu
**Related Documentation:**

- **[PR Testing Agent](pr-testing-agent.md)** - Core agent behavior and requirements
- [Testing Build Scripts](testing-build-scripts.md) - Build/package testing requirements
- [Testing Build Scripts](../docs/testing-build-scripts.md) - Build/package testing requirements
- [CI Config Switching](../../SWITCHING_CI_CONFIGS.md) - Testing minimum vs latest dependencies
- [CLAUDE.md](../../CLAUDE.md) - Full development guide

Expand Down Expand Up @@ -68,7 +68,7 @@ This guide shows you **how to use** the PR Testing Agent with Claude Code, inclu
**The easiest way to use this agent with Claude Code is to explicitly reference it in your prompts:**

```
"Use the PR Testing Agent from .claude/docs/pr-testing-agent.md to validate my testing"
"Use the PR Testing Agent from .claude/agents/pr-testing-agent.md to validate my testing"

"I changed package.json. According to PR Testing Agent Section 3, what testing is required?"

Expand Down Expand Up @@ -334,7 +334,7 @@ pbpaste | bin/ci-run-failed-specs

**The PR Testing Agent guidelines are automatically available when:**

- You reference `.claude/docs/pr-testing-agent.md` in prompts
- You reference `.claude/agents/pr-testing-agent.md` in prompts
- You mention "PR Testing Agent" or "testing checklist"
- You ask about testing requirements for specific file types
- CLAUDE.md is loaded (which references this documentation)
Expand Down Expand Up @@ -686,8 +686,8 @@ gh pr view --json statusCheckRollup

**Reference documentation:**

- Testing build scripts: [testing-build-scripts.md](testing-build-scripts.md)
- Testing build scripts: [../docs/testing-build-scripts.md](../docs/testing-build-scripts.md)
- CI debugging: [CLAUDE.md](../../CLAUDE.md) "Replicating CI Failures Locally"
- Config switching: [SWITCHING_CI_CONFIGS.md](../../SWITCHING_CI_CONFIGS.md)
- Local testing issues: [spec/dummy/TESTING_LOCALLY.md](../../spec/dummy/TESTING_LOCALLY.md)
- Master health: [master-health-monitoring.md](master-health-monitoring.md)
- Master health: [../docs/master-health-monitoring.md](../docs/master-health-monitoring.md)