Digital Karma Web Standards & Architecture

Constellation Protocol v7.1

The Digital Karma Web Constellation is an open standard enabling any AI-ready website to join an aligned pattern of connected digital assets. Sites discover, understand, and trust each other through standardized endpoints, root discovery files, and transparent reputation scoring. DigitalKarmaWeb.com is the specification authority, but any site can implement the standard independently.

Core Principles

1. Discoverability - Sites expose predictable machine-readable entry points.
2. Interoperability - JSON payloads and Schema.org markup use consistent patterns.
3. Transparency - Quality scores and compliance signals are openly documented.
4. Decentralization - Peer-to-peer discovery works without mandatory central approval.
5. Root Integrity - robots.txt and sitemap.xml stay at the site root.
6. Version Discipline - The published version must match the actual implementation.

What Changed in v7.1

Compliance Levels

Read Full Constellation Spec

Required Artifacts

A v7.1 site publishes 5 required JSON files under /ai/ plus /llm.txt at the root.

Root Discovery Rules

v7.1 tightened the root placement rules. These are required operational discovery files, even though they are not part of the 6-artifact set.

/robots.txt

• Always store it at the site root.
• Do not relocate it into /ai/.
• Allow intended public AI discovery paths.
• Include a Sitemap: reference to the root /sitemap.xml.

/sitemap.xml

• Always store it at the site root.
• Treat it as the canonical crawl sitemap.
• If it is generated automatically, update the generator rather than hand-editing the artifact.

/ai/sitemap.json

• Optional companion inventory for machine-readable content maps.
• Helpful, but not a replacement for the root XML sitemap.

Manifest and Health Examples

Manifest Example

{
  "name": "Your Site Name",
  "url": "https://yoursite.com",
  "federation_version": "7.1",
  "updated_utc": "2026-04-22T00:00:00Z",
  "endpoints": {
    "manifest": "/ai/manifest.json",
    "health": "/ai/health.json",
    "catalog": "/ai/catalog.json",
    "karma": "/ai/karma.json",
    "federation": "/ai/federation.json",
    "llm_txt": "/llm.txt",
    "sitemap": "/sitemap.xml"
  },
  "related_sites": ["https://www.aiwebsitesystems.com"]
}

Health Example

{
  "site": "https://yoursite.com",
  "status": "ok",
  "federation_version": "7.1",
  "updated_utc": "2026-04-22T00:00:00Z",
  "last_rebuild_utc": "2026-04-22T00:00:00Z",
  "metrics": {
    "pageCount": 20,
    "datasetCount": 3,
    "entityCount": 4
  }
}

Schema and Scoring

Primary public-facing pages should include valid Schema.org JSON-LD. The most useful types across the portfolio are Organization, WebSite, WebPage, Service, Article, Dataset, and DataCatalog.

Scoring Signals

Badge Thresholds

• Karma Certified at 0.70 or higher
• Karma Pro at 0.85 or higher
• Karma Elite at 0.95 or higher

Naming rule: Do not use Karma Bronze on v7.x sites. The correct name is Karma Certified.

Directory Blueprint

Minimum v7.1 Shape

/
|-- ai/
|   |-- manifest.json
|   |-- health.json
|   |-- catalog.json
|   |-- karma.json
|   `-- federation.json
|-- llm.txt
|-- robots.txt
|-- sitemap.xml
`-- datasets/                # optional but recommended

Pro / Elite Shape

/
|-- ai/
|   |-- manifest.json
|   |-- health.json
|   |-- catalog.json
|   |-- karma.json
|   |-- federation.json
|   |-- diagnostics.json
|   |-- sitemap.json
|   `-- journal/
|-- entities/
|-- federation/
|-- datasets/
|-- llm.txt
|-- robots.txt
`-- sitemap.xml

Validation Checklist

Before marking a site as v7.1 complete, verify all of the following:

• /ai/manifest.json loads and parses.
• /ai/health.json loads and parses.
• /ai/catalog.json loads and parses.
• /ai/karma.json loads and parses.
• /ai/federation.json loads and parses.
• /llm.txt loads at the root.
• /robots.txt loads at the root.
• /sitemap.xml loads at the root.
• federation_version is "7.1" everywhere it appears.
• Schema.org exists on primary pages.
• Constellation peer links are present.
• robots.txt points to the root sitemap.xml.
• No one relocated root discovery files into /ai/.