Update repo documentation and agent-facing guidance such as AGENTS.md, README.md, docs/, specs, plans, and runbooks. Use when code, skill, or infrastructure changes risk doc drift or when documentation needs cleanup or restructuring. Do not use for code review, runtime verification, or `agent-readiness` setup.
98
100%
Does it follow best practices?
Impact
94%
1.00xAverage score across 3 eval scenarios
Passed
No known issues
{
"context": "Tests whether the agent restructures monolithic README.md content into the correct top-level doc split (README.md for users, CONTRIBUTING.md for contributors, SECURITY.md for reporters), following the prescribed section order in each file, with README.md linking out rather than duplicating content.",
"type": "weighted_checklist",
"checklist": [
{
"name": "README hero section",
"description": "README.md starts with a one-sentence purpose/description of the project (hero section is first or near-first)",
"max_score": 10
},
{
"name": "README install near top",
"description": "README.md has Installation section before Architecture or any deep explanatory content",
"max_score": 10
},
{
"name": "README links out to CONTRIBUTING",
"description": "README.md contains a link or pointer to CONTRIBUTING.md rather than re-stating contributor steps inline",
"max_score": 8
},
{
"name": "README links out to SECURITY",
"description": "README.md contains a link or pointer to SECURITY.md rather than re-stating security contact inline",
"max_score": 8
},
{
"name": "No content duplication",
"description": "Contributor setup steps (npm install, branch naming, PR process) appear in CONTRIBUTING.md but NOT duplicated in README.md",
"max_score": 8
},
{
"name": "CONTRIBUTING setup first",
"description": "CONTRIBUTING.md has Setup or environment bootstrap section before Pull request or Release notes sections",
"max_score": 8
},
{
"name": "CONTRIBUTING validation section",
"description": "CONTRIBUTING.md contains a section for running tests/validation with the actual commands (npm test or npm run test:coverage)",
"max_score": 8
},
{
"name": "SECURITY private-first",
"description": "SECURITY.md explicitly tells reporters NOT to open public issues for vulnerabilities",
"max_score": 12
},
{
"name": "SECURITY contact present",
"description": "SECURITY.md contains a contact section with the security email address",
"max_score": 10
},
{
"name": "SECURITY short",
"description": "SECURITY.md is at most 50 lines",
"max_score": 8
},
{
"name": "Doc changes summary",
"description": "doc-changes.md exists and lists at least two pieces of content that moved from README.md to another file",
"max_score": 10
}
]
}