Mermaid Diagram Style Guide

{
  "id": "mermaid-diagrams",
  "numericId": "E735",
  "path": "/internal/mermaid-diagrams/",
  "filePath": "internal/mermaid-diagrams.mdx",
  "title": "Mermaid Diagram Style Guide",
  "quality": 37,
  "readerImportance": 12,
  "researchImportance": 10,
  "tacticalValue": null,
  "contentFormat": "article",
  "tractability": null,
  "neglectedness": null,
  "uncertainty": null,
  "causalLevel": null,
  "lastUpdated": "2026-03-13",
  "dateCreated": "2026-02-20",
  "llmSummary": "Internal style guide for creating Mermaid diagrams in the wiki, recommending vertical layouts over horizontal (max 3-4 parallel nodes), providing semantic color palette, and advocating tables over diagrams for taxonomies. Includes practical width limits and anti-patterns for common diagram issues.",
  "description": "Guidelines for creating effective Mermaid diagrams in this wiki",
  "ratings": {
    "novelty": 1,
    "rigor": 4,
    "actionability": 6,
    "completeness": 7
  },
  "category": "internal",
  "subcategory": "style-guides",
  "clusters": [
    "ai-safety"
  ],
  "metrics": {
    "wordCount": 422,
    "tableCount": 3,
    "diagramCount": 6,
    "internalLinks": 0,
    "externalLinks": 0,
    "footnoteCount": 0,
    "bulletRatio": 0,
    "sectionCount": 20,
    "hasOverview": false,
    "structuralScore": 8
  },
  "suggestedQuality": 53,
  "updateFrequency": 90,
  "evergreen": true,
  "wordCount": 422,
  "unconvertedLinks": [],
  "unconvertedLinkCount": 0,
  "convertedLinkCount": 0,
  "backlinkCount": 2,
  "hallucinationRisk": {
    "level": "medium",
    "score": 60,
    "factors": [
      "no-citations",
      "low-quality-score"
    ]
  },
  "entityType": "internal",
  "redundancy": {
    "maxSimilarity": 0,
    "similarPages": []
  },
  "changeHistory": [
    {
      "date": "2026-02-17",
      "branch": "claude/add-page-info-boxes-7WxMd",
      "title": "Add PageStatus and info boxes to internal pages",
      "summary": "Enabled PageStatus rendering, Data links, and Feedback widgets on internal pages by removing the `isInternal` guards in the wiki page renderer. Added `evergreen`, `update_frequency`, and `lastEdited` frontmatter to all ~40 internal pages so update schedules and staleness indicators are visible.",
      "pr": 185
    },
    {
      "date": "2026-02-15",
      "branch": "claude/internal-pages-infrastructure-Y2TWq",
      "title": "Internal pages entity infrastructure",
      "summary": "Added full entity infrastructure to internal pages (style guides, architecture docs, research reports, schema docs). Internal pages now have the `internal` entity type, get auto-assigned E* numeric IDs (E698-E731), are included in the search index, and participate in backlinks/related graph computation. Includes review fixes: filtering internal pages from public explore/home, converting all 7 remaining .md files, adding `internal` to data/schema.ts, and updating all `shouldSkipValidation`/`pageType === 'documentation'` checks.",
      "pr": 142
    }
  ],
  "coverage": {
    "passing": 5,
    "total": 13,
    "targets": {
      "tables": 2,
      "diagrams": 0,
      "internalLinks": 3,
      "externalLinks": 2,
      "footnotes": 2,
      "references": 1
    },
    "actuals": {
      "tables": 3,
      "diagrams": 6,
      "internalLinks": 0,
      "externalLinks": 0,
      "footnotes": 0,
      "references": 0,
      "quotesWithQuotes": 0,
      "quotesTotal": 0,
      "accuracyChecked": 0,
      "accuracyTotal": 0
    },
    "items": {
      "llmSummary": "green",
      "schedule": "green",
      "entity": "red",
      "editHistory": "green",
      "overview": "red",
      "tables": "green",
      "diagrams": "green",
      "internalLinks": "red",
      "externalLinks": "red",
      "footnotes": "red",
      "references": "red",
      "quotes": "red",
      "accuracy": "red"
    },
    "editHistoryCount": 2,
    "ratingsString": "N:1 R:4 A:6 C:7"
  },
  "readerRank": 574,
  "researchRank": 556,
  "recommendedScore": 100.98
}

No external links