docs/DOCS_CONTRACT.json

{
  "optional_paths": [
    "vision/README.md",
    "vision/VISION.md",
    "vision/ROADMAP.md"
  ],
  "required_paths": [
    "AGENTS.md",
    "docs/README.md",
    "docs/ARCHITECTURE.md",
    "docs/RUNBOOK.md",
    "docs/QUALITY_SCORE.md",
    "docs/FEATURE_SLICING.md",
    "docs/DOCS_TAXONOMY.md",
    "docs/design-docs/index.md",
    "docs/design-docs/core-beliefs.md",
    "docs/design-docs/decisions/0001-template.md",
    "docs/exec-plans/README.md",
    "docs/exec-plans/tech-debt-tracker.md",
    "docs/discovery/index.md",
    "docs/delivery-specs/index.md",
    "docs/guides/README.md",
    "docs/references/README.md",
    "docs/exploration/README.md",
    "docs/learnings/README.md",
    "docs/learnings/architecture.md",
    "docs/learnings/conventions.md",
    "docs/learnings/workflow.md",
    "docs/learnings/integrations.md",
    "docs/learnings/gotchas.md",
    "docs/learnings/security.md",
    "docs/learnings/testing.md",
    "docs/learnings/archived/README.md",
    "docs/DOCS_CONTRACT.json"
  ],
  "map_files": [
    "AGENTS.md"
  ],
  "index_files": [
    "docs/README.md"
  ],
  "learnings_category_files": [
    "docs/learnings/architecture.md",
    "docs/learnings/conventions.md",
    "docs/learnings/workflow.md",
    "docs/learnings/integrations.md",
    "docs/learnings/gotchas.md",
    "docs/learnings/security.md",
    "docs/learnings/testing.md"
  ],
  "learnings_budget": {
    "max_bullets_per_category": 30,
    "require_feature_id_suffix": true,
    "enforce_dedupe_within_category": true,
    "enforce_dedupe_across_categories": false
  },
  "agents_md_max_lines": 100,
  "agents_md_max_learning_bullets_total": 0,
  "orphan_spec_ignore_prefixes": [
    "F001", "F002", "F003", "F004", "F005",
    "F006", "F007", "F008", "F009", "F010",
    "F013", "F014", "F015"
  ],
  "directory_types": {
    "docs/guides": "how-to",
    "docs/design-docs": "explanation",
    "docs/discovery": "explanation",
    "docs/delivery-specs": "reference",
    "docs/exploration": "exploration",
    "docs/references": "reference",
    "docs/learnings": "reference",
    "docs/exec-plans": "how-to"
  }
}