ProcStack's AI Metadata Specification v0.1

Updated : June 17th 2025

This document defines custom metadata and link conventions used across the ProcStack project pages to expose structured data to bots, crawlers, and language models.

This document is a work in progress, structure for json's to be added shortly.

Meta Tags

• ai:data-source - Points to a JSON file containing full structured data about this page or project.
• ai:data-manifest - Points to a master manifest file listing all available structured content on the site.
• ai:content-api - Points to a base URL where related AI-parsable JSON files or endpoints exist.
• robots: ai:json - Optional value in robots meta tag indicating that AI-parsable structured content exists for this page.

Link Tags

• <link rel="alternate" type="application/json" ...> - JSON representation of the full site or specific page.
• <link rel="data-manifest" ...> - Points to the master structured content manifest (site-wide JSON).

Use Cases

• Allow AI crawlers to skip parsing raw HTML and use the structured JSON directly
• Enable automated indexing or analysis of content for search, LLM embeddings, or documentation purposes
• Help language models understand project structure, contributors, and page purpose
• Prevent excessive requests to the same web server

Example 1 - Site Root

URL : https://procstack.github.io/index.htm

<!-- AI/LLM Data Discovery -->
<meta name="ai:data-source" content="https://procstack.github.io/bots/siteContent.json">
<meta name="ai:data-manifest" content="https://procstack.github.io/data-manifest.json">
<link rel="alternate" type="application/json" href="https://procstack.github.io/bots/siteContent.json" title="Full JSON of all Page's Content Data">
<link rel="data-manifest" type="application/json" href="https://procstack.github.io/data-manifest.json" title="Data Sources Manifest" />
  

Example 2 - Individual Page

URL : https://procstack.github.io/ProjectsLinks/currentsOfWar.htm

<!-- AI/LLM Data Discovery -->
<meta name="ai:data-source" content="https://procstack.github.io/bots/ProjectsLinks_currentsOfWar.htm.json">
<meta name="ai:data-manifest" content="https://procstack.github.io/data-manifest.json">
<link rel="alternate" type="application/json" href="https://procstack.github.io/bots/ProjectsLinks_currentsOfWar.htm.json" title="Single Page Content Data">
<link rel="data-manifest" type="application/json" href="https://procstack.github.io/data-manifest.json" title="Data Sources Manifest" />
  

Example 3 - API End-Point

<meta name="ai:content-api" content="https://procstack.github.io/bots/">