• Read the page's H2/H3 structure
• For each diff symbol from the classifier output, find the section most directly documenting it
• Capture line ranges: lines 120-145 not the whole page

The output is a sections_to_edit[] per page, where each entry is:

page: docs/src/content/docs/consumer/install.md
sections_to_edit:
  - section: "## From Git"
    line_range: [120, 145]
    diff_symbol: "--no-cache flag"
    edit_kind: add | modify | remove
    rationale: "the new --no-cache flag is documented nowhere; section already lists other flags so this is the natural home"

Step 3: detect cross-page conflicts

If two pages document the same symbol and the diff changes the symbol's behaviour, BOTH pages need an edit AND they must stay consistent. Flag this in the brief so the CDO synthesizer knows to cross-check coherence between the two redrafts:

cross_page_constraint:
  pages: [path1, path2]
  shared_symbol: "apm install --target"
  consistency_required: "both pages must reflect the same default value"

Step 4: emit the per-page task brief

Return JSON with this shape (one entry per page in scope_pages[]):

{
  "tasks": [
    {
      "page": "docs/src/content/docs/consumer/install.md",
      "persona_owner": "consumer",
      "promise": 1,
      "sections_to_edit": [
        {
          "section": "## From Git",
          "line_range": [120, 145],
          "diff_symbol": "--no-cache flag",
          "edit_kind": "add",
          "rationale": "..."
        }
      ],
      "verify_claims": [
        {"claim": "the flag is named --no-cache", "verify_with": "apm install --help"},
        {"claim": "the flag is documented in click.option decorator", "verify_with": "grep -n no-cache src/apm_cli/commands/install.py"}
      ]
    }
  ],
  "cross_page_constraints": [
    {"pages": [...], "shared_symbol": "...", "consistency_required": "..."}
  ],
  "estimated_panel_calls": 8
}

The verify_claims[] per page is consumed by the python-architect panelist -- it tells the verifier WHICH claims need a S7 tool-call check (run apm install --help, grep the source) rather than prose-trusting.

Output contract

Return a SINGLE JSON document matching the schema in Step 4 as the final message of your task. No prose around the JSON.

Anti-patterns

• Selecting whole pages when one section suffices (inflates context per panelist).
• Skipping verify_claims[] -- that's the S7 tool-bridge hook; the verifier needs it.
• Inventing pages not in scope_pages[] -- that's the classifier's job, not yours. If you think the classifier missed a page, return an extra field localizer_concern instead of expanding scope unilaterally.

cli-logging-ux

优化 APM 代码库中的 CLI 输出、日志提示与诊断信息体验

docs-impact-classifier

快速判断 PR 变更对文档的影响级别，决定是否需要更新或重构文档。