Make a Wiki Component Page - templates/page.json

by adom

Create a wiki component page the RIGHT way. Pages are keyed manufacturer-mpn and scoped to ONE DATASHEET, so a datasheet covering six voltages and three packages is ONE page covering all of them, never six pages. Two manufacturers publishing the same MPN are two pages, because their limits genuinely differ. Renders through a hand-built readme.html on the Adom theme tokens with a fixed ten-section shape (identity, at a glance, specifications, symbol+footprint viewers, pin map, variants, assets, i

Overview Files Skills Discover Packages Releases Dependencies Issues1 Breadcrumbs Pull Requests Activity

Download

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72

{
  "_comment": "Manifest skeleton for a wiki component page. Replace every {{TOKEN}} and delete this key. The SAME title/description/tags must also go in package.json: page.json drives the page repo (repo push), package.json drives the registry (pkg publish), and the page header reads whichever was written last.",

  "schema_version": 1,
  "type": "component",
  "slug": "{{MANUFACTURER_SHORT}}-{{MPN_LOWER}}",
  "title": "{{WHAT_IT_IS}} {{MFR}} - {{MPN}}",
  "brief": "{{ONE_OR_TWO_SENTENCES}}. Name the manufacturer, the headline rating, the variant range the datasheet covers, and the packages.",
  "version": "1.0.0",

  "tags": [
    "component",
    "ic",
    "{{FUNCTION}}",
    "{{MPN_LOWER}}",
    "{{MANUFACTURER_SHORT}}",
    "kicad",
    "adom-lbr"
  ],

  "sample_prompts": [
    "Pull the {{MFR}} {{MPN}} KiCad symbol, footprint and 3D model into my project",
    "{{A_REAL_SELECTION_QUESTION_SOMEONE_WOULD_ASK}}"
  ],

  "component": {
    "mpn": "{{MPN}}",
    "manufacturer": "{{MANUFACTURER_FULL}}",
    "package": "{{PRIMARY_PACKAGE}}",
    "pin_count": 0,
    "category": "{{CATEGORY}}",
    "subcategory": "{{SUBCATEGORY}}",
    "datasheet": "{{VENDOR_DATASHEET_URL}}",
    "parts": {
      "symbol": "{{SLUG_STEM}}.kicad_sym",
      "footprint": "{{SLUG_STEM}}-{{PKG}}.kicad_mod",
      "footprint_alt": "{{SLUG_STEM}}-{{PKG2}}.kicad_mod",
      "model_3d": "{{SLUG_STEM}}-{{PKG}}.glb",
      "model_3d_chip": "{{SLUG_STEM}}-{{PKG}}.glb",
      "step": "{{SLUG_STEM}}-{{PKG}}.step"
    },
    "distributor_links": {
      "lcsc": "{{LCSC_OR_DELETE}}"
    },
    "datasheet_cover": "screenshots/datasheet-cover.png",
    "viewer_3d": { "ground": false },
    "body": "{{BODY_DIMENSIONS}}",
    "pitch": "{{LEAD_PITCH}}"
  },

  "metadata": {
    "specs": {
      "{{PARAMETER}}": "{{VALUE_WITH_CONDITIONS}}"
    },
    "cad_provenance": "Where the symbol, each footprint and each 3D model actually came from, including original library names before renaming, and anything deliberately NOT shipped."
  },

  "discovery_triggers": [
    "{{MPN_LOWER}}",
    "{{MFR}} {{MPN_LOWER}}",
    "{{WHAT_SOMEONE_SEARCHES_WHEN_THEY_DO_NOT_KNOW_THE_PART_NUMBER}}"
  ],
  "discovery_pitch": "One sentence an agent can surface. Say what the part does, what the page ships, and what makes it worth opening.",

  "org": "adom",
  "visibility": "public",
  "hero": { "type": "image", "path": "screenshots/hero.png" },

  "description": "The long form. Manufacturer, function, the full variant range the datasheet covers, headline limits with their conditions, packages, and any gotcha a reader must not miss (exposed pad net, tab function, second-source differences).",

  "dependencies": {}
}