meilisearch-mcp: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

🚨 IMPORTANT: Development Workflow Guidelines

ALL coding agents MUST follow these mandatory guidelines for every task.

🔄 Fresh Start Protocol

BEFORE starting ANY new task or issue:

1. Always start from latest main:

   git checkout main
   git pull origin main  # Ensure you have the latest changes
   git checkout -b feature/your-branch-name  # Create new branch
   

2. Verify clean state:

   git status  # Should show clean working directory
   

3. Never carry over unrelated changes from previous work

4. Each task gets its own focused branch from latest main

🎯 Focused Development Rules

ONLY make changes directly related to the specific task/issue:

• ✅ DO: Add/modify code that solves the specific issue
• ✅ DO: Add focused tests for the specific functionality
• ✅ DO: Update documentation if specifically required
• ❌ DON'T: Include formatting changes to unrelated files
• ❌ DON'T: Add comprehensive test suites unless specifically requested
• ❌ DON'T: Refactor unrelated code
• ❌ DON'T: Include previous work from other branches

📋 Task Assessment Phase

Before writing any code, determine scope:

1. Read the issue/task carefully - understand exact requirements
2. Identify minimal changes needed - what files need modification?
3. Plan focused tests - only for the specific functionality being added
4. Avoid scope creep - resist urge to "improve" unrelated code

🧪 Test-Driven Development (TDD) Approach

When tests are required for the specific task:

# 1. Write failing tests FIRST (focused on the issue)
python -m pytest tests/test_specific_issue.py -v  # Should fail

# 2. Write minimal code to make tests pass
# Edit ONLY files needed for the specific issue

# 3. Run tests to verify they pass
python -m pytest tests/test_specific_issue.py -v  # Should pass

# 4. Refactor if needed, but stay focused