# QQwrite Brief

Use this file when DeepSeek screening results need to become an input package
for QQwrite.

## Ownership

DeepSeek may generate the `qqwrite_brief` draft from:

- the manuscript profile
- author evidence and figure notes
- QQnote/Zotero/Obsidian note candidates
- DeepSeek-screened strong/weak related papers
- target journal and template choice

QQsci owns:

- the brief schema
- the prompt that asks DeepSeek to generate the brief
- schema validation
- obvious overclaim and DOI-preservation checks
- handoff to QQwrite

QQwrite consumes the brief. QQwrite should not re-screen literature or decide
which papers are strong/weak.

## Required Schema

Ask DeepSeek to return JSON whenever possible:

```json
{
  "target_journal": "",
  "article_type": "",
  "recommended_word_template": "afm/article-template.docx",
  "material_system": "",
  "application": "",
  "central_claim": "",
  "novelty_gap": "",
  "design_principle": "",
  "key_author_evidence": [
    {
      "evidence": "",
      "source": "manuscript / figure / SI / author note",
      "supports": ""
    }
  ],
  "strong_related_papers": [
    {
      "doi": "",
      "title": "",
      "usable_for": [],
      "must_cite_near": [],
      "reason": ""
    }
  ],
  "weak_related_papers": [
    {
      "doi": "",
      "title": "",
      "usable_for": [],
      "reason": ""
    }
  ],
  "section_plan": {
    "Title": [],
    "Abstract": [],
    "Introduction": [],
    "Results and Discussion": [],
    "Conclusion": [],
    "Experimental Section": []
  },
  "claim_reference_map": [
    {
      "claim": "",
      "author_evidence": "",
      "supporting_dois": [],
      "writing_location": "",
      "status": "supported / needs author evidence / citation only / do not claim"
    }
  ],
  "must_not_overclaim": [],
  "missing_inputs": [],
  "qqwrite_instructions": []
}
```

## DeepSeek Prompt

Give DeepSeek the screened-paper JSON and ask:

```text
Using the screened strong/weak related papers and the author-provided manuscript
evidence, generate a QQwrite writing brief.

Rules:
1. Do not invent experimental results, mechanisms, references, DOI values, or
   figure numbers.
2. Strong papers may define novelty, direct comparison, benchmark, and citation
   placement.
3. Weak papers may support field framing, mechanism language, or writing
   structure, but must not be treated as direct benchmark papers.
4. Every major claim must include author evidence, supporting DOI, or a clear
   status explaining that it still needs evidence.
5. Preserve DOI strings exactly as provided.
6. Return JSON only, following the QQwrite brief schema.
```

## QQsci Check Before Handoff

Before passing the brief to QQwrite, check:

- required top-level fields are present
- `central_claim` is backed by author evidence
- every DOI came from the screened output or user input
- weak papers are not used as direct benchmark unless justified
- `must_not_overclaim` and `missing_inputs` are not empty when evidence is
  incomplete
- `recommended_word_template` points to a QQwrite-owned template

If the brief fails checks, mark the issue in `missing_inputs` or ask DeepSeek to
repair only the failed fields. Do not let QQwrite consume a malformed brief.