{
  "files_to_modify": {
    "frontend": ["README.md", "package.json"]
  },
  "files_to_create": ["scripts/README.md"],
  "files_to_reference": [
    "README.md",
    "scripts/convert-translations.js",
    "scripts/pagespeed-check.js",
    "scripts/optimize-images.js"
  ],
  "patterns": {
    "documentation_pattern": "Project uses markdown files for documentation with clear section headers (##)",
    "readme_sections": "README.md has sections for Development, Features, Tech Stack, Project Structure",
    "script_comments": "Some scripts have JSDoc-style comments at the top explaining purpose and usage"
  },
  "existing_implementations": {
    "description": "Found 11 working utility scripts in scripts/ directory, but only 3 are exposed in package.json. Scripts include image optimization, sitemap generation, font downloads, icon generation, translation conversion, GitHub README generation, and PageSpeed testing.",
    "relevant_files": [
      "scripts/optimize-images.js",
      "scripts/optimize-images.mjs",
      "scripts/generate-sitemap.js",
      "scripts/pagespeed-check.js",
      "scripts/convert-translations.js",
      "scripts/download-fonts.js",
      "scripts/download-fonts.mjs",
      "scripts/generate-icons.mjs",
      "scripts/generate-icons-simple.mjs",
      "scripts/generate-github-readme.js",
      "scripts/generate-og-image.html"
    ],
    "missing_scripts": [
      "generate-blog-images.mjs (referenced in package.json but doesn't exist)",
      "lighthouse-audit-all-locales.js (mentioned in spec but doesn't exist)",
      "axe-accessibility-audit.js (mentioned in spec but doesn't exist)"
    ]
  },
  "investigation_findings": {
    "script_categories": {
      "image_processing": ["optimize-images.js", "optimize-images.mjs", "generate-icons.mjs", "generate-icons-simple.mjs"],
      "content_generation": ["generate-sitemap.js", "generate-github-readme.js", "generate-og-image.html"],
      "asset_management": ["download-fonts.js", "download-fonts.mjs"],
      "localization": ["convert-translations.js"],
      "performance_testing": ["pagespeed-check.js"]
    },
    "package_json_scripts": {
      "documented": ["build:images", "generate:images", "generate:images:dry"],
      "undocumented_count": 8
    }
  }
}