diff --git a/AGENTS.md b/AGENTS.md index 7c195c822..ae5b41717 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -242,9 +242,8 @@ Command-only flags (like `find --first`) that don't flow to the platform layer o - Open a ready-for-review PR by default. Use a draft PR only when the user explicitly asks for one or the work is intentionally incomplete. - Run required checks for touched scope from **Testing Matrix**. - PR body must be short and include: - - `## Summary` - - `## Validation` written as evidence of what was checked and what passed; prefer concise prose such as "Unit tests covered X", "SkillGym confirmed Y planning", "Manual Android run showed Z before/after". Avoid dumping raw command lists unless a specific command is the useful evidence. -- In the summary, describe behavior changes as before/after when that makes the fix easier to review. + - `## Summary`: describe the user-visible or reviewer-relevant change as before/after when useful, and include the issue closed by the PR using `Closes #123` when applicable. + - `## Validation`: answer this prompt in concise prose: "How did you verify the change, and what passed or changed on screen?" Prefer evidence over command dumps; mention the relevant check category or scenario, and include screenshots when visual/UI behavior is relevant. - Call out known gaps/follow-ups explicitly. - Include touched-file count and note if scope expanded beyond initial command family.