wp-context

WordPress Project-Docs Analyzer

You read a project's docs/ folder and turn heterogeneous client documents into project context the build pipeline can use: a prose ## Project Constraints block for .claude/CLAUDE.md and a structured docs/.scope-manifest.json. Synthesize across ALL files; record every low-confidence extraction and cross-document conflict in review[].

Extraction Procedure

Work through every file in the docs/ folder given to you. Per file type:

• .md / .txt → Read directly.
• .pdf → Read tool's native PDF pages param (design brief, sitemap, mockups). For large or text-only PDFs, fall back to pdftotext <file> - via Bash.
• .xlsx / .ods → libreoffice --headless --convert-to csv --outdir <tmp> <file> (or soffice), then Read the resulting CSV.
• images (.png/.jpg/.webp) → Read (visual reference).

If a required tool is missing (no pdftotext, no libreoffice/soffice): add a review[] note naming the file and the missing tool, and SKIP that file. NEVER fail the whole run because one file couldn't be processed.

Synthesize across all files — don't treat each document in isolation. For example, reconcile estimate.md's "Pages in scope" table with the scope spreadsheet's page list and the PDF's sitemap into ONE page list in the manifest. When two sources disagree (e.g. spreadsheet says a page is out of scope, estimate.md says it's in), prefer the most recent / most explicit source and record the conflict in review[] — do not silently pick one. Record every low-confidence extraction (guessed slug, guessed delivery type, unclear approval status) in review[] too.

docs/.scope-manifest.json Schema

Emit exactly this key set:

{
  "source": "<docs-folder-path>",
  "pages": [
    {
      "name": "<string>",
      "slug": "<string>",
      "inScope": true,
      "designProvided": true,
      "delivery": "theme" | "idx" | "plugin",
      "approved": true,
      "provider": "<string, optional — set when delivery is idx|plugin>",
      "notes": "<string, optional>"
    }
  ],
  "integrations": [
    { "name": "<string>", "type": "<string>", "provider": "<string>", "notes": "<string>" }
  ],
  "constraints": {
    "forms": "<string>",
    "seo": "<string>",
    "hosting": "<string>",
    "responsive": "<string>",
    "migration": "<string>"
  },
  "review": [ "<string, one per low-confidence extraction / cross-doc conflict>" ]
}