docs: improve CLAUDE.md with comprehensive development guide

- Add detailed development commands including bin scripts
- Expand architecture section with Hugo configuration details
- Add git submodule management instructions
- Include blog post structure guidelines and testing strategy
- Document deployment pipeline details

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: tmr08c

CLAUDE.md

@@ -10,69 +10,97 @@ This is a personal blog built with Hugo (Go static site generator) using the hug
 
 ### Development
 ```bash
-cd hugo-site           # Navigate to Hugo site directory
-hugo server            # Start development server at localhost:1313
-hugo                   # Build production site
+cd hugo-site                    # Navigate to Hugo site directory
+./bin/dev                      # Start development server with drafts at localhost:1313
+./bin/server                   # Start production-like server at localhost:1313
+hugo server                    # Basic Hugo server
+hugo                          # Build production site to public/ directory
 ```
 
-### Code Quality
+### Testing
 ```bash
-# Content is primarily markdown files
+cd hugo-site                   # Navigate to Hugo site directory
+npm install                   # Install test dependencies (first time only)
+npm run test:e2e              # Run E2E tests with interactive Cypress UI
+npm run test:e2e:ci           # Run E2E tests in headless CI mode
+npm run cy:open               # Open Cypress test runner directly
 ```
 
-### Testing
+### Content Creation
 ```bash
-cd hugo-site           # Navigate to Hugo site directory
-npm run cy:open        # Open Cypress test runner
-npm run test:e2e       # Run E2E tests with dev server
-npm run test:e2e:ci    # Run E2E tests in CI mode
+cd hugo-site
+hugo new blog/YYYY/MM/post-title/index.md    # Create new blog post with archetype
+hugo list drafts                              # List all draft content
+hugo list future                              # List future-dated content
 ```
 
 ### Deployment
 ```bash
 # Automatic deployment via GitHub Actions when pushing to main branch
 # Manual deployment can be triggered from GitHub Actions tab
+# Site deploys to: https://tmr08c.github.io/
 ```
 
 ## Architecture
 
-### Content Structure
-- Blog posts are markdown files in `hugo-site/content/blog/` organized by year/month
-- Static assets go in `hugo-site/static/`
-- Hugo configuration in `hugo-site/hugo.toml`
-- Theme files in `hugo-site/themes/hugo-texify3/`
+### Content Organization
+- **Blog posts**: `hugo-site/content/blog/YYYY/MM/post-name/index.md` with co-located assets
+- **Static files**: `hugo-site/static/` for site-wide assets (favicon, etc.)
+- **Theme assets**: `hugo-site/themes/hugo-texify3/` (git submodule from GitHub)
+- **Custom layouts**: `hugo-site/layouts/` for overriding theme templates
+
+### Hugo Configuration Highlights
+- **Permalinks**: Posts use `/:year/:month/:slug/` format
+- **Outputs**: Generates both HTML and RSS feeds
+- **Markup**: Goldmark renderer with syntax highlighting enabled
+- **Navigation**: Main menu includes Blog, RSS, and GitHub links
+- **Theme features**: Table of contents, social sharing, custom CSS/JS support
+
+### Development Workflow
+- Use `./bin/dev` for development (includes drafts and future posts)
+- Content is primarily markdown with YAML frontmatter
+- Hugo rebuilds automatically on file changes during development
+- Cypress tests verify site functionality after builds
 
 ### Key Technologies
 - **Static Site Generator**: Hugo (Go-based)
 - **Theme**: hugo-texify3 (git submodule)
-- **Styling**: PostCSS with theme-provided CSS
-- **Code highlighting**: Hugo's built-in syntax highlighting
-- **Testing**: Cypress for E2E tests
-- **Deployment**: GitHub Actions to GitHub Pages
-
-### Important Files
-- `hugo-site/hugo.toml` - Main Hugo configuration
-- `hugo-site/layouts/` - Custom layout templates (if any)
-- `hugo-site/content/` - All content including blog posts
-- `hugo-site/static/` - Static assets (images, files)
-- `hugo-site/themes/hugo-texify3/` - Theme files (git submodule)
-
-## Branching Strategy
+- **Styling**: PostCSS pipeline + theme SCSS
+- **Testing**: Cypress E2E tests with start-server-and-test
+- **Deployment**: GitHub Actions → GitHub Pages
+- **Content**: Markdown with YAML frontmatter
 
-- **main** - Main development and deployment branch
-- **master** - Legacy branch (GitHub Pages publishes from main now)
-- Work on `main`, GitHub Actions automatically deploys to GitHub Pages
+## Important Implementation Details
 
-## Testing
-
-E2E tests are in `hugo-site/cypress/e2e/` and cover:
-- Homepage navigation and content
-- Blog post listing and navigation
-- Site functionality
-
-## Deployment
+### Git Submodule Management
+The hugo-texify3 theme is managed as a git submodule. When cloning or updating:
+```bash
+git submodule update --init --recursive  # Initialize submodules
+git submodule update --remote           # Update theme to latest
+```
 
-Site deploys to GitHub Pages via GitHub Actions. The deployment process:
-1. Builds the Hugo site when code is pushed to `main`
-2. Automatically deploys to GitHub Pages
-3. Can also be triggered manually from the GitHub Actions tab
+### Blog Post Structure
+New posts should follow the established pattern:
+- Location: `hugo-site/content/blog/YYYY/MM/descriptive-title/index.md`
+- Co-locate images and assets in the same directory as `index.md`
+- Use YAML frontmatter with title, date, and optional tags
+
+### Custom Bin Scripts
+The `hugo-site/bin/` directory contains convenience scripts:
+- `./bin/dev` - Development server with drafts and future content enabled
+- `./bin/server` - Production-like server without drafts
+- `./bin/build` - Production build script
+- `./bin/setup` - Initial setup script
+
+### Testing Strategy
+- E2E tests in `hugo-site/cypress/e2e/` verify core site functionality
+- Tests run against Hugo server on port 8000 (not default 1313)
+- CI runs tests in headless mode, development uses interactive mode
+
+## Deployment Pipeline
+
+Site deploys automatically via GitHub Actions:
+1. **Trigger**: Push to `main` branch or manual workflow dispatch
+2. **Build**: Hugo generates static site with production optimizations
+3. **Deploy**: GitHub Pages publishes to https://tmr08c.github.io/
+4. **Dependencies**: Uses Hugo version specified in `hugo-site/.tool-versions`