Explore References

Step 2: Compare Approaches

Analyze the differences:

• What patterns does each library use?
• What are the tradeoffs of each approach?
• Which handles edge cases best?
• Which has the cleanest API?

Step 3: Extract Insights

Identify what we should learn:

• Best practices to adopt
• Pitfalls to avoid
• Edge cases we must handle
• API patterns that feel ergonomic

Output Format

Write your findings to .agents/scratch/<topic>-research.md with this structure:

# <Topic> Research

## Summary

Brief overview of findings and recommendations.

## pdf.js Approach

- How it works
- Key files: `path/to/file.js`
- Pros/cons

## pdf-lib Approach

- How it works
- Key files: `path/to/file.ts`
- Pros/cons

## PDFBox Approach

- How it works
- Key files: `path/to/File.java`
- Pros/cons

## Recommendations for @libpdf/core

- What approach to take
- Key considerations
- Edge cases to handle

Guidelines

• Be thorough - This research informs implementation decisions
• Include code references - File paths and line numbers help future exploration
• Note edge cases - What weird PDFs do the libraries handle?
• Consider our constraints - We target Node, Bun, and browsers equally
• Focus on insights - Don't just describe; analyze and recommend

Begin

Search the reference libraries for the topic determined from the conversation context and compile your research findings.