Content Scaffolding Analysis (GitHub Copilot)

Generate a documentation scaffolding proposal from the context file.

Input

Read .tmp/scaffold-context.json which contains:

• draft: Documentation draft content and frontmatter
• products: Available InfluxDB products
• productHints: Suggested products based on content analysis
• versionInfo: Detected version (3.x/2.x/1.x) and tools
• structure: Repository structure and sibling weights
• conventions: Documentation standards

Analysis

Determine:

1. Topic and audience from draft content
2. Target products from productHints and versionInfo
3. Documentation section (admin/write-data/query-data/reference/get-started/plugins)
4. Shared vs product-specific structure
5. Weight from structure.siblingWeights for the section

File Structure

Generate files following these patterns:

Shared Content Pattern

content/shared/{namespace}-{section}/{topic-name}.md
  ├─ content/{namespace}/{product}/{section}/{topic-name}.md (frontmatter only)
  ├─ content/{namespace}/{product}/{section}/{topic-name}.md (frontmatter only)
  └─ ...

Product-Specific Pattern

content/{namespace}/{product}/{section}/{topic-name}.md (full content)

Frontmatter Template

For frontmatter-only files:

---
title: Clear SEO title
description: 1-2 sentence description
menu:
  {namespace}_{product}:
    name: Nav label
    parent: Parent item
weight: {calculated from siblings}
source: /shared/{namespace}-{section}/{topic-name}.md
related:
  - /path/to/related1/
  - /path/to/related2/
alt_links:
  {product}: /path/to/equivalent/
---

Code Samples

Based on versionInfo:

• v3.x: Use influxdb3 CLI, influxctl, /api/v3
• v2.x: Use influx CLI, /api/v2
• v1.x: Use influx CLI (v1), influxd, InfluxQL

Output

Generate JSON matching scripts/schemas/scaffold-proposal.schema.json:

{
  "analysis": {
    "topic": "...",
    "targetProducts": ["..."],
    "section": "...",
    "isShared": true/false,
    "reasoning": "...",
    "styleReview": {
      "issues": [],
      "recommendations": []
    },
    "codeValidation": {
      "tested": false,
      "tools": []
    }
  },
  "files": [
    {
      "path": "content/...",
      "type": "shared-content" | "frontmatter-only",
      "content": "..." OR "frontmatter": {...}
    }
  ],
  "nextSteps": ["..."]
}

Save to: .tmp/scaffold-proposal.json

Conventions

• Files: lowercase-with-hyphens.md
• Menu keys: {namespace}_{product} (e.g., influxdb3_core)
• Weights: 1-99 (top), 101-199 (level 2), 201-299 (level 3)
• Shared content: content/shared/ subdirectories
• Related links: 3-5 contextually relevant articles

Begin analysis of .tmp/scaffold-context.json.