Add comprehensive CLAUDE.md documentation for AI assistants

[epavanello]

Created a detailed guide for AI assistants working with the DevMotion codebase, including:

• Complete project overview and technology stack
• Detailed architecture and design patterns
• Comprehensive directory structure with explanations
• Development workflows and commands
• Code conventions and style guide
• Key concepts (Project, Layers, Keyframes, Animation Engine, MCP Server)
• Testing guidelines and examples
• Common tasks and troubleshooting guide
• Best practices for state management, performance, and security

This documentation will help AI assistants understand the codebase structure,
follow project conventions, and implement changes more effectively.

https://claude.ai/code/session_01MXufG9kCKY5NJMyaaEU3dj

Summary by CodeRabbit

• Documentation
  • Added comprehensive architecture and development reference documentation covering core design patterns, naming conventions, file organization, development workflows, component management tasks, animation engine and flow architecture, server implementation details and setup, testing strategies and approaches, critical design patterns to follow and patterns to avoid, and best practices for maintaining and extending the DevMotion editor ecosystem.

[coderabbitai]

📝 Walkthrough

Walkthrough

A new comprehensive documentation file, CLAUDE.md, has been added to guide AI assistant development within the DevMotion editor ecosystem. The document covers architecture patterns, key file locations, conventions, core data types, common tasks, development workflows, and critical patterns to follow.

Changes

Cohort / File(s)	Summary
Documentation CLAUDE.md	New 229-line reference guide documenting DevMotion AI Assistant architecture, core patterns (Svelte 5 runes, Zod-first types, shared mutations), conventions, data types, common tasks, development workflows, MCP server architecture, testing strategies, and environment variables. Status-dated 2026-02-05.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

📚 A guide for the wise and the code,
Where AI assistants find their road,
Architecture patterns, neat and bright,
✨ DevMotion shines with newfound light,
The rabbit hops through this knowledge base,
Svelte and Zod in perfect grace!

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The pull request title accurately describes the main change: adding comprehensive CLAUDE.md documentation for AI assistants. The title is specific, clear, and directly reflects the changeset content.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch claude/add-claude-documentation-5WJXu

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@CLAUDE.md`:
- Around line 67-76: The fenced code block containing the src/lib/ directory
tree is missing a language specifier (triggers MD040); update the opening fence
(```) to include a language such as text so it becomes ```text — this change
should be made where the directory tree block (starting with "src/lib/") is
declared in CLAUDE.md to satisfy the linter.

[coderabbitai]

⚠️ Potential issue | 🟡 Minor

Add a language specifier to the fenced code block.

Line 67 opens a fenced block without a language, which trips MD040. Consider using text for the directory tree.

🛠️ Suggested fix

-```
+```text
 src/lib/
 ├── stores/           # Global state (Svelte 5 runes)
 ├── schemas/          # Zod schemas (source of truth for types)
 ├── engine/           # Animation interpolation & rendering
 ├── layers/           # Layer type components & registry
 ├── ai/              # Shared mutation logic for web + MCP
 ├── components/       # UI components (editor/, ui/, ai/)
 └── server/          # Server-only code (db/, services/)

</details>

<details>
<summary>🧰 Tools</summary>

<details>
<summary>🪛 markdownlint-cli2 (0.20.0)</summary>

[warning] 67-67: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

</details>

</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

In @CLAUDE.md around lines 67 - 76, The fenced code block containing the
src/lib/ directory tree is missing a language specifier (triggers MD040); update
the opening fence () to include a language such as text so it becomes text
— this change should be made where the directory tree block (starting with
"src/lib/") is declared in CLAUDE.md to satisfy the linter.

</details>

<!-- fingerprinting:phantom:triton:eagle -->

<!-- This is an auto-generated comment by CodeRabbit -->