Raiju/CLAUDE.md

Raiju CMS - Claude Entry Point

This file exists for tools that automatically look for CLAUDE.md.

The canonical, tool-neutral agent guide is AI-AGENT-GUIDE.md. Read it before making non-trivial changes. For task-oriented workflows, also see SKILLS.md.

Critical Rules

• Decide first whether you are doing site adaptation or Raiju core development.
• For site adaptation, avoid editing Raiju-Core files such as admin/, api/, cli/, most of includes/, core css/, and core js/; use content JSON, page templates, css/website.css, css/page-*.css, assets, and documented hooks instead.
• For existing-site migrations, preserve the source visual behavior exactly: copy original local CSS/JS/assets first, keep class names and layout wrappers, and inject editable helpers without redesigning, simplifying, or re-creating the styling.
• For Raiju core development, core files may be edited when the user explicitly asks for admin UI, API, CLI, backup, routing, setup, editor, or shared behavior changes.
• JSON is the source of truth for editable content.
• Use $basePath for asset and link paths.
• Set $contentPage before including includes/header.php.
• Compare original and converted screenshots section by section before calling a migration done; visual differences are defects unless the user requested a redesign.
• main is protected on GitHub; push branches and merge through Pull Requests.