claude-tap AGENTS.md

Maintainer Automation Notes

External contributors should start with CONTRIBUTING.md. This file documents stricter maintainer and agent automation workflows; it is not the public contribution checklist.

AGENTS 索引

本文件是贡献者规则的入口。详细策略文本位于 .agents/docs/standards/*.md。

Documentation Boundary

docs/ is reserved for public project documentation and README assets that open-source users or external contributors read directly. Maintainer policies, implementation plans, learning records, PR evidence, and recording assets belong under .agents/ so internal automation workflows stay out of the public docs tree.

Public user-facing documentation must be bilingual. Add or update the English document and the Simplified Chinese counterpart together; use README.md with README_zh.md, and use *.zh.md beside English guide files under docs/guides/.

Review Guidelines

When reviewing pull requests, prioritize findings that can cause correctness bugs, regressions, security or privacy issues, release failures, broken CI, broken packaging, or misleading evidence. Treat these as high-priority review findings.

Do not block on style-only or preference-only comments unless they make the code materially harder to maintain or violate an existing repository rule.

For every pull request, check:

1. The implementation matches the requested scope and does not mix unrelated refactors, feature work, or generated artifacts.
2. Tests contain meaningful assertions that would fail for realistic regressions, not only line coverage.
3. UI, viewer, or evidence changes include real trace-backed screenshots or recordings when required by repository policy.
4. Public documentation changes are bilingual, with matching English and Simplified Chinese updates.
5. Workflow, release, credential, subprocess, network, filesystem, and dependency changes use least privilege and avoid leaking secrets.
6. Commit titles, PR titles, PR bodies, and evidence links follow the repository contribution and preflight requirements.