{
  "schema_version": "0.1",
  "name": "AgentPress Publication Spec",
  "purpose": "A Substack-like publication format optimized for AI agents, RAG systems, crawlers, eval harnesses, and citation agents.",
  "required_files": [
    "index.html",
    "README.md",
    "AGENT_ENTRYPOINT.md",
    "agent-task-card.json",
    "llms.txt",
    "sitemap.xml",
    ".well-known/ai-ingestion.json",
    "CITATION.cff",
    "disclaimer.md"
  ],
  "recommended_files": [
    "rag-pack/ingestion-manifest.json",
    "rag-pack/retrieval-queries.md",
    "dataset/benchmark.jsonl",
    "telemetry/agent-telemetry-map.json",
    "discovery/crawler-seed-list.json",
    "prompts/agent-prompt.md",
    "EVAL_CARD.md"
  ],
  "publication_contract": {
    "human_readable": true,
    "machine_readable": true,
    "crawlable": true,
    "evaluable": true,
    "citeable": true,
    "privacy_preserving_telemetry": true
  },
  "agent_entrypoint_contract": {
    "must_include": [
      "primary_task",
      "input_contract",
      "expected_output_schema",
      "canonical_links",
      "non_goals",
      "citation_rules",
      "disclaimer"
    ]
  },
  "task_card_contract": {
    "must_include": [
      "task_type",
      "target_agents",
      "objective",
      "input_contract",
      "output_contract",
      "scoring_rubric",
      "primary_assets"
    ]
  },
  "telemetry_contract": {
    "allowed": ["explicit_source_tags", "platform_referrers", "aggregate_clone_counts"],
    "disallowed": ["hidden_pixels", "fingerprinting", "deceptive_tracking"]
  }
}