Track AI mentions and citations with fixed questions Native input preparation Editorial analysis contract, never a claim about vendor-native export headers Existing examples/checklists are optional supporting scaffolds unless explicitly mapped below. Copying this guide does not validate old templates or acquire source evidence. These are blank review scaffolds. Fill them only from source evidence acquired through START-HERE.txt. Original examples belong to the original prompt and do not test this native route. A source bundle requires actual approved evidence and has no blank substitute. BEFORE USING AN AI TOOL - Existing authorized access to the named product and in-scope records; actual tenant, plan, permissions and menu version must be checked. - Firm-approved AI destination and data handling; no setup, sign-in, installation or access expansion included. STOP OR LIMIT THE REVIEW INPUTS AND EXACT MAPPINGS contractVersion: 1 schemaOrigin: Editorial analysis contract, never a claim about vendor-native export headers testedStatus: False existingKitRole: Existing examples/checklists are optional supporting scaffolds unless explicitly mapped below. Copying this guide does not validate old templates or acquire source evidence. requiredInputs: - name: benchmark-protocol.txt type: text requiredSections: - approved practice/jurisdiction and fixed question panel reference - branded/unbranded groups; provider/interface/mode/locale/model-as-shown - account/personalization state; predetermined repetition IDs and windows - failed/no-answer retention; mention/entity rules and source-support criteria - full panel versus explicitly labelled bounded pilot; lawyer/research reviewer required: True templateFilename: native-benchmark-protocol-template.txt existingKitFiles: - benchmark-protocol-template.txt compatibility: Existing protocol scaffold can be retained and completed. Its 20–30 question panel applies to the full benchmark; a smaller native pilot must be labelled partial and cannot claim the full benchmark. missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete. inputName: benchmark-protocol.txt sections: - approved practice/jurisdiction and fixed question panel reference - branded/unbranded groups; provider/interface/mode/locale/model-as-shown - account/personalization state; predetermined repetition IDs and windows - failed/no-answer retention; mention/entity rules and source-support criteria - full panel versus explicitly labelled bounded pilot; lawyer/research reviewer compatibleWithoutMapping: False - name: question-panel.csv type: csv headers: - query_id - prompt_text - branded_group - practice - jurisdiction - approval_ref required: True templateFilename: native-question-panel-template.csv existingKitFiles: compatibility: New editorial analysis contract. Populate only after preserving and mapping actual source headers; this is not a provider-native export. missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete; never fill evidence gaps by inference. inputName: question-panel.csv compatibleWithoutMapping: False - name: observations.csv type: csv headers: - run_id - query_id - repetition_id - engine - interface - mode - model_label - locale - account_state - observed_at - timezone - run_status - answer_ref - source_ref required: True templateFilename: native-observations-template.csv existingKitFiles: - input-preparation.txt compatibility: Legacy ai-citation-runs.csv can map run/query IDs and actual collection metadata when headers are inspected. Retain every planned repetition including failure/no_answer; missing settings remain unknown. missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete; never fill evidence gaps by inference. inputName: observations.csv compatibleWithoutMapping: False - name: mentions.csv type: csv headers: - run_id - mention_id - entity_id - exact_mention_text - answer_location - entity_match_status - reviewer_alias - source_ref required: True templateFilename: native-mentions-template.csv existingKitFiles: compatibility: New normalized mention table: one observed entity mention per row. Existing run-table mention cells can be split only with exact answer locations and human-checked identity; never fabricate mentions from citations. missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete; never fill evidence gaps by inference. inputName: mentions.csv compatibleWithoutMapping: False - name: citation-checks.csv type: csv headers: - run_id - citation_id - source_url - answer_location - linked_statement - source_support_status - checked_at - reviewer_alias - source_ref required: True templateFilename: native-citation-checks-template.csv existingKitFiles: - input-preparation.txt compatibility: Legacy ai-citation-sources.csv maps actual visible source links only. Add answer location, linked statement and human checked source_support_status. A link is not automatically supporting evidence. missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete; never fill evidence gaps by inference. inputName: citation-checks.csv compatibleWithoutMapping: False - name: full-answer-text/ type: source-bundle required: True templateFilename: None requiredContents: Entire actual answer for every successful run, keyed by answer_ref; failed/no-answer observations have explicit run_status instead of fabricated text compatibility: Must be actual approved public/deidentified source content, not an empty template. Untouched originals remain separately restricted. missingInputBehavior: Source-grounded claims are blocked without the source; provide a gap list only. inputName: full-answer-text/ compatibleWithoutMapping: False - name: public-page-inventory.csv type: csv headers: - url - entity_id - page_purpose - captured_at - source_ref required: True templateFilename: native-public-page-inventory-template.csv existingKitFiles: compatibility: Preserves the earlier public-page inventory requirement for verifying entities/cited pages; no site crawl or source fetching is assumed. missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete; never fill evidence gaps by inference. inputName: public-page-inventory.csv compatibleWithoutMapping: False - name: manifest.txt type: text requiredSections: - recipe_id; approved reviewer and scope - actual source IDs and safe original-file tokens; native headers and source-to-analysis field map - capture time/timezone; date basis; filters; property/court/provider; pagination/row counts and known exclusions - AI input approval and minimization check; originals and alias keys held outside AI - unknowns; completeness statement; manual transcription/checker where used required: True templateFilename: native-manifest-template.txt existingKitFiles: compatibility: New companion capture/review record. Staff supplies observed or approved values; unknown is explicit. missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete. inputName: manifest.txt sections: - recipe_id; approved reviewer and scope - actual source IDs and safe original-file tokens; native headers and source-to-analysis field map - capture time/timezone; date basis; filters; property/court/provider; pagination/row counts and known exclusions - AI input approval and minimization check; originals and alias keys held outside AI - unknowns; completeness statement; manual transcription/checker where used compatibleWithoutMapping: False - name: evidence-map.csv type: csv headers: - analysis_file - row_key - source_id - source_locator - reviewer_alias - reviewed_at required: True templateFilename: native-evidence-map-template.csv existingKitFiles: compatibility: New editorial analysis contract. Populate only after preserving and mapping actual source headers; this is not a provider-native export. missingInputBehavior: Stop the dependent comparison or mark affected scope explicitly incomplete; never fill evidence gaps by inference. inputName: evidence-map.csv compatibleWithoutMapping: False compatibilityNotes: - ai-citation-runs.csv and ai-citation-sources.csv are optional legacy filenames only after explicit field mapping to observations.csv and citation-checks.csv. They do not substitute for exact questions, full answers, planned-run denominator or checked mentions. - The native acquisition route documents Gemini only. Existing observations from other engines remain separate strata with their own verified collection conditions; do not label them Gemini or directly comparable by default. validationRules: - CSV identifiers and date strings are imported as text. Preserve leading zeros and exact keys. Do not execute formulas from source values. - Blank templates are deliberately incomplete. Unknown is not zero, false, missing-not-found or a passing review. - Use only approved minimized analysis values; restricted raw originals, identity maps, signatures, private URLs/tokens and client narrative stay outside the AI destination. - A native file may retain its actual header names if manifest.txt supplies a reviewer-verified one-to-one map to this contract. Do not blindly rename files/headers. compatibleWithoutMapping: False legacyMappings: - existingKitFiles: - benchmark-protocol-template.txt nativeInput: benchmark-protocol.txt mapping: Existing protocol scaffold can be retained and completed. Its 20–30 question panel applies to the full benchmark; a smaller native pilot must be labelled partial and cannot claim the full benchmark. compatibleWithoutMapping: False - existingKitFiles: - input-preparation.txt nativeInput: observations.csv mapping: Legacy ai-citation-runs.csv can map run/query IDs and actual collection metadata when headers are inspected. Retain every planned repetition including failure/no_answer; missing settings remain unknown. compatibleWithoutMapping: False - existingKitFiles: - input-preparation.txt nativeInput: citation-checks.csv mapping: Legacy ai-citation-sources.csv maps actual visible source links only. Add answer location, linked statement and human checked source_support_status. A link is not automatically supporting evidence. compatibleWithoutMapping: False additionalEvidence: - question-panel.csv - mentions.csv - full-answer-text/ - public-page-inventory.csv - manifest.txt - evidence-map.csv ACTUAL SOURCE REQUIREMENTS full-answer-text/ Entire actual answer for every successful run, keyed by answer_ref; failed/no-answer observations have explicit run_status instead of fabricated text Source-grounded claims are blocked without the source; provide a gap list only. Actual evidence required. This kit does not include a placeholder that counts as evidence. FINAL CHECK Every stated input is loaded or pasted into the analysis tool; IDs, scope and date basis are verified; missing facts stay unknown. Native exports keep their original headers until an explicit, reviewed field map is recorded. Account behavior and end-to-end execution were not tested.