AlexandrAI AGENTS.md
agents-md

AlexandrAI Publishing Research Paper Gate Agent Guide

Project-specific AGENTS.md guidance for the AlexandrAI research-paper gate, researchAudit minimums, citation checks, claim ledger validation, scarce-evidence audits, and paper length checks.

AGENTS.md

Guidance for coding agents working on the AlexandrAI research-paper gate.

Project Overview

The research-paper gate prevents shallow papers from being published as formal scholarship. It validates metadata, taxonomy ids, references, inline citations, researchAudit depth, full-read support, claim ledger support, scarce-evidence exhaustion, and minimum rendered length.

Project Map

  • skills/alexandrai-publishing/assets/report-formats/specs/research-paper.md defines the paper authoring contract.
  • skills/alexandrai-publishing/assets/report-formats/schemas/research-paper.schema.json defines the report-data shape.
  • skills/alexandrai-publishing/assets/report-formats/templates/research_paper_sample.html provides the canonical shell.
  • skills/alexandrai-publishing/scripts/alexandrai.mjs implements validateData(), validateResearchAudit(), validateExhaustionAudit(), scanCitations(), and prose length checks.
  • skills/alexandrai-publishing/references/WEB-RESEARCH.md defines external evidence discipline.
  • skills/alexandrai-publishing/references/STUDY-FRAMING.md defines theme, category, and evidence mode selection.

Setup Commands

bashnode skills/alexandrai-publishing/scripts/alexandrai.mjs lint paper.html --format research-paper
node skills/alexandrai-publishing/scripts/alexandrai.mjs search "<core concept>" "<method>" "<domain>"

Change Rules For Agents

  • Require top-level paper metadata, sections, references, aipaper metadata, and researchAudit.
  • Keep paper keywords and topics English ASCII.
  • Cite only references that appear in researchAudit.fullReadSources.
  • Map every major claim to full-read source ids, reasoning support, or computation support.
  • Use reasoning support only for explicitly marked inference claims.
  • Require an exhaustion audit for scarce evidence.
  • Validate inline citation markers against declared reference ids.
  • Keep the minimum length gate tied to rendered prose and earned figures or tables.

Verification

bashnode skills/alexandrai-publishing/scripts/alexandrai.mjs lint paper.html --format research-paper

Repair the exact machine-readable lint errors. Do not bypass the gate by changing format unless the subject truly cannot sustain a formal paper.

Security Notes

Research-paper references and audit records are public. Do not include private URLs, local files, credentials, or source excerpts that exceed fair quotation limits.

PR Checklist

  • Research audit minimums still run.
  • Cited references must be full-read.
  • Claim ledger support is validated.
  • Scarce evidence requires exhaustion.
  • Citation scan covers nested sections.