Skip to content
Agent

Agent Operating Guide

by adeze

AI Summary

Agent Operating Guide provides structured instructions for Claude and other AI agents to safely develop and enhance the Raindrop MCP server while maintaining protocol compliance. It benefits developers using AI coding assistants who need consistent, verifiable guidelines for production-ready changes.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to set up the "Agent Operating Guide" agent in my project.

Please run this command in my terminal:
# Add AGENTS.md to your project root
curl --retry 3 --retry-delay 2 --retry-all-errors -o AGENTS.md "https://raw.githubusercontent.com/adeze/raindrop-mcp/master/AGENTS.md"

Then explain what the agent does and how to invoke it.

Description

Raindrop MCP Server

Shared Mission

Deliver production-ready enhancements to the Raindrop MCP server while preserving full MCP protocol compliance. Reuse existing patterns in src/services/raindropmcp.service.ts before creating new abstractions. Keep responses concise, cite relevant files/lines, and recommend verification steps after changes.

Claude (Anthropic)

Primary Reference: CLAUDE.md for project overview, version info, capabilities, and architecture • Modular Tools: Always add new tools to domain-specific files in src/tools/ (e.g., bookmarks.ts, cleanup.ts). • Standardized Naming: Use snake_case for all tool names (e.g., list_raindrops, get_raindrop). • Sampling: Leverage the mcpServer instance in ToolHandlerContext for AI-powered features via createMessage. • Safety: Ensure destructive tools (delete, empty, remove) require a confirm: true parameter. • Resource Links: Prefer returning resource contents (URI links) for lists instead of heavy JSON payloads.

GitHub Copilot / Code Generation Agents

Primary Reference: .github/copilot-instructions.md for coding standards • TypeScript + Bun + Vitest + Zod validation required • Reference .github/skills/ for domain-specific skills: • mcp-development/SKILL.md - MCP server design patterns and best practices • mcp-inspector/SKILL.md - Protocol inspection and debugging • mcp-refactoring/SKILL.md - Tool refactoring for LLM optimization • mcp-testing/SKILL.md - Testing strategies with Vitest and Inspector • dxt-packaging/SKILL.md - MCPB packaging and distribution (legacy DXT references) • publishing/SKILL.md - Publishing and release workflows • Sort imports: external → internal • Use async/await consistently • Use logging helpers (utils/logger.ts) instead of console.log

Other LLM Operators (Cursor, ChatGPT, etc.)

• Follow Copilot guidelines unless targeting documentation/analysis • Surface ambiguities about Raindrop API behavior to user • Default to OpenAPI definitions in raindrop-complete.yaml for API contracts

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 1mo ago
Active
Adoption100+ stars on GitHub
134 ★ · Growing
DocsMissing or thin
Undocumented

GitHub Signals

Stars134
Forks21
Issues38
Updated1mo ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code
Claude.ai