Skip to content

Replay your coding agent sessions as a map and a timeline

docs: shorten PR template and add AI tools policy to CONTRIBUTING

Taradepan R1cc76c19dd27
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index a6bc110..d2540d8 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,11 +1,15 @@
-## What and why
+<!-- One change per PR. Read "Using AI tools" in CONTRIBUTING.md: a human must understand
+and be able to explain every line. PRs that look fully autonomous will be closed. -->
-<!-- One change per PR. Link the issue it closes, if any. -->
+## Summary
-## Checklist
+<!-- What and why, in your own words. Link the issue: Closes #N -->
+
+## Test plan
+
+<!-- What you ran and what you saw. For UI changes: before and after screenshots, light and dark
+(`pnpm screenshots` in `viewer/`). Say what you did not test. -->
- [ ] `make check` passes
-- [ ] Tests added or updated
- [ ] No prompt text, model output, tool input/output, file contents or command arguments can reach a map, a log line or the viewer ([redaction contract](https://github.com/Entelligence-AI/agentplay/blob/main/docs/format.md#redaction-contract))
- [ ] No new network calls or Python runtime dependencies
-- [ ] UI changes: before/after screenshots in light and dark (`pnpm screenshots` in `viewer/`)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 367b3df..93702cc 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -52,10 +52,19 @@ A parser turns one agent's transcript into the shared span shape: a root Session
- update [docs/format.md](docs/format.md), [schema/agentplay-v1.schema.json](schema/agentplay-v1.schema.json) and the viewer's zod schema (`viewer/src/core/schema.ts`) in the same PR;
- keep new fields optional for readers, since older maps will not have them.
+## Using AI tools
+
+AI coding tools are welcome. You stay responsible for everything you submit.
+
+- **A human must be in the loop.** Read and understand every line before you open the PR, and be ready to explain it. We close pull requests that look like they were opened by an agent with no one reviewing its work.
+- **Write the PR description and replies yourself.** Explain the change in your own words. If you quote AI output, put it in a quote block and say where it came from.
+- **Never claim a check you did not run.** The test plan says what you actually ran and saw, and what you did not test.
+
## Pull requests
-- Keep each PR to one change, and include tests.
+- Keep each PR to one change, and include tests that fail without it.
- Run `make check` before pushing.
+- Fill in the PR template: a summary in your own words, the linked issue, and a test plan.
- For UI changes, attach before and after screenshots in light and dark (`pnpm screenshots` in `viewer/`).
- By contributing, you agree that your contribution is licensed under the Apache License 2.0.