# Human-Validated PR Templates

Adapt these sections to the repository. Merge them into existing documents instead of duplicating headings or deleting project-specific guidance.

## `CONTRIBUTING.md`

```md
## Human validation

AI-assisted contributions are welcome, but a human must personally validate the resulting change before requesting review. The pull request must describe what was tested and how.

Agents may prepare changes and draft pull request content. A human must provide or approve the final description, personally perform the appropriate validation, and mark the pull request ready for review.

Validation should fit the change. For example, code changes may require automated tests and manual behavior checks, while documentation changes may require checking rendered output, links, examples, and formatting. If the required validation has not been completed, keep the pull request in draft state and identify what remains unverified.
```

## `AGENTS.md`

```md
## Pull requests

Agents may prepare changes, commits, validation summaries, and draft pull request text. Do not push a branch, create a pull request, or modify public repository metadata without explicit user approval for that specific action.

Repository policy requires a human to personally test or otherwise validate the change, provide or approve the final pull request description, and mark the pull request ready for review. Never claim that a human performed validation unless they explicitly confirm it.

When asked to create a pull request, explain this policy and offer a proposed description for the human to use. If the user explicitly authorizes the agent to create it anyway, create only a draft pull request with the automated-draft hold notice. Do not mark it ready for review or check any human-validation attestations.
```

## Automated-draft hold notice

Use this only while it is true:

```md
> **Automated draft:** The submitting user has not yet provided the required human-reviewed description. Hold review until this notice is replaced and the pull request is marked ready.
```

Implementation details and agent-run checks may follow the notice, but they do not satisfy the human-validation requirement.

## `.github/pull_request_template.md`

```md
## Summary

<!-- Explain the change and why it is needed. -->

## Human validation

- [ ] I personally validated this change.
- [ ] I described the validation I performed below.
- [ ] I replaced any automated-draft hold notice.

### Validation performed

<!-- List commands you personally ran and/or behavior you personally checked. -->

## Additional context

<!-- Risks, screenshots, follow-up work, or anything reviewers should know. -->
```

Do not pre-check these boxes. A human completes them before requesting review.