research-cross-referencer

Research Cross-Referencer

Reads a new or refreshed research entry, scans the research/README.md index to find related entries, and appends a ## Cross-References table to the entry. Enables readers to navigate the research knowledge base without manually searching every entry.

Input (from orchestrator prompt):

Add cross-references to ./research/{category}/{name}.md

Output: The target entry file is edited to include a ## Cross-References section.

Workflow

flowchart TD
    Start([Receive entry path]) --> Read[Read the full entry file]
    Read --> ReadREADME[Read ./research/README.md completely]
    ReadREADME --> Extract[Extract topic domain technology and problem<br>keywords from the new entry:<br>category, key technologies, problem domain,<br>integration patterns, workflow position]
    Extract --> Scan[Scan README.md category tables<br>for entries with overlapping characteristics]
    Scan --> Score["Score each candidate entry:<br>same category = highest weight<br>same technology stack = high weight<br>same problem domain = medium weight<br>adjacent workflow step = medium weight<br>(e.g. tool A feeds tool B)"]
    Score --> Count{How many candidates scored above threshold<br>(score >= 2)?}
    Count -->|"0 — none scored above threshold"| Done(["Return STATUS: complete<br>CROSS_REFERENCES_ADDED: 0<br>Do not write a section. Stop."])
    Count -->|"1 or 2 — fewer than 3"| WriteMin["Use all candidates found"]
    Count -->|"3 to 8"| WriteSection[Use all found candidates]
    Count -->|"More than 8"| Top8[Select top 8 by score]
    WriteMin --> CheckExists{Does ## Cross-References<br>already exist in the entry?}
    WriteSection --> CheckExists
    Top8 --> CheckExists
    CheckExists -->|"Yes — section exists"| Replace["Replace the existing ## Cross-References section<br>(do not append duplicate)"]
    CheckExists -->|"No — section absent"| AnchorCheck{Does the entry have a body<br>## Freshness Tracking heading?}
    AnchorCheck -->|"Yes — legacy text-header entry"| Append["Append ## Cross-References section<br>after ## Freshness Tracking"]
    AnchorCheck -->|"No — freshness lives in frontmatter"| AppendRefs["Append ## Cross-References section<br>after ## References"]
    Replace --> EditFile[Edit the entry file]
    Append --> EditFile
    AppendRefs --> EditFile
    EditFile --> Return([Return structured result])