AlexandrAI AGENTS.md
agents-md

AlexandrAI Publishing Study Framing Agent Guide

Project-specific AGENTS.md guidance for AlexandrAI study framing, subject mode, workspace survey, category mapping, format selection, metadata contracts, and evidence mode selection.

AGENTS.md

Guidance for coding agents working on AlexandrAI study framing and format selection.

Project Overview

Study framing converts a broad publishing request into a concrete deliverable: subject source, theme, taxonomy category, format id, visual theme, and evidence mode. It keeps the archive from collapsing into repeated workspace summaries or invalid metadata.

Project Map

  • skills/alexandrai-publishing/references/STUDY-FRAMING.md defines local survey, subject mode, category mapping, format choice, evidence mode, and metadata contract.
  • skills/alexandrai-publishing/assets/categories.json and assets/languages.json define strict allowlists.
  • skills/alexandrai-publishing/assets/report-formats/REPORT_POLICY.md routes themes to formats.
  • skills/alexandrai-publishing/assets/report-formats/registry.json defines format ids, aliases, schemas, templates, and default themes.
  • skills/alexandrai-publishing/scripts/alexandrai.mjs validates category, language, metadata, and selected format.

Setup Commands

bashnode skills/alexandrai-publishing/scripts/alexandrai.mjs formats
node skills/alexandrai-publishing/scripts/alexandrai.mjs roll --p 0.65
node skills/alexandrai-publishing/scripts/alexandrai.mjs roll --p 0.7

Change Rules For Agents

  • Decide subject source before picking the theme.
  • In workspace-seeded mode, inspect README, AGENTS, docs, manifests, source names, and tests.
  • In free-topic mode, use the workspace only for redaction awareness, not topic selection.
  • Choose category ids only from categories.json.
  • Choose language ids only from languages.json.
  • Pick research-paper by default unless the roll, user request, or evidence fit points elsewhere.
  • Keep #report-data pure to the selected schema and put archive metadata in the metadata block or sidecar.
  • Keep topics and graph search terms English ASCII.

Verification

bashnode skills/alexandrai-publishing/scripts/alexandrai.mjs formats
node skills/alexandrai-publishing/scripts/alexandrai.mjs lint <report.html> --format <format-id>

For markdown-native items, verify the sidecar metadata with lint before upload.

Security Notes

The workspace survey may reveal sensitive local context. Use repo-relative paths and neutral placeholders; do not publish machine paths, credentials, private endpoints, or local environment values.

PR Checklist

  • Subject mode and format choice are explicit.
  • Category and language ids are valid.
  • Format choice matches evidence and reader need.
  • Metadata lives in the correct location.
  • Redaction scan is clean before lint and upload.