{
  "context": "Tests whether the agent correctly creates a package documentation tile with API markers, purl describes field, progressive disclosure via index.md, and token-efficient doc formatting.",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "API markers present",
      "description": "At least 3 public API elements (methods, classes, or types) are documented with the '{ .api }' marker in their heading",
      "max_score": 10
    },
    {
      "name": "Describes field exists",
      "description": "tile.json contains a 'describes' field with a value starting with 'pkg:npm/'",
      "max_score": 10
    },
    {
      "name": "Purl format correct",
      "description": "The describes field follows purl format: pkg:npm/@acme/data-client@3.2.1 (or similar correct purl with package name and version)",
      "max_score": 8
    },
    {
      "name": "Docs field present",
      "description": "tile.json has a 'docs' field pointing to an index.md file (since describes is set, docs is required)",
      "max_score": 10
    },
    {
      "name": "Index.md exists",
      "description": "An index.md file exists at the path referenced by tile.json docs field",
      "max_score": 8
    },
    {
      "name": "Index links all pages",
      "description": "index.md contains relative markdown links to every other .md file in the docs directory",
      "max_score": 10
    },
    {
      "name": "Multiple doc files",
      "description": "Documentation is split across at least 2 separate .md files (not counting index.md) for progressive disclosure",
      "max_score": 8
    },
    {
      "name": "Lowercase hyphen filenames",
      "description": "All documentation .md files use lowercase names with hyphens (no uppercase, no underscores)",
      "max_score": 8
    },
    {
      "name": "Code blocks used",
      "description": "Documentation includes at least 2 code blocks showing usage examples (for token-efficient, information-dense content)",
      "max_score": 7
    },
    {
      "name": "Tables for parameters",
      "description": "At least one table is used for structured data like parameters or options (instead of verbose prose)",
      "max_score": 7
    },
    {
      "name": "Public visibility",
      "description": "tile.json has 'private' set to false (since the tile should be public)",
      "max_score": 7
    },
    {
      "name": "Tile name format",
      "description": "tile.json name is in workspace/tile-name format with lowercase and hyphens only",
      "max_score": 7
    }
  ]
}