AGENTS.md - Guidelines for AI Coding Agents

This is a Jekyll-based personal website using GitHub Pages and the Minimal Mistakes theme.

Build Commands

Serve the site locally

bundle exec jekyll serve

Site will be available at http://127.0.0.1:4000

Build for production

bundle exec jekyll build

Output goes to _site/ directory.

Install dependencies

bundle install

Clean build artifacts

bundle exec jekyll clean

Project Structure

Code Style Guidelines

YAML Data Files (_data/*.yml)

Markdown Files (_pages/, _posts/)

Configuration (_config.yml)

GitHub Pages Constraints

Naming Conventions

Error Handling

Adding New Content

Add a new page

  1. Create file in _pages/ with front matter
  2. Add to navigation in _data/navigation.yml if needed
  3. Test locally before committing

Add to projects/jobs/etc

  1. Edit corresponding file in _data/
  2. Follow existing structure and ordering
  3. Use consistent date formats

Modify configuration

  1. Edit _config.yml
  2. Restart jekyll serve for changes to take effect
  3. Test build with bundle exec jekyll build

Common Issues

Notes