Skip to main content

AST Variables Compilation

To ensure the monorepo remains fully copy-pasteable and generic for AI context injection, we enforce the usage of AST (Abstract Syntax Tree) Variables across the documentation hub.

1. The remark-project-variables Plugin​

Documentation authors and AI agents are strictly forbidden from hardcoding the brand domain (e.g., example.com). Instead, they must use agnostic tokens:

  • tupynambalucas.dev
  • Tupynambalucas
  • tupynambalucas-dev

The remark-project-variables plugin intercepts the Docusaurus MDX compilation pipeline, traverses the Markdown AST (mdast), and replaces these tokens with the active configurations found in project.config.json before rendering the final HTML.

This prevents "Brand Hallucination" when the AI extracts context using RAG memory indexing.