docs: clarify shared validation and SRP review checks

Merged
SI
1mo ago
+56-0

API instructions state SRP/DRY principles but leave reviewers to infer shared-validation checks for matching API/MCP capabilities. Add one checklist for file responsibilities, schema reuse, required inputs, defaults/limits and repeated transforms, preserving intentional transport differences and the current MCP registration/authentication design.

This is the contributor-instruction slice of existing #358/API #258. Its current comparison includes unrelated runtime/content files; those remain outside this successor and the historical PR stays open. The verification note records the exact original and current-main baseline.

Validation: required pnpm lint and git diff --check pass. Only two Markdown files change; all existing AGENTS content outside the new checklist, runtime code, schemas, fixtures and public-documentation pins are unchanged. No new runtime test is needed for this instruction-only change; independent review and normal PR CI follow.


Summary by cubic

Adds an explicit SRP/DRY review checklist to AGENTS.md so API/MCP shared-capability checks no longer rely on reviewer inference.

  • The checklist covers file responsibility, schema reuse, required inputs, defaults/limits, and repeated transforms, while preserving intentional transport differences and the current MCP registration design.
  • Adds docs/verification/reviewer-guidance-retired-pr.md recording this successor's scope against the original API #258, whose GitHub comparison includes unrelated runtime/content files that remain out of scope.