AGENTS.md — bhargavachary.github.io

AGENTS.md — bhargavachary.github.io

Personal website and blog for D K Bhargav Achary. Live site: https://bhargavachary.in

Stack

  • Static site generator: Jekyll + GitHub Pages (Ruby)
  • Theme: chrisrhymes/bulma-clean-theme@v0.14.0 (remote theme via _config.yml)
  • Analytics: Google Analytics G-TFVWELSZ9W
  • Comments: Disqus (bhargavacharyin)
  • Deploy: Push to master → GitHub Actions (jekyll.yml) → auto-deploys to gh-pages
  • No Node.js, no npm, no Python — pure Jekyll/Ruby

Structure

_posts/         ← blog posts: YYYY-MM-DD-title.md (required front matter)
_pages/         ← static pages
_data/          ← YAML data files (nav, authors, etc.)
_includes/      ← reusable HTML partials
_layouts/       ← page layout templates
_config.yml     ← site config (do not touch url or baseurl)
Gemfile         ← Ruby deps (github-pages gem + plugins)
scripts/
  optimize-images.sh   ← run before committing any images

Commands

bundle install                  # install Ruby deps
bundle exec jekyll serve        # local dev at http://localhost:4000
bash scripts/optimize-images.sh # optimize images before committing

Rules

  • Blog posts go in _posts/YYYY-MM-DD-title.md with front matter: layout, title, date, categories
  • Do not change url: "https://bhargavachary.in" or baseurl: "" in _config.yml
  • Do not modify the remote theme version without local testing first
  • Optimize images with optimize-images.sh before committing
  • Do not commit a macOS-generated Gemfile.lock — it’s platform-specific and breaks CI
  • Do not manually push to gh-pages — CI owns that branch
  • Public repo — never commit credentials, tokens, or new tracking IDs

Owner

D K Bhargav Achary — sole maintainer.