jmagly/research-cite

Research Cite Command

Generate properly formatted, policy-compliant citations from the research corpus.

Instructions

When invoked, generate correct citations:

1. Locate Source

   • Search .aiwg/research/sources/ and .aiwg/research/findings/ for specified reference
   • Match by REF-XXX identifier, author name, or keyword
   • If multiple matches, present options for user selection

2. Load Metadata

   • Extract frontmatter: ref_id, title, authors, year, DOI, source_type
   • Load quality assessment if available
   • Determine GRADE level

3. Generate Citation

   • Format @-mention citation with full path
   • Include page numbers if specified
   • Apply GRADE-appropriate hedging language
   • Include quality level annotation

4. Output Formats

   • inline - Ready to paste into markdown with GRADE-appropriate language
   • bibtex - BibTeX format for reference management
   • reference - Full reference section entry
   • apa - APA 7th edition format
   • chicago - Chicago Manual of Style format

Arguments

• [ref-id or keyword] - REF-XXX identifier or search keyword (required)
• --format [inline|bibtex|reference|apa|chicago] - Output format (default: inline)
• --page [n] - Include page reference
• --quote "[text]" - Include direct quote with citation
• --hedging [suggest|none] - Include hedging language suggestions (default: suggest)

Examples

# Basic inline citation
/research-cite REF-022

# Citation with page reference
/research-cite REF-022 --page 4

# Citation with quote
/research-cite REF-022 --page 4 --quote "deliberate decision making"

# BibTeX format for bibliography
/research-cite REF-022 --format bibtex

# Search by keyword
/research-cite "autogen multi-agent" --format inline

# Multiple citations for bibliography
/research-cite REF-022 REF-001 REF-013 --format reference

Expected Output

Inline Format (Default)

/research-cite REF-022 --page 4

Output:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Citation (inline format):

  According to @.aiwg/research/findings/REF-022-autogen.md (p. 4),
  AutoGen enables "flexible conversation patterns" through multi-agent
  collaboration.

GRADE Assessment: MODERATE
  Source: arXiv preprint (peer-reviewed conference version available)
  Quality: Moderate (single study, not systematic review)

Recommended Hedging Language:
  ✓ APPROPRIATE: "Research suggests...", "Evidence indicates..."
  ✗ TOO STRONG: "Research proves...", "Evidence demonstrates..."
  ✗ TOO WEAK: "Some sources claim...", "Anecdotal reports suggest..."

Usage Example:
  Multi-agent conversation patterns suggest flexible agent orchestration
  is feasible for complex workflows (@.aiwg/research/findings/REF-022-autogen.md,
  p. 4), though scalability limits require further investigation (GRADE: MODERATE).

BibTeX Format

/research-cite REF-022 --format bibtex

Output:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

@article{wu2023autogen,
  title={AutoGen: Enabling Next-Gen LLM Applications via Multi-Agent Conversation},
  author={Wu, Qingyun and Bansal, Gagan and Zhang, Jieyu and Wu, Yiran and Zhang, Shaokun and Zhu, Erkang and Li, Beibin and Jiang, Li and Zhang, Xiaoyun and Wang, Chi},
  journal={arXiv preprint arXiv:2308.08155},
  year={2023},
  doi={10.48550/arXiv.2308.08155},
  note={GRADE: MODERATE - arXiv preprint}
}

Reference Format

/research-cite REF-022 --format reference

Output:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Wu, Q., Bansal, G., Zhang, J., Wu, Y., Zhang, S., Zhu, E., Li, B.,
Jiang, L., Zhang, X., & Wang, C. (2023). AutoGen: Enabling Next-Gen
LLM Applications via Multi-Agent Conversation. *arXiv preprint*
arXiv:2308.08155. https://doi.org/10.48550/arXiv.2308.08155

GRADE: MODERATE
Internal Reference: @.aiwg/research/findings/REF-022-autogen.md
PDF: @.aiwg/research/sources/REF-022.pdf

GRADE-Based Hedging

Citations automatically include hedging guidance based on evidence quality:

| GRADE Level | Appropriate Language | Avoid | |-------------|---------------------|-------| | HIGH | "demonstrates", "shows", "confirms" | Uncertainty language | | MODERATE | "suggests", "indicates", "supports" | Definitive claims | | LOW | "limited evidence", "preliminary findings" | Strong claims | | VERY LOW | "anecdotal", "exploratory", "reports suggest" | Confident claims |

Batch Citation

Generate bibliography for multiple sources:

/research-cite REF-001 REF-013 REF-022 REF-057 --format reference

Output:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## References

Feng, Y., et al. (2024). The Landscape of Emerging AI Agent Architectures...
  GRADE: MODERATE - @.aiwg/research/findings/REF-001-production-agentic.md

Hong, S., et al. (2023). MetaGPT: Meta Programming for Multi-Agent Systems...
  GRADE: HIGH - @.aiwg/research/findings/REF-013-metagpt.md

Wu, Q., et al. (2023). AutoGen: Enabling Next-Gen LLM Applications...
  GRADE: MODERATE - @.aiwg/research/findings/REF-022-autogen.md

Schmidgall, S., et al. (2024). Agent Laboratory: Using LLM Agents...
  GRADE: HIGH - @.aiwg/research/findings/REF-057-agent-laboratory.md

Citation Validation

All citations are validated against:

• [ ] Source exists in .aiwg/research/
• [ ] Metadata is complete (title, authors, year)
• [ ] DOI/identifier is valid
• [ ] GRADE level is assessed
• [ ] Hedging language matches quality level
• [ ] Page references are within paper bounds (if PDF available)
• [ ] Quotes are exact (if --quote provided)

Integration with Writing

When writing documentation:

1. Use /research-cite REF-XXX to get citation
2. Copy inline format into document
3. Use suggested hedging language
4. Add @-mention for traceability
5. Include GRADE level in internal notes

References

• @$AIWG_ROOT/agentic/code/frameworks/research-complete/agents/citation-agent.md - Citation Agent
• @$AIWG_ROOT/src/research/services/citation-service.ts - Citation formatting
• @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/citation-policy.md - Citation policy requirements
• @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/research/frontmatter-schema.yaml - Source metadata
• @.aiwg/research/docs/grade-assessment-guide.md - GRADE levels