Contracts

Each checklist H2 is a question that every selected declaration answers in its doc comment. A package's evidence.config.json selects the checklists; pnpm evidence checks that answers exist, and review checks that they are true and complete.

Answering

1. Before writing, read the declaration and everything its H2 asks about, such as its callees, callers, tests, and platforms.
2. Answer every fact the H2 asks for, from what the code actually does. A partial, generic, or untrue answer is a defect, not a pass.
3. If the code falls short of the question, fix the code, and state any gap that remains instead of claiming the requirement is met.
4. Write @evidence contracts/<file>.md#<anchor> <reason> after a blank comment line, and @evidenceExclude the same way only for an item that does not apply, never for a whole file.

Selection

• From a package, pnpm exec evidence list and pnpm exec evidence inspect '<target>' show what a selector reaches.
• For a declaration the adapter cannot address, keep its native doc comment and place its checklist answers and tags on the nearest supported owner shown by list and inspect.
• Claims: 3/4 active means a selector matched nothing, without a diagnostic, and Coverage counts checklist sections, not declarations.
• A Go package of unexported declarations, such as packages/evidence/native, selects no production host, so review covers it. A declare module "@ttsc/lint" augmentation reports typescript-ambient-module until the adapter resolves it.
• Exclude only generated, copied, or dependency material with verified provenance, and omit a pure re-export barrel whose targets span disjoint claims.
• Never narrow a selector or lower a severity to pass the check.
• Enroll tests in the existing Evidence step of build.yml, and record entries the adapter cannot address, such as anonymous callbacks or dynamic registrations, for review.

Editing The Checklists

Tens of thousands of tags cite their paths and H2s, so adding, renaming, or removing an H2 needs an authorized migration of every answer. Keep one chapter per question.