reference

You are tasked with researching reference material provided by the user and creating comprehensive documentation.

Input

The user will provide a description that may contain one or more URLs to research.

Process

1. Setup url-to-md tool (if not already installed)

Check if url-to-md is available, and if not, install it:

deno install -A --global -n url-to-md https://raw.githubusercontent.com/zph/url-to-md/refs/heads/main/url-to-md.ts

2. Extract and Process URLs

• Identify all direct URLs in the user's description
• For each URL, use url-to-md to download and convert the content to markdown
• Save each article to docs/research/<descriptive-task-name>/ with a descriptive filename based on the article title or URL
• Use the format: <article-name>.md

3. Supplementary Research

• Use WebSearch or WebFetch to gather additional context if needed
• Ensure you understand the topic comprehensively

4. Create Summary Documentation

Create a README.md in docs/research/<descriptive-task-name>/ that includes:

Structure:

# [Descriptive Task Name]

## Overview
Brief introduction to the research topic and purpose.

## Key Findings
Summarize the main insights from all sources.

## Sources

### [Article 1 Title]
**Source:** [URL]
**Saved as:** `article-1.md`

[2-3 paragraph summary of key points]

Key takeaways:
- Bullet point 1
- Bullet point 2
- Bullet point 3

### [Article 2 Title]
**Source:** [URL]
**Saved as:** `article-2.md`

[Summary continues...]

## References
1. [Author/Site Name]. "[Article Title]". [URL]. Retrieved [Date].
2. [Continue with all sources...]

## Related Topics
- Topic 1
- Topic 2

## Additional Notes
Any supplementary insights or connections between sources.

Important Guidelines

1. Citations: Use proper markdown citation format throughout
2. File naming: Use descriptive, kebab-case names for files
3. Organization: Each research session gets its own folder under docs/research/
4. Content preservation: Keep the full url-to-md output in individual files
5. Summary quality: README.md should synthesize information, not just list it
6. Cross-references: Link between related concepts when applicable

Example Workflow

If user says: "Research these articles on Rust async patterns: https://example.com/rust-async, https://example.com/tokio-guide"

1. Create docs/research/rust-async-patterns/
2. Download:
   • rust-async.md (from first URL)
   • tokio-guide.md (from second URL)
3. Create README.md with synthesis of both articles, proper citations, and key insights

Output

After completing the research:

1. Confirm all URLs were processed successfully
2. Provide the path to the research folder
3. Give a brief summary of what was learned
4. Ask if the user wants any specific aspects explored further