* docs(agents): add Working Principles and file/comment conventions
Add a "Working Principles" section at the top of AGENTS.md, with
Simplicity First (adapted from Andrej Karpathy's CLAUDE.md) as the lead
principle. Extend Code Conventions with two new entries:
- File naming: PascalCase for React components, kebab-case preferred for
new non-component files, existing camelCase stays as-is.
- Comments: default to none; explain why, not what.
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
* docs(agents): link Karpathy's CLAUDE.md in attribution
Per review feedback, make the source attribution clickable so reviewers
can reach the original document in one hop.
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
* docs(agents): align comments guidance — "default to none"
Raise the bar for code comments from "add sparingly" to "default to
none" in the runtime prompt, matching the AGENTS.md convention. Add a
preservation clause to AGENTS.md so agents do not strip existing
high-value comments during cleanup passes. Update snapshots.
Co-Authored-By: Qwen Code <noreply@alibaba-inc.com>
* docs(pr-template): restructure for reviewer test plan clarity
- Reorganize PR template around a Reviewer Test Plan section with How to verify, Before/After, and Tested on
- Add collapsible Chinese description section for bilingual PRs
- Simplify create-pr command guidance to match the new template
- Tighten AGENTS.md file naming and comments conventions; align PR submission guide with the new template
This makes PRs easier to review by focusing contributors on the evidence reviewers need most.
* docs(pr-template): merge Before/After into Evidence and require full Chinese translation
- Consolidate Before and After sections into a single Evidence (Before & After) section
- Update Chinese summary comment to require full paragraph-by-paragraph translation instead of abbreviated bullets
This reduces template redundancy for non-UI changes and ensures the Chinese block is a proper translation, not a summary.
---------
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
Co-authored-by: Qwen Code <noreply@alibaba-inc.com>
Move "Dive Deeper" section after "Screenshots / Video Demo" to improve
readability. Screenshots section is more actionable and should appear
earlier in the template.
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
Add a new section to the PR template encouraging contributors to attach
visual demos of their changes. This helps reviewers understand changes
quickly and prioritizes reviews. Also update CONTRIBUTING.md with
guidelines for different types of changes (bug fixes, features, refactors).
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
