mcp-blueprint: Instructions file for Claude Code

CLAUDE.md

This document defines the general development guidelines for AI coding assistants contributing to this repository.

These guidelines are intentionally project-independent and should remain applicable across different projects.

Project-specific requirements are documented in the repository documentation.

---

General Principles

Produce software that is:

• Correct
• Readable
• Maintainable
• Modular
• Production-ready

Always prefer simplicity over unnecessary complexity.

Choose solutions that minimize long-term maintenance.

---

Read the Documentation First

Before making significant changes, read the Markdown documentation available in the project root.

The project documentation defines:

• goals
• architecture
• implementation priorities
• design decisions

Follow the documented architecture unless explicitly instructed otherwise.

---

Language

Use English consistently for:

• source code
• comments
• docstrings
• documentation
• commit messages
• prompts
• examples
• configuration descriptions
• error messages

Do not mix languages.

---

Code Quality

Write clean, explicit and readable code.

Prefer:

• small functions
• focused classes
• modular components
• reusable code

Avoid:

• duplicated logic
• unnecessary abstractions
• premature optimization
• hidden side effects

Prefer composition over inheritance whenever practical.

---

Dependencies

Keep dependencies to a minimum.

Before introducing a new library, verify that it provides significant value.

Avoid overlapping libraries that solve the same problem.

---

Configuration

Avoid hardcoded values.

Use configuration files or environment variables whenever appropriate.

---

Testing

Whenever practical, accompany new functionality with automated tests.

Code without tests should be considered incomplete.

---

Documentation

Documentation is part of the implementation.

Whenever functionality or architecture changes, update the relevant documentation.

---

Git

Use Git from the beginning.