[{"data":1,"prerenderedAt":581},["ShallowReactive",2],{"navigation_docs_en":3,"dtpr-schemas-index":287,"-en-plugin-comprehension-rubric":295,"-en-plugin-comprehension-rubric-surround":576},[4,22,26,30,102,152,174,196,226,278,283],{"title":5,"path":6,"stem":7,"children":8},"Getting started","/en/getting-started","en/1.getting-started/0.index",[9,10,14,18],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13},"MCP quickstart","/en/getting-started/mcp-quickstart","en/1.getting-started/1.mcp-quickstart",{"title":15,"path":16,"stem":17},"REST quickstart","/en/getting-started/rest-quickstart","en/1.getting-started/2.rest-quickstart",{"title":19,"path":20,"stem":21},"UI quickstart","/en/getting-started/ui-quickstart","en/1.getting-started/3.ui-quickstart",{"title":23,"path":24,"stem":25},"Attribution","/en/attribution","en/10.attribution",{"title":27,"path":28,"stem":29},"Cite DTPR for AI","/en/cite","en/11.cite",{"title":31,"path":32,"stem":33,"children":34},"MCP server","/en/mcp","en/2.mcp/0.index",[35,36,40,44,48,98],{"title":31,"path":32,"stem":33},{"title":37,"path":38,"stem":39},"Connecting","/en/mcp/connection","en/2.mcp/1.connection",{"title":41,"path":42,"stem":43},"Envelope","/en/mcp/envelope","en/2.mcp/2.envelope",{"title":45,"path":46,"stem":47},"Resources","/en/mcp/resources","en/2.mcp/3.resources",{"title":49,"path":50,"stem":51,"children":52},"Tools","/en/mcp/tools","en/2.mcp/4.tools/0.index",[53,54,58,62,66,70,74,78,82,86,90,94],{"title":49,"path":50,"stem":51},{"title":55,"path":56,"stem":57},"list_schema_versions","/en/mcp/tools/list-schema-versions","en/2.mcp/4.tools/1.list-schema-versions",{"title":59,"path":60,"stem":61},"MCP tool: resolve_datachain","/en/mcp/tools/resolve-datachain","en/2.mcp/4.tools/10.resolve-datachain",{"title":63,"path":64,"stem":65},"MCP tool: validate_resolved","/en/mcp/tools/validate-resolved","en/2.mcp/4.tools/11.validate-resolved",{"title":67,"path":68,"stem":69},"get_schema","/en/mcp/tools/get-schema","en/2.mcp/4.tools/2.get-schema",{"title":71,"path":72,"stem":73},"list_categories","/en/mcp/tools/list-categories","en/2.mcp/4.tools/3.list-categories",{"title":75,"path":76,"stem":77},"list_elements","/en/mcp/tools/list-elements","en/2.mcp/4.tools/4.list-elements",{"title":79,"path":80,"stem":81},"get_element","/en/mcp/tools/get-element","en/2.mcp/4.tools/5.get-element",{"title":83,"path":84,"stem":85},"get_elements","/en/mcp/tools/get-elements","en/2.mcp/4.tools/6.get-elements",{"title":87,"path":88,"stem":89},"validate_datachain","/en/mcp/tools/validate-datachain","en/2.mcp/4.tools/7.validate-datachain",{"title":91,"path":92,"stem":93},"render_datachain","/en/mcp/tools/render-datachain","en/2.mcp/4.tools/8.render-datachain",{"title":95,"path":96,"stem":97},"get_icon_url","/en/mcp/tools/get-icon-url","en/2.mcp/4.tools/9.get-icon-url",{"title":99,"path":100,"stem":101},"Prompts","/en/mcp/prompts","en/2.mcp/5.prompts",{"title":103,"path":104,"stem":105,"children":106},"REST API (v2)","/en/rest","en/3.rest/0.index",[107,108,112,116,120,124,128,132,136,140,144,148],{"title":103,"path":104,"stem":105},{"title":109,"path":110,"stem":111},"GET /schemas","/en/rest/schemas","en/3.rest/1.schemas",{"title":113,"path":114,"stem":115},"POST /schemas/:version/resolve","/en/rest/resolve","en/3.rest/10.resolve",{"title":117,"path":118,"stem":119},"POST /schemas/:version/validate_resolved","/en/rest/validate-resolved","en/3.rest/11.validate-resolved",{"title":121,"path":122,"stem":123},"GET /schemas/:version/manifest","/en/rest/manifest","en/3.rest/2.manifest",{"title":125,"path":126,"stem":127},"GET /schemas/:version/categories","/en/rest/categories","en/3.rest/3.categories",{"title":129,"path":130,"stem":131},"GET /schemas/:version/elements","/en/rest/elements-list","en/3.rest/4.elements-list",{"title":133,"path":134,"stem":135},"GET /schemas/:version/elements/:element_id","/en/rest/element-detail","en/3.rest/5.element-detail",{"title":137,"path":138,"stem":139},"POST /schemas/:version/validate","/en/rest/validate","en/3.rest/6.validate",{"title":141,"path":142,"stem":143},"Icon routes","/en/rest/icons","en/3.rest/7.icons",{"title":145,"path":146,"stem":147},"Pagination & fields","/en/rest/pagination-and-fields","en/3.rest/8.pagination-and-fields",{"title":149,"path":150,"stem":151},"Errors","/en/rest/errors","en/3.rest/9.errors",{"title":153,"path":154,"stem":155,"children":156},"Icon composition","/en/icons","en/4.icons/0.index",[157,158,162,166,170],{"title":153,"path":154,"stem":155},{"title":159,"path":160,"stem":161},"Shapes","/en/icons/shapes","en/4.icons/1.shapes",{"title":163,"path":164,"stem":165},"Symbols","/en/icons/symbols","en/4.icons/2.symbols",{"title":167,"path":168,"stem":169},"Composed variants","/en/icons/composed-variants","en/4.icons/3.composed-variants",{"title":171,"path":172,"stem":173},"URLs","/en/icons/urls","en/4.icons/4.urls",{"title":175,"path":176,"stem":177,"children":178},"@dtpr/ui","/en/ui","en/5.ui/0.index",[179,180,184,188,192],{"title":175,"path":176,"stem":177},{"title":181,"path":182,"stem":183},"@dtpr/ui/core","/en/ui/core","en/5.ui/1.core",{"title":185,"path":186,"stem":187},"@dtpr/ui/vue","/en/ui/vue","en/5.ui/2.vue",{"title":189,"path":190,"stem":191},"@dtpr/ui/html","/en/ui/html","en/5.ui/3.html",{"title":193,"path":194,"stem":195},"Theming","/en/ui/theming","en/5.ui/4.theming",{"title":197,"path":198,"stem":199,"children":200},"Concepts","/en/concepts","en/6.concepts/0.index",[201,202,206,210,214,218,222],{"title":197,"path":198,"stem":199},{"title":203,"path":204,"stem":205},"Datachains","/en/concepts/datachains","en/6.concepts/1.datachains",{"title":207,"path":208,"stem":209},"Elements & categories","/en/concepts/elements-categories","en/6.concepts/2.elements-categories",{"title":211,"path":212,"stem":213},"Versions & releases","/en/concepts/versions-and-releases","en/6.concepts/3.versions-and-releases",{"title":215,"path":216,"stem":217},"Content hash","/en/concepts/content-hash","en/6.concepts/4.content-hash",{"title":219,"path":220,"stem":221},"Shape contract","/en/concepts/shape-contract","en/6.concepts/5.shape-contract",{"title":223,"path":224,"stem":225},"Subchains","/en/concepts/subchains","en/6.concepts/6.subchains",{"title":227,"path":228,"stem":229,"children":230},"Claude plugin","/en/plugin","en/7.plugin/0.index",[231,232,236,270,274],{"title":227,"path":228,"stem":229},{"title":233,"path":234,"stem":235},"Install","/en/plugin/install","en/7.plugin/1.install",{"title":237,"path":238,"stem":239,"children":240},"Skills","/en/plugin/skills","en/7.plugin/2.skills/0.index",[241,242,246,250,254,258,262,266],{"title":237,"path":238,"stem":239},{"title":243,"path":244,"stem":245},"dtpr-describe-system","/en/plugin/skills/describe-system","en/7.plugin/2.skills/1.describe-system",{"title":247,"path":248,"stem":249},"dtpr-datachain-structure","/en/plugin/skills/datachain-structure","en/7.plugin/2.skills/2.datachain-structure",{"title":251,"path":252,"stem":253},"dtpr-category-audit","/en/plugin/skills/category-audit","en/7.plugin/2.skills/3.category-audit",{"title":255,"path":256,"stem":257},"dtpr-element-design","/en/plugin/skills/element-design","en/7.plugin/2.skills/4.element-design",{"title":259,"path":260,"stem":261},"dtpr-symbol-design","/en/plugin/skills/symbol-design","en/7.plugin/2.skills/5.symbol-design",{"title":263,"path":264,"stem":265},"dtpr-translate","/en/plugin/skills/translate","en/7.plugin/2.skills/6.translate",{"title":267,"path":268,"stem":269},"dtpr-comprehension-audit","/en/plugin/skills/comprehension-audit","en/7.plugin/2.skills/7.comprehension-audit",{"title":271,"path":272,"stem":273},"Research corpus","/en/plugin/research-corpus","en/7.plugin/3.research-corpus",{"title":275,"path":276,"stem":277},"Comprehension rubric","/en/plugin/comprehension-rubric","en/7.plugin/4.comprehension-rubric",{"title":49,"path":279,"stem":280,"children":281},"/en/tools","en/8.tools/0.index",[282],{"title":49,"path":279,"stem":280},{"title":284,"path":285,"stem":286},"Changelog","/en/changelog","en/9.changelog",{"ok":288,"versions":289},true,[290],{"id":291,"status":292,"created_at":293,"content_hash":294},"ai@2026-05-06-beta","beta","2026-05-06T20:23:42.963Z","sha256-2d208111b0c597ff2b38cb1c24168799b0a5ff9290203ebf46c4f7c16a0fcb24",{"id":296,"title":275,"body":297,"description":570,"extension":571,"links":572,"meta":573,"navigation":288,"path":276,"seo":574,"stem":277,"__hash__":575},"docs_en/en/7.plugin/4.comprehension-rubric.md",{"type":298,"value":299,"toc":561},"minimark",[300,313,351,356,455,483,487,490,500,505,532,536],[301,302,303,304,308,309,312],"p",{},"A qualitative checklist for grading DTPR content (datachain-types, categories, elements, full datachain-instances) against the bar of ",[305,306,307],"strong",{},"\"a non-technical person encountering an AI system understands this on a quick read.\""," The audience is anyone meeting an AI system in the wild — in an app, on a website, in a vehicle, on a kiosk or sign, or while moving through public space — with enough time to parse what they see but no prior expertise. There is no scoring math. Each item has pass / fail / partial signals plus an explicit ",[305,310,311],{},"n/a"," when it does not apply to the artifact under review.",[301,314,315,316,323,324,329,330,329,335,340,341,346,347,350],{},"This rubric is the shared dependency of ",[317,318,320],"a",{"href":319},"/plugin/skills/comprehension-audit",[321,322,267],"code",{}," (standalone use) and the four authoring skills that inline findings — ",[317,325,327],{"href":326},"/plugin/skills/datachain-structure",[321,328,247],{},", ",[317,331,333],{"href":332},"/plugin/skills/category-audit",[321,334,251],{},[317,336,338],{"href":337},"/plugin/skills/element-design",[321,339,255],{},", and ",[317,342,344],{"href":343},"/plugin/skills/translate",[321,345,263],{}," — which emit a Comprehension check block using the shared template before handing off via ",[321,348,349],{},"schema:new",".",[352,353,355],"h2",{"id":354},"the-seven-items","The seven items",[357,358,359,372],"table",{},[360,361,362],"thead",{},[363,364,365,369],"tr",{},[366,367,368],"th",{},"Item",[366,370,371],{},"Passes when...",[373,374,375,386,396,409,419,429,442],"tbody",{},[363,376,377,383],{},[378,379,380],"td",{},[305,381,382],{},"Audience fit",[378,384,385],{},"The language, framing, and example are understood by a non-expert on first read.",[363,387,388,393],{},[378,389,390],{},[305,391,392],{},"Plain-language",[378,394,395],{},"Every noun and verb is everyday English or glossed once with a plain-English anchor.",[363,397,398,403],{},[378,399,400],{},[305,401,402],{},"Symbol legibility",[378,404,405,406,408],{},"Silhouette is clear at sign scale; meaning carries even without caption. (",[305,407,311],{}," when the artifact has no symbol.)",[363,410,411,416],{},[378,412,413],{},[305,414,415],{},"Ambiguity flags",[378,417,418],{},"No ambiguities, or every ambiguity is explicitly flagged in the content.",[363,420,421,426],{},[378,422,423],{},[305,424,425],{},"Locale coverage",[378,427,428],{},"Every claim is translatable without idiom loss; placeholder syntax supports all required locales.",[363,430,431,436],{},[378,432,433],{},[305,434,435],{},"Variable-substitution clarity",[378,437,438,439,441],{},"Variable placeholders render cleanly across the expected value range. (",[305,440,311],{}," when the artifact has no variables.)",[363,443,444,449],{},[378,445,446],{},[305,447,448],{},"Overlap and distinctness",[378,450,451,452,454],{},"Adjacent items (elements within a category, categories within a datachain-type) occupy distinct semantic slots. (",[305,453,311],{}," when reviewing a single element with no peers.)",[301,456,457,458,461,462,465,466,468,469,472,473,475,476,478,479,482],{},"A holistic ",[305,459,460],{},"Overall"," verdict closes the block. It does not average the items — if any item is ",[305,463,464],{},"fail"," and the artifact will ship publicly, Overall is ",[305,467,464],{},". If every item is ",[305,470,471],{},"pass"," or ",[305,474,311],{},", Overall is ",[305,477,471],{},". Otherwise ",[305,480,481],{},"partial"," with a one-line summary of what to fix.",[352,484,486],{"id":485},"block-template","Block template",[301,488,489],{},"Schema-tier skills copy this shape verbatim in their proposal output:",[491,492,497],"pre",{"className":493,"code":495,"language":496},[494],"language-text","## Comprehension check\n\n- **Audience fit:** pass|fail|partial|n/a — \u003Cone-line reason>\n- **Plain-language:** pass|fail|partial|n/a — \u003Cone-line reason>\n- **Symbol legibility:** pass|fail|partial|n/a — \u003Cone-line reason>\n- **Ambiguity flags:** pass|fail|partial|n/a — \u003Cone-line reason>\n- **Locale coverage:** pass|fail|partial|n/a — \u003Cone-line reason>\n- **Variable-substitution clarity:** pass|fail|partial|n/a — \u003Cone-line reason>\n- **Overlap and distinctness:** pass|fail|partial|n/a — \u003Cone-line reason>\n- **Overall:** pass|fail|partial — \u003Cone-line summary>\n\nRubric version: \u003CYYYY-MM-DD from comprehension-rubric.md frontmatter>\n","text",[321,498,495],{"__ignoreMap":499},"",[501,502,504],"h3",{"id":503},"rules","Rules",[506,507,508,515,522],"ul",{},[509,510,511,512,514],"li",{},"One bullet per rubric item, in the order above. Do not reorder or skip items; mark inapplicable items ",[305,513,311],{}," with a reason.",[509,516,517,518,521],{},"The ",[321,519,520],{},"\u003Cone-line reason>"," must name the specific phrase, element, or pattern that drove the verdict. \"pass — reads cleanly\" is not a reason; \"pass — 'who sees your data' avoids jargon\" is.",[509,523,517,524,527,528,531],{},[321,525,526],{},"Rubric version:"," trailer carries the ",[321,529,530],{},"rubric_version"," from the rubric's frontmatter at the time of the audit. When the rubric evolves, prior audits remain interpretable — callers re-grade by re-running the skill.",[352,533,535],{"id":534},"source","Source",[506,537,538,550],{},[509,539,540,543,544,350],{},[321,541,542],{},"plugin/dtpr/references/comprehension-rubric.md"," — full rubric, source of truth: ",[317,545,549],{"href":546,"rel":547},"https://github.com/Helpful-Places/dtpr/blob/main/plugin/dtpr/references/comprehension-rubric.md",[548],"nofollow","repository",[509,551,552,555,556,350],{},[321,553,554],{},"plugin/dtpr/references/comprehension-block-template.md"," — ",[317,557,560],{"href":558,"rel":559},"https://github.com/Helpful-Places/dtpr/blob/main/plugin/dtpr/references/comprehension-block-template.md",[548],"template source",{"title":499,"searchDepth":562,"depth":562,"links":563},2,[564,565,569],{"id":354,"depth":562,"text":355},{"id":485,"depth":562,"text":486,"children":566},[567],{"id":503,"depth":568,"text":504},3,{"id":534,"depth":562,"text":535},"The seven-item rubric that the four authoring skills inline and dtpr-comprehension-audit grades against.","md",null,{},{"title":275,"description":570},"ZjehItvX2HPx9POqvuhSv4FA1kMGGQRn8hpTxtZJcV8",[577,579],{"title":271,"path":272,"stem":273,"description":578,"children":-1},"A file-based, author-seeded knowledge base that compounds across DTPR authoring sessions.",{"title":49,"path":279,"stem":280,"description":580,"children":-1},"Standalone tools for working with DTPR for AI datachains.",1779049695874]