CLAUDE.md

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

Project Overview

This is a Jekyll-based healthcare website featuring 141+ medical articles with intelligent categorization, tagging, and search functionality. The project has two main article directories:

• articles/ - Original source articles (141 total) with basic formatting
• _articles/ - Processed Jekyll articles (31/141 completed) with proper front matter, categorization, and enhanced content

Development Commands

Local Development

# Install Ruby dependencies
bundle install

# Serve locally with auto-reload
bundle exec jekyll serve

# Build for production
bundle exec jekyll build

Article Processing

The main workflow involves converting articles from articles/ to _articles/ with proper Jekyll front matter and medical categorization.

Architecture

Collections Structure

• _articles: Jekyll collection with processed medical articles
• _layouts: Three main layouts (default, article, category)
• assets: CSS styling and JavaScript search functionality

Article Processing Requirements

When processing articles from articles/ to _articles/:

1. Front Matter: Add comprehensive YAML front matter including:
   • title: Professional medical title
   • categories: From predefined healthcare categories (skin-conditions, respiratory, cardiovascular, mental-health, pediatric, orthopedic, digestive, infectious-diseases, emergency-care, preventive-care, dermatology, allergies, eye-conditions, first-aid)
   • tags: Medical terms relevant to the condition
   • reading_time: Estimated reading time in minutes
   • excerpt: Brief summary for SEO and quick reference
   • medical_author: Attribution (typically “Healthcare Professional”)
   • last_reviewed: Review date
   • related_conditions: Array of related medical conditions

Content Structure:

• Overview - Introduction and importance of understanding the condition
• Understanding How [Condition] Develops - Step-by-step formation process and affecting factors
• Root Causes and Contributing Factors - Primary causes (hormonal, genetic) and contributing factors (lifestyle, environmental, dietary, behavioral)
• Types of [Condition] Lesions/Symptoms - Detailed categorization with appearance, formation, and treatment notes
• Comprehensive Treatment Options - Tiered approach from over-the-counter to professional medical treatments
• When to See a Doctor - Clear indicators for seeking professional care
• Management Tips and Best Practices - Daily routines and lifestyle modifications
• Prevention Strategies - Primary and secondary prevention approaches
• Long-term Outlook and Expectations - Timeline and realistic expectations
• Medical Disclaimer - Important safety and professional consultation notes

1. Content Enhancement: Expand basic articles while maintaining medical accuracy and professional standards

2. Medical Standards: All articles must include appropriate medical disclaimers and evidence-based information

Key Features

• Search functionality: JavaScript-powered search in assets/js/search.js
• Responsive design: Mobile-optimized healthcare information
• SEO optimization: Schema.org structured data for medical articles
• Professional layouts: Specialized article layout with metadata display

Configuration

• Jekyll configuration in _config.yml with healthcare-specific settings
• Permalink structure: /articles/:name/
• Medical disclaimer included in site configuration
• Predefined healthcare categories for consistent categorization