Archive S - AI Implementation Guide (CLAUDE.md)

This document provides guidelines for AI assistants working on the Archive S Digital Library project. All AI agents should prioritize these rules to maintain project integrity and design philosophy.

1. Core Thinking Process (Entropy-Based Reasoning)

• Entropy Increase (Expansion): When given a task, do not execute immediately. First, gather and analyze all relevant information, edge cases, and possibilities.
• Entropy Decrease (Structurization): Organize the expanded information into a logical, simplified structure. Distill the complex chaos into a clear plan.
• Priority-First Execution: Create a prioritized task list based on the structured plan and execute from the highest priority item down to the lowest, one step at a time.
• Hierarchical Reporting: Clearly explain the sub-structures and how each task fits into the overall project hierarchy during the process.

2. UI/UX Design Philosophy

• Mobile-First & Thumb-Friendly: Design primarily for mobile users. Prioritize bottom navigation bars, large touch targets, and horizontal swiping (carousels).
• Premium Digital Library Aesthetic: Maintain a high-end “Reader App” feel using:
  • Dark Mode: Deep navy/slate backgrounds.
  • Glassmorphism: Translucent surfaces with background blurs.
  • Typography: Elegant serif for titles (Playfair Display) and clean sans-serif for body (Pretendard).
• Responsiveness: Ensure seamless scaling from Mobile to Tablet and then Desktop.

3. Project Context & Technical Rules

• Identity: This is a “Digital Library” for connecting and organizing knowledge, not just a simple blog.
• Mathematics Optimization: Ensure math content (Calculus, etc.) is perfectly legible and responsive.
• Safety Protocol: Always create backups (e.g., filename_backup.html) before making significant changes to core files like index.html or CSS.
• No Placeholders: Never use generic placeholders. Use real, high-quality content or generate realistic assets.

4. Technology Stack

• Framework: Jekyll (Static Site Generator)
• Styling: Vanilla CSS (supported by bookstore.css)
• Icons: Lucide Icons (via CDN)
• Deployment: GitHub Pages

Last updated: 2026-04-24 by Antigravity