docs/output-format.md

# Output Format: ResearchLink AI

## Paper Module Directory

Every paper generates a `YYYY-paper-slug/` directory:

```
YYYY-paper-slug/
  README.md               — Quick overview + links
  metadata.yml            — Structured YAML metadata
  paper-card.md           — One-page structured summary
  digest.md               — Plain-English deep dive
  literature-review.md    — Research landscape positioning
  concept-map.md          — Mermaid diagrams
  implementation-link.md  — Code repository guide
  reproducibility.md      — Reproduction guidance + checklist
  limitations.md          — Limitations and validity
  teaching-path.md        — Staged learning path
  references.md           — Reference list
  references.bib          — BibTeX entries
  generation-report.md    — Pipeline run summary
  notes/
    reviewer-style-summary.md
    claim-evidence-table.md
    related-work-matrix.md
  labs/
    README.md
    01-concept-toy-example.py
    02-method-toy-example.py
    03-reward-or-metric-example.py
```

## Standard Header

Every `.md` file starts with:

```
> **Generated by ResearchLink AI.** Please review citations, metadata, and claims before publishing.
```

## metadata.yml Fields

All fields listed in `schemas/paper.py::PaperMetadata`.
Verification and confidence sections are always included.

## Quality Flag Levels

- `ERROR:` — Must be fixed before publishing (e.g., citation placeholders)
- `WARN:` — Should be reviewed (e.g., missing venue)
- `INFO:` — Informational (e.g., Semantic Scholar match found)